VirtualXML_MasivSolicitaRecibidoMetaData

Función VirtualXML_MasivaSolicitaRecibidoMetadata2022

VirtualXML

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

La Metadata es un archivo de texto cuyos valores se encuentran separados por el símbolo 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 documento
Fecha y hora de emisión
Fecha y hora de certificación
Importe
Total del documento
Tipo de CFDI (Ingreso, Egreso, Nomina, Traslado, Pago)
Estado del CFDI: Vigente o Cancelado
Fecha de cancelación en caso de que el CFDI haya sido cancelado.

Ejemplo:

66148226-FE20-4443-B534-D72284B9790A~ESD140725UP8~"E-SI SOLUCIONES DIGITALES"~BATJ680401RR9~Julio Ballesteros Tellez~LSO1306189R5~2022-08-07 16:43:20~2022-08-10 15:50:54~435~I~1~
9E43558C-0742-4B46-A2FC-5F06AD3E363C~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_MasivaSolicitaRecibidoMetadata(
	String Usuario, 
        String ArchivoCerFiel, 
        String ArchivoKeyFiel, 
        String PwdKey, 
        String RfcEmisor, 
        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.

RfcEmisor: Tipo: System String
Parámetro opcional para indicar el RFC del EMISOR de los documentos recibidos de los cuales se quiere obtener la Metadata. Si se desean obtener la metadata de todos los documentos recibidos de un mismo receptor, se debe indicar en este parámetro el RFC del EMISOR. Si se desean descargar la metadata de todos los documentos recibidos, independientemente del emisor, 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_MasivaSolicitaRecibido

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.

Ejemplo

Copiar en el Portapapeles Imprimir

private void SolicitaMetadataEmitidos(Int error)
{
    // Iniciamos solicitud de la metadata de xml recibidos de todo el año 2020 para todos los receptores 
    int nResultado = VirtualXML_MasivaSolicitaRecibidoMetadata2022("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_MasivaSolicitaEmitidoXML()
                                   VirtualXML_MasivaSolicitaRecibidoXML()
                                   VirtualXML_MasivaSolicitaEmitidoMetadata()
                                   VirtualXML_MasivaVerifica()
                                   VirtualXML_MasivaDescarga()