En esta documentación encontraras la información para consumir nuestro web services para consulta y descarga de todo tipo de CFDI desde el SAT de modo masivo. Te permite obtener y administrar la información financiera de tu empresa descargando todos tus XML a una nube segura por 5 años.
El servicio se encuentra disponible en una dirección URL pública:
https://descargamasiva.pade.mx/api/
URL de generación de una solicitud de Descarga de comprobantes:
https://descargamasiva.pade.mx/api/solicitud/generar
Este método se utiliza para generar la solicitud según los parámetros especificados en la petición. El método realiza la autenticación al servicio, valida los parámetros y regresa un Json como respuesta al servicio. La estructura del Json de respuesta se explica más adelante.
Sin embargo los parámetros rfcEmisor o rfcReceptor debe de ir al menos uno, ya que uno de los dos (emisor o receptor) debe coincidir con el rfc del solicitante.
{
"numeroSolicitud": "00000000-0000-0000-0000-000000000000",
"estadoSolicitud": "5000",
"mensaje": [
"Solicitud creada exitosamente."
],
"respuestaSAT": {
"codigo": "5000",
"mensaje": "Solicitud Aceptada"
}
}
{
"numeroSolicitud": "00000000-0000-0000-0000-000000000000",
"estadoSolicitud": "8000",
"mensaje": [
"Error al generar la solicitud."
],
"respuestaSAT": {
"codigo": "5001",
"mensaje": "Tercero no Autorizado""
}
}
No todos los atributos estarán presentes siempre en la respuesta. La descripción de los mismos se define a continuación:
URL para consultar el estatus de una solicitud generada de Descarga de comprobantes:
https://descargamasiva.pade.mx/api/solicitud/estatus
Se utiliza para consultar el estatus de una solicitud anteriormente generada para la descarga de comprobantes de un RFC Solicitante según los parámetros especificados. Este método realiza la autenticación al servicio, validación y descarga de los paquetes ante el SAT.
{
"numeroSolicitud": "00000000-0000-0000-0000-000000000000",
"estadoSolicitud": "2",
"mensaje": [
"Solicitud en progreso"
],
}
{
"numeroSolicitud": "00000000-0000-0000-0000-000000000000",
"estadoSolicitud": "7",
"mensaje": [
"Paquetes listos"
],
"paquetes": [
"<URL descarga>"
]
}
{
"numeroSolicitud": "00000000-0000-0000-0000-000000000000",
"estadoSolicitud": "8000",
"mensaje": [
"Solicitud no encontrada"
]
}
No todos los atributos estarán presentes siempre en la respuesta. La descripción de los mismos se define a continuación:
Un archivo PFX no es más que el Certificado y Llave privada en un solo archivo. Podríamos decir que una fusión de ambos archivos.>
Para la generación de este archivo, necesitaremos un certificado (*.cer) y su llave privada correspondiente (*.key), teniendo esto, además necesitaremos la utilería para OpenSSL. Para Windows lo descargaremos de https://www.openssl.org/source/.
Una vez teniendo descomprimido, abriremos la consola en windows. Para ello iremos a “inicio” y buscaremos “cmd” y ejecutaremos la consola o “Command Prompt”, después nos posicionaremos en el mismo directorio donde descomprimiste el .zip. Para este ejemplo utilizaré la ruta “c:\out\openssl”
Y estando utilizaremos los siguientes comandos.
openssl pkcs8 -inform der –in CSD_Pruebas_CFDI_LAN7008173R5.key -passin pass:12345678a -out key.pem
Donde tenemos “CSD_Pruebas_CFDI_LAN7008173R5.key” como la llave privada, “12345678a” como el password de la llave privada y “key.pem” como el archivo de salida.
openssl x509 -inform der –in CSD_Pruebas_CFDI_LAN7008173R5.cer -out cer.pem
En este caso tenemos “CSD_Pruebas_CFDI_LAN7008173R5.cer” como el certificado y “cer.pem” como el archivo de salida.
openssl pkcs12 -export –in cer.pem -inkey key.pem -out LAN7008173R5.pfx
Al ejecutar esté último comando, nos solicitara un password, dicho password es el que tendrá el PFX. En este caso yo proporcione el mismo que tiene la llave privada (12345678a). De igual manera nos solicitara confirmar el password. (En la consola no se mostrará lo que escribamos como password, pero si lo tiene en cuenta para la generación del mismo).
Como paso final, en los WebService que ofrecemos normalmente solicitamos este archivo en el request como base64. Esto lo podemos hacer en nuestro lenguaje de programación directamente o a través de OpenSSL.
openssl enc -base64 –in LAN7008173R5.pfx -out LAN7008173R5.txt
Y esto nos generará un archivo .txt con la encriptación de los binarios del PFX en base64.
| Código del estado de la solicitud | Mensaje |
|---|---|
| 1 | Solicitud aceptada. |
| 2 | Solicitud en progreso |
| 3 | Lista para descarga |
| 4 | Descargando paquetes |
| 5 | Solicitud rechazada |
| 6 | Solicitud vencida |
| 7 | Paquetes listos. |
| Código del estado de la solicitud | Mensaje |
|---|---|
| 5000 | Solicitud creada exitosamente. |
| 8000 | Error al generar la solicitud |
| Código del estado de la solicitud | Mensaje | Observaciones |
|---|---|---|
| 5000 | Solicitud recibida con éxito. | Indica que la solicitud de descarga que se está verificando fue aceptad |
| 5001 | Tercero no Autorizado | 5002 | Se agotó las solicitudes de por vida | Para el caso de descarga de tipo CFDI, se tiene un límite máximo para solicitudes con los mismos parámetros (Fecha Inicial, Fecha Final, RfcEmisor, RfcReceptor). | 5003 | Tope máximo | Indica que en base a los parámetros de consulta se está superando el tope máximo de CFDI o Metadata, por solicitud de descarga masiva. | 5004 | No se encontró la información | Indica que la solicitud de descarga que se está verificando no generó paquetes por falta de información. | 5005 | Solicitud duplicada | 5007 | No existe el paquete solicitado | Indica que la solicitud de descarga que se está verificando no generó paquetes por falta de información. | 5010 | Error de empaquetado | Indica que la solicitud tuvo un problema en su empaquetado, se reencolará para ser consultado más tarde. | 404 | Error no Controlado | Error genérico, en caso de presentarse realizar nuevamente la petición y si persiste el error levantar un RMA. |