El servicio de timbrado recibe una petición con el archivo a certificar codificado en Base64 y devuelve un objeto con el XML certificado.
A continuación se presenta un diagrama del funcionamiento general de la solución:

• Insumos: Archivo de texto (layout) o XML que se quiere enviar a certificar en Base64.
• Procesamiento: Proceso de validación del comprobante, certificación, envío y almacenamiento del mismo.
• Resultado: En caso de éxito el sistema devuelve archivo XML del CFDI con nodo TimbreFiscalDigital en formato de texto codificado en Base64 .

Diagrama 1: Funcionamiento general.

Cliente genérico de pruebas ideal para validar la estructura de tus archivos a certificar

• Cliente Web para pruebas de estructura

Documentación técnica Oficial

• Catálogos, XSD, xslt, guias de llenado

URL del servicio de pruebas de timbrado. (Endpoint)

• https://wsdemo.dinvbox.mx/timbrado/soap

WSDL

• https://wsdemo.dinvbox.mx/timbrado/wsdl

Métodos

• requestTimbrarCFDI
• requestCancelarCFDI

El método requestTimbrarCFDI es capaz de certificar cualquier archivo en formato XML o TXT (que cumpla con las estructuras soportadas por el servicio), el cual espera como parámetro un objeto de la siguiente forma:

Descripción del objeto de petición

Petición SOAP

A continuación se muestra una petición al método en formato XML para consumir el método requestTimbrarCFDI con SOAP 1.2

<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope" xmlns:ns1="https://wsdemo.dinvbox.mx/timbrado/soap" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:enc="http://www.w3.org/2003/05/soap-encoding">
  <env:Body>
    <ns1:requestTimbrarCFDI env:encodingStyle="http://www.w3.org/2003/05/soap-encoding">
      <param0 xsi:type="enc:Struct">
        <UserPass xsi:type="xsd:string">b9ec2afa3361a59af4b4d102d3f704eabdf097d4</UserPass>
        <UserID xsi:type="xsd:string">UsuarioPruebasWS</UserID>
        <emisorRFC xsi:type="xsd:string">RFC del emisor contenido en el archivo</emisorRFC>
        <text2CFDI xsi:type="xsd:string">Archivo codificado en Base64</text2CFDI>
        <generarTXT xsi:type="xsd:boolean">false</generarTXT>
        <generarPDF xsi:type="xsd:string">false</generarPDF>
        <generarCBB xsi:type="xsd:boolean">false</generarCBB>
      </param0>
    </ns1:requestTimbrarCFDI>
  </env:Body>
</env:Envelope>
                        

Descripción del objeto de respuesta

Una vez realizada la petición en caso de éxito nos devolverá un objeto con las siguientes propiedades

                                    TransID|58921
                                    noCertificadoSAT|00001000000200365214
                                    FechaTimbrado|2012-10-24T16:24:40
                                    UUID|6C60D1A9-9EF0-4B67-A962-8A2CB902F977
                                    selloSAT|SiyadAfQXi3VVGemME99TcIaUbuQfNElzAPsyd/Jlu2MIzWfocVyTvIjUb5rGlexbca/tf2bfXRi/krFqGODX00GnG3TDoAXMoGKbtV6oUD7EbIvyr+D0tE4/MF1EMqcdldatClrod/4xx8g0Pa0R9t+PtVVy0eF7y3SJ78q9+Q=
                                    selloCFD|WhU6wKjmAhfwehBHCbwVw2YANaFpjkJiV3rauEXllEMNpnaRnv4p8eBMAM1+3JxwVrFQK/+Gcy9FC3uTvOmF5HoMJGUui3ROW3wpleUCBbBdoJUVbWEVZs2UxgYewlpZ47A44O+Z9oHELFLmWdL0YEm8HF1WqoDBid8CF27tza8=
                                    Fecha|2012-10-24T10:11:12
                                    Serie|A
                                    Folio|1
                                

                                                    <?xml version="1.0" encoding="UTF-8"?>
                                                    <cfdi:Comprobante xmlns:cfdi="http://www.sat.gob.mx/cfd/3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xs="http://www.w3.org/2001/XMLSchema" xsi:schemaLocation="http://www.sat.gob.mx/cfd/3 http://www.sat.gob.mx/sitio_internet/cfd/3/cfdv32.xsd" version="3.2" fecha="2012-10-24T10:11:12" folio="1" serie="A" subTotal="100.00" descuento="0.00" total="116.00" Moneda="MXN" condicionesDePago="Contado" tipoDeComprobante="ingreso" noCertificado="20001000000100001703" certificado="MIIFLTCCBBWgAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDE3MDMwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTogSMOpY3RvciBPcm5lbGFzIEFyY2lnYTAeFw0xMDExMTkxOTM3MTRaFw0xMjExMTgxOTM3MTRaMIHGMSEwHwYDVQQDExhFRElUT1JJQUwgU0lTVEEgU0EgREUgQ1YxITAfBgNVBCkTGEVESVRPUklBTCBTSVNUQSBTQSBERSBDVjEhMB8GA1UEChMYRURJVE9SSUFMIFNJU1RBIFNBIERFIENWMSUwIwYDVQQtExxFU0k5MjA0Mjc4ODYgLyBIRUdUNzYxMDAzNFMyMR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGTlNSMDgxFDASBgNVBAsTC1N1Y3Vyc2FsQVZMMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQD16plVVRcPvh0jIoj95adxvBJKf/HleXgPA/24EtvrpsxWvoK9F7xXnJac35QXAzl9ZGdR4LI0ftA4N7FjaGRYipfec2MspbZUWswlB0n5GMhP6OdRYzxtLJXbk97+zasMu0XrmLWqRDdSDnCqPKRsbD7yYAr4gf0FFLkUjJUFAQIDAQABo4HqMIHnMAwGA1UdEwEB/wQCMAAwCwYDVR0PBAQDAgbAMB0GA1UdDgQWBBQ8LZCEQvmi5pC+z/Z8sd+VW12bsjAuBgNVHR8EJzAlMCOgIaAfhh1odHRwOi8vcGtpLnNhdC5nb2IubXgvc2F0LmNybDAzBggrBgEFBQcBAQQnMCUwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLnNhdC5nb2IubXgvMB8GA1UdIwQYMBaAFOtZfQQimlONnnEaoFiWKfU54KDFMBAGA1UdIAQJMAcwBQYDKgMEMBMGA1UdJQQMMAoGCCsGAQUFBwMCMA0GCSqGSIb3DQEBBQUAA4IBAQCZRRU8wfK3GrV1GO05mrh59KtxfayjyOkwFipqeUq0/9faaX0YwTaph/gkZnYhV5/hLCurKOoKgCmpvGIy2/0416V1ClJt4SsAvju4UlvITaloVUDMqICAJpRKK/lCygmbuRPgi4noHrIpLlh8HTwyiWHq//C1Zl1hSTDrCZK48krdagtUml3IepYJSlFnps8Rr/7thF5DAkCwoScV5gsC7TRTy/rzTZh+MeXVDD+gJTR8wSD0njdkP4DfLSYyWVBu42YyXRLd9LWpgTX3lXh7uiVeiuLP5mFbZLmfrby0sSzlzG+Mz3ohhzdmz5keu3LexIphJ/Hzu1+MbUzi2xb9" formaDePago="PAGO EN UNA SOLA EXHIBICIÓN" metodoDePago="Transferencía Electrónica" NumCtaPago="0000-HSBC" LugarExpedicion="Nuevo León, México." sello="WhU6wKjmAhfwehBHCbwVw2YANaFpjkJiV3rauEXllEMNpnaRnv4p8eBMAM1+3JxwVrFQK/+Gcy9FC3uTvOmF5HoMJGUui3ROW3wpleUCBbBdoJUVbWEVZs2UxgYewlpZ47A44O+Z9oHELFLmWdL0YEm8HF1WqoDBid8CF27tza8=">
                                                    <cfdi:Emisor nombre="EMPRESA DE MUESTRA WEB SERVICES S.A de C.V." rfc="ESI920427886">
                                                    <cfdi:DomicilioFiscal calle="Calle" noExterior="Número Ext." noInterior="Número Int." colonia="Colonia" localidad="Localidad" municipio="Municipio" estado="NUEVO LEON" pais="México" codigoPostal="66260"/>
                                                    <cfdi:ExpedidoEn calle="Calle sucursal" municipio="Nuevo León" estado="Nuevo León" pais="México" codigoPostal="77000"/>
                                                    <cfdi:RegimenFiscal Regimen="Personal moral régimen general de ley."/>
                                                    </cfdi:Emisor>
                                                    <cfdi:Receptor nombre="PUBLICO EN GENERAL" rfc="XAXX010101000">
                                                    <cfdi:Domicilio localidad="SAN PEDRO GARZA GARCIA" estado="NUEVO LEON" pais="MEXICO" codigoPostal="66260"/>
                                                    </cfdi:Receptor>
                                                    <cfdi:Conceptos>	
                                                    <cfdi:Concepto cantidad="1" unidad="Pieza" noIdentificacion="ec-0001" descripcion="Venta de equipo de computo" valorUnitario="50.00" importe="50.00"/>
                                                    <cfdi:Concepto cantidad="1" unidad="No aplica" descripcion="Asesoría" valorUnitario="50.00" importe="50.00"/>
                                                    </cfdi:Conceptos>
                                                    <cfdi:Impuestos>
                                                    </cfdi:Impuestos>
                                                    <cfdi:Complemento> 
                                                    <tfd:TimbreFiscalDigital xmlns:tfd="http://www.sat.gob.mx/TimbreFiscalDigital" version="1.0" UUID="6C60D1A9-9EF0-4B67-A962-8A2CB902F977" FechaTimbrado="2012-10-24T16:24:40" selloCFD="WhU6wKjmAhfwehBHCbwVw2YANaFpjkJiV3rauEXllEMNpnaRnv4p8eBMAM1+3JxwVrFQK/+Gcy9FC3uTvOmF5HoMJGUui3ROW3wpleUCBbBdoJUVbWEVZs2UxgYewlpZ47A44O+Z9oHELFLmWdL0YEm8HF1WqoDBid8CF27tza8=" noCertificadoSAT="00001000000200365214" selloSAT="SiyadAfQXi3VVGemME99TcIaUbuQfNElzAPsyd/Jlu2MIzWfocVyTvIjUb5rGlexbca/tf2bfXRi/krFqGODX00GnG3TDoAXMoGKbtV6oUD7EbIvyr+D0tE4/MF1EMqcdldatClrod/4xx8g0Pa0R9t+PtVVy0eF7y3SJ78q9+Q=" xsi:schemaLocation="http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/TimbreFiscalDigital/TimbreFiscalDigital.xsd"/></cfdi:Complemento>
                                                    </cfdi:Comprobante>
                                                

Respuesta SOAP

La respuesta en formato XML es similar al siguiente ejemplo

<?xml version='1.0' encoding='utf-8'?>
 <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:ns1="https://wsdemo.dinvbox.mx/timbrado/soap" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Body>
   <ns1:requestTimbrarCFDIResponse>
    <return xsi:type="SOAP-ENC:Struct">
     <xml xsi:type="xsd:string">Nodo con el archivo XML codificado en Base64</xml>
     <txt xsi:type="xsd:string">Nodo con el archivo TXT codificado en Base64</txt>
     <pdf xsi:type="xsd:string">Nodo con el archivo PDF codificado en Base64</pdf>
    </return>
    </ns1:requestTimbrarCFDIResponse>
   </SOAP-ENV:Body>
  </SOAP-ENV:Envelope>
                        

Listado RFC para pruebas

Nota importante:Se ha implementado la siguiente lista con la finalidad de replicar el ambiente productivo en el cual se aplican validaciones de LCO y LRFC.

Actualmente los listados de productivo que emite el SAT contienen la razón social sin régimen capital, por lo que se ha implementado de la misma forma en demo.

MI RAZON SOCIAL (Se omite el S.A de C.V)

Validez Obligaciones

• 1 – Habilitado para facturar (IVA exento, tasa 0% y 16%)
• 2 – Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Norte
• 3 – Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Sur
• 4 – Habilitado para facturar (IVA exento, tasa 0%, 8% y 16%) Zona Fronteriza Norte y Sur

El método requestCancelarCFDI de acuerdo al nuevo esquema de cancelación este metódo sólo realiza la solicitud de cancelación de un CFDI ante el SAT, hay nuevos métodos que se utilizarán de la mano de este, pero la documentación la tenemos reservada para nuestros usuarios y por lo tanto solo podrán visualizarla una vez que se les entreguen sus accesos a su panel administrador, desde el cual tenemos documentado todos los métodos relacionados a este proceso.

Nota: En ambiente productivo para poder enviar la solicitud de cancelación, es necesario que el usuario haya cargado previamente sus certificados en la liga: https://developers.facturacionmoderna.com/activar_cancelacion

Descripción del objeto de petición

Petición SOAP

A continuación se muestra una petición al método en formato XML para consumir el método requestCancelarCFDI con SOAP 1.2

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://wsdemo.dinvbox.mx/timbrado/soap" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
    <ns1:requestCancelarCFDI>
    <request xsi:type="SOAP-ENC:Struct">
        <UserPass xsi:type="xsd:string">b9ec2afa3361a59af4b4d102d3f704eabdf097d4</UserPass>
        <UserID xsi:type="xsd:string">UsuarioPruebasWS</UserID>
        <emisorRFC xsi:type="xsd:string">ESI920427886</emisorRFC>
        <uuid xsi:type="xsd:string">ABC1147C-D41E-4596-9C3E-45629B097CDB</uuid>
        <Motivo xsi:type="xsd:string">01</Motivo>
        <FolioSustitucion xsi:type="xsd:string">ABC1147C-D41E-4596-9C3E-45629B090000</FolioSustitucion>
    </request>
</ns1:requestCancelarCFDI>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
                        

Respuesta SOAP

La respuesta en formato XML es similar al siguiente ejemplo

Nuestro servicio de cancelación funciona mediante una cola, la cancelación de un comprobante se realiza de 2 a 3 minutos después de haberlo enviado a cancelar.

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://wsdemo.dinvbox.mx/timbrado/soap" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
    <ns1:requestCancelarCFDIResponse>
        <return xsi:type="SOAP-ENC:Struct">
            <Code xsi:type="xsd:string">GT05</Code>
            <Message xsi:type="xsd:string">UUID enviado a la cola de cancelancion, espere unos minutos.</Message>
        </return>
    </ns1:requestCancelarCFDIResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
                        

La propiedad text2CFDI enviada en el método requestTimbrarCFDI soporta los siguientes tipos de archivos

Vigente desde el 01 de Enero de 2022 y Única versión válida a partir del 01 de Enero de 2023

Se les recomienda revisar toda la documentación públicada por el SAT y estar al pendiente de las actualizaciones que pública el mismo, esta versión de CFDI, esta regulada con catálogos y cuenta con validaciones adicionales a las especificadas en el xslt por lo que es importante tambien revisen la matriz de validaciones.

Documentación oficial que deben revisar (Publicada por el SAT)

• Estructura/Esquema archivo .xsd
• Estándar (Anexo 20) archivo .pdf
• Secuencia cadena original archivo .xlst

• Guia de llenado
• Catálogos
• Matriz de errores
• Preguntas Frecuentes

Toda la documentación antes mencionada la localizan en: la documentación del SAT

El SAT suele actualizar sus ligas, en caso de que la actualmente publicada ya no este en uso, favor de corroborar directamente en el sitio oficial

La finalidad de la publicación de esta sección es meramente orientativa, para ayudar a los usuarios a agilizar su integración con el web service, sin embargo en caso de requerir ajustes o actualizaciones al código de las clases, es 100% responsabilidad de quien lo usa hacerlas.

Estimados usuarios les recalcamos que Dinvbox NO tiene ninguna obligación de realizar ajustes y/o actualizaciones a los EJEMPLOS GRATUITOS aquí publicados. Consulta nuestros ejemplos en GitHub https://github.com/facturacionmoderna

• PHP
• Ruby (Colaboración)
• C#
• Delphi 6
• Delphi 7
• Delphi 2009
• Java
• Perl
• Python
• Visual Basic 6
• Visual Basic .NET
• Bash
• Progress OpenEdge

• Validación de pruebas de layout
• Validador de sintaxis y forma del CFDI
• Análisis de mensajes SOAP

Lo primero que se necesita es tener instalada la librería OpenSSL (programa dedicado a la generación y tratado de claves, certificados y keyStore) para poder utilizar los comandos que nos ayudarán a crear las llaves de nuestros sellos digitales.

Linux

Instalar librería:

Debian/Ubuntu: #sudo apt-get install openssl

CentOS, Red Hat: #yum install openssl

Ejecutar las instrucciones:

Archivo key.pem

openssl pkcs8 -inform DER -in nombrearchivo.key -out nombrearchivo.key.pem -passin pass:contraseña

openssl x509 -inform DER -outform PEM -in ruta/nombreArchivo.cer -pubkey -out ruta/nombreArchivo.cer.pem

Windows

Descargar libreria: http://slproweb.com/products/Win32OpenSSL.html

Deberán descargar la versión según su sistema operativo, e instalar.

Ejecutar desde terminal

Archivo key.pem

openssl.exe pkcs8 -inform DER -in ruta/nombreArchivo.key -passin pass:contraseña -out ruta/nombreArchivo.key.pem

archivo cer.pem

openssl.exe x509 -inform DER -outform PEM -in ruta/nombreArchivo.cer -pubkey -out ruta/nombreArchivo.cer.pem
                        

Para poder certificar sus comprobantes a través del consumo de alguno de nuestro métodos de conexión deberá:

1. Elegir entre usar el conector Ctifac (genera costo de anualidad) o desarrollar su propia clase de conexión
2. Realizar el proceso de pruebas, mandar a revisión evidencia de 3 archivos procesados exitosamente (XML y PDF) al correo ws@dinvbox.mx
3. Esperar a que el área de soporte confirme las pruebas han sido aceptadas.
4. Concretar la compra, y enviar datos de personas autorizadas para solicitar soporte, datos de empresa o persona titular.
5. Realizar cambios de datos de conexión a los asignados para pase a producción.