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>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"> <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-retenciones&codeblock=0" 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>