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.

<h1>Web Service de Descarga de CFDI del SAT – IEngine</h1>
<div class="level1">

</div>

<h2>1. Introducción</h2>
<div class="level2">

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

</div>

<h2>2. Endpoint del Servicio</h2>
<div class="level2">

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

</div>

<h2>3. Método de consumo</h2>
<div class="level2">

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

<p>
<b>Ejemplo de estructura:</b>
</p>

<p>
<a href="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" class="urlextern" title="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"  rel="nofollow">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</a>
</p>

</div>

<h2>4. Parámetros de entrada</h2>
<div class="level2">

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

<h2>5. Ejemplo de solicitud</h2>
<div class="level2">

<p>
<b>Solicitud (GET):</b>
</p>

<p>
<a href="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" class="urlextern" title="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"  rel="nofollow">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</a>
</p>

</div>

<h2>6. Funcionamiento del servicio</h2>
<div class="level2">

<p>
El flujo de operación es el siguiente:
</p>
<ul>
<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>
</ul>

</div>

<h2>7. Webhook receptor</h2>
<div class="level2">

<p>
<b>Descripción:</b>  El webhook es un endpoint proporcionado por el usuario consumidor del servicio. Este endpoint será invocado <b>N veces</b>, donde N corresponds al número de XML descargados.
</p>

<p>
<b>Nota:</b>  Si SAT devuelve 100 XML, el webhook será llamado 100 veces de forma individual y cada llamada contendrá un XML diferente.
</p>

</div>

<h2>8. Parámetros enviados al webhook</h2>
<div class="level2">

<p>
El webhook recibe un parámetro vía POST:
</p>

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



</pre><p> </p>




</div>

<h2>9. Ejemplo de recepción del webhook</h2>
<div class="level2">

<p>
<b>Ejemplo en PHP:</b>
</p>
<pre class="code">&lt;?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";
}

?&gt;



</pre><p> </p>




</div>

<h2>10. Recomendaciones para implementar el webhook</h2>
<div class="level2">
<ul>
<li class="level1"> Aceptar solicitudes HTTP POST.</li>
<li class="level1"> Validar que el parámetro xml exista.</li>
<li class="level1"> Guardar o procesar el XML recibido.</li>
<li class="level1"> Responder rápidamente para evitar tiempos de espera (timeouts).</li>
<li class="level1"> Registrar errores de procesamiento.</li>
</ul>

<p>
<b>Respuesta recomendada:</b>  HTTP 200 OK (Cuerpo: OK)
</p>

</div>

<h2>11. Manejo de múltiples XML</h2>
<div class="level2">
<ul>
<li class="level1"> El webhook puede recibir múltiples llamadas consecutivas.</li>
<li class="level1"> Cada llamada representa un CFDI independiente.</li>
<li class="level1"> No debe asumir que todos los XML llegarán en una sola petición.</li>
<li class="level1"> Debe implementar almacenamiento temporal o procesamiento en cola si espera grandes volúmenes.</li>
</ul>

</div>

<h2>12. Consideraciones de seguridad</h2>
<div class="level2">
<ul>
<li class="level1"> Utilizar HTTPS en el callback.</li>
<li class="level1"> Validar el origen de las solicitudes.</li>
<li class="level1"> Implementar autenticación adicional en la URL si el ambiente lo requiere.</li>
<li class="level1"> Evitar almacenar XML sin controles de acceso.</li>
</ul>

</div>

<h2>13. Resumen del flujo</h2>
<div class="level2">
<pre class="code">Cliente
  |
  | Solicitud descarga SAT (GET)
  v
IEngine Web Service
  |
  | Consulta CFDI SAT
  v
XML encontrado
  |
  | POST webhook (N veces)
  v
Sistema consumidor (Procesa y almacena)



</pre><p> </p>




</div>

<h2>14. Ejemplo completo</h2>
<div class="level2">

<p>
<b>Solicitud:</b>
</p>

<p>
<a href="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" class="urlextern" title="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"  rel="nofollow">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</a>
</p>

<p>
<b>Resultado si existen 25 CFDI:</b>
</p>
<ul>
<li class="level1"> El webhook será invocado 25 veces de forma independiente.</li>
<li class="level3"> Cada invocación recibirá:</li>
</ul>

<p>
<br/>

</p>

</div>
iTimbre Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página
