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.
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" } ] } } }