servicio de emisión cfdi-retenciones.

El servicio de emisión en REST de diverza, es usado por Conector Fiscal®

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

La siguiente información comprende la emisión de un comprobante sin sello, donde obtienes todo el comprobante; *disponible sólo para clientes de Conector Fiscal®

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

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.

emitir.

Ésta dirección es utilizada para el ambiente de pruebas del servicio de Conector Fiscal®, en donde los parámetros de entrada son los mismos que en /api/v1/timbrar, con la diferencia que deberás enviar un CFDi que no haya sido sellado.

Anexo a continuación, se encuentra un ejemplo de CFDi sin el sello del comprobante, es importante incluir los atributos de certificado y noCertificado ya que son necesarios para que el sistema de Conector Fiscal reconozca el número de serie y pueda firmar el comprobante con el CSD que hayas instalado en nuestro servicio de emisión y el cual estás indicando en el archivo XML como noCertificado. También es importante incluir el atributo de "sello", pero se deberá de agregar de esta forma:`sello="", es decir, sin valor, sólo el atributo, de otra manera recibiras un mensaje de error: "No válido según esquema".

La respuesta exitosa de este servicio envía todo el comprobante con el complemento de timbre.

servicio de pruebas

  Servidor de prueba: https://staging.diverza.com/api/v1/emitir
  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/emitir -X POST --data @CFD_Timbrar_Ret.xml -H "Content-MD5: 7a3ef6cdd777ffbb3662038ea4092c1c" -H "x-auth-token: ABCD1234" -H "Content-Type: application/vnd.sat.retencion+xml; charset=UTF-8" -i

ejemplo del CFDi sin sellar

<?xml version="1.0" encoding="UTF-8"?>
<cfdi:Comprobante 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=""
  noCertificado="20001000000100005867" formaDePago="CONTADO"
  sello=""
  fecha="2014-08-18T11:11:59" folio="1" serie="EDR" 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 http://www.sat.gob.mx/consumodecombustibles http://www.sat.gob.mx/sitio_internet/cfd/consumodecombustibles/consumodecombustibles.xsd"
  xmlns:bfa2="http://www.buzonfiscal.com/ns/addenda/bf/2" xmlns:cfdi="http://www.sat.gob.mx/cfd/3"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:consumodecombustibles="http://www.sat.gob.mx/consumodecombustibles">
  <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 S.A." 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="COMBUSTIBLE"
      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:Comprobante>

encabezado de la respuesta

    Status Code: 200 OK
    Cache-Control: max-age=0, private, must-revalidate
    Connection: keep-alive
    Content-Length: 4594
    Date: Mon, 18 Aug 2014 13:52:07 GMT
    Server: nginx/1.0.15

cuerpo de la respuesta

<?xml version="1.0" encoding="UTF-8"?>

<cfdi:Comprobante 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="myU+JLrM6WIsWQcDhnojOKA3so/f3DZSRBGBYeGjd5CiofHUh+5jdvwLlcNPyPbsjNw6ydpfNTYGelXnED1lNr0M6oIblMnJQLR9VLW4Duim+f19yJYV84SmJbjxfav+2F7L99P7gsmHGhWfrUB9ZR5pS81WikUbmZU/5lZrruA=" fecha="2014-08-18T08:52:07" folio="1" serie="EDR" 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 " xmlns:bfa2="http://www.buzonfiscal.com/ns/addenda/bf/2" xmlns:cfdi="http://www.sat.gob.mx/cfd/3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <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 S.A." 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="COMBUSTIBLE" 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"  selloSAT="Td7nVapc3EnDy/TgcQ7g7idomGHIO7YOtKHH3TudRpiA/GKSCLjSflKp6GUw8+axKKejYiwAKC7r+NLhcsYEoC3iVmvjuTPxaYOMqoDGRp7ZfRnu7CNVoKlKCzo+23J1shuutwwJN4oXwjkev/SgNS/9Plnnw/qV2wWBR5yoRGc=" noCertificadoSAT="20001000000100005761" selloCFD="myU+JLrM6WIsWQcDhnojOKA3so/f3DZSRBGBYeGjd5CiofHUh+5jdvwLlcNPyPbsjNw6ydpfNTYGelXnED1lNr0M6oIblMnJQLR9VLW4Duim+f19yJYV84SmJbjxfav+2F7L99P7gsmHGhWfrUB9ZR5pS81WikUbmZU/5lZrruA=" FechaTimbrado="2014-08-18T08:52:07" UUID="3de69e91-0b85-4d48-921e-2a97256bb116" version="1.0"/>
    </cfdi:Complemento>
    <cfdi:Addenda>
        <bfa2:AddendaBuzonFiscal version="2.0">
            <bfa2:TipoDocumento descripcion="Comprobante de Nomina" nombreCorto="N"/>
            <bfa2:CFD totalConLetra="Doscientos ocho mil ciento noventa y siete pesos 77/100 M.N."/>
        </bfa2:AddendaBuzonFiscal>
    </cfdi:Addenda>
</cfdi:Comprobante>

Como podemos darnos cuenta, el mensaje de respuesta de este servicio de emisión, nos entrega el CFDi completo, con sello y timbre fiscal.

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.