Realiza la solicitud al SAT de descarga masiva de XMLs EMITIDOS por el contribuyente.
Las funciones para solicitar descargas se deben de ejecutar primero antes de descargar información del SAT, son 4, dependiendo de la información que se quiera obtener:
Las funciones para solicitar descargas se 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
public static void VirtualXML_MasivaSolicitaEmitidoXML2022(
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)
Parametros
- Usuario
- Tipo: System
String
Nombre del usuario VirtualPAC (el mismo que se utiliza en el portal de asignación de timbres)
Tipo: System String
- Ubicación (ruta y nombre del archivo) del Archivo .CER correspondiente a la FIEL del emisor.
- Tipo: System
String
Ubiación (ruta y nombre del archivo) del Archivo .KEY correspondiente a la FIEL del emisor.
- 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. Si se desean obtener todos los documentos emitidos a un mismo receptor, se debe indicar en este parámetro el RFC del RECEPTOR. Si se desean descargar todos los documentos emitidos, independientemente del receptor, este parametro se debe indicarse vacío.
- 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
Parámetro para indicar la fecha de finalización de la descarga en el formato aaaa-mm-ddThh:mm:ss
- 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.
- 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.
- 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_MasivaSolicitaEmitidoXML2022
- ArchLog
- Tipo: System
String
Nombre del archivo que guardará la bitácora de la petición (necesario para depurar errores).
- 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, el cual aparecerá en el archivo de
bitácora..Ejemplo
private void SolicitaXMLEmitidos(Int error)
{
// Iniciamos solicitud de XMLs emitidos de EGRESO de todo el año 2021 para todos los receptores
int nResultado = VirtualXML_MasivaSolicitaEmitidoXML2022("cibertec","archivo.cer","archivo.key","password","","2021-01-01T00:00:00","2021-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" ); // ....
}
}
Veáse También:
VirtualXML_MasivaSolicitaEmitidoMetadata()
VirtualXML_MasivaSolicitaRecibidoXML()
VirtualXML_MasivaSolicitaRecibidoMetadata()
VirtualXML_MasivaVerifica()
VirtualXML_MasivaDescarga()