desarrolladores.

servicio de timbrado cfdi-retenciones.

 

Esta documentación es para timbrado de CFDIs de retenciones.
Para timbrado de un comprobante normal de CFDI, ingrese aquí.

El servicio de timbre fiscal tiene distintos endpoints que puedes utilizar, en esta sección te mostraremos lo referente al servicio de timbrado.

Timbrado de un comprobante de retenciones, donde obtienes solo el timbre:

https://staging.diverza.com/api/v1/timbrar

Timbrado de un comprobante de retenciones, donde obtienes todo el comprobante incluyendo su timbre:

https://staging.diverza.com/api/v1/timbrar?completo

encabezados

Todas las peticiones requieren los siguientes ecabezados:

x-auth-token:

Incluirá el token que nosotros te proporcionaremos para que te reconozcamos y podamos brindarte el servicio. Para propósitos de pruebas, puedes usar el valor ABCD1234 asignado al RFC Emisor AAA010101AAA.

Content-Type:

Indicará el tipo de documento que deseas procesar:

Constancia de retención

  • application/vnd.sat.retencion+xml; charset=UTF-8

Content-MD5:

Contendrá el hash del archivo enviado en tu petición, expresado como una cadena de 32 caracteres. Te recomendamos ampliamente implementar este valor, ya que te proporciona un mecanismo de certeza adicional. Para propósito de pruebas, el valor de este atributo no será validado

x-refid:

Te permite identificar cada documento que envíes a procesar con nosotros. Por cada RefID único que utilices obtendrás el mismo complemento de timbre (y folio fiscal).
Conoce más sobre esta opción en la documentación sobre RefID.

timbrar.



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/api/v1/timbrar
  Token de prueba: ABCD1234
  Metodo HTTP: POST
  Header HTTP: x-auth-token
  Header HTTP: Content-MD5
  Header HTTP: Content-Type

ejemplo de la instrucción desde terminal

curl https://staging.diverza.com/api/v1/timbrar -X POST --data @cfdi.xml -H "Content-MD5: 7a3ef6-cdd777ffbb3662038ea4092c1c" -H "x-auth-token: ABCD1234" -H "Content-Type: application/vnd.sat.retencion+xml; charset=UTF-8" -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="2015-03-05T12:16:03" UUID="280b1fef-381b-4f05-939f-9c6def0c0a4b" version="1.0"/>



timbrar?completo.



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/api/v1/timbrar?completo
  Token de prueba: ABCD1234
  Metodo HTTP: POST
  Header HTTP: x-auth-token
  Header HTTP: Content-MD5
  Header HTTP: Content-Type

ejemplo de la instrucción desde terminal

curl https://staging.diverza.com/api/v1/timbrar?completo -X POST --data @cfdi.xml -H "Content-MD5: 7a3ef6cdd777ffbb3662038ea4092c1c" -H "x-auth-token: ABCD1234" -H "Content-Type: application/vnd.sat.retencion+xml; charset=UTF-8" -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"?>
<retenciones:Retenciones DescRetenc="Otro tipo de retención" CveRetenc="25"
    FechaExp="2015-03-05T12:16:02-06:00"
    Cert="MIIEdDCCA1ygAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDU4NjcwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTogSMOpY3RvciBPcm5lbGFzIEFyY2lnYTAeFw0xMjA3MjcxNzAyMDBaFw0xNjA3MjcxNzAyMDBaMIHbMSkwJwYDVQQDEyBBQ0NFTSBTRVJWSUNJT1MgRU1QUkVTQVJJQUxFUyBTQzEpMCcGA1UEKRMgQUNDRU0gU0VSVklDSU9TIEVNUFJFU0FSSUFMRVMgU0MxKTAnBgNVBAoTIEFDQ0VNIFNFUlZJQ0lPUyBFTVBSRVNBUklBTEVTIFNDMSUwIwYDVQQtExxBQUEwMTAxMDFBQUEgLyBIRUdUNzYxMDAzNFMyMR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGUk5OMDkxETAPBgNVBAsTCFVuaWRhZCAxMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2TTQSPONBOVxpXv9wLYo8jezBrb34i/tLx8jGdtyy27BcesOav2c1NS/Gdv10u9SkWtwdy34uRAVe7H0a3VMRLHAkvp2qMCHaZc4T8k47Jtb9wrOEh/XFS8LgT4y5OQYo6civfXXdlvxWU/gdM/e6I2lg6FGorP8H4GPAJ/qCNwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQUFAAOCAQEATxMecTpMbdhSHo6KVUg4QVF4Op2IBhiMaOrtrXBdJgzGotUFcJgdBCMjtTZXSlq1S4DG1jr8p4NzQlzxsdTxaB8nSKJ4KEMgIT7E62xRUj15jI49qFz7f2uMttZLNThipunsN/NF1XtvESMTDwQFvas/Ugig6qwEfSZc0MDxMpKLEkEePmQwtZD+zXFSMVa6hmOu4M+FzGiRXbj4YJXn9Myjd8xbL/c+9UIcrYoZskxDvMxc6/6M3rNNDY3OFhBK+V/sPMzWWGt8S1yjmtPfXgFs1t65AZ2hcTwTAuHrKwDatJ1ZPfa482ZBROAAX1waz7WwXp0gso7sDCm2/yUVww=="
    NumCert="20001000000100005867"
    Sello="RL4NSIttJa1ge5Cuztl10w/vboORtsaFgHKPoHM5MbSmsd7HtpAFVhGpeM5STz+igcdAzEt2rMfMOFRSSOX+I1X3m0TK+LCtExDyBPTPr2bvmrhSx/FN39RQNAHiykVXK0nF0Z2COCAVOgdShWLA6ZJqOQGgUmbWFcjCxUY6+Ns="
    FolioInt="TEST00001" Version="1.0"
    xsi:schemaLocation="http://www.sat.gob.mx/esquemas/retencionpago/1 http://www.sat.gob.mx/esquemas/retencionpago/1/retencionpagov1.xsd"
    xmlns:retenciones="http://www.sat.gob.mx/esquemas/retencionpago/1"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <retenciones:Emisor CURPE="AAAA010101HNLMNLD2"
        NomDenRazSocE="Empresa DEMO para Rentenciones S de TST" RFCEmisor="AAA010101AAA"/>
    <retenciones:Receptor Nacionalidad="Nacional">
        <retenciones:Nacional CURPR="VAHE820926HNLLRD02" NomDenRazSocR="PÚBLICO EN GENERAL S DE TST"
            RFCRecep="XAXX010101000"/>
    </retenciones:Receptor>
    <retenciones:Periodo Ejerc="2014" MesFin="6" MesIni="6"/>
    <retenciones:Totales montoTotRet="3500.00" montoTotExent="1000.00" montoTotGrav="13000.00"
        montoTotOperacion="14000.00">
        <retenciones:ImpRetenidos TipoPagoRet="Pago definitivo" montoRet="500.00" Impuesto="01"
            BaseRet="1000.00"/>
        <retenciones:ImpRetenidos TipoPagoRet="Pago provisional" montoRet="500.00" Impuesto="02"
            BaseRet="1000.00"/>
    </retenciones:Totales>
    <retenciones: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" selloSAT="K/037xM0jb64wNRVY5wAhTIs0z78ikLMduI6fH7S8hXAaSpwpCrP7qaoIcm9n8t8NvW4BnezvG5OdbMmQs9rZqHg2yE1CFgyAlMuMEFfyEb9LILzNVl7xCnNvPoCnhquPFLI+4SH+MLuFkfG4c1YBruQFeOyL4/r6PquI+ASnsc=" noCertificadoSAT="20001000000100005761" selloCFD="ElqnU5BgK66ZWCvJU6NMqA6bzAHpJZ1Va2Ilcp+eIit0BtGjHpzPp2UjpRYttpMc01YBQtbHo4ErG/WDJ3jHKsYZ455NJgRirYgHVGvcMV3UdQ0gSILGcubcjLgBIGYozKuipRcYqOtk3wwkzxQa3sEMZpLczNxirVLtbaX/vpU=" FechaTimbrado="2015-03-05T12:16:03" UUID="280b1fef-381b-4f05-939f-9c6def0c0a4b" version="1.0"/>
    </retenciones:Complemento>
    <retenciones:Addenda/>
</retenciones:Retenciones>



cancelar.

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