iTimbre Wiki

Esta página es de solo lectura. Puedes ver la fuente pero no puedes cambiarla. Pregunta a tu administrador si crees que esto es incorrecto.

<p>
<b>Web Service de Descarga de CFDI del SAT – IEngine</b>
</p>

<p>
<b>1. Introducción</b>
</p>

<p>
El presente documento describe el uso del Web Service <b>IEngine – Descarga SAT</b>, utilizado para solicitar la descarga de comprobantes fiscales digitales (CFDI) desde el SAT mediante los parámetros proporcionados.
</p>

<p>
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.
</p>
<hr />

<p>
<b>2. Endpoint del Servicio</b>
</p>

<p>
<b>URL del Web Service</b>
</p>

<p>
<a href="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php" class="urlextern" title="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php"  rel="nofollow">https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php</a>
</p>
<hr />

<p>
<b>3. Método de consumo</b>
</p>

<p>
El servicio recibe parámetros mediante una solicitud HTTP GET.
</p>

<p>
Ejemplo:
</p>

<p>
<a href="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php" class="urlextern" title="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php"  rel="nofollow">https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php</a>?
</p>

<p>
engine=descagaSAT&
</p>

<p>
RfcEmisor=RFC&
</p>

<p>
TipoComprobante=N&
</p>

<p>
callback=webhookUrl&
</p>

<p>
fechaInicial=2025-10-22&
</p>

<p>
fechaFinal=2025-10-24
</p>
<hr />

<p>
<b>4. Parámetros de entrada</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="leftalign"> <br/>
<b>Parámetro</b> <br/>
   </th><th class="leftalign"> <br/>
<b>Tipo</b> <br/>
   </th><th class="leftalign"> <br/>
<b>Requerido</b> <br/>
   </th><th class="leftalign"> <br/>
<b>Descripción</b> <br/>
   </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="col0"> <br/>
engine <br/>
 </td><td class="col1"> <br/>
String <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
Nombre del motor a ejecutar. Para descarga SAT debe enviarse descagaSAT. <br/>
 </td>
	</tr>
	<tr class="row2">
		<td class="col0"> <br/>
RfcEmisor <br/>
 </td><td class="col1"> <br/>
String <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
RFC del emisor del cual se desean descargar comprobantes. <br/>
 </td>
	</tr>
	<tr class="row3">
		<td class="col0"> <br/>
TipoComprobante <br/>
 </td><td class="col1"> <br/>
String <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
Tipo de comprobante a consultar. Ejemplo: N para nómina. <br/>
 </td>
	</tr>
	<tr class="row4">
		<td class="col0"> <br/>
callback <br/>
 </td><td class="col1"> <br/>
URL/String <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
Endpoint donde serán enviados los XML descargados. <br/>
 </td>
	</tr>
	<tr class="row5">
		<td class="col0"> <br/>
fechaInicial <br/>
 </td><td class="col1"> <br/>
Date <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
Fecha inicial del rango de búsqueda. Formato: YYYY-MM-DD <br/>
 </td>
	</tr>
	<tr class="row6">
		<td class="col0"> <br/>
fechaFinal <br/>
 </td><td class="col1"> <br/>
Date <br/>
 </td><td class="col2"> <br/>
Sí <br/>
 </td><td class="col3"> <br/>
Fecha final del rango de búsqueda. Formato: YYYY-MM-DD <br/>
 </td>
	</tr>
</table>
<span class='np_break'> </span>
</div><hr />

<p>
<b>5. Ejemplo de solicitud</b>
</p>

<p>
Solicitud:
</p>

<p>
GET
</p>

<p>
<a href="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php" class="urlextern" title="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php"  rel="nofollow">https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php</a>?
</p>

<p>
engine=descagaSAT&
</p>

<p>
RfcEmisor=XAXX010101000&
</p>

<p>
TipoComprobante=N&
</p>

<p>
callback=<a href="https://midominio.com/webhook&" class="urlextern" title="https://midominio.com/webhook&"  rel="nofollow">https://midominio.com/webhook&</a>
</p>

<p>
fechaInicial=2025-10-22&
</p>

<p>
fechaFinal=2025-10-24
</p>
<hr />

<p>
<b>6. Funcionamiento del servicio</b>
</p>

<p>
El flujo de operación es el siguiente:
</p>
<ol>
<li class="level1"> El usuario realiza una petición al Web Service indicando:<ul>
<li class="level3"> RFC del emisor.</li>
<li class="level3"> Tipo de comprobante.</li>
<li class="level3"> Periodo de consulta.</li>
<li class="level3"> URL del webhook receptor.</li>
</ul>
</li>
<li class="level1"> El servicio consulta los CFDI disponibles en SAT.</li>
<li class="level1"> Por cada XML encontrado, el servicio realiza una llamada HTTP al webhook registrado.</li>
<li class="level1"> El webhook recibe el XML correspondiente.</li>
<li class="level1"> El proceso se repite hasta enviar todos los XML encontrados.</li>
</ol>
<hr />

<p>
<b>7. Webhook receptor</b>
</p>

<p>
<b>Descripción</b>
</p>

<p>
El webhook es un endpoint proporcionado por el usuario consumidor del servicio.
</p>

<p>
Este endpoint será invocado <b>N veces</b>, donde <b>N corresponde al número de XML descargados</b>.
</p>

<p>
Ejemplo:
</p>
<ul>
<li class="level1"> Si SAT devuelve 100 XML:<ul>
<li class="level3"> El webhook será llamado 100 veces.</li>
<li class="level3"> Cada llamada contendrá un XML diferente.</li>
</ul>
</li>
</ul>
<hr />

<p>
<b>8. Parámetros enviados al webhook</b>
</p>

<p>
El webhook recibe un parámetro:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="leftalign"> <br/>
<b>Parámetro</b> <br/>
   </th><th class="leftalign"> <br/>
<b>Tipo</b> <br/>
   </th><th class="leftalign"> <br/>
<b>Descripción</b> <br/>
   </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="col0"> <br/>
xml <br/>
 </td><td class="col1"> <br/>
String/XML <br/>
 </td><td class="col2"> <br/>
Contenido completo del CFDI descargado. <br/>
 </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
Ejemplo de payload recibido:
</p>

<p>
[
</p>

<p>
'xml' ⇒ 'contenido_xml_del_cfdi'
</p>

<p>
]
</p>
<hr />

<p>
<b>9. Ejemplo de recepción del webhook</b>
</p>

<p>
Ejemplo en PHP:
</p>

<p>
&lt;?php
</p>

<p>
$xml = $_POST['xml'] ?? null;
</p>

<p>
if ($xml) {
</p>

<p>
<em> Procesar XML recibido

file_put_contents(

'cfdi.xml',

$xml

);

echo "XML recibido correctamente";

} else {

http_response_code(400);

echo "XML no recibido";

}

?>

—-

<b>10. Recomendaciones para implementar el webhook</b>

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

—-

<b>11. Manejo de múltiples XML</b>

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.

—-

<b>12. Consideraciones de seguridad</b>

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.

—-

<b>13. Resumen del flujo</b>

Cliente

|

| Solicitud descarga SAT

|

v

IEngine Web Service

|

| Consulta CFDI SAT

|

v

XML encontrado

|

| POST webhook

|

v

Sistema consumidor

|

| Procesa y almacena XML

—-

<b>14. Ejemplo completo</b>

Solicitud:

<a href="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php" class="urlextern" title="https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php"  rel="nofollow">https://pruebas-ifactura.itimbre.com/plugins/IEngine/IEngine.php</a>?

engine=descagaSAT&

RfcEmisor=AAA010101AAA&

TipoComprobante=N&

callback=<a href="https://cliente.com/webhook/cfdi&" class="urlextern" title="https://cliente.com/webhook/cfdi&"  rel="nofollow">https://cliente.com/webhook/cfdi&</a>

fechaInicial=2025-10-22&

fechaFinal=2025-10-24

Resultado:

Si existen 25 CFDI:

  * El webhook será invocado 25 veces.
  * Cada invocación recibirá:

[

'xml' ⇒ '&lt;cfdi:Comprobante … > … &lt;/cfdi:Comprobante>'

]

—-

.

<b>Tipos de comprobante CFDI soportados</b>

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:

^ <br/>
<b>Valor</b> <br/>
   ^ <br/>
<b>Tipo de comprobante</b> <br/>
   ^ <br/>
<b>Descripción</b> <br/>
   |
| <br/>
I <br/>
 | <br/>
Ingreso <br/>
 | <br/>
Comprobantes emitidos por la prestación de servicios, venta de productos, arrendamientos u operaciones donde existe un ingreso. <br/>
 |
| <br/>
E <br/>
 | <br/>
Egreso <br/>
 | <br/>
Comprobantes utilizados para devoluciones, descuentos, bonificaciones o ajustes relacionados con ingresos previamente registrados. <br/>
 |
| <br/>
T <br/>
 | <br/>
Traslado <br/>
 | <br/>
Comprobantes utilizados para acreditar el transporte o traslado de mercancías. <br/>
 |
| <br/>
N <br/>
 | <br/>
Nómina <br/>
 | <br/>
Comprobantes fiscales digitales utilizados para registrar pagos de salarios y prestaciones a trabajadores. <br/>
 |
| <br/>
P <br/>
 | <br/>
Pago <br/>
 | <br/>
Comprobantes utilizados para registrar la recepción de pagos relacionados con operaciones previamente facturadas. <br/>
 |

<b>Ejemplos de uso</b>

<b>Descargar CFDI de nómina</b>

TipoComprobante=N

Consulta únicamente CFDI de nómina.

—-

<b>Descargar facturas emitidas</b>

TipoComprobante=I

Consulta comprobantes tipo ingreso.

—-

<b>Descargar notas de crédito</b>

TipoComprobante=E

Consulta comprobantes tipo egreso.

—-

<b>Descargar comprobantes de traslado</b>

TipoComprobante=T

Consulta CFDI tipo traslado.

—-

<b>Descargar complementos de pago</b>

TipoComprobante=P

Consulta CFDI tipo pago.

—-

<b>Consideraciones</b>

  * 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.

<br/>

</p>
iTimbre Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página
