Función VirtualXML_MicroConsultaDatosFiscales VirtualXML
Nivel de MicroServicio: 1
Precio de la función: $50.00 mas IVA

Realiza una búsqueda de los datos fiscales de un receptor indicando únicamente el RFC del mismo.

La búsqueda se realiza sobre la base de datos de receptores de VirtualPAC, por lo que no es seguro que el RFC solicitado exista en nuestros registros, sin embargo, si ANTES de usar esta función la combinas con el Validador de Datos  Fiscales versión WEB en su versión gratuita o Premium, tendrás un 100% de certeza tanto de que exista el RFC en la base de datos, como de que sus datos fiscales sean correctos.

Namespace: VirtualXML®
Aplicación: CFDI ver. 4.0
Sintaxis
Copiar en el PortapapelesImprimir
public static void VirtualXML_MicroConsultaDatosFiscales(
	string ApiKey,
	string Usuario,	
	string RfcEmisor,	
	string RfcReceptor,
	string Cer,
	string Key,
	string PwdKey
	string ResultFile,
	string OutLog,
	string Reservado)

Parámetros

ApiKey
Tipo: System  String
Clave de acceso a funcionalidades administrativas.

Usuario
Tipo: System  String
Clave de usuario VirtualPAC, es decir, la clave con la accedes al portal VirtualPAC.

RfcEmisor
Tipo: System  String
RFC emisor, previamente dado de alta en el portal VirtualPAC.

RfcReceptor
Tipo: System  String
RFC del cual deseamos obtener los datos fiscales actualizados.

Cer
Tipo: System  String
Archivo .CER del certificado de sello digital (CSD) del emisor.
Key
Tipo: System  String
Archivo .KEY del certificado de sello digital (CSD) del emisor.
PwdKey
Tipo: System  String
Contraseña del archivo .KEY del certificado del sello digital (CSD) del emisor.
ResultFile
Tipo: System  String
Nombre del archivo .INI donde se van a guardar los datos fiscales del RFC receptor. El archivo  INI presenta la siguiente estructura:

  [VirtualXML]
  EXITCODE = 0 // resultado de la función
  COMMINFO = Success.Match.Exact // uso interno
  RFC = CTE940531F58
  NOMBRE = CIBERNETICA Y TECNOLOGIA
  REGIMEN = 601
  CP = 53050
  VALIDATEDON = 2023-04-17 // fecha de la última actualización de datos
  SOURCE = local // uso interno
  FECHAHORA = 2023-06-09T17:15:45 // fecha / hora en que se realiza la consulta
  FUNCTIONCALL = VirtualXML_MicroConsultaDatosFiscales // función que se utilizó

OutLog
Tipo: System  String
Nombre del archivo donde se guardará la bitácora de procesos de la consulta de datos fiscales del  RFC.
Reservado
Tipo: System  String
Parámetro reservado para usos futuros.

Valor retornado:

Tipo: Int32

Retorna un valor númerico indicando el resultado de la búsqueda del RFC receptor y pueden ser los siguientes:

Resultado
Descripción
0
 Busqueda exitosa, revise el archivo .INI para obtener los datos fiscales del receptor
-2
 Error desconocido
-3
 Error en la validación de identidad
-4
 Politica de uso justo sobrepasada
-5
 Fecha de servicio vencida
-6
 ApiKey inválido
-7
 Servicio no contratado
-8
 RFC emisor no encontrado
-9
 Saldo para demos agotado
-10
 Servicio fuera de linea
-11
 ApiKey no coincide con el usuario

Ejemplo:
Copiar en el PortapapelesImprimir
private void ConsultaRfcReceptor()
{
    // Hacemos la consulta 
    int nResultado = VirtualXML_MicroConsultaDatosFiscales("4fX0clxaYpp95dZuYBrzlo5IXJC2BIWkxzdbh0G9yc",;
							   "demo_cibertec",;
							   "EKU9003173C9",;
							   "CTE940531F58",;
							   "ArchivoCer.cer",;
							   "ArchivoKey.key",;
							   "PasswordKey",;
							   "ResultadoDatosFiscales.INI",;
							   "BitacoraDatosFiscales.log","");

switch ( nResult )
    {
       case 0:
          // Se han encontrado los datos fiscales del emisor
          MsgBox("RFC encontrado, revise el archivo ResultadoDatosFiscales.INI para obtener los datos del emisor");
          break;
       case -2
          // Error no identifcado
          MsgBox("Error desconocido");
          break;
       case -3:
          // Identidad invalida 
          MsgBox("No existe el usuario VirtualPAC");
          break;
       case -4:
          // Error uso justo
          MsgBox("Se ha rebasado la politica de uso justo de la función");
          break;
       case -5:
          // Servicio vencido
          MsgBox("La fecha de servicio ha expirado");
         break;
       case -6:
          // Error en el ApiKey
          MsgBox("El ApiKey proporcionado no existe");
         break;
       case -7
          // Servicio no contratado
          MsgBox("No tienes contratado el servicio de validación de RFCs");
         break;       
       case -8:
          // RFC no encontrado
          MsgBox("El RFC solicitado no se encuentra en nuestros regisros, utilice su validador de datos fiscales");
         break;       
       case -9:
          // Demo agotado
          MsgBox("Se han agotado las consultas de demo");
         break;       
       case -10:
          // Servicio fuera de linea
          MsgBox("Servicio de validación fuera de línea, intente mas tarde");
         break;       
       case -11:
          // Usuario/ApiKey invalidos
          MsgBox("El ApiKey no corresponde al usuario de VirtualPAC");
         break;       
    }

    VirtualXML_Free(hXml);
}
Veáse También
VirtualXML_MicroValidaDatosFiscales()