VirtualXML_MasivSolicitaRecibidoXml

Función VirtualXML_MasivaSolicitaRecibidoXML2022

VirtualXML

Realiza la solicitud al SAT de descarga masiva de XMLs RECIBIDOS por el contribuyente.

Las funciones para solicitar descargas 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_MasivaSolicitaRecibidoXML2022(
	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. Si se desean obtener todos los documentos emitidos por un mismo contribuyente, se debe indicar en este parámetro el RFC del EMISOR. Si se desean descargar 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 información solicitada 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.

Ejemplo

Copiar en el Portapapeles Imprimir

private void SolicitaXMLEmitidos(Int error)
{
    // Iniciamos solicitud de XMLs de EGRESO recibidos de todo el año 2020 para todos los receptores 
    int nResultado = VirtualXML_MasivaSolicitaRecibidoXML2022("cibertec","archivo.cer","archivo.key","password","","2020-01-01T00:00:00","2020-12-31T23:59:59","","E","","","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_MasivaSolicitaEmitidoMetadata2022()
                                   VirtualXML_MasivaSolicitaEmitidoXML2022()
                                   VirtualXML_MasivaSolicitaRecibidoMetadata2022()
                                   VirtualXML_MasivaVerifica()
                                   VirtualXML_MasivaDescarga()