iTimbre Wiki

¡Esta es una revisión vieja del documento!

---

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:

https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php?

engine=descagaSAT&

RfcEmisor=RFC&

TipoComprobante=N&

callback=webhookUrl&

fechaInicial=2025-10-22&

fechaFinal=2025-10-24

---

4. Parámetros de entrada

---

5. Ejemplo de solicitud

Solicitud:

GET

https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php?

engine=descagaSAT&

RfcEmisor=XAXX010101000&

TipoComprobante=N&

callback=https://midominio.com/webhook&

fechaInicial=2025-10-22&

fechaFinal=2025-10-24

---

6. Funcionamiento del servicio

El flujo de operación es el siguiente:

1. El usuario realiza una petición al Web Service indicando:
   • RFC del emisor.
   • Tipo de comprobante.
   • Periodo de consulta.
   • URL del webhook receptor.
2. El servicio consulta los CFDI disponibles en SAT.
3. Por cada XML encontrado, el servicio realiza una llamada HTTP al webhook registrado.
4. El webhook recibe el XML correspondiente.
5. 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.

Ejemplo:

• Si SAT devuelve 100 XML:
  • El webhook será llamado 100 veces.
  • Cada llamada contendrá un XML diferente.

---

8. Parámetros enviados al webhook

El webhook recibe un parámetro:

Ejemplo de payload recibido:

[

'xml' ⇒ 'contenido_xml_del_cfdi'

]

---

9. Ejemplo de recepción del webhook

Ejemplo en PHP:

<?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”; } ?> —- 10. Recomendaciones para implementar el webhook El endpoint receptor debe: * 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. * Registrar errores de procesamiento. Respuesta recomendada: HTTP 200 OK Ejemplo: OK —- 11. Manejo de múltiples XML El consumidor debe considerar que: * 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 Se recomienda: * Utilizar HTTPS en el callback. * Validar el origen de las solicitudes. * Implementar autenticación adicional si el ambiente lo requiere. * Evitar almacenar XML sin controles de acceso. —- 13. Resumen del flujo Cliente | | Solicitud descarga SAT | v IEngine Web Service | | Consulta CFDI SAT | v XML encontrado | | POST webhook | v Sistema consumidor | | Procesa y almacena XML —- 14. Ejemplo completo Solicitud: https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php? engine=descagaSAT& RfcEmisor=AAA010101AAA& TipoComprobante=N& callback=https://cliente.com/webhook/cfdi& fechaInicial=2025-10-22& fechaFinal=2025-10-24 Resultado: Si existen 25 CFDI: * El webhook será invocado 25 veces. * Cada invocación recibirá: [ 'xml' ⇒ '<cfdi:Comprobante … > … </cfdi:Comprobante>' ] —- . 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 TipoDeComprobante definido por el SAT: ^
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 Descargar CFDI de nómina TipoComprobante=N Consulta únicamente CFDI de nómina. —- Descargar facturas emitidas TipoComprobante=I Consulta comprobantes tipo ingreso. —- Descargar notas de crédito TipoComprobante=E Consulta comprobantes tipo egreso. —- Descargar comprobantes de traslado TipoComprobante=T Consulta CFDI tipo traslado. —- Descargar complementos de pago TipoComprobante=P Consulta CFDI tipo pago. —- Consideraciones * 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 de TipoComprobante. * La cantidad de llamadas al webhook dependerá del número de XML encontrados para el tipo de comprobante solicitado.