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>
.box-url { background-color: #f4f6f7; border-left: 4px solid #3498db; padding: 10px; font-family: monospace; font-size: 14px; margin-bottom: 15px; }
</p>
<pre class="code">      .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; }

</pre><p> </p>

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

<p>
&lt;box-code>[
</p>
<pre class="code">  'xml' => 'contenido_xml_del_cfdi'

</pre><p> </p>

<p>
]
&lt;/box-code>
</p>

</div>

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

<p>
<b>Ejemplo en PHP:</b>
</p>

<p>
&lt;box-code>&lt;?php
</p>

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

<p>
if ($xml) {
</p>
<pre class="code">  // Procesar XML recibido
  file_put_contents('cfdi.xml', $xml);
  echo "XML recibido correctamente";

</pre><p> </p>

<p>
} else {
</p>
<pre class="code">  http_response_code(400);
  echo "XML no recibido";

</pre><p> </p>

<p>
}
</p>

<p>
?>
&lt;/box-code>
</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">

<p>
&lt;box-code>Cliente
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<tr class="row0">
		
	</tr>
	<tr class="row1">
		
	</tr>
	<tr class="row2">
		
	</tr>
	<tr class="row3">
		
	</tr>
	<tr class="row4">
		
	</tr>
	<tr class="row5">
		
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
&lt;/box-code>
</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>
&lt;box-code>[
</p>
<pre class="code">  'xml' => '&lt;cfdi:Comprobante ...> ... &lt;/cfdi:Comprobante>'

</pre><p> </p>

<p>
]
&lt;/box-code>
</p>

</div>

<h2>Tipos de comprobante CFDI soportados</h2>
<div class="level2">

<p>
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:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="col0">Valor </th><th class="col1">Tipo de comprobante </th><th class="col2">Descripción </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="leftalign"><b>I</b>   </td><td class="col1">Ingreso </td><td class="col2">Comprobantes emitidos por la prestación de servicios, venta de productos, arrendamientos u operaciones donde existe un ingreso. </td>
	</tr>
	<tr class="row2">
		<td class="leftalign"><b>E</b>   </td><td class="col1">Egreso </td><td class="col2">Comprobantes utilizados para devoluciones, descuentos, bonificaciones o ajustes relacionados con ingresos previamente registrados. </td>
	</tr>
	<tr class="row3">
		<td class="leftalign"><b>T</b>   </td><td class="col1">Traslado </td><td class="col2">Comprobantes utilizados para acreditar el transporte o traslado de mercancías. </td>
	</tr>
	<tr class="row4">
		<td class="leftalign"><b>N</b>   </td><td class="col1">Nómina </td><td class="col2">Comprobantes fiscales digitales utilizados para registrar pagos de salarios y prestaciones a trabajadores. </td>
	</tr>
	<tr class="row5">
		<td class="leftalign"><b>P</b>   </td><td class="col1">Pago </td><td class="col2">Comprobantes utilizados para registrar la recepción de pagos relacionados con operaciones previamente facturadas. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplos de uso rápidos:</b>
</p>
<ul>
<li class="level1"> <b>Descargar CFDI de nómina:</b>  TipoComprobante=N</li>
<li class="level3"> <b>Descargar facturas emitidas:</b>  TipoComprobante=I</li>
<li class="level3"> <b>Descargar notas de crédito:</b>  TipoComprobante=E</li>
<li class="level3"> <b>Descargar comprobantes de traslado:</b>  TipoComprobante=T</li>
<li class="level3"> <b>Descargar complementos de pago:</b>  TipoComprobante=P</li>
</ul>

<p>
<b>Consideraciones adicionales:</b>
</p>
<ul>
<li class="level1"> El valor enviado debe utilizar la letra correspondiente en mayúscula.</li>
<li class="level3"> La consulta se realizará únicamente para el tipo de comprobante indicado.</li>
<li class="level3"> Para descargar diferentes tipos de CFDI se debe realizar una solicitud independiente por cada valor.</li>
</ul>

</div>
iTimbre Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página
