Herramientas de usuario
¡Esta es una revisión vieja del documento!
Tabla de Contenidos
.box-url { background-color: #f4f6f7; border-left: 4px solid #3498db; padding: 10px; font-family: monospace; font-size: 14px; margin-bottom: 15px; }
.box-code { background-color: #2c3e50; color: #ffffff; padding: 12px; border-radius: 4px; font-family: monospace; font-size: 14px; overflow-x: auto; margin-bottom: 15px; }
table { width: 100%; border-collapse: collapse; margin-bottom: 20px; }
th, td { border: 1px solid #dddddd; padding: 8px; text-align: left; }
th { background-color: #f2f2f2; }
.alert-box { background-color: #e8f4f8; border-left: 4px solid #2980b9; padding: 10px; margin-bottom: 15px; }
Web Service de Descarga de CFDI del SAT – IEngine
1. Introducción
El presente documento describe el uso del Web Service IEngine – Descarga SAT, utilizado para solicitar la descarga de comprobantes fiscales digitales (CFDI) desde el SAT mediante los parámetros proporcionados.
El servicio permite consultar y descargar los XML asociados a un RFC emisor dentro de un rango de fechas determinado. Una vez obtenidos los comprobantes, el sistema envía cada XML descargado hacia un endpoint webhook configurado por el usuario.
2. Endpoint del Servicio
URL del Web Service:
https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php
3. Método de consumo
El servicio recibe parámetros mediante una solicitud HTTP GET.
Ejemplo de estructura:
4. Parámetros de entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| engine | String | Sí | Nombre del motor a ejecutar. Para descarga SAT debe enviarse descagaSAT. |
| RfcEmisor | String | Sí | RFC del emisor del cual se desean descargar comprobantes. |
| TipoComprobante | String | Sí | Tipo de comprobante a consultar. Ejemplo: N para nómina. Ver catálogo al final. |
| callback | URL/String | Sí | Endpoint donde serán enviados los XML descargados. |
| fechaInicial | Date | Sí | Fecha inicial del rango de búsqueda. Formato: YYYY-MM-DD |
| fechaFinal | Date | Sí | Fecha final del rango de búsqueda. Formato: YYYY-MM-DD |
5. Ejemplo de solicitud
6. Funcionamiento del servicio
El flujo de operación es el siguiente:
- El usuario realiza una petición al Web Service indicando:
- RFC del emisor.
- Tipo de comprobante.
- Periodo de consulta.
- URL del webhook receptor.
- El servicio consulta los CFDI disponibles en SAT.
- Por cada XML encontrado, el servicio realiza una llamada HTTP al webhook registrado.
- El webhook recibe el XML correspondiente.
- El proceso se repite hasta enviar todos los XML encontrados.
7. Webhook receptor
Descripción: El webhook es un endpoint proporcionado por el usuario consumidor del servicio. Este endpoint será invocado N veces, donde N corresponde al número de XML descargados.
Nota: Si SAT devuelve 100 XML, el webhook será llamado 100 veces de forma individual y cada llamada contendrá un XML diferente.
8. Parámetros enviados al webhook
El webhook recibe un parámetro vía POST:
| Parámetro | Tipo | Descripción |
|---|---|---|
| xml | String/XML | Contenido completo del CFDI descargado. |
Ejemplo de payload recibido:
<box-code>[
'xml' => 'contenido_xml_del_cfdi'
] </box-code>
9. Ejemplo de recepción del webhook
Ejemplo en PHP:
<box-code><?php
$xml = $_POST['xml'] ?? null;
if ($xml) {
// Procesar XML recibido
file_put_contents('cfdi.xml', $xml);
echo "XML recibido correctamente";
} else {
http_response_code(400); echo "XML no recibido";
}
?> </box-code>
10. Recomendaciones para implementar el webhook
- Aceptar solicitudes HTTP POST.
- Validar que el parámetro xml exista.
- Guardar o procesar el XML recibido.
- Responder rápidamente para evitar tiempos de espera (timeouts).
- Registrar errores de procesamiento.
Respuesta recomendada: HTTP 200 OK (Cuerpo: OK)
11. Manejo de múltiples XML
- El webhook puede recibir múltiples llamadas consecutivas.
- Cada llamada representa un CFDI independiente.
- No debe asumir que todos los XML llegarán en una sola petición.
- Debe implementar almacenamiento temporal o procesamiento en cola si espera grandes volúmenes.
12. Consideraciones de seguridad
- Utilizar HTTPS en el callback.
- Validar el origen de las solicitudes.
- Implementar autenticación adicional en la URL si el ambiente lo requiere.
- Evitar almacenar XML sin controles de acceso.
13. Resumen del flujo
<box-code>Cliente
</box-code>
14. Ejemplo completo
Solicitud:
Resultado si existen 25 CFDI:
- El webhook será invocado 25 veces de forma independiente.
- Cada invocación recibirá:
<box-code>[
'xml' => '<cfdi:Comprobante ...> ... </cfdi:Comprobante>'
] </box-code>
Tipos de comprobante CFDI soportados
El parámetro TipoComprobante permite indicar el tipo de CFDI que se desea consultar durante la descarga desde SAT. Los valores posibles corresponden al atributo oficial definido por la autoridad:
| Valor | Tipo de comprobante | Descripción |
|---|---|---|
| I | Ingreso | Comprobantes emitidos por la prestación de servicios, venta de productos, arrendamientos u operaciones donde existe un ingreso. |
| E | Egreso | Comprobantes utilizados para devoluciones, descuentos, bonificaciones o ajustes relacionados con ingresos previamente registrados. |
| T | Traslado | Comprobantes utilizados para acreditar el transporte o traslado de mercancías. |
| N | Nómina | Comprobantes fiscales digitales utilizados para registrar pagos de salarios y prestaciones a trabajadores. |
| P | Pago | Comprobantes utilizados para registrar la recepción de pagos relacionados con operaciones previamente facturadas. |
Ejemplos de uso rápidos:
- Descargar CFDI de nómina: TipoComprobante=N
- Descargar facturas emitidas: TipoComprobante=I
- Descargar notas de crédito: TipoComprobante=E
- Descargar comprobantes de traslado: TipoComprobante=T
- Descargar complementos de pago: TipoComprobante=P
Consideraciones adicionales:
- El valor enviado debe utilizar la letra correspondiente en mayúscula.
- La consulta se realizará únicamente para el tipo de comprobante indicado.
- Para descargar diferentes tipos de CFDI se debe realizar una solicitud independiente por cada valor.
Herramientas de la página
