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 Timbrado</h1>
<div class="level1">

</div>

<h1>Introducción</h1>
<div class="level1">

<p>
Como proveedor autorizado de certificación con el número 68934, <b>iTimbre</b> realiza la validación y certificación (<b>timbrado</b>) de Comprobantes Fiscales Digitales generados por Internet (<em><b>CFDI</b></em>) conforme a las especificaciones requeridas por el SAT a través de su Web Service (Software como Servicio) de una manera rápida y segura.
</p>

<p>
Además de la certificación de sus comprobantes, iTimbre le ofrece el servicio de cancelación y búsqueda de sus comprobantes fiscales.
</p>

</div>

<h1>Servicio</h1>
<div class="level1">

<p>
La característica principal de la arquitectura del Web Service de iTimbre es que utiliza JSON+REST en lugar del tradicional XML+SOAP. Por lo tanto es importante tener conocimientos del formato JSON para poder crear los mensajes que serán enviados al Web Service. Afortunadamente JSON es mucho más fácil de entender e implementar.
</p>

</div>

<h1>Registro</h1>
<div class="level1">

<p>
Antes de comenzar a realizar pruebas con el Web Service de iTimbre es necesario registrarse a través de las siguientes ligas:
</p>

<p>
<b>Pruebas:</b> <a href="https://pruebas.itimbre.com/registro/index.php?servicio=timbrado" class="urlextern" title="https://pruebas.itimbre.com/registro/index.php?servicio=timbrado"  rel="nofollow">https://pruebas.itimbre.com/registro/index.php?servicio=timbrado</a>
</p>

<p>
<b>Producción:</b> <a href="https://portal.itimbre.com/registro/index.php?servicio=timbrado" class="urlextern" title="https://portal.itimbre.com/registro/index.php?servicio=timbrado"  rel="nofollow">https://portal.itimbre.com/registro/index.php?servicio=timbrado</a>
</p>

<p>
Es necesario que en el campo de “Servicio deseado” se mantenga seleccionada la opción de “Solo timbrado”, para que se habiliten en el Web Service las conexiones externas. También es importante distinguir entre la versión de pruebas y la de producción, ya que <b>son sistemas totalmente independientes aunque sean idénticos</b>. La única diferencia es la validez de los comprobantes certificados. La versión de pruebas utiliza un CSD de pruebas para validar los comprobantes, pero al igual que la versión de producción, también verifica el RFC y el certificado del CFDI en la lista de contribuyentes del SAT. Por esta razón no es posible utilizar certificados de pruebas para enviar comprobantes a la versión de pruebas del Web Service, ya que generarán el código de error correspondiente.
</p>

<p>
Al realizar el registro recibirá un correo electrónico de confirmación con la liga hacia el Portal de iTimbre y una contraseña temporal. En caso de no recibir el correo electrónico busque en su carpeta de “Spam” o “Correo no deseado”.
</p>

<p>
Cuando ingrese al sistema por primera vez, éste le pedirá que cambie su contraseña temporal por una personalizada que cumpla con los requisitos de seguridad establecidos. La contraseña debe contener al menos 8 caracteres e incluir al menos una mayúscula, una minúscula, un número y un carácter especial (@#$).
</p>

<p>
Posteriormente, el sistema lo llevará a la página de inicio, donde podrá ver sus datos personales, editarlos, cambiar su contraseña, y descargar las políticas de uso, el acuerdo de confidencialidad y el presente manual de integración.
</p>

<p>
En el sub-módulo de “Emisores” aparece la lista de los emisores registrados. El sistema actualmente no cuenta con un límite de emisores, así que puede registrar todos los que desee siempre y cuando no hayan sido registrados en la aplicación gratuita. Para dar de alta un nuevo emisor dar clic en “Agregar Emisor”.
</p>

<p>
Agregue los datos de la empresa y al terminar haga clic en “Aceptar”. Si los datos fueron llenados correctamente se registrará el emisor en el sistema y se generará una contraseña aleatoria, la cual necesitará al momento de hacer el llamado al Web Service de iTimbre. La contraseña aparecerá en el campo correspondiente.
</p>

<p>
En caso de necesitar ayuda vaya al módulo de “Soporte” y llene el formulario. En breve nos comunicaremos con usted.
</p>

</div>

<h1>Conexión al Web Service</h1>
<div class="level1">

<p>
Para realizar la conexión con el Web Service de iTimbre es necesario proveer los siguientes datos en el llamado:
</p>
<ul>
<li class="level1"> Usuario. El usuario es el correo electrónico utilizado al momento de crear la cuenta en el Portal de iTimbre. El mismo con el que se ingresa al sistema.</li>
<li class="level1"> RFC del emisor.</li>
<li class="level1"> Contraseña del emisor. La contraseña generada al registrar al emisor en el sistema, como se mostró anteriormente. Nota: no confundir con la contraseña utilizada para acceder al Portal de iTimbre.</li>
<li class="level1"> Método. El método es la función a realizar. Actualmente se cuenta con los siguientes métodos:<ul>
<li class="level3"> cfd2cfdi → método que se utiliza para validar y timbrar un CFDI.</li>
<li class="level3"> cancelarCFDI →método utilizado para cancelar un CFDI.</li>
<li class="level3"> buscarCFDI → método utilizado para buscar un CFDI.</li>
<li class="level3"> Parámetros. Los parámetros son datos adicionales que deben enviarse y dependen del método utilizado, los cuales se describen más adelante.</li>
</ul>
</li>
</ul>

<p>
Al realizar el llamado, las variables se deben serializar en formato JSON y almacenarse en una variable llamada “q”, la cual se debe enviar por HTTP. Las ligas del Web Service se enlistan a continuación.
</p>

<p>
<b>Direcciones del servicio</b>:
</p>

<p>
Pruebas: <a href="https://portalws.itimbre.com/itimbreprueba.php" class="urlextern" title="https://portalws.itimbre.com/itimbreprueba.php"  rel="nofollow">https://portalws.itimbre.com/itimbreprueba.php</a>
</p>

<p>
Producción: <a href="https://portalws.itimbre.com/itimbre.php" class="urlextern" title="https://portalws.itimbre.com/itimbre.php"  rel="nofollow">https://portalws.itimbre.com/itimbre.php</a>
</p>

<p>
Nota: <b>es muy importante utilizar la liga correcta. Si el registro se realizó en la versión de pruebas se debe utilizar únicamente la liga de pruebas y lo mismo aplica para la versión de producción.</b>
</p>

</div>

<h1>Timbrado de CFDI 3.3</h1>
<div class="level1">

<p>
Las siguientes validaciones se realizan al XML:
</p>
<ul>
<li class="level1"> La estructura del XML cumple con las especificaciones del SAT.</li>
<li class="level1"> El Certificado de Sello Digital (CSD) del emisor haya sido emitido por el SAT.</li>
<li class="level1"> El CSD esté vigente en la fecha de generación del Comprobante.</li>
<li class="level1"> El Comprobante no haya sido validado previamente.</li>
<li class="level1"> Que el RFC y número de certificado se encuentren en las lista de contribuyentes del SAT.</li>
<li class="level1"> El periodo de tiempo entre la fecha de expedición del documento y la fecha en la que se pretende certificar no exceda de 72 horas.</li>
<li class="level1"> El CSD con el que se sello el documento corresponda al contribuyente que aparece como emisor del CFDI y que el sello digital corresponda al documento enviado.</li>
<li class="level1"> Que el documento cumpla con la especificación Técnica del Anexo 20 en sus apartados II y III.</li>
</ul>

<p>
En caso que el XML cumpla con las validaciones mencionadas, el Web Service lo devolverá al contribuyente con la información contenida y el Timbre Fiscal Digital, este incluye:
</p>
<ul>
<li class="level1"> El número de folio fiscal asignado.</li>
<li class="level1"> Fecha y hora de Validación.</li>
<li class="level1"> El número de serie del certificado del SAT con el que se realizó la validación.</li>
<li class="level1"> El sello digital del Timbre Fiscal Digital.</li>
</ul>

</div>

<h2>Llamado</h2>
<div class="level2">

</div>

<h2></h2>
<div class="level2">

<p>
Para realizar la validación y certificación de un CFDI se deben utilizar los métodos “<b>cfd2cfdi</b>”. Los parámetros a ser enviados por el Web Service para realizar la función de validación de los comprobantes fiscales están estructurados de la siguiente manera:
</p>

</div>

<h3>Parámetros de la llamada</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="leftalign">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. <b>Por defecto se asignará 0</b>.  </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="col1">Este parámetro consiste en el tipo de petición solicitado para generar el CFDI. Los valores posibles se encuentran en el catálogo de métodos. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="leftalign">Debe contener un arreglo con los parámetros: <b>user</b>, <b>pass</b>, <b>RFC</b>, y <b>xmldata</b>.  </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="leftalign">Contraseña generada por iTimbre asignada al emisor de manera automática. Se puede utilizar la <b>contraseña máster</b> del administrador de los emisores para cualquier RFC.  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  xmldata  </td><td class="col1">Contenido del XML con la información del comprobante. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Ejemplos</h3>
<div class="level3">

<p>
<b>Ejemplo de codificación del llamado en formato JSON para certificación de CFDI v3.2</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=0" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-nomina.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"101",
    "method":"cfd2cfdi",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "xmldata":"< cfdi>< /cfdi>"
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h2>Respuesta</h2>
<div class="level2">

<p>
En caso de validación del XML o que surja algún error en el proceso, el Web Service de iTimbre le enviará una respuesta.
</p>

</div>

<h3>Parámetros de la Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  UUID  </td><td class="col1">Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  data  </td><td class="col1">XML timbrado. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  acuse  </td><td class="col1">Acuse que proporciona el SAT como comprobante de que el CFDI fue recibido satisfactoriamente. Nota: este parámetro pudiera no ser regresado si el servicio de recepción del SAT no se encuentre disponible en el momento de la llamada. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, una descripción del error regresado al intentar validar el XML. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  Otros  </td><td class="leftalign">Otros parámetros en caso de que se ocupen como referencia, por ejemplo el usuario que hizo el llamado, o algún <b>timestamp</b>.  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Ejemplos</h3>
<div class="level3">

<p>
<b>Ejemplo de respuesta válida arrojada por el Web Service</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=1" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"101",
    "result": {
        "retcode":1,
        "UUID":"63C2042F-FAF0-48A0-A9AF-0304813D2528",
        "data":"< cfdi>< /cfdi>",
        "acuse":"< xml>< /xml>"
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplos de errores</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=2" title="Descargar trozo de código fuente" class="mediafile mf_json">error1.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,
    "result":
    {
        "retcode":-1,
        "error":"Variable q faltante."
    }
}



</pre><p> </p>
</dd></dl>



<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=3" title="Descargar trozo de código fuente" class="mediafile mf_json">error2.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,
    "result":    {
        "retcode":-1,
        "error":"Los datos recibidos no cumplen con el formato JSON correcto."
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h1>Conexión al Web Service Retenciones y Pagos</h1>
<div class="level1">

<p>
Para realizar la conexión con el Web Service de iTimbre es necesario proveer los siguientes datos en el llamado:
</p>
<ul>
<li class="level1"> <b>Usuario</b>. El usuario es el correo electrónico utilizado al momento de crear la cuenta en el Portal de iTimbre. El mismo con el que se ingresa al sistema.</li>
<li class="level1"> <b>RFC</b>  del emisor.</li>
<li class="level1"> <b>Contraseña del emisor</b>. La contraseña generada al registrar al emisor en el sistema, como se mostró anteriormente. Nota: no confundir con la contraseña utilizada para acceder al Portal de iTimbre.</li>
<li class="level1"> <b>Método</b>. El método es la función a realizar. Actualmente se cuenta con los siguientes métodos:<ul>
<li class="level3"> <b>enviarRetencion</b>  → método que se utiliza para validar y timbrar un CFDI.</li>
<li class="level3"> <b>cancelarRetencion</b>  →método utilizado para cancelar un CFDI.</li>
<li class="level3"> <b>verificarEstatusRetencion</b>→ Para recibir un acuse utilizando el parametro folio_seguimiento.</li>
</ul>
</li>
<li class="level1"> <b>Parámetros</b>. Los parámetros son datos adicionales que deben enviarse y dependen del método utilizado, los cuales se describen más adelante.</li>
</ul>

<p>
Al realizar el llamado, las variables se deben serializar en formato JSON y almacenarse en una variable llamada “q”, la cual se debe enviar por HTTP.
</p>

<p>
Las ligas del Web Service se enlistan a continuación.
</p>

<p>
<b>Direcciones del servicio:</b>
</p>

<p>
Pruebas:<a href="http://portalws1.itimbre.com/itimbreprueba.php?q=" class="urlextern" title="http://portalws1.itimbre.com/itimbreprueba.php?q="  rel="nofollow">http://portalws1.itimbre.com/itimbreprueba.php?q=</a>
</p>

</div>

<h1>Timbrado de Retenciones y Pagos</h1>
<div class="level1">

<p>
Las siguientes validaciones se realizan al XML:
</p>
<ul>
<li class="level1"> La estructura del XML cumple con las especificaciones del SAT.</li>
<li class="level1"> El Certificado de Sello Digital (CSD) del emisor haya sido emitido por el SAT.</li>
<li class="level1"> El CSD esté vigente en la fecha de generación del Comprobante.</li>
<li class="level1"> El Comprobante no haya sido validado previamente.</li>
<li class="level1"> Que el RFC y número de certificado se encuentren en las lista de contribuyentes del SAT.</li>
<li class="level1"> El periodo de tiempo entre la fecha de expedición del documento y la fecha en la que se pretende certificar no exceda de 72 horas.</li>
<li class="level1"> El CSD con el que se sello el documento corresponda al contribuyente que aparece como emisor del CFDI y que el sello digital corresponda al documento enviado.</li>
</ul>

<p>
En caso que el XML cumpla con las validaciones mencionadas, el Web Service lo devolverá al contribuyente con la información contenida y el Timbre Fiscal Digital, este incluye:
</p>
<ul>
<li class="level1"> El número de folio fiscal asignado.</li>
<li class="level1"> Fecha y hora de Validación.</li>
<li class="level1"> El número de serie del certificado del SAT con el que se realizó la validación.</li>
<li class="level1"> El sello digital del Timbre Fiscal Digital.</li>
</ul>

</div>

<h2>Llamado</h2>
<div class="level2">

</div>

<h2></h2>
<div class="level2">

<p>
Para realizar la validación y certificación de un CFDI se deben utilizar los métodos “<b>enviarRetencion</b>”. Los parámetros a ser enviados por el Web Service para realizar la función de validación de los comprobantes fiscales están estructurados de la siguiente manera:
</p>

</div>

<h3>Parámetros de la llamada</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="leftalign">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. <b>Por defecto se asignará 0</b>.  </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="col1">Este parámetro consiste en el tipo de petición solicitado para generar el CFDI. Los valores posibles se encuentran en el catálogo de métodos. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="leftalign">Debe contener un arreglo con los parámetros: <b>user</b>, <b>pass</b>, <b>RFC</b>, y <b>xmldata</b>.  </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="leftalign">Contraseña generada por iTimbre asignada al emisor de manera automática. Se puede utilizar la <b>contraseña máster</b> del administrador de los emisores para cualquier RFC.  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  xmldata  </td><td class="col1">Contenido del XML con la información del comprobante. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Ejemplos</h3>
<div class="level3">

<p>
<b>Ejemplo de codificación del llamado en formato JSON para certificación de retenciones:</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=4" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-retenciones.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"101",
    "method":"enviarRetencion",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "xmldata":"< cfdi>< /cfdi>"
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h2>Respuesta</h2>
<div class="level2">

<p>
En caso de validación del XML o que surja algún error en el proceso, el Web Service de iTimbre le enviará una respuesta.
</p>

</div>

<h3>Parámetros de la Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  UUID  </td><td class="col1">Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  data  </td><td class="col1">XML timbrado. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  acuse  </td><td class="col1">Acuse que proporciona el SAT como comprobante de que el CFDI fue recibido satisfactoriamente. Nota: este parámetro pudiera no ser regresado si el servicio de recepción del SAT no se encuentre disponible en el momento de la llamada. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, una descripción del error regresado al intentar validar el XML. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  Otros  </td><td class="leftalign">Otros parámetros en caso de que se ocupen como referencia, por ejemplo el usuario que hizo el llamado, o algún <b>timestamp</b>.  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Ejemplos</h3>
<div class="level3">

<p>
<b>Ejemplo de respuesta válida arrojada por el Web Service</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=5" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"101",
    "result": {
        "retcode":1,
        "UUID":"63C2042F-FAF0-48A0-A9AF-0304813D2528",
        "data":"< cfdi>< /cfdi>",
        "acuse":"< xml>< /xml>"
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplos de errores</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=6" title="Descargar trozo de código fuente" class="mediafile mf_json">error1.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,
    "result":
    {
        "retcode":-1,
        "error":"Variable q faltante."
    }
}



</pre><p> </p>
</dd></dl>



<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=7" title="Descargar trozo de código fuente" class="mediafile mf_json">error2.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,
    "result":    {
        "retcode":-1,
        "error":"Los datos recibidos no cumplen con el formato JSON correcto."
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h3>Códigos de Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  Código  </th><th class="centeralign">  Validación  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  1002  </td><td class="col1">El PAC envía versión del estándar no existente. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  1004  </td><td class="col1">La estructura del comprobante recibido no es válida. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  1006  </td><td class="col1">El Timbre proporcionado ya existe. UUID: &lt;UUID>. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  1009  </td><td class="col1">El documento de retenciones no cuenta con los datos mínimos. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  1010  </td><td class="col1">Sello de certificación inválido. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  1011  </td><td class="col1">Sello del documento de retenciones inválido. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  1012  </td><td class="col1">TFD no válido. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  1013  </td><td class="col1">Versión del estándar no vigente. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  1014  </td><td class="col1">Comprobante con envío extemporáneo por vigencia de versión. </td>
	</tr>
	<tr class="row10">
		<td class="centeralign">  1015  </td><td class="col1">Uso del complemento no vigente. </td>
	</tr>
	<tr class="row11">
		<td class="centeralign">  1016  </td><td class="col1">Uso de complemento no permitido. </td>
	</tr>
	<tr class="row12">
		<td class="centeralign">  1017  </td><td class="col1">Uso del certificado de FIEL no válido. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h2>Nuevo esquema de Cancelación de CFDI 3.3</h2>
<div class="level2">

<p>
Para cancelar algún CFDI no se necesita que éste haya sido certificado por iTimbre. No obstante, se requiere que el mensaje enviado al SAT incluya cierta información firmada por el emisor del CFDI, por lo que es necesario que se proporcione el sello digital (CSD) con el que fue firmado el CFDI en un archivo PFX. Para más detalle consulte el documento “Manual de Generación del PFX”.
</p>

<p>
La petición de cancelación seguirá siendo la misma. Se requiere contar con un esquema de aceptación o rechazo de cancelación del CFDI por parte del receptor el cuál aceptará o rechazará las solicitudes de cancelación de los CFDI. iTimbre como proveedor autorizado por el SAT ha preparado el entorno para consumir este nuevo servicio en él cual se han agregado nuevos métodos de consulta al web service de timbrado para verificar el estatus del comprobante y la aceptación o rechazo del cfdi por parte del receptor.
</p>

</div>

<h2>Flujo del nuevo esquema de cancelación</h2>
<div class="level2">

<p>
<img src="/lib/exe/fetch.php?w=901&h=434&tok=f0ccee&media=http%3A%2F%2Fwww.itimbre.com%2Fwp-content%2Fuploads%2F2018%2F10%2FEsquema-de-cancelaci%C3%B3n-de-facturas.jpg" class="media" title="esquema-de-cancelacion-de-facturas.jpg" alt="esquema-de-cancelacion-de-facturas.jpg" width="901" height="434" />
</p>

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
Los parámetros a ser enviados para realizar la cancelación y verificación de respuesta de aceptación o rechazo del XML &lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para cancelar un cfdi es:&lt;/font> <b>cancelarCFDI.</b> los parametros son los siguientes:
</p>

<p>
<b>Parametros:</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para cancelar un cfdi es: <b>cancelarCFDI.</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFCdel emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  pfx_pass  </td><td class="col1">Llave publica usada para abrir el PFX. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  pfx_pem  </td><td class="col1">Archivo resultante de convertir el certificado (.cer) y la llave (.key) a PEM. Para generar este archivo puede consultar el documento “Manual de Generación del PFX” ofrecido por iTimbre. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios (UUID) a cancelar. El número máximo es de 500 y todos los folios deben pertenecer al mismo emisor y haber sido generados con el mismo CSD que se proporciona en el archivo PFX. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3></h3>
<div class="level3">

<p>
<br/>

</p>

</div>

<h3>Ejemplos Cancelación.</h3>
<div class="level3">

<p>
<b>Ejemplo de codificación de llamado en formato JSON (Un solo folio):</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=8" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-1cancelacion.json</a></dt>
<dd><pre class="code file JSON">{
"id":1001,
"method":"cancelarCFDI",
"params": {
"user":"miemail@midominio.com",
"pass":"cabb17fb8536180e11af6dff0da42132",
"RFC":"EEM010101XYZ",
"pfx_pass":"Clave de mi archivo PFX",
"pfx_pem":"< < Archivo PFX de mi CSD>>",
"folios": [
"25916C58-672A-43CD-96EE-F14E0FDD4378",
]
}
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplos para la cancelación para más de un folio.</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=9" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-Xcancelacion.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"cancelarCFDI",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "pfx_pass":"Clave de mi archivo PFX",
        "pfx_pem":"Archivo PFX de mi CSD",
        "folios": [
            "25916C58-672A-43CD-96EE-F14E0FDD4378",
            "9F5E685B-1444-4B54-9421-FBC9203686B2",
            "C0FAA75F-974C-41C9-80A7-5C744517F81F"
        ]
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>&lt;font 20px/arial;;#000000;;#ffffff>Respuesta:&lt;/font> </b>
</p>

<p>
<b>Parametros para la respuesta:</b>
</p>

</div>

<h3>Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. Nota: aunque el valor de retcode sea 1, la solicitud de cancelación no se debe considerar como satisfactoria. Debido a que en el llamado se puede solicitar cancelar más de un CFDI, algunos podrían cancelarse exitosamente mientras que otros no. Es por eso que se debe revisar el parámetro folios, el cual contiene la lista de folios que se solicitaron cancelar con su respectivo código de respuesta. <br/>
  <br/>
El parametro redcode para <b>retenciones y pagos</b> tiene un significado distinto: <br/>
Si es 1 –> La cancelación ha sido exitosa y el acuse se regresa en el parámetro <b>acuse_cancelacion</b> <br/>
Si la respuesta es 2 –> Significa que se activo la cancelación asincrona,entonces se regresa un folio de seguimiento en la variable <b>folio_seguimiento</b>. <br/>
Si es -1 –>Entonces hubo un error genérico y la descripción se reflejara en la variable error. Cualquier otro valor en el retcode será uno de los códigos del catalogo. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  acuse  </td><td class="col1">Acuse del SAT en caso de que retcode sea 1 y que dentro del arreglo folios haya al menos un UUID cancelado. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  fecha  </td><td class="col1">Fecha en que el SAT cancela el CFDI, en caso de existir acuse. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  signature  </td><td class="col1">Firma del acuse del SAT, en caso de existir. Esta firma es parte del acuse, pero aquí se proporciona por separado por simplificación. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, descripción del error. NOTA: es importante que no exista ningún error para considerar que la cancelación fue exitosa. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios que se enviaron a cancelar y su correspondiente estatus. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  UUID  </td><td class="leftalign">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.&lt;/font>  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de respuesta válida arrojada por el Web Service (un folio)</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=10" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta-1cancelacion.json</a></dt>
<dd><pre class="code file JSON">{
    {
        "id":1001,
        "result": {
            "acuse":"< s:Envelope>Acuse del SAT< \/s:Envelope>",
            "id":1001,
            "fecha":"2013-04-15T20:48:39.7200698",
            "retcode":1,
            "signature":"AuPN3mjhCjI2NYiif2Mdtdib9nxhTOw5jf7TPIloqqv2RHnsJ5XnHAdkf5A9ccfXJ4fpJNY0k3kNHkwFRQmhXw==",
            "folios": [
                {
                "UUID":"48D57A35-48BB-4C4B-AB44-678FCBF74D93",
                "status":"201"
                }
            ]
        }
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplo de respuesta válida arrojada por el Web Service (varios folios)</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=11" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta-Xcancelacion.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "result": {
        "acuse":"< s:Envelope>Acuse del SAT< \/s:Envelope>",
        "id":1001,"fecha":"2013-04-15T20:54:30.5215219",
        "retcode":1,
        "signature":"6JdRGnok96RTYFHtWyO38VPlz6Q3vNAB45Sd83wQgXVbI7jPcDlA+LGDLbKaGFUyomdkxhF84OztzenYGFKOxw==",
        "folios": [
        {
            "UUID":"25BB40C3-6884-4975-AEFD-6BE6A58DE83B",
            "status":"201"
        },
        {
            "UUID":"A566F905-7312-491D-B428-E93391BA81D8",
            "status":"201"
        },
        {
            "UUID":"AA2463D4-A080-4FEB-882F-CC634FDA9D06",
            "status":"201"
        }
        ]
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplos de errores</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=12" title="Descargar trozo de código fuente" class="mediafile mf_json">error1.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"1001",
    "result": {
        "retcode":"305",
        "error":"La fecha de emision no esta dentro de la vigencia del CSD del Emisor."
    }
}



</pre><p> </p>
</dd></dl>



<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=13" title="Descargar trozo de código fuente" class="mediafile mf_json">error2.json</a></dt>
<dd><pre class="code file JSON">{
    "id":"1001",
    "result": {
        "retcode":"303",
        "error":"Sello no corresponde a emisor."
    }
}



</pre><p> </p>
</dd></dl>




<p>
<br/>

</p>

</div>

<h1>Valida CFDI:</h1>
<div class="level1">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
Estos son los parámetros a ser enviados para realizar la Validación del CFDI. &lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para cancelar un cfdi es:&lt;/font><b> validaCFDI</b><b>.</b> los parametros son los siguientes:
</p>

<p>
<b>Parametros: </b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para consultar la respuesta de aceptación o rechazo por parte del receptor de la facura es: <b>validaCFDI.</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  client  </td><td class="leftalign">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Parametro para validar el tipo de cliente, valores permitidos&lt;/font> <b>cfdfactura </b> &lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>(Clientes que utilizan el servicio de facturacion33.itimbre.com)&lt;/font> <b>integracion_libre </b> &lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>(clientes que utilizan el servicio de portalws.timbre.com)&lt;/font>  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  xmldata  </td><td class="col1">Contenido del XML con la información del comprobante. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo validacion del estatus del cfdi a cancelar en el SAT JSON: </b> &lt;font 14px/arial;;#000000;;#ffffff>(Clientes que utilizan el servicio de facturacion33.itimbre.com)&lt;/font>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=14" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-validacfdi.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"validaCFDI",
    "params": {
        "client":"cfdfactura",
        "user":"demo",
        "pass":"demo",
        "RFC":"LAN7008173R5",
        "status_sat":"true",
        "xmldata:"< ?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\" ?>< cfdi:Comprobante xmlns:cfdi=\"http://www.sat.gob.mx\/cfd\/3\" Certificado=\"MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp\/38ULWto\/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx\/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr\/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA\/g7kzcU\/1tcpFXF\/rIy93APvkU72jwvkrnprzs+SnG81+\/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ\/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ\/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9\/T6MNZ+\/LM2L\/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw\/ZH+P88RAt5em5\/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp\/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW\/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE\/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7\/w=\" Fecha=\"2018-07-23T09:44:30\" Folio=\"13890\" FormaPago=\"01\" LugarExpedicion=\"21000\" MetodoPago=\"PUE\" Moneda=\"MXN\" NoCertificado=\"20001000000300022815\" Sello=\"aj9W8lJYOTQcUQNm\/zDuorm59tuJsZkoOIw1wg+R3V25r5fCBf\/raSB0xBczKTGcrxobkqvA2k7K2RANjU9RfN7BITbqKmegXAo89GFa9SKB7pmgxro7PRO1bOK47mGUs031WHkjEOgAFC+Ump4R+FErpaLzJXqliJFJUJpPov3j1JLFcDMz0fWo4t1ocL\/KCp5KppXFK3kiWYuHW+GIVbeo4qwyjB0ycg0+qB2sz2zmeOMymuCoAQJ5d63aG2xyEq+VOk0jXwXO\/82WaDDMQgAY9xq5brWX8R49dcV7q4bNIQ+enm85wXmuzS0M1\/hFV2mJLttdIMLBjLzz9vouoQ==\" Serie=\"AA\" SubTotal=\"10000.00\" TipoCambio=\"1\" TipoDeComprobante=\"I\" Total=\"11600.00\" Version=\"3.3\" xmlns:xsi=\"http://www.w3.org\/2001\/XMLSchema-instance\" xsi:schemaLocation=\"http://www.sat.gob.mx\/cfd\/3 http://www.sat.gob.mx\/sitio_internet\/cfd\/3\/cfdv33.xsd\">< cfdi:Emisor Nombre=\"EMPRESA DE EJEMPLO\" RegimenFiscal=\"601\" Rfc=\"LAN7008173R5\"\/>< cfdi:Receptor Nombre=\"SAT Ejemplo\" Rfc=\"AAQM610917QJA\" UsoCFDI=\"P01\"\/>< cfdi:Conceptos>< cfdi:Concepto Cantidad=\"100\" ClaveProdServ=\"84111802\" ClaveUnidad=\"H87\" Descripcion=\"AGENCIA - agencia\" Importe=\"10000.00\" NoIdentificacion=\"177\" Unidad=\"Pieza\" ValorUnitario=\"100\">< cfdi:Impuestos>< cfdi:Traslados>< cfdi:Traslado Base=\"10000\" Importe=\"1600.00\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"\/>< \/cfdi:Traslados>< \/cfdi:Impuestos>< \/cfdi:Concepto>< \/cfdi:Conceptos>< cfdi:Impuestos TotalImpuestosTrasladados=\"1600.00\">< cfdi:Traslados>< cfdi:Traslado Importe=\"1600.00\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"\/>< \/cfdi:Traslados>< \/cfdi:Impuestos>< cfdi:Complemento>< tfd:TimbreFiscalDigital FechaTimbrado=\"2018-07-23T11:44:35\" Leyenda=\"iTimbreSandbox\" NoCertificadoSAT=\"30001000000300036827\" RfcProvCertif=\"SDA1109203R3\" SelloCFD=\"aj9W8lJYOTQcUQNm\/zDuorm59tuJsZkoOIw1wg+R3V25r5fCBf\/raSB0xBczKTGcrxobkqvA2k7K2RANjU9RfN7BITbqKmegXAo89GFa9SKB7pmgxro7PRO1bOK47mGUs031WHkjEOgAFC+Ump4R+FErpaLzJXqliJFJUJpPov3j1JLFcDMz0fWo4t1ocL\/KCp5KppXFK3kiWYuHW+GIVbeo4qwyjB0ycg0+qB2sz2zmeOMymuCoAQJ5d63aG2xyEq+VOk0jXwXO\/82WaDDMQgAY9xq5brWX8R49dcV7q4bNIQ+enm85wXmuzS0M1\/hFV2mJLttdIMLBjLzz9vouoQ==\" SelloSAT=\"Cjzzcf7rC\/icXGKkNv4xMEC9FAKKh2NNQS2YFzTvN5uPbXrlwjsGxZsXIeNyTHRrOrAnasRqilTw4SIX6yIwWgDd+lfWYqlaYWTUUjJ6Uk35OahsT+v8ZdjioefS9JNT5hFj6LUxro4fu2k4dh66HginLGqeTJNRWpDyE4kncWyTzYpSo+TUp1ymvDUZsO9wIth8i28Zq8w2I31GRV2YRuv\/F\/oKo8txYjWoc+oC+QwlnKvFi8TwE7o1LZSsC\/isSk0oAtJGSDofEAk2MjVWGXLdMgMmQgyBEd1Jv2s7AK+uklwmEVqhjI3LwVvdhddmB3Q1163QPomEahKyJ5hNkA==\" UUID=\"A4120E96-0400-4766-A41D-1559A8444C80\" Version=\"1.1\" xmlns:tfd=\"http://www.sat.gob.mx\/TimbreFiscalDigital\" xsi:schemaLocation=\"http://www.sat.gob.mx\/TimbreFiscalDigital http://www.sat.gob.mx\/sitio_internet\/cfd\/timbrefiscaldigital\/TimbreFiscalDigitalv11.xsd\"\/>< \/cfdi:Complemento>< \/cfdi:Comprobante>"
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Ejemplo validacion del estatus del cfdi a cancelar en el SAT JSON: </b> &lt;font 14px/arial;;#000000;;#ffffff>(clientes que utilizan el servicio de portalws.timbre.com)&lt;/font>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=15" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-validacfdi.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"validaCFDI",
    "params": {
        "client":"Integracion_libre",
        "user":"demo",
        "pass":"demo",
        "RFC":"LAN7008173R5",
        "status_sat":"true",
        "xmldata:"< ?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"no\" ?>< cfdi:Comprobante xmlns:cfdi=\"http://www.sat.gob.mx\/cfd\/3\" Certificado=\"MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp\/38ULWto\/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx\/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr\/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA\/g7kzcU\/1tcpFXF\/rIy93APvkU72jwvkrnprzs+SnG81+\/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ\/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ\/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9\/T6MNZ+\/LM2L\/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw\/ZH+P88RAt5em5\/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp\/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW\/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE\/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7\/w=\" Fecha=\"2018-07-23T09:44:30\" Folio=\"13890\" FormaPago=\"01\" LugarExpedicion=\"21000\" MetodoPago=\"PUE\" Moneda=\"MXN\" NoCertificado=\"20001000000300022815\" Sello=\"aj9W8lJYOTQcUQNm\/zDuorm59tuJsZkoOIw1wg+R3V25r5fCBf\/raSB0xBczKTGcrxobkqvA2k7K2RANjU9RfN7BITbqKmegXAo89GFa9SKB7pmgxro7PRO1bOK47mGUs031WHkjEOgAFC+Ump4R+FErpaLzJXqliJFJUJpPov3j1JLFcDMz0fWo4t1ocL\/KCp5KppXFK3kiWYuHW+GIVbeo4qwyjB0ycg0+qB2sz2zmeOMymuCoAQJ5d63aG2xyEq+VOk0jXwXO\/82WaDDMQgAY9xq5brWX8R49dcV7q4bNIQ+enm85wXmuzS0M1\/hFV2mJLttdIMLBjLzz9vouoQ==\" Serie=\"AA\" SubTotal=\"10000.00\" TipoCambio=\"1\" TipoDeComprobante=\"I\" Total=\"11600.00\" Version=\"3.3\" xmlns:xsi=\"http://www.w3.org\/2001\/XMLSchema-instance\" xsi:schemaLocation=\"http://www.sat.gob.mx\/cfd\/3 http://www.sat.gob.mx\/sitio_internet\/cfd\/3\/cfdv33.xsd\">< cfdi:Emisor Nombre=\"EMPRESA DE EJEMPLO\" RegimenFiscal=\"601\" Rfc=\"LAN7008173R5\"\/>< cfdi:Receptor Nombre=\"SAT Ejemplo\" Rfc=\"AAQM610917QJA\" UsoCFDI=\"P01\"\/>< cfdi:Conceptos>< cfdi:Concepto Cantidad=\"100\" ClaveProdServ=\"84111802\" ClaveUnidad=\"H87\" Descripcion=\"AGENCIA - agencia\" Importe=\"10000.00\" NoIdentificacion=\"177\" Unidad=\"Pieza\" ValorUnitario=\"100\">< cfdi:Impuestos>< cfdi:Traslados>< cfdi:Traslado Base=\"10000\" Importe=\"1600.00\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"\/>< \/cfdi:Traslados>< \/cfdi:Impuestos>< \/cfdi:Concepto>< \/cfdi:Conceptos>< cfdi:Impuestos TotalImpuestosTrasladados=\"1600.00\">< cfdi:Traslados>< cfdi:Traslado Importe=\"1600.00\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"\/>< \/cfdi:Traslados>< \/cfdi:Impuestos>< cfdi:Complemento>< tfd:TimbreFiscalDigital FechaTimbrado=\"2018-07-23T11:44:35\" Leyenda=\"iTimbreSandbox\" NoCertificadoSAT=\"30001000000300036827\" RfcProvCertif=\"SDA1109203R3\" SelloCFD=\"aj9W8lJYOTQcUQNm\/zDuorm59tuJsZkoOIw1wg+R3V25r5fCBf\/raSB0xBczKTGcrxobkqvA2k7K2RANjU9RfN7BITbqKmegXAo89GFa9SKB7pmgxro7PRO1bOK47mGUs031WHkjEOgAFC+Ump4R+FErpaLzJXqliJFJUJpPov3j1JLFcDMz0fWo4t1ocL\/KCp5KppXFK3kiWYuHW+GIVbeo4qwyjB0ycg0+qB2sz2zmeOMymuCoAQJ5d63aG2xyEq+VOk0jXwXO\/82WaDDMQgAY9xq5brWX8R49dcV7q4bNIQ+enm85wXmuzS0M1\/hFV2mJLttdIMLBjLzz9vouoQ==\" SelloSAT=\"Cjzzcf7rC\/icXGKkNv4xMEC9FAKKh2NNQS2YFzTvN5uPbXrlwjsGxZsXIeNyTHRrOrAnasRqilTw4SIX6yIwWgDd+lfWYqlaYWTUUjJ6Uk35OahsT+v8ZdjioefS9JNT5hFj6LUxro4fu2k4dh66HginLGqeTJNRWpDyE4kncWyTzYpSo+TUp1ymvDUZsO9wIth8i28Zq8w2I31GRV2YRuv\/F\/oKo8txYjWoc+oC+QwlnKvFi8TwE7o1LZSsC\/isSk0oAtJGSDofEAk2MjVWGXLdMgMmQgyBEd1Jv2s7AK+uklwmEVqhjI3LwVvdhddmB3Q1163QPomEahKyJ5hNkA==\" UUID=\"A4120E96-0400-4766-A41D-1559A8444C80\" Version=\"1.1\" xmlns:tfd=\"http://www.sat.gob.mx\/TimbreFiscalDigital\" xsi:schemaLocation=\"http://www.sat.gob.mx\/TimbreFiscalDigital http://www.sat.gob.mx\/sitio_internet\/cfd\/timbrefiscaldigital\/TimbreFiscalDigitalv11.xsd\"\/>< \/cfdi:Complemento>< \/cfdi:Comprobante>"
    }
}



</pre><p> </p>
</dd></dl>




<p>
<br/>

</p>

</div>

<h2>Respuesta:</h2>
<div class="level2">

</div>

<h4>Ejemplos de respuesta metodo validaCFDI:</h4>
<div class="level4">

<p>
(<br/>

[ConsultaResult] stdClass Object<br/>

(<br/>

[CodigoEstatus] S - Comprobante obtenido satisfactoriamente.<br/>

[EsCancelable] Cancelable sin aceptación<br/>

[Estado] Vigente<br/>

[EstatusCancelacion] <br/>

)
</p>

<p>
)
</p>

</div>

<h4>Ejemplo de respuesta:</h4>
<div class="level4">

<p>
(<br/>

[ConsultaResult]<br/>

(<br/>

[CodigoEstatus] S - Comprobante obtenido satisfactoriamente.<br/>

[EsCancelable] Cancelable con aceptación<br/>

[Estado] Vigente<br/>

[EstatusCancelacion] <b>En proceso</b> <br/>

)
</p>

<p>
)
</p>

<p>
<b>Ejemplo de respuesta negativa:</b>
</p>

<p>
(
</p>

<p>
[ConsultaResult] stdClass Object
</p>

<p>
( [CodigoEstatus] N - <b>602</b>: Comprobante no encontrado.
</p>

<p>
[Estado] No Encontrado )
</p>

<p>
<b>Mensajes de Rechazo y Aceptación.</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<tr class="row0">
		<td class="leftalign"><b>Código</b>   </td><td class="leftalign"><b>Observaciones.</b>   </td>
	</tr>
	<tr class="row1">
		<td class="col0">N 601 </td><td class="leftalign"><b>La expresión impresa proporcionada no es válida.</b> Este código de respuesta se presentará cuando la petición de validación no se haya respetado en el formato definido.  </td>
	</tr>
	<tr class="row2">
		<td class="col0">N 602 </td><td class="col1">Este código de respuesta se presentará cuando el UUID del comprobante no se encuentre en la Base de Datos del SAT. </td>
	</tr>
	<tr class="row3">
		<td class="col0">S </td><td class="col1">Comprobante obtenido satisfactoriamente.“En Proceso” </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<br/>

</p>

</div>

<h2>Pendientes CFDI.</h2>
<div class="level2">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
A continuación los parámetros a ser enviados para hacer una revisión de CFDI pendientes. &lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para revisar los pendientes de un CFDI es:&lt;/font> <b>pendientes CFDI</b><b>.</b> los parametros son los siguientes:
</p>

</div>

<h3>Parámetros.</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para consultar la respuesta de aceptación o rechazo por parte del receptor de la facura es: <b>pendientesCFDI</b>.  </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  client  </td><td class="leftalign">Parametro para validar el tipo de cliente, valores permitidos <b>cfdfactura </b> (Clientes que utilizan el servicio de facturacion33.itimbre.com) <b>integracion_libre </b> (clientes que utilizan el servicio de portalws.timbre.com)  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  rfcReceptor  </td><td class="col1">RFC del receptor del CFDI. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo pendientesCFDI</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=16" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-Pendientes.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"pendientesCFDI",
    "params": {
        "client":"cfdfactura",
        "user":"demo010303ol1",
        "pass":"demo010303ol1",
        "RFC":"AAQM610917QJA",
        "rfcReceptor":"AAQM610917QJA",
        "id_transaccion": 0
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h2>Respuesta:</h2>
<div class="level2">

</div>

<h3></h3>
<div class="level3">

<p>
<b>Parámetros de la respuesta: </b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. Nota: aunque el valor de retcode sea 1, la solicitud de cancelación no se debe considerar como satisfactoria. Debido a que en el llamado se puede solicitar cancelar más de un CFDI, algunos podrían cancelarse exitosamente mientras que otros no. Es por eso que se debe revisar el parámetro folios, el cual contiene la lista de folios que se solicitaron cancelar con su respectivo código de respuesta. <br/>
  <br/>
El parametro redcode para <b>retenciones y pagos</b> tiene un significado distinto: <br/>
Si es 1 –> La cancelación ha sido exitosa y el acuse se regresa en el parámetro <b>acuse_cancelacion</b> <br/>
Si la respuesta es 2 –> Significa que se activo la cancelación asincrona,entonces se regresa un folio de seguimiento en la variable <b>folio_seguimiento</b>. <br/>
Si es -1 –>Entonces hubo un error genérico y la descripción se reflejara en la variable error. Cualquier otro valor en el retcode será uno de los códigos del catalogo. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, descripción del error. NOTA: es importante que no exista ningún error para considerar que la cancelación fue exitosa. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  data  </td><td class="leftalign">X&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>ML timbrado.&lt;/font>  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de respuesta pendientesCFDI.</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=17" title="Descargar trozo de código fuente" class="mediafile mf_json">Respuesta-Pendientes.json</a></dt>
<dd><pre class="code file JSON">{
    "id": 0,
    "result": {
        "stampdate": "2018-07-23T21:20:56-05:00",
        "ip_addr": "::1",
        "data": "< s:Envelope xmlns:s=\"http://schemas.xmlsoap.org\/soap\/envelope/">< s:Body xmlns:xsi=\"http://www.w3.org\/2001\/XMLSchema-instance\" xmlns:xsd=\"http://www.w3.org\/2001\/XMLSchema\">< ObtenerPeticionesPendientesResponse xmlns=\"http://cancelacfd.sat.gob.mx\">< ObtenerPeticionesPendientesResult CodEstatus=\"1100\">< UUID>1199A672-56FD-4A1B-B63D-C1B0033E53ED< \/UUID>< UUID>1199A672-56FD-4A1B-B63D-C1B0033E53ED< \/UUID>< UUID>75DBF22F-4934-4FB3-802B-489429C2B778< \/UUID>< \/ObtenerPeticionesPendientesResult>< \/ObtenerPeticionesPendientesResponse>< \/s:Body>< \/s:Envelope>",
        "retcode": 1,
        "total_processing_time": 5.37415599823
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h2></h2>
<div class="level2">

</div>

<h2></h2>
<div class="level2">

</div>

<h3></h3>
<div class="level3">

<p>
<br/>

</p>

</div>

<h1>Procesar respuesta:</h1>
<div class="level1">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
Los parámetros a ser enviados para procesar respuesta.&lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para procesar respuestas es:&lt;/font> <b>Procesar-RespuestaCFDI.</b> los parametros son los siguientes:
</p>

</div>

<h3>Parámetros.</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para procesar la respuesta de aceptación o rechazo del receptor del CFDI es: <b>procesar-respuestaCFDI.</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  client  </td><td class="leftalign">Parametro para validar el tipo de cliente, valores permitidos <b>cfdfactura </b> (Clientes que utilizan el servicio de facturacion33.itimbre.com) <b>integracion_libre </b> (clientes que utilizan el servicio de portalws.timbre.com)  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  rfcReceptor  </td><td class="col1">RFC del receptor del CFDI. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios (UUID) a cancelar. El número máximo es de 500 y todos los folios deben pertenecer al mismo emisor y haber sido generados con el mismo CSD que se proporciona en el archivo PFX. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo procesar-respuesta:</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=18" title="Descargar trozo de código fuente" class="mediafile mf_json">llamado-Pendientes.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"procesar-respuestaCFDI",
    "params": {
        "client":"cfdfactura",
        "user":"demo010303ol1",
        "pass":"Administr4dor",
        "RFC":"AAQM610917QJA",
        "rfcReceptor":"AAQM610917QJA",
        "solicitud":{
          "Folios": [ {
                      "UUID":"A4120E96-0400-4766-A41D-1559A8444C80",
                      "EstatusUUID": "201",
                      "Respuesta": "Aceptacion"}],
        "RfcReceptor":"AAQM610917QJA" },
        "id_transaccion": 0
    }
}



</pre><p> </p>
</dd></dl>




<p>
NOTA: La funcion principal de este ejemplo es para proporcionar la respuesta de aceptacion o rechazo la cual deben mostrar en el sistema del cliente del emisor de la factua.
</p>

<p>
<br/>

</p>

</div>

<h2>Respuesta:</h2>
<div class="level2">

</div>

<h2>Ejemplos de respuesta procesar-respuestaCFDI.</h2>
<div class="level2">

<p>
(<br/>

[ConsultaResult] stdClass Object<br/>

(<br/>

[CodigoEstatus] S - Comprobante obtenido satisfactoriamente.<br/>

[EsCancelable] Cancelable sin aceptación<br/>

[Estado] Cancelado<br/>

[EstatusCancelacion] Cancelado sin aceptación<br/>

)
</p>

<p>
)
</p>

</div>

<h2></h2>
<div class="level2">

</div>

<h1>Cancelar Retencion.</h1>
<div class="level1">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
Los parámetros a ser enviados para realizar la cancelación de retención del XML. &lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para cancelar lar retención de un CFDI es:&lt;/font> <b>cancelarRetencion</b><b>.</b> los parametros son los siguientes:
</p>

<p>
<b>Parametros</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para cancelar un cfdi es: <b>cancelarRetencion.</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFCdel emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  rfcReceptor  </td><td class="col1">RFCdel receptor del CFDI. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  pfx_pass  </td><td class="col1">Llave publica usada para abrir el PFX. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  pfx_pem  </td><td class="col1">Archivo resultante de convertir el certificado (.cer) y la llave (.key) a PEM. Para generar este archivo puede consultar el documento “Manual de Generación del PFX” ofrecido por iTimbre. </td>
	</tr>
	<tr class="row10">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios (UUID) a cancelar. El número máximo es de 500 y todos los folios deben pertenecer al mismo emisor y haber sido generados con el mismo CSD que se proporciona en el archivo PFX. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de codificación de llamado en formato JSON (Un solo folio) para retenciones y pagos</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=19" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-001cancelacion.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"cancelarRetencion",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "pfx_pass":"Clave de mi archivo PFX",
        "pfx_pem":"< < Archivo PFX de mi CSD>>",
        "folios": [
            "25916C58-672A-43CD-96EE-F14E0FDD4378",
        ]
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h1>Respuesta:</h1>
<div class="level1">

</div>

<h3>Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Este parámetro consiste en el tipo de petición solicitado para generar el CFDI. Los valores posibles se encuentran en el catálogo de métodos.&lt;/font> </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. Nota: aunque el valor de retcode sea 1, la solicitud de cancelación no se debe considerar como satisfactoria. Debido a que en el llamado se puede solicitar cancelar más de un CFDI, algunos podrían cancelarse exitosamente mientras que otros no. Es por eso que se debe revisar el parámetro folios, el cual contiene la lista de folios que se solicitaron cancelar con su respectivo código de respuesta. <br/>
  <br/>
El parametro redcode para <b>retenciones y pagos</b> tiene un significado distinto: <br/>
Si es 1 –> La cancelación ha sido exitosa y el acuse se regresa en el parámetro <b>acuse_cancelacion</b> <br/>
Si la respuesta es 2 –> Significa que se activo la cancelación asincrona,entonces se regresa un folio de seguimiento en la variable <b>folio_seguimiento</b>. <br/>
Si es -1 –>Entonces hubo un error genérico y la descripción se reflejara en la variable error. Cualquier otro valor en el retcode será uno de los códigos del catalogo. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  acuse  </td><td class="col1">Acuse del SAT en caso de que retcode sea 1 y que dentro del arreglo folios haya al menos un UUID cancelado. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  acuse_cancelacion  </td><td class="col1">Parámetro de retenciones y pagos , donde regresa el acuse del SAT cuando es exitosa. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  fecha  </td><td class="col1">Fecha en que el SAT cancela el CFDI, en caso de existir acuse. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  signature  </td><td class="col1">Firma del acuse del SAT, en caso de existir. Esta firma es parte del acuse, pero aquí se proporciona por separado por simplificación. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, descripción del error. NOTA: es importante que no exista ningún error para considerar que la cancelación fue exitosa. </td>
	</tr>
	<tr class="row10">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios que se enviaron a cancelar y su correspondiente estatus. </td>
	</tr>
	<tr class="row11">
		<td class="centeralign">  folio_seguimiento  </td><td class="col1">Parámetro de retenciones y pagos, este parametro se regresa cuando se activa la cancelación asincrona brindando un folio de seguimiento. </td>
	</tr>
	<tr class="row12">
		<td class="centeralign">  result  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo.&lt;/font> </td>
	</tr>
	<tr class="row13">
		<td class="centeralign">  params  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Debe contener un arreglo con los parámetros: user, pass, status_sat,&lt;/font> RFC&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>, rfcReceptor y folios,client&lt;/font> </td>
	</tr>
	<tr class="row14">
		<td class="centeralign">  user  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró).&lt;/font> </td>
	</tr>
	<tr class="row15">
		<td class="centeralign">   <br/>
pass  </td><td class="leftalign">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Contraseña generada por iTimbre asignada al emisor de manera automática. Se puede utilizar la&lt;/font> <b>contraseña máster</b> &lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>del administrador de los emisores para cualquier&lt;/font> RFC&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>.&lt;/font>  </td>
	</tr>
	<tr class="row16">
		<td class="centeralign">  pfx_pass  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Llave publica usada para abrir el PFX.&lt;/font> </td>
	</tr>
	<tr class="row17">
		<td class="centeralign">  UUID  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-family: arial; font-size: 14px;;;#ffffff>Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.&lt;/font> </td>
	</tr>
	<tr class="row18">
		<td class="centeralign">  pfx_pem  </td><td class="col1">&lt;font 14px/arial;;#000000;;#ffffff>Archivo resultante de convertir el certificado (.cer) y la llave (.key) a PEM. Para generar este archivo puede consultar el documento “Manual de Generación del PFX” ofrecido por iTimbre.&lt;/font> </td>
	</tr>
	<tr class="row19">
		<td class="centeralign">  RFC  </td><td class="leftalign">RFC&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas.&lt;/font>  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de codificación de respuesta en formato JSON (Un solo folio) para retenciones y pagos</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=20" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-001cancelacion.json</a></dt>
<dd><pre class="code file JSON"> "id":1001,
 "method":"cancelarRetencion",
 "result": {
 "params": {
 "acuse_cancelacion":"< s:Envelope>Acuse del SAT< \/s:Envelope>",
 "user":"miemail@midominio.com",
 "id":1001,
 "pass":"cabb17fb8536180e11af6dff0da42132",
 "fecha":"2013-04-15T20:48:39.7200698",
 "RFC":"EEM010101XYZ",
"retcode":1,
 "pfx_pass":"Clave de mi archivo PFX",
  "signature":"AuPN3mjhCjI2NYiif2Mdtdib9nxhTOw5jf7TPIloqqv2RHnsJ5XnHAdkf5A9ccfXJ4fpJNY0k3kNHkwFRQmhXw==",
 "pfx_pem":"< < Archivo PFX de mi CSD>>",
 "folios": [          "folios": [
   {              "25916C58-672A-43CD-96EE-F14E0FDD4378",
   "UUID":"48D57A35-48BB-4C4B-AB44-678FCBF74D93",          ]
   "status":"201"
   }
 ]
 }
  }       }
 }   }



</pre><p> </p>
</dd></dl>




<p>
<br/>

</p>

</div>

<h2>Consulta CFDI.</h2>
<div class="level2">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
Los parámetros a ser enviados para realizar la consulta de un CFDI &lt;font 14px/arial;;#000000;;#ffffff>Nombre del método para cancelar un cfdi es:&lt;/font> <b>consultaCFDI.</b> los parametros son los siguientes:
</p>

<p>
<b>Parametros:</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para cancelar un cfdi es: <b>consultaCFDI</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFCdel emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  rfcReceptor  </td><td class="col1">RFCdel receptor del CFDI. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  UUID  </td><td class="leftalign">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.&lt;/font>  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de codificación de llamado para consultar un CFDI</b>:
</p>

</div>

<h2></h2>
<div class="level2">
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=21" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-consultarCFDI.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"consultaCFDI",
    "params": {
        client":"cfdfactura"
        "user":"demo010303ol1",
        "pass":"Administr4dor",
        "RFC":"AAQM610917QJA",
        "solicitud": {
       "UUID":"793A76DD-D744-4AF1-8A16-E59BB3B7F78B",
     "RfcReceptor":"AAQM610917QJA"
                  },
     "id_transaccion": 0
     }
}< /file>



</pre><p> </p>
</dd></dl>




<p>
<br/>

</p>

</div>

<h2>Verificar estatus de retencion.</h2>
<div class="level2">

<p>
Los parámetros a ser enviados para Verificar el estatus de la retención del XML. &lt;font 14px color: rgb(0, 0, 0);/arial;;rgb(0, 0, 0);;#ffffff>Nombre del método para cancelar un cfdi es:&lt;/font> <b>verificarEstatusRetencion.</b> los parametros son los siguientes:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  method  </td><td class="leftalign">Nombre del método para cancelar un cfdi es: <b>verificarEstatusRetencion.</b>   </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  RFC  </td><td class="col1">RFCdel emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios (UUID) a cancelar. El número máximo es de 500 y todos los folios deben pertenecer al mismo emisor y haber sido generados con el mismo CSD que se proporciona en el archivo PFX. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo de codificación de llamado en formato JSON para recuperar acuse de cancelación de retenciones y pagos</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=22" title="Descargar trozo de código fuente" class="mediafile mf_json">llamada-0001cancelacion.json</a></dt>
<dd><pre class="code file JSON">{
    "id":1001,
    "method":"verificarEstatusRetencion",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "folio_seguimiento":"005",
 
    }
}



</pre><p> </p>
</dd></dl>




<p>
<br/>

</p>

</div>

<h3>Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">El mismo id que fue enviado en el llamado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="col1">Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es exitosa. Si es diferente de 1, el número es el código de error. Nota: aunque el valor de retcode sea 1, la solicitud de cancelación no se debe considerar como satisfactoria. Debido a que en el llamado se puede solicitar cancelar más de un CFDI, algunos podrían cancelarse exitosamente mientras que otros no. Es por eso que se debe revisar el parámetro folios, el cual contiene la lista de folios que se solicitaron cancelar con su respectivo código de respuesta. <br/>
  <br/>
El parametro redcode para <b>retenciones y pagos</b> tiene un significado distinto: <br/>
Si es 1 –> La cancelación ha sido exitosa y el acuse se regresa en el parámetro <b>acuse_cancelacion</b> <br/>
Si la respuesta es 2 –> Significa que se activo la cancelación asincrona,entonces se regresa un folio de seguimiento en la variable <b>folio_seguimiento</b>. <br/>
Si es -1 –>Entonces hubo un error genérico y la descripción se reflejara en la variable error. Cualquier otro valor en el retcode será uno de los códigos del catalogo. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  acuse  </td><td class="col1">Acuse del SAT en caso de que retcode sea 1 y que dentro del arreglo folios haya al menos un UUID cancelado. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  acuse_cancelacion  </td><td class="col1">Parámetro de retenciones y pagos , donde regresa el acuse del SAT cuando es exitosa. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  fecha  </td><td class="col1">Fecha en que el SAT cancela el CFDI, en caso de existir acuse. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  signature  </td><td class="col1">Firma del acuse del SAT, en caso de existir. Esta firma es parte del acuse, pero aquí se proporciona por separado por simplificación. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  error  </td><td class="col1">En caso de existir, descripción del error. NOTA: es importante que no exista ningún error para considerar que la cancelación fue exitosa. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  folios  </td><td class="col1">Arreglo que contiene la lista de folios que se enviaron a cancelar y su correspondiente estatus. </td>
	</tr>
	<tr class="row10">
		<td class="centeralign">  folio_seguimiento  </td><td class="col1">Parámetro de retenciones y pagos, este parametro se regresa cuando se activa la cancelación asincrona brindando un folio de seguimiento. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
Ejemplo del manejo de los folios:
</p>
<pre class="code PHP"><span class="re0">$primer_folio</span> <span class="sy0">=</span> <span class="re0">$folios</span><span class="br0">[</span><span class="nu0">0</span><span class="br0">]</span> <span class="sy0">-></span> <span class="me1">UUID</span><span class="sy0">;</span>
<span class="re0">$estatus_primer_folio</span> <span class="sy0">=</span> <span class="re0">$folios</span><span class="br0">[</span><span class="nu0">0</span><span class="br0">]</span> <span class="sy0">-></span> <span class="me1">status</span><span class="sy0">;</span>
<span class="re0">$segundo_folio</span> <span class="sy0">=</span> <span class="re0">$folios</span><span class="br0">[</span><span class="nu0">1</span><span class="br0">]</span> <span class="sy0">-></span> <span class="me1">UUID</span><span class="sy0">;</span>
<span class="re0">$estatus_segundo_folio</span> <span class="sy0">=</span> <span class="re0">$folios</span><span class="br0">[</span><span class="nu0">1</span><span class="br0">]</span> <span class="sy0">-></span> <span class="me1">status</span><span class="sy0">;</span>



</pre><p> </p>




</div>

<h4></h4>
<div class="level4">

<p>
<b>Estatus del CFDI.</b>
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<tr class="row0">
		<td class="leftalign"><b>Descripcion del código</b>   </td><td class="leftalign"><b>Código</b>   </td><td class="leftalign"><b>Observaciones</b>   </td>
	</tr>
	<tr class="row1">
		<td class="col0">Existen cfdi relacionados al folio fiscal </td><td class="col1">2000 </td><td class="col2">Este código de respuesta se presentará cuando la petición de consulta encuentre documentos relacionados al UUID consultado. </td>
	</tr>
	<tr class="row2">
		<td class="col0">No Existen cfdi relacionados al folio fiscal </td><td class="col1">2001 </td><td class="col2">Este código de respuesta se presentará cuando el UUID consultado no contenga documentos relacionados a él. </td>
	</tr>
	<tr class="row3">
		<td class="col0">El folio fiscal no pertenece al receptor. </td><td class="col1">2002 </td><td class="col2">Este código de respuesta se presentará cuando el RFC del receptor no corresponda al UUID consultado. </td>
	</tr>
	<tr class="row4">
		<td class="col0">No existen peticiones para el RFC Receptor </td><td class="col1">1101 </td><td class="col2">Este código se regresa cuando la consulta se realizó de manera exitosa, pero no se encontraron solicitudes de cancelación para el rfc receptor </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplos.</b>
</p>

<p>
<br/>

</p>

</div>

<h4>Códigos de Respuesta de Estatus UUID ( Para retenciones y pagos)</h4>
<div class="level4">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  Código  </th><th class="centeralign">  Validación  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  1201  </td><td class="col1">UUID Cancelado. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  1202  </td><td class="col1">UUID Previamente cancelado. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  1203  </td><td class="col1">UUID no corresponde con el emisor. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  1205  </td><td class="col1">UUID no existe. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<br/>

</p>

</div>

<h4>Códigos de Respuesta a nivel petición (Para retenciones y pagos)</h4>
<div class="level4">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  Código  </th><th class="centeralign">  Validación  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  1300  </td><td class="col1">Autenticación no valida. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  1301  </td><td class="col1">XML mal formado. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  1302  </td><td class="col1">Estructura de folios no válida. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  1303  </td><td class="col1">Estructura de RFC no válida. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  1304  </td><td class="col1">Estructura de fecha no válida. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  1305  </td><td class="col1">Certificado no correspondiente al emisor. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  1306  </td><td class="col1">Certificado no vigente. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  1307  </td><td class="col1">Uso de la FIEL no permitido. </td>
	</tr>
	<tr class="row9">
		<td class="centeralign">  1308  </td><td class="col1">Certificado revocado o caduco. </td>
	</tr>
	<tr class="row10">
		<td class="centeralign">  1309  </td><td class="col1">Firma mal formada o invalida. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h2>Búsqueda de CFDI</h2>
<div class="level2">

<p>
Esta función permite realizar una búsqueda en la base de datos del Web Service por medio de un ID controlado por el cliente o por el folio del comprobante a recuperar.
</p>

</div>

<h3>Método</h3>
<div class="level3">

<p>
Existe un método definido para la búsqueda, el cual es <b>buscarCFDI</b>. Este método puede ser llamado para pedir al Web Service algún CFDI que se desee consultar a petición del cliente.
</p>

<p>
El llamado al Web Service se realiza por medio de este URL:
</p>

<p>
<a href="https://portalws.itimbre.com/itimbre/itimbre.php" class="urlextern" title="https://portalws.itimbre.com/itimbre/itimbre.php"  rel="nofollow">https://portalws.itimbre.com/itimbre/itimbre.php</a>
</p>

</div>

<h3>Parámetros</h3>
<div class="level3">

<p>
Los parámetros a la llamada al Web Service son estructurados de la siguiente manera:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  method  </td><td class="col1">Método que será llamado al Web Service para realizar la búsqueda (buscarCFDI). </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, RFC, etc. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  RFC  </td><td class="leftalign">RFC del emisor del CFDI. Nota: <b>es el único parámetro que debe estar en mayúsculas.</b>   </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  UUID  </td><td class="col1">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.&lt;/font> </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  ID  </td><td class="leftalign">&lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML.&lt;/font> <b>Por defecto se asignará 0</b> &lt;font 14px/arial;;rgb(51, 51, 51) font-size: 14px;;;#ffffff>.&lt;/font>  </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<br/>

</p>

</div>

<h3>Llamado</h3>
<div class="level3">

<p>
Cuando se realice el llamado al Web Service, es necesario seguir el siguiente lineamiento en el JSON CALL.
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=24" title="Descargar trozo de código fuente" class="mediafile mf_json">busqueda.json</a></dt>
<dd><pre class="code file JSON">{
    “method” :“buscarCFDI”,
    “params” : {
        “user” : “usuario”,
        “pass” : “contraseña”,
        “RFC” : “RFC”,
        “id” : “string”,
        “UUID” : “string”
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h3>Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  retcode  </td><td class="col1">Código de retorno, si es 1, la repuesta es el xml buscado. Si es diferente de 1, no se encontró el CFDI. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  data  </td><td class="col1">Xml timbrado, si fue encontrado, o mensaje de error, si no fue encontrado. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
La respuesta arrojada por el Web Service será la siguiente:
</p>

<p>
Respuesta exitosa, búsqueda encontrada:
</p>
<pre class="code JSON">{
   “data” :“xml”,
   “retcode” : 1
}



</pre><p> </p>




<p>
Respuesta errónea, CFDI no encontrado:
</p>
<pre class="code JSON">{
   “retcode” :dif 1 ,
   “data” :“notfound”
}



</pre><p> </p>




</div>

<h3>Al utilizar el método buscarCFDI recibirán estas nuevas variables :</h3>
<div class="level3">

</div>

<h4>*consulta_sat</h4>
<div class="level4">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  CÓDIGO  </th><th class="centeralign">  MENSAJE DE RESPUESTA  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  1  </td><td class="col1">Si el valor es 1 significa que hubo éxito al conectarse con el SAT y que el SAT ya tiene el CFDI. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  602  </td><td class="col1">Si el valor es 602 significa que hubo éxito al conectarse con el SAT pero el SAT todavía no tiene el CFDI. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  603  </td><td class="col1">Si el valor es 603 significa que hubo éxito al conectarse con el SAT pero hubo un error en los datos. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  -1  </td><td class="col1">Si el valor es -1 significa que no se pudo establecer una conexión con el servicio del SAT o hubo una falla en su servicio. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h4>*acuse_consulta_sat</h4>
<div class="level4">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  CÓDIGO  </th><th class="centeralign">  MENSAJE DE RESPUESTA  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  1  </td><td class="col1">Acuse de consulta con el SAT. Esta variable solo aparece cuando consulta_sat es 1. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h4>*error_consulta_sat</h4>
<div class="level4">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  CÓDIGO  </th><th class="centeralign">  MENSAJE DE RESPUESTA  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="leftalign">  </td><td class="col1">&lt;font 13px line-height: normal;/arial, sans-serif;;#000000;;#ffffff>Detalles del error en la consulta. Esta variable solo aparece cuando consulta_sat NO es 1.&lt;/font> </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h2>Reporte de CFDI</h2>
<div class="level2">

<p>
Esta función permite realizar un conteo en el Web Service de los timbres emitidos en determinado lapso de tiempo por los emisores.
</p>

</div>

<h3>Métodos</h3>
<div class="level3">

<p>
Existe un método definido para el conteo de los timbres, el cual es <b>reporte</b> este método puede ser llamado para pedir al Web Service la cantidad de timbres consumidos a lo largo de determinado periodo.
</p>

<p>
El llamado al Web Service se realiza por medio de este URL:
</p>

<p>
<a href="https://portalws.itimbre.com/itimbre.php" class="urlextern" title="https://portalws.itimbre.com/itimbre.php"  rel="nofollow">https://portalws.itimbre.com/itimbre.php</a>
</p>

</div>

<h3>Parámetros</h3>
<div class="level3">

<p>
Los parámetros a la llamada al Web Service son estructurados de la siguiente manera:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  method  </td><td class="col1">Método que será llamado al Web Service para realizar el conteo de los folios emitidos en determinado lapso de tiempo (reporte). </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, RFC, etc. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  RFC  </td><td class="col1">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. (Es opcional ingresarlo) </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  fecha_inicio  </td><td class="col1">La fecha de inicio mandara la instrucción al Web service para establecer a partir de qué fecha desea iniciar el conteo de los timbres emitidos. El formato de la fecha debe ser AAAA-MM-DD. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  fecha_final  </td><td class="col1">La fecha final mandara la instrucción al Web Service para establecer el final del conteo. El formato de la fecha debe ser AAAA-MM-DD. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Llamada</h3>
<div class="level3">

<p>
Cuando se realice el llamado al Web Service, es necesario seguir el siguiente lineamiento en el JSON CALL.
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=27" title="Descargar trozo de código fuente" class="mediafile mf_json">busqueda.json</a></dt>
<dd><pre class="code file JSON">{
    "method":"reporte",
    "params": {
        "user":"mi usuario",
        "pass":"mi password",
        "RFC":"RFC Opcional",
        "fecha_inicio":"2014-01-01",
        "fecha_final":"2014-06-30"
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h3>Respuesta</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de la operación. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="leftalign">Arreglo que contiene el <em>retcode</em> y <em>data</em>.  </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de respuesta recibido por el servicio. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  data  </td><td class="col1">Arreglo contiene cada uno de los RFC registrados y los totales correspondientes. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  total  </td><td class="col1">Cantidad de timbres consumidos por cada RFC. </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  error  </td><td class="col1">Redacción del error en caso de existir. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
La respuesta arrojada por el Web Service será la siguiente: Respuesta exitosa, búsqueda encontrada es en un formato JSON,ordenado por RFC , y posteriormente por la cantidad de timbres emitidos, correspondiente al rango de fechas utilizado.
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=28" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta-reporte.json</a></dt>
<dd><pre class="code file JSON">{
    "id":null,
    "result": {
        "retcode":1,
        "data": {
            "FAGL700301GL1": {
                "total":10660
            },
            "ITI920713RL5": {
                "total":600
            },
            "XFE0404037IA": {
                "total":164
            },
            "ECP120423Q73": {
                "total":255
            },
            "IRH910115684": {
                "total":403
            },
            "AGV120712FL1": {
                "total":3884
            },
            "HAAL9004112A1": {
                "total":796
            }
        }
    }
}



</pre><p> </p>
</dd></dl>




<p>
Respuesta errónea, CFDI no encontrado:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=29" title="Descargar trozo de código fuente" class="mediafile mf_json">error-reporte.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,
    "result": {
        "retcode":-1,
        "error":"No se encontraron registros con la informacion recibida."
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h2>Reporte detallado de CFDI</h2>
<div class="level2">

<p>
Esta función permite realizar un reporte detallado en el Web Service de los timbres emitidos conteniendo el <em>UUID</em>, folio interno y fecha de timbrado.
</p>

</div>

<h3>Métodos</h3>
<div class="level3">

<p>
Existe un método definido para el reporte detallado de los timbres, el cual es <b>reporte_detallado</b> Este método puede ser llamado para pedir al Web Service el detalle de los timbres emitidos en determinado lapso de tiempo.
</p>

<p>
El llamado al Web Service se realiza por medio de este URL:
</p>

<p>
<a href="https://portalws.itimbre.com/itimbre.php" class="urlextern" title="https://portalws.itimbre.com/itimbre.php"  rel="nofollow">https://portalws.itimbre.com/itimbre.php</a>
</p>

</div>

<h3>Parámetros</h3>
<div class="level3">

<p>
Los parámetros a la llamada al Web Service son estructurados de la siguiente manera:
</p>

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  method  </td><td class="col1">Método que será llamado al Web Service para realizar el conteo de los folios emitidos en determinado lapso de tiempo (reporte_detallado). </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  params  </td><td class="col1">Debe contener un arreglo con los parámetros: user, pass, RFC, etc. </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  pass  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  RFC  </td><td class="leftalign">RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas. (Es <b>requerido</b> ingresarlo)  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  fecha_inicio  </td><td class="col1">La fecha de inicio mandara la instrucción al Web service para establecer a partir de qué fecha desea iniciar el conteo de los timbres emitidos. El formato de la fecha debe ser AAAA-MM-DD. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  fecha_final  </td><td class="col1">La fecha final mandara la instrucción al Web Service para establecer el final del conteo. El formato de la fecha debe ser AAAA-MM-DD. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
</div>

<h3>Llamado</h3>
<div class="level3">

<p>
Cuando se realice el llamado al Web Service, es necesario seguir el siguiente lineamiento en el JSON CALL.
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=30" title="Descargar trozo de código fuente" class="mediafile mf_json">reporte-detallado.json</a></dt>
<dd><pre class="code file JSON"> {
     "method":"reporte_detallado",
     "params":  {
         "user":"mi usuario",
         "pass":"mi password",
         "RFC":"RFC Obligatorio",
         "fecha_inicio":"2014-01-01",
         "fecha_final":"2014-02-28"
     }
}



</pre><p> </p>
</dd></dl>




</div>

<h3>Respuesta iTimbre</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETROS  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de la operación. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  result  </td><td class="leftalign">Arreglo que contiene el <em>retcode</em> y <em>data</em>.  </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  retcode  </td><td class="col1">Código de respuesta recibido por el servicio. </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  data  </td><td class="col1">Arreglo contiene la información de los CFDIs que corresponden a la bósquda. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  uuid  </td><td class="leftalign">  </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  folio_interno  </td><td class="col1">Si fue especificada al timbrar se mostrará el folio interno del CFDI. </td>
	</tr>
	<tr class="row7">
		<td class="centeralign">  fecha_timbrado  </td><td class="col1">Fecha en la que fue certificado el CFDI. </td>
	</tr>
	<tr class="row8">
		<td class="centeralign">  error  </td><td class="col1">Redacción del error en caso de existir. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Respuesta exitosa, búsqueda encontrada es en un formato JSON ordenado por UUID, folio interno y la fecha de timbrado</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=31" title="Descargar trozo de código fuente" class="mediafile mf_json">respuesta-reporte-detallado.json</a></dt>
<dd><pre class="code file JSON">{
    "id":null,
    "result":    {
        "retcode":1,
        "data":    [
        {
        "uuid":"D6763BF1-9E12-4500-9B99-D02293F4C6C9",
        "folio_interno":"",
        "fecha_timbrado":"2014-01-28 19:09:08"
        },
        {
        "uuid":"41H26024-587E-480G-8BB6-CF1248CB58B6",
        "folio_interno":"",
        "fecha_timbrado":"2014-01-29 09:49:59"
        }
        ]
    }
}



</pre><p> </p>
</dd></dl>




<p>
<b>Respuesta errónea, CFDI no encontrado</b>:
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=32" title="Descargar trozo de código fuente" class="mediafile mf_json">error-reporte-detallado.json</a></dt>
<dd><pre class="code file JSON">{
    "id":0,"result": {
        "retcode":-1,
        "error":"No se encontraron registros con la informacion recibida."
    }
}



</pre><p> </p>
</dd></dl>




</div>

<h1>Cancelación Masiva</h1>
<div class="level1">

<p>
Esta nueva aplicación le permitirá a el usuario anular los comprobantes de forma masiva ,optimizando tiempo y recursos ya que únicamente requiere contar con la lista de UUID a cancelar la cual se puede ingresar manualmente ó subir un archivo en formato CSV que contenga los UUID.
</p>

<p>
Para acceder a la aplicación, favor dar clic en el siguiente enlace : <a href="http://portalws.itimbre.com/cancelacion_masiva.php" class="urlextern" title="http://portalws.itimbre.com/cancelacion_masiva.php"  rel="nofollow">http://portalws.itimbre.com/cancelacion_masiva.php</a>
</p>

</div>

<h3>Paso 1</h3>
<div class="level3">

<p>
Para comenzar a efectuar la cancelación es necesario cargar a la aplicación una lista que contenga los UUIDs separados por líneas de salto (enters) en un archivo con formato CSV .
</p>

<p>
Una vez seleccionado el archivo CSV con los UUID a cancelar es necesario dar clic en <b>Subir CSV</b> para cargarlos a la aplicación.
</p>

<p>
<em>Nota: También tiene la opción de agregar la lista manualmente en el recuadro blanco que aparece debajo del botón <b>Subir CSV</b>.</em>
</p>

<p>
<img src="/lib/exe/fetch.php?media=subircsv01.jpg" class="media" title="subircsv01.jpg" alt="subircsv01.jpg" />
</p>

</div>

<h3>Paso 2</h3>
<div class="level3">

<p>
Es necesario ingresar :
</p>
<ul>
<li class="level1"> Usuario</li>
<li class="level1"> Contraseña</li>
<li class="level1"> RFC</li>
</ul>

<p>
Dichos parámetros son los que se utilizan para realizar la conexión al Web Service.
</p>

<p>
<img src="/lib/exe/fetch.php?media=userpass.jpg" class="media" title="userpass.jpg" alt="userpass.jpg" />
</p>

</div>

<h3>Paso 3</h3>
<div class="level3">

<p>
Es necesario cargar a la aplicación los siguientes archivos del Emisor:
</p>
<ul>
<li class="level1"> El certificado CSD (.CER)</li>
<li class="level1"> Clave privada (.KEY)</li>
<li class="level1"> Ingresar la contraseña ( Es la contraseña con la que se emitieron los Sellos Digitales ante el SAT)</li>
</ul>

<p>
<img src="/lib/exe/fetch.php?media=subircerkeycont.jpg" class="media" title="subircerkeycont.jpg" alt="subircerkeycont.jpg" />
</p>

</div>

<h3>Paso 4</h3>
<div class="level3">

<p>
Por último solo es necesario hacer clic en el botón de <b>Cancelar CFDIS</b> para que se lleve acabo la cancelación. Una vez realizado lo mencionado el sistema le brindara la opción para descargar el acuse de cancelación dando clic en <b>Descargar Acuse</b> (solo cuando la cancelación fue satisfactoria).
</p>

<p>
El sistema soporta una cantidad ilimitada de UUIDs, pero únicamente se puede realizar una cancelación en grupos de 500, entonces si se sube un CSV que contenga más de 5000 CFDIs a cancelar se van a recibir mas de 10 acuses de cancelación.
</p>

<p>
<em>Nota: En caso de le arroje una leyenda o código de error favor de comunicarse a el área de soporte técnico.</em>
</p>

<p>
<img src="/lib/exe/fetch.php?media=cancelarcfdi2014.jpg" class="media" title="cancelarcfdi2014.jpg" alt="cancelarcfdi2014.jpg" />
</p>

</div>

<h2>Recuperar PDF</h2>
<div class="level2">

</div>

<h2>Llamado</h2>
<div class="level2">

<p>
A continuación los parámetros a ser enviados para hacer recuperación de CFDI en formato PDF. &lt;font 9pt/arial;;rgb(0, 0, 0);;#ffffff>Nombre del método para recuperar los archivos de un CFDI en formato PDF es:&lt;/font>  <b>Recuperar PDF.</b> los parametros son los siguientes:
</p>

</div>

<h3>Parámetros.</h3>
<div class="level3">

<span class='np_break'> </span>
<div class="table"><table class="inline">
	<thead>
	<tr class="row0">
		<th class="centeralign">  PARÁMETRO  </th><th class="centeralign">  DESCRIPCIÓN  </th>
	</tr>
	</thead>
	<tr class="row1">
		<td class="centeralign">  id  </td><td class="col1">Identificador de referencia asignado por el cliente. Este parámetro no es requerido por el Web Service de iTimbre, sino que tiene como propósito ser utilizado por el cliente como método de control para asegurarse de recibir la respuesta solicitada. Se recomienda utilizar el número de folio interno del XML. </td>
	</tr>
	<tr class="row2">
		<td class="centeralign">  folio  </td><td class="col1">Folio de control del emisor </td>
	</tr>
	<tr class="row3">
		<td class="centeralign">  user  </td><td class="col1">Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró). </td>
	</tr>
	<tr class="row4">
		<td class="centeralign">  method  </td><td class="col1">Este parámetro consiste en el tipo de petición solicitado para generar el CFDI. Los valores posibles se encuentran en el catálogo de métodos. </td>
	</tr>
	<tr class="row5">
		<td class="centeralign">  cuenta  </td><td class="col1">Parametro para validar el tipo de cliente, y la cuenta en la que se recuperará el archivo PDF </td>
	</tr>
	<tr class="row6">
		<td class="centeralign">  password  </td><td class="col1">Contraseña generada por iTimbre al momento de registrar al emisor. </td>
	</tr>
</table>
<span class='np_break'> </span>
</div>
<p>
<b>Ejemplo Recuperar PDF</b>
</p>
<dl class="file">
<dt><a href="/doku.php?do=export_code&id=web-service&codeblock=33" title="Descargar trozo de código fuente" class="mediafile mf_json">RecuperarPDF.json</a></dt>
<dd><pre class="code file JSON">{
 "id_transaccion": 0,
 "cuenta": "Demo",
 "user": "administrador",
 "password": "Administr4dor",
 "method": "recuperar",
 "folio": "NumeroFolio",
 "allowCancelled": true
}



</pre><p> </p>
</dd></dl>




</div>

<h2></h2>
<div class="level2">

<p>
<br/>

</p>

</div>
iTimbre Wiki

Herramientas de usuario

Herramientas del sitio

Herramientas de la página
