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.
Como proveedor autorizado de certificación con el número 68934, iTimbre realiza la validación y certificación (timbrado) de Comprobantes Fiscales Digitales generados por Internet (CFDI) 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.
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.
Antes de comenzar a realizar pruebas con el Web Service de iTimbre es necesario registrarse a través de las siguientes ligas:
Pruebas: https://pruebas.itimbre.com/registro/index.php?servicio=timbrado
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 son sistemas totalmente independientes aunque sean idénticos. 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.
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”.
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 (@#$).
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.
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”.
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.
En caso de necesitar ayuda vaya al módulo de “Soporte” y llene el formulario. En breve nos comunicaremos con usted.
Para realizar la conexión con el Web Service de iTimbre es necesario proveer los siguientes datos en el llamado:
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.
Direcciones del servicio:
Pruebas:http://portalws1.itimbre.com/itimbreprueba.php?q=
Las siguientes validaciones se realizan al XML:
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:
Para realizar la validación y certificación de un CFDI se deben utilizar los métodos “enviarRetencion”. 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:
Ejemplo de codificación del llamado en formato JSON para certificación de retenciones:
{ "id":"101", "method":"enviarRetencion", "params": { "user":"miemail@midominio.com", "pass":"cabb17fb8536180e11af6dff0da42132", "RFC":"EEM010101XYZ", "xmldata":"< cfdi>< /cfdi>" } }
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.
Ejemplo de respuesta válida arrojada por el Web Service:
{ "id":"101", "result": { "retcode":1, "UUID":"63C2042F-FAF0-48A0-A9AF-0304813D2528", "data":"< cfdi>< /cfdi>", "acuse":"< xml>< /xml>" } }
Ejemplos de errores:
{ "id":0, "result": { "retcode":-1, "error":"Variable q faltante." } }
{ "id":0, "result": { "retcode":-1, "error":"Los datos recibidos no cumplen con el formato JSON correcto." } }
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”.
Los parámetros a ser enviados para realizar la Cancelación del XML están estructurados de la siguiente manera:
Ejemplo de codificación de llamado en formato JSON (Un solo folio) para retenciones y pagos:
{ "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", ] } }
Ejemplo de codificación de llamado en formato JSON para recuperar acuse de cancelación de retenciones y pagos:
{ "id":1001, "method":"verificarEstatusRetencion", "params": { "user":"miemail@midominio.com", "pass":"cabb17fb8536180e11af6dff0da42132", "RFC":"EEM010101XYZ", "folio_seguimiento":"005", } }
Ejemplo del manejo de los folios:
$primer_folio = $folios[0] -> UUID; $estatus_primer_folio = $folios[0] -> status; $segundo_folio = $folios[1] -> UUID; $estatus_segundo_folio = $folios[1] -> status;
Ejemplo de respuesta válida arrojada por el Web Service para retenciones y pagos (un folio):
{ { "id":1001, "result": { "acuse_cancelacion":"< 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" } ] } } }