desarrolladores.

servicio de timbrado cfdi.

 

Esta documentación es para timbrado de CFDIs normales.
Para CFDIs de retenciones, ingresa aquí.

El servicio de timbre fiscal tiene distintos endpoints que puedes utilizar dependiendo del tipo de procesamiento que necesitas:

Timbrado de un comprobante, donde obtienes solo el timbre
https://staging.diverza.com/stamp

Timbrado de un comprobante, donde obtienes todo el comprobante incluyendo su timbre
https://staging.diverza.com/stamp/complete

Cancelación de un comprobante timbrado desde nuestros servicios
https://staging.diverza.com/stamp/cancel

stamp

Al mandar tu petición de timbrado a ésta dirección, como mensaje de respuesta obtendrás solamente el complemento del timbre, tal y como se muestra a continuación.

Recuerda que todos los complementos se encuentran dentro del nodo <cfdi:Comprobante>

servicio de pruebas

  Servidor de prueba: https://staging.diverza.com/stamp
  Token de prueba: ABCD1234
  Metodo HTTP: POST
  Header HTTP: x-auth-token

ejemplo de la instrucción desde terminal

cURL https://staging.diverza.com/stamp -X POST --data @cfdi.xml -H "x-auth-token: ABCD1234" -i

encabezado de la respuesta

    Status Code: 200 OK
    Cache-Control: max-age=0, private, must-revalidate
    Connection: keep-alive
    Content-Length: 730
    Date: Thu, 14 Aug 2014 22:13:37 GMT
    Server: nginx/1.0.15

cuerpo de la respuesta

<tfd:TimbreFiscalDigital 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/TimbreFiscalDigital.xsd" selloSAT="K/037xM0jb64wNRVY5wAhTIs0z78ikLMduI6fH7S8hXAaSpwpCrP7qaoIcm9n8t8NvW4BnezvG5OdbMmQs9rZqHg2yE1CFgyAlMuMEFfyEb9LILzNVl7xCnNvPoCnhquPFLI+4SH+MLuFkfG4c1YBruQFeOyL4/r6PquI+ASnsc=" noCertificadoSAT="20001000000100005761" selloCFD="ElqnU5BgK66ZWCvJU6NMqA6bzAHpJZ1Va2Ilcp+eIit0BtGjHpzPp2UjpRYttpMc01YBQtbHo4ErG/WDJ3jHKsYZ455NJgRirYgHVGvcMV3UdQ0gSILGcubcjLgBIGYozKuipRcYqOtk3wwkzxQa3sEMZpLczNxirVLtbaX/vpU=" FechaTimbrado="2014-08-14T17:13:37" UUID="280b1fef-381b-4f05-939f-9c6def0c0a4b" version="1.0"/>

stamp/complete

Este servicio de timbrado responde con el comprobante CFDi completo, incluyendo el timbre.

Dependiendo de tu proceso de trabajo, encontrarás más conveniente recuperar el comprobante completo o solo el timbre.

servicio de pruebas

  Servidor de prueba: https://staging.diverza.com/stamp/complete
  Token de prueba: ABCD1234
  Metodo HTTP: POST
  Header HTTP: x-auth-token

ejemplo de la instrucción desde terminal

cURL https://staging.diverza.com/stamp/complete -X POST --data @cfdi.xml -H "x-auth-token: ABCD1234" -i

encabezado de la respuesta

    Status Code: 200 OK
    Cache-Control: max-age=0, private, must-revalidate
    Connection: keep-alive
    Content-Length: 4270
    Date: Fri, 15 Aug 2014 14:24:32 GMT
    Server: nginx/1.0.15

cuerpo de la respuesta

<?xml version="1.0" encoding="UTF-8"?>
<cfdi:Comprobante xmlns:cfdi="http://www.sat.gob.mx/cfd/3" xmlns:bfa2="http://www.buzonfiscal.com/ns/addenda/bf/2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" LugarExpedicion="CIUDAD DE MEXICO - D.F." metodoDePago="NO IDENTIFICADO" tipoDeComprobante="egreso" total="208197.77" Moneda="MXP" TipoCambio="1.0000" subTotal="208197.77" condicionesDePago="PAGO EN UNA SOLA EXHIBICION" certificado="MIIEdDCCA1ygAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDU4NjcwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTogSMOpY3RvciBPcm5lbGFzIEFyY2lnYTAeFw0xMjA3MjcxNzAyMDBaFw0xNjA3MjcxNzAyMDBaMIHbMSkwJwYDVQQDEyBBQ0NFTSBTRVJWSUNJT1MgRU1QUkVTQVJJQUxFUyBTQzEpMCcGA1UEKRMgQUNDRU0gU0VSVklDSU9TIEVNUFJFU0FSSUFMRVMgU0MxKTAnBgNVBAoTIEFDQ0VNIFNFUlZJQ0lPUyBFTVBSRVNBUklBTEVTIFNDMSUwIwYDVQQtExxBQUEwMTAxMDFBQUEgLyBIRUdUNzYxMDAzNFMyMR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGUk5OMDkxETAPBgNVBAsTCFVuaWRhZCAxMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2TTQSPONBOVxpXv9wLYo8jezBrb34i/tLx8jGdtyy27BcesOav2c1NS/Gdv10u9SkWtwdy34uRAVe7H0a3VMRLHAkvp2qMCHaZc4T8k47Jtb9wrOEh/XFS8LgT4y5OQYo6civfXXdlvxWU/gdM/e6I2lg6FGorP8H4GPAJ/qCNwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQUFAAOCAQEATxMecTpMbdhSHo6KVUg4QVF4Op2IBhiMaOrtrXBdJgzGotUFcJgdBCMjtTZXSlq1S4DG1jr8p4NzQlzxsdTxaB8nSKJ4KEMgIT7E62xRUj15jI49qFz7f2uMttZLNThipunsN/NF1XtvESMTDwQFvas/Ugig6qwEfSZc0MDxMpKLEkEePmQwtZD+zXFSMVa6hmOu4M+FzGiRXbj4YJXn9Myjd8xbL/c+9UIcrYoZskxDvMxc6/6M3rNNDY3OFhBK+V/sPMzWWGt8S1yjmtPfXgFs1t65AZ2hcTwTAuHrKwDatJ1ZPfa482ZBROAAX1waz7WwXp0gso7sDCm2/yUVww==" noCertificado="20001000000100005867" formaDePago="CONTADO" sello="ElqnU5BgK66ZWCvJU6NMqA6bzAHpJZ1Va2Ilcp+eIit0BtGjHpzPp2UjpRYttpMc01YBQtbHo4ErG/WDJ3jHKsYZ455NJgRirYgHVGvcMV3UdQ0gSILGcubcjLgBIGYozKuipRcYqOtk3wwkzxQa3sEMZpLczNxirVLtbaX/vpU=" fecha="2014-08-14T17:11:59" folio="1" serie="ECCAR" version="3.2" xsi:schemaLocation="http://www.buzonfiscal.com/ns/addenda/bf/2 http://www.buzonfiscal.com/schema/xsd/Addenda_BF_v20.xsd http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv32.xsd ">
  <cfdi:Emisor nombre="EMISOR DEMO S.A. DE C.V." rfc="AAA010101AAA">
    <cfdi:DomicilioFiscal codigoPostal="64000" pais="México" estado="Nuevo León" municipio="Monterrey" colonia="Centro" noInterior="4to Piso" noExterior="1921" calle="Diego Rivera" />
    <cfdi:RegimenFiscal Regimen="Regimen General de Ley Personas Morales" />
  </cfdi:Emisor>
  <cfdi:Receptor nombre="EMPRESA RECEPTORA DEMO S.A. DE C.V." rfc="BBB010101BBB">
    <cfdi:Domicilio codigoPostal="64000" pais="México" estado="Nuevo León" municipio="San Pedro Garza García" colonia="Magistrales" noInterior="3C" noExterior="1432" calle="Insurgentes" />
  </cfdi:Receptor>
  <cfdi:Conceptos>
    <cfdi:Concepto importe="0.00" valorUnitario="0.00" descripcion="CUBIERTA POLIPROPILENO 3&quot;" unidad="PZA" cantidad="1" />
  </cfdi:Conceptos>
  <cfdi:Impuestos totalImpuestosTrasladados="0.00">
    <cfdi:Traslados>
      <cfdi:Traslado importe="0.00" tasa="16" impuesto="IVA" />
    </cfdi:Traslados>
  </cfdi:Impuestos>
  <cfdi:Complemento>
    <tfd:TimbreFiscalDigital 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/TimbreFiscalDigital.xsd" version="1.0" UUID="16b34940-d1b9-401d-9c17-06ff93228282" FechaTimbrado="2014-08-15T09:24:32" selloCFD="ElqnU5BgK66ZWCvJU6NMqA6bzAHpJZ1Va2Ilcp+eIit0BtGjHpzPp2UjpRYttpMc01YBQtbHo4ErG/WDJ3jHKsYZ455NJgRirYgHVGvcMV3UdQ0gSILGcubcjLgBIGYozKuipRcYqOtk3wwkzxQa3sEMZpLczNxirVLtbaX/vpU=" noCertificadoSAT="20001000000100005761" selloSAT="Ll9PHSS4hYf+WQP+7qn4WNG04Fa9R+/vliXgmVlZpvOlYbXGccS8UsQZAg5bGElQh58RIRnfHo/zIaU3+5gFa59I4FmHxMQMdBKNrv1Lv0L5KkCDeiiv484XrF5ZQHYm5yJBrRhqVsbNQBfJZw1HoNo0j8IpAMZVl0/S+97Mraw=" />
  </cfdi:Complemento>
</cfdi:Comprobante>

stamp/cancel

Tenemos un apartado especial para la información relacionada con este servicio, te invito a visitar nuestra sección de Servicio de Cancelación.

Como referencia la petición de cancelación desde terminal se ejecuta así:

cURL -X POST "https://staging.diverza.com/stamp/cancel/AAA010101AAA/f7da0c0d-2c2e-4753-9d56-b0f080252eda" -H "x-auth-token: ABCD1234" -i

La respuesta te dará códigos de error, donde 200 OK y 0 Proceso realizado con éxito indican que la cancelación fue exitosa.