VirtualXML_MasivSolicitaEmitidoMetaData

Función VirtualXML_MasivaSolicitaEmitidoMetadata2022

VirtualXML

Realiza la solicitud al SAT de la Metadata correspondiente a los documentos EMITIDOS por el contribuyente.

La Metadata es un archivo de texto cuyos valores se encuentran separados por el simbolo de tilde (~) y que contiene información sobre un conjunto de archivos XML. Dicha información es:

UUID del documento
Rfc del Emisor
Nombre del Emisor
Rfc del Receptor
Nombre del Receptor
Rfc del PAC (Proveedor Autorizado de Certificación) que timbró el documentoImporte
Fecha y hora de Emisión
Fecha y hora de Certificación
Total del documento
Tipo de CFDI (Ingreso, Egreso, Nomina, Traslado, Pago)
Estado del CFDI: Vigente (1) o Cancelado (0)
Fecha de cancelación en caso de que el documento haya sido cancelado.

Ejemplo:

66148226-FE20-4443-B534-D72284B9790A~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"SST120524DC3~SOLUCIONES SOFTWARE Y TECNOLOGIA DIGITAL RMG~LSO1306189R5~2022-08-08 12:37:49~2022-08-08 17:13:10~12500~I~1~
8C0344D4-26BE-4A02-B5D8-990AD370F907~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~PIG190624TJ8~PROCESOS INNOVATIVOS GENERACIONALES~LSO1306189R5~2022-08-08 13:05:11~2022-08-08 15:43:47~1160~I~1~
CCF6839F-E5C0-4915-9B73-C15581683D53~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~GENL730909PM6~LUIS JORGE GERMAN NERI~LSO1306189R5~2022-08-09 12:30:04~2022-08-09 13:14:42~1160~I~1~
66F9609B-68C8-45DF-A91C-717D18F3C987~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~COPG650201NT3~Gustavo Ignacio Coutiño Peña~LSO1306189R5~2022-08-10 10:30:00~2022-08-10 17:00:56~11500~I~1~
5BA85B19-7259-4E50-8CC2-D39F8BDA9C60~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~SOOA790415DV3~JOSE ALEJANDRO SOTO ORRANTIA~LSO1306189R5~2022-08-11 12:15:37~2022-08-11 14:26:49~290~I~1~
6ABEBC46-AA3A-4A53-A062-018974652A6D~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~CVI201022V53~CORPORATIVO VIPACO~LSO1306189R5~2022-08-11 12:50:13~2022-08-11 14:45:58~1160~I~1~
ABE77799-D402-48B9-B7C9-D30729D6A21E~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~AGR950727NH3~AGROBO~LSO1306189R5~2022-08-11 13:10:17~2022-08-11 14:50:47~4930~I~1~
3A3C0D42-01FE-4B93-B5F4-C62E6E58CC30~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~BIM220708NZ7~BRIGHT INDUSTRIES MEXICO~LSO1306189R5~2022-08-12 13:03:07~2022-08-15 12:05:08~1160~I~1~
6F7FEECD-4548-4874-B66C-48523F1F0149~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~SOLM660807IH3~Martha Lucía Sosa López~LSO1306189R5~2022-08-15 13:36:09~2022-08-16 09:07:11~2610~I~0~2022-08-29 21:58:31

Las funciones para solicitar descargas (tanto de metadata como de xmls) de deben de ejecutar primero antes de descargar información del SAT, son 4, dependiendo de la información que se quiera obtener:

Solicitud de Metadata de XML Emitidos (VirtualXML_MasivaSolicitaEmitidoMetadata2022())
Solicitud de Metadata de XML Recibidos (VirtualXML_MasivaSolicitaRecibidoMetadata2022())
Solicitud de descarga masiva de XML Emitidos (VirtualXML_MasivaSolicitaEmitidoXML2022())
Solicitud de descarga masiva de XML Recibidos(VirtualXML_MasivaSolicitaRecibidoXML2022())

Namespace: VirtualXML®
Aplicación: CFDI ver. 3.3 y CFDI ver. 4.0

Sintaxis

C++

Copiar en el Portapapeles Imprimir

public static void VirtualXML_MasivaSolicitaEmitidoMetadata2022(
	String Usuario, 
        String ArchivoCerFiel, 
        String ArchivoKeyFiel, 
        String PwdKey, 
        String RfcReceptor, 
        String FechaDesde, 
        String FechaHasta, 
	String Estado, 
	String Complemento, 
	String Tipo, 
	String UUID,
        String ArchResultado, 
        String ArchLog, 
        String Reservado)

public static void VirtualXML_AddConcepto(
	int p,
	string cantidad,
	string unidad,
	string descripcion,
	string valorUnitario,
	string importe,
	string noIdentificacion
)

Parametros

Usuario: Tipo: System String
Nombre del usuario VirtualPAC (el mismo que se utiliza en el portal de asignación de timbres)

ArchivoCerFiel
Tipo: System String

Ubicación (ruta y nombre del archivo) del Archivo .CER correspondiente a la FIEL del emisor.

ArchivoKeyFiel

Tipo: System String
Ubiación (ruta y nombre del archivo) del Archivo .KEY correspondiente a la FIEL del emisor.

PwdKey

Tipo: System String
Password del Archivo .KEY de la FIEL del emisor.

RfcReceptor: Tipo: System String
Parámetro opcional para indicar el RFC del RECEPTOR de los documentos emitidos de los cuales se quiere obtener la Metadata. Si se desean obtener la metadata de todos los documentos emitidos a un mismo receptor, se debe indicar en este parámetro el RFC del RECEPTOR. Si se desean descargar la metadata de todos los documentos emitidos, independientemente del receptor, este parametro se debe omitir.

FechaDesde

Tipo: System String
Parámetro para indicar la fecha de inicio de la descarga masiva en el formato aaaa-mm-ddThh:mm:ss

FechaHasta: Tipo: System String
Parametro para indicar la fecha de finalización de la descarga en el formato aaaa-mm-ddThh:mm:ss

Estado: Tipo: System String
Parámetro para indicar el estado de los documentos a descargar. Valores posibles "1" = Activo, "0" = Cancelados, si se omite, se devuleven todos los documentos. Nota: A partir del año 2022, los documentos CANCELADOS no se descargan, sin embargo, el estado de cancelado y la fecha de cancelación quedan reportados en la descarga de la MetaData.

Complemento

Tipo: System String
Parámetro para indicar el complemento que debe tener el documento a descargar. Se debe indicar el nombre del complemento como se indica en el Anexo 20 p.ej. "Donatarias", "leyendasFisc", "CartaPorte20", "implocal", etc. Si se omite se descargan los XMLs con cualquier complemento

Tipo: Tipo: System String
Parametro para indicar el tipo de documento que deseamos descargar. Valores posibles "I" = Ingreso, "E" = Egreso, "N" = Nomina, "P" = Pagos, "T" = Traslados. Si se omite, se descargan todo tipo de documentos.

UUID

Tipo: System String
Parametro para indicar el UUID de un documento específico a descargar. Si se omite, se descargan todos los CFDIs.

ArchResultado: Tipo: System String
El resultado de la petición será devuelto en un archivo con el formato INI cuyo nombre se debe indicar en este parámetro (indicar la extensión ".INI" en el nombre).; En este archivo se encuentra la información que será necesaria para la posterior verificación y recuperación de la metadata en la entrada IDSOLICITUD.:

	[VirtualXML]
	IDSOLICITUD = fef63edl-1041-402f-b678-b42126b9f66d
	FUNCTIONCALL = VirtualXML_MasivaSolicitaEmitido

ArchLog: Tipo: System String
Nombre del archivo que guardará la bitácora de la petición (necesario para depurar errores).

Reservado

Tipo: System String
Parmetro sin valor para usos futuros.

Valor retornado:

Tipo: Int32

Retorna 0 si la peticion se realizó con éxito. Cualquier otro valor diferente de 0 indica un error que deberá ser consultado en el archivo de bitácora.

Ejemplo

Copiar en el Portapapeles Imprimir

private void SolicitaMetadataEmitidos(Int error)
{
    // Iniciamos solicitud de la metadata de xml emitidos de todo el año 2020 para todos los receptores 
    int nResultado = VirtualXML_MasivaSolicitaEmitidoMetadata2022("cibertec","archivo.cer","archivo.key","password","","2020-01-01T00:00:00","2020-12-31T23:59:59","","","","";"Resultado.INI","bitacora.log","");
    
    if ( nResultado != 0 )
    {
        // Ocurrio un Error
        MsgBox("Error en la solicitud de descarga" );  
    }
    else
    {
        // Todo correcto procede a recuperar el ID de la peticion
        MsgBox("Solicitud generada con exito, revise el archivo Resultado.INI para obtener el ID de la peticion" );        // ....
    }

}

private void GeneraDocto(String version)
{
    // Creamos un comprobante 
    int hXml = VirtualXML_New(version);

    // Llenado del documento 

    // Datos del emisor 

    // Datos del receptor 

    // Conceptos 
    // Aqui va un bucle de conceptos, aqui vamos a poner un for para agregar 5 conceptos 
    for ( int i = 0; i < 5; i++)
    {
        VirtualXML_AddConcepto( hXml, i.ToString(), "PZAS", "Descripcion", "1000", ( i * 1000 ).ToString(), "" );
    }

    // Procesamiento del documento 
    // .... 

    // Lectura de resultados 
    // .... 

    // Liberacion de memoria
    VirtualXML_Free(hXml);
}

Veáse También:

                                   VirtualXML_MasivaSolicitaEmitidoXM2022L()
                                   VirtualXML_MasivaSolicitaRecibidoXML2022()
                                   VirtualXML_MasivaSolicitaRecibidoMetadata2022()
                                   VirtualXML_MasivaVerifica()
                                   VirtualXML_MasivaDescarga()