Herramientas de usuario

Herramientas del sitio

Unable to set PDF file protection, CSPRNG Functions are not available. Use paragonie/random_compat polyfill or upgrade to PHP 7.
Command unknown: redirect

web-service

¡Esta es una revisión vieja del documento!


Web Service Timbrado

Introducción

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.

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

Servicio

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.

Registro

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

Producción: https://portal.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.

Conexión al Web Service

Para realizar la conexión con el Web Service de iTimbre es necesario proveer los siguientes datos en el llamado:

  • 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.
  • RFC del emisor.
  • 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.
  • Método. El método es la función a realizar. Actualmente se cuenta con los siguientes métodos:
    • cfd2cfdi → método que se utiliza para validar y timbrar un CFDI.
    • cancelarCFDI →método utilizado para cancelar un CFDI.
    • buscarCFDI → método utilizado para buscar un CFDI.
    • Parámetros. Los parámetros son datos adicionales que deben enviarse y dependen del método utilizado, los cuales se describen más adelante.

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: https://portalws.itimbre.com/itimbreprueba.php

Producción: https://portalws.itimbre.com/itimbre.php

Nota: 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.

Timbrado de CFDI 3.3

Las siguientes validaciones se realizan al XML:

  • La estructura del XML cumple con las especificaciones del SAT.
  • El Certificado de Sello Digital (CSD) del emisor haya sido emitido por el SAT.
  • El CSD esté vigente en la fecha de generación del Comprobante.
  • El Comprobante no haya sido validado previamente.
  • Que el RFC y número de certificado se encuentren en las lista de contribuyentes del SAT.
  • 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.
  • 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.
  • Que el documento cumpla con la especificación Técnica del Anexo 20 en sus apartados II y III.

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:

  • El número de folio fiscal asignado.
  • Fecha y hora de Validación.
  • El número de serie del certificado del SAT con el que se realizó la validación.
  • El sello digital del Timbre Fiscal Digital.

Llamado

Para realizar la validación y certificación de un CFDI se deben utilizar los métodos “cfd2cfdi”. 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:

Parámetros de la llamada

PARÁMETRO DESCRIPCIÓN
id 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. Por defecto se asignará 0.
method 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.
params Debe contener un arreglo con los parámetros: user, pass, RFC, y xmldata.
user Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró).
pass Contraseña generada por iTimbre asignada al emisor de manera automática. Se puede utilizar la contraseña máster del administrador de los emisores para cualquier RFC.
RFC RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas.
xmldata Contenido del XML con la información del comprobante.

Ejemplos

Ejemplo de codificación del llamado en formato JSON para certificación de CFDI v3.2:

llamado-nomina.json
{
    "id":"101",
    "method":"cfd2cfdi",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "xmldata":"<cfdi></cfdi>"
    }
}

Respuesta

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.

Parámetros de la Respuesta

PARÁMETROS DESCRIPCIÓN
id El mismo id que fue enviado en el llamado.
result Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo.
retcode 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.
UUID Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.
data XML timbrado.
acuse 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.
error En caso de existir, una descripción del error regresado al intentar validar el XML.
Otros Otros parámetros en caso de que se ocupen como referencia, por ejemplo el usuario que hizo el llamado, o algún timestamp.

Ejemplos

Ejemplo de respuesta válida arrojada por el Web Service:

respuesta.json
{
    "id":"101",
    "result": {
        "retcode":1,
        "UUID":"63C2042F-FAF0-48A0-A9AF-0304813D2528",
        "data":"<cfdi></cfdi>",
        "acuse":"<xml></xml>"
    }
}

Ejemplos de errores:

error1.json
{
    "id":0,
    "result":
    {
        "retcode":-1,
        "error":"Variable q faltante."
    }
}
error2.json
{
    "id":0,
    "result":    {
        "retcode":-1,
        "error":"Los datos recibidos no cumplen con el formato JSON correcto."
    }
}

Conexión al Web Service Retenciones y Pagos

Para realizar la conexión con el Web Service de iTimbre es necesario proveer los siguientes datos en el llamado:

  • 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.
  • RFC del emisor.
  • 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.
  • Método. El método es la función a realizar. Actualmente se cuenta con los siguientes métodos:
    • enviarRetencion → método que se utiliza para validar y timbrar un CFDI.
    • cancelarRetencion →método utilizado para cancelar un CFDI.
    • verificarEstatusRetencion→ Para recibir un acuse utilizando el parametro folio_seguimiento.
  • Parámetros. Los parámetros son datos adicionales que deben enviarse y dependen del método utilizado, los cuales se describen más adelante.

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=

Timbrado de Retenciones y Pagos

Las siguientes validaciones se realizan al XML:

  • La estructura del XML cumple con las especificaciones del SAT.
  • El Certificado de Sello Digital (CSD) del emisor haya sido emitido por el SAT.
  • El CSD esté vigente en la fecha de generación del Comprobante.
  • El Comprobante no haya sido validado previamente.
  • Que el RFC y número de certificado se encuentren en las lista de contribuyentes del SAT.
  • 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.
  • 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.

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:

  • El número de folio fiscal asignado.
  • Fecha y hora de Validación.
  • El número de serie del certificado del SAT con el que se realizó la validación.
  • El sello digital del Timbre Fiscal Digital.

Llamado

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:

Parámetros de la llamada

PARÁMETRO DESCRIPCIÓN
id 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. Por defecto se asignará 0.
method 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.
params Debe contener un arreglo con los parámetros: user, pass, RFC, y xmldata.
user Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró).
pass Contraseña generada por iTimbre asignada al emisor de manera automática. Se puede utilizar la contraseña máster del administrador de los emisores para cualquier RFC.
RFC RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas.
xmldata Contenido del XML con la información del comprobante.

Ejemplos

Ejemplo de codificación del llamado en formato JSON para certificación de retenciones:

llamado-retenciones.json
{
    "id":"101",
    "method":"enviarRetencion",
    "params": {
        "user":"miemail@midominio.com",
        "pass":"cabb17fb8536180e11af6dff0da42132",
        "RFC":"EEM010101XYZ",
        "xmldata":"<cfdi></cfdi>"
    }
}

Respuesta

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.

Parámetros de la Respuesta

PARÁMETROS DESCRIPCIÓN
id El mismo id que fue enviado en el llamado.
result Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo.
retcode 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.
UUID Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.
data XML timbrado.
acuse 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.
error En caso de existir, una descripción del error regresado al intentar validar el XML.
Otros Otros parámetros en caso de que se ocupen como referencia, por ejemplo el usuario que hizo el llamado, o algún timestamp.

Ejemplos

Ejemplo de respuesta válida arrojada por el Web Service:

respuesta.json
{
    "id":"101",
    "result": {
        "retcode":1,
        "UUID":"63C2042F-FAF0-48A0-A9AF-0304813D2528",
        "data":"<cfdi></cfdi>",
        "acuse":"<xml></xml>"
    }
}

Ejemplos de errores:

error1.json
{
    "id":0,
    "result":
    {
        "retcode":-1,
        "error":"Variable q faltante."
    }
}
error2.json
{
    "id":0,
    "result":    {
        "retcode":-1,
        "error":"Los datos recibidos no cumplen con el formato JSON correcto."
    }
}

Códigos de Respuesta

Código Validación
1002 El PAC envía versión del estándar no existente.
1004 La estructura del comprobante recibido no es válida.
1006 El Timbre proporcionado ya existe. UUID: <UUID>.
1009 El documento de retenciones no cuenta con los datos mínimos.
1010 Sello de certificación inválido.
1011 Sello del documento de retenciones inválido.
1012 TFD no válido.
1013 Versión del estándar no vigente.
1014 Comprobante con envío extemporáneo por vigencia de versión.
1015 Uso del complemento no vigente.
1016 Uso de complemento no permitido.
1017 Uso del certificado de FIEL no válido.

Nuevo esquema de Cancelación de CFDI 3.3

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”.

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.

Flujo del nuevo esquema de cancelación

esquema-de-cancelacion-de-facturas.jpg

Llamado

Los parámetros a ser enviados para realizar la cancelación y verificación de respuesta de aceptación o rechazo del XML Nombre del método para cancelar un cfdi es: cancelarCFDI. los parametros son los siguientes:

Parametros:

PARÁMETRO DESCRIPCIÓN
id 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.
method Nombre del método para cancelar un cfdi es: cancelarCFDI.
params Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client.
user Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró).
pass Contraseña generada por iTimbre al momento de registrar al emisor.
RFC RFCdel emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas.
pfx_pass Llave publica usada para abrir el PFX.
pfx_pem 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.
folios 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.


Ejemplos Cancelación.

Ejemplo de codificación de llamado en formato JSON (Un solo folio):

llamada-1cancelacion.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",
]
}
}

Ejemplos para la cancelación para más de un folio.

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

Respuesta:

Parametros para la respuesta:

Respuesta

PARÁMETROS DESCRIPCIÓN
id El mismo id que fue enviado en el llamado.
result Un arreglo dentro del cual se encuentran el resto de los parámetros que se describen abajo.
retcode 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.

El parametro redcode para retenciones y pagos tiene un significado distinto:
Si es 1 –> La cancelación ha sido exitosa y el acuse se regresa en el parámetro acuse_cancelacion
​Si la respuesta es 2 –> Significa que se activo la cancelación asincrona,entonces se regresa un folio de seguimiento en la variable folio_seguimiento.
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.
acuse Acuse del SAT en caso de que retcode sea 1 y que dentro del arreglo folios haya al menos un UUID cancelado.
fecha Fecha en que el SAT cancela el CFDI, en caso de existir acuse.
signature Firma del acuse del SAT, en caso de existir. Esta firma es parte del acuse, pero aquí se proporciona por separado por simplificación.
error 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.
folios Arreglo que contiene la lista de folios que se enviaron a cancelar y su correspondiente estatus.
UUID Identificador único del CFDI timbrado. Nota: es el único parámetro que se regresa en mayúsculas.

Ejemplo de respuesta válida arrojada por el Web Service (un folio):

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

Ejemplo de respuesta válida arrojada por el Web Service (varios folios):

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

Ejemplos de errores:

error1.json
{
    "id":"1001",
    "result": {
        "retcode":"305",
        "error":"La fecha de emision no esta dentro de la vigencia del CSD del Emisor."
    }
}
error2.json
{
    "id":"1001",
    "result": {
        "retcode":"303",
        "error":"Sello no corresponde a emisor."
    }
}


Valida CFDI:

Llamado

Estos son los parámetros a ser enviados para realizar la Validación del CFDI. Nombre del método para cancelar un cfdi es: validaCFDI. los parametros son los siguientes:

Parametros:

PARÁMETRO DESCRIPCIÓN
id 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.
method Nombre del método para consultar la respuesta de aceptación o rechazo por parte del receptor de la facura es: validaCFDI.
params Debe contener un arreglo con los parámetros: user, pass, status_sat, RFC, rfcReceptor y folios,client.
user Usuario del Portal de iTimbre con el que se ingresa al sistema (correo electrónico con el que se registró).
client Parametro para validar el tipo de cliente, valores permitidos cfdfactura (Clientes que utilizan el servicio de facturacion33.itimbre.com) integracion_libre (clientes que utilizan el servicio de portalws.timbre.com)
pass Contraseña generada por iTimbre al momento de registrar al emisor.
RFC RFC del emisor del CFDI. Nota: es el único parámetro que debe estar en mayúsculas.
xmldata Contenido del XML con la información del comprobante.

Ejemplo validacion del estatus del cfdi a cancelar en el SAT JSON: (Clientes que utilizan el servicio de facturacion33.itimbre.com)

llamado-validacfdi.json
{
  "id": "10001",
  "method": "validaCFDI",
  "params": {
    "RFC": "PZA000413788",
    "user": "demo",
    "pass": "demo",
    "client": "cfdfactura",
    "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=\"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\" Fecha=\"2020-05-27T13:54:41\" Folio=\"266861\" FormaPago=\"01\" LugarExpedicion=\"22210\" MetodoPago=\"PUE\" Moneda=\"USD\" NoCertificado=\"20001000000300022760\" Sello=\"aRgnDUJdY97V9NMJTOtyU15PGL9k2wDbnXQ9LS+Qoqw5FJrSwB5Y9uk0NDPwoihR5Fcdb26cKO6B6TstMQfhoaQJ3p26Oz2AdCjWLXf5gnYVS9sx/Ek1/9+ajvGEPjWRZHmOSSU6STSu10anerado3bYRGvP3N1dh3p2igaSI9W0c91Du7DqN6SEa/xJbkh6rzFjxwWg+siaI7op1DPq4YPzMOKp5UtcVzsCTAWkZgzUvx0ABp0gnrg7OT8c7kyHdzYtvuT45tkqe8wpHTeVaXyIAkXqhgtkvtXL8T2uXh6OhjyAZ6f4S6pdKTvX6U3kMRUsYo3tBsjLdpuquKVVSw==\" Serie=\"AA\" SubTotal=\"1.00\" TipoCambio=\"24.5544\" TipoDeComprobante=\"I\" Total=\"1.16\" 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=\"DEMO SA DE CV\" RegimenFiscal=\"601\" Rfc=\"PZA000413788\"/>   <cfdi:Receptor Nombre=\"Publico En Gral\" Rfc=\"XAXX010101000\" UsoCFDI=\"G03\"/>   <cfdi:Conceptos>     <cfdi:Concepto Cantidad=\"1\" ClaveProdServ=\"01010101\" ClaveUnidad=\"ACT\" Descripcion=\"Venta12345\" Importe=\"1.000000\" NoIdentificacion=\"01010101\" ValorUnitario=\"1\">       <cfdi:Impuestos>         <cfdi:Traslados>           <cfdi:Traslado Base=\"1\" Importe=\"00.16\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"/>         </cfdi:Traslados>       </cfdi:Impuestos>     </cfdi:Concepto>   </cfdi:Conceptos>   <cfdi:Impuestos TotalImpuestosTrasladados=\"00.16\">     <cfdi:Traslados>       <cfdi:Traslado Importe=\"00.16\" Impuesto=\"002\" TasaOCuota=\"0.160000\" TipoFactor=\"Tasa\"/>     </cfdi:Traslados>   </cfdi:Impuestos>   <cfdi:Complemento>     <tfd:TimbreFiscalDigital FechaTimbrado=\"2020-05-27T15:54:43\" Leyenda=\"iTimbreSandbox\" NoCertificadoSAT=\"20001000000300022323\" RfcProvCertif=\"SDA1109203R3\" SelloCFD=\"aRgnDUJdY97V9NMJTOtyU15PGL9k2wDbnXQ9LS+Qoqw5FJrSwB5Y9uk0NDPwoihR5Fcdb26cKO6B6TstMQfhoaQJ3p26Oz2AdCjWLXf5gnYVS9sx/Ek1/9+ajvGEPjWRZHmOSSU6STSu10anerado3bYRGvP3N1dh3p2igaSI9W0c91Du7DqN6SEa/xJbkh6rzFjxwWg+siaI7op1DPq4YPzMOKp5UtcVzsCTAWkZgzUvx0ABp0gnrg7OT8c7kyHdzYtvuT45tkqe8wpHTeVaXyIAkXqhgtkvtXL8T2uXh6OhjyAZ6f4S6pdKTvX6U3kMRUsYo3tBsjLdpuquKVVSw==\" SelloSAT=\"NGTLABDjeWfJ+ruCNshwy/xbIv6kxBuf9xtb3mBOXHKnigsdTA5zLyHQkB6gxXPsrKlaoDlH/gNnd48lVdiiZMn6+CDcey89erEbwocIr2lDPrUSbnzVxP1ywnAqpMh0AYD4ONXgwJhuwlLwyoI6nSCAe1QZbhqZV2AOghAishnFDPa+2mIP8Iqzgo/DNIqIu1p3NQDJZFSajnoTODlHlX5UNJJPuJHnswyDQDSQBrP2v0QzQmmVW8JGJi9aDUK5xtsuqUP8APqrhx4mlRKLorUJqK4PJTLxC/ftQldNdRpoG34pi8faILZKZRbeYVxk3io26K521nyCm+R7/AR4wg==\" UUID=\"EF8168FF-A405-4257-ACFF-A2745F1352D8\" 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>"
  }
}

Ejemplo validacion del estatus del cfdi a cancelar en el SAT JSON: (clientes que utilizan el servicio de portalws.timbre.com)

llamado-validacfdi.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>"
    }
}

Respuesta:

Ejemplos de respuesta metodo validaCFDI:

(
[ConsultaResult] stdClass Object
(
[CodigoEstatus] S - Comprobante obtenido satisfactoriamente.
[EsCancelable] Cancelable sin aceptación
[Estado] Vigente
[EstatusCancelacion]
)

)

Ejemplo de respuesta:

(
[ConsultaResult]
(
[CodigoEstatus] S - Comprobante obtenido satisfactoriamente.
[EsCancelable] Cancelable con aceptación
[Estado] Vigente
[EstatusCancelacion] En proceso
)

)

Ejemplo de respuesta negativa:

(

[ConsultaResult] stdClass Object

( [CodigoEstatus] N - 602: Comprobante no encontrado.

[Estado] No Encontrado )

Mensajes de Rechazo y Aceptación.

Código Observaciones.
N 601 La expresión impresa proporcionada no es válida. Este código de respuesta se presentará cuando la petición de validación no se haya respetado en el formato definido.
N 602 Este código de respuesta se presentará cuando el UUID del comprobante no se encuentre en la Base de Datos del SAT.
S Comprobante obtenido satisfactoriamente.“En Proceso”

Pendientes CFDI.

Llamado

A continuación los parámetros a ser enviados para hacer una revisión de CFDI pendientes. Nombre del método para revisar los pendientes de un CFDI es: pendientes CFDI. los parametros son los siguientes:

Parámetros.


web-service.1590707542.txt.gz · Última modificación: 2020/05/28 23:12 por