En esta página
clarify
Layout
Implementación de API para Timbrado de Comprobantes Digitales por internet via Layout - TXT.
Descargar Documento
Método de sellado y timbrado
Pruebas
La dirección donde se encuentra publicada la API para pruebas es la siguiente: URL:
https://apitest.paxfacturacion.com.mx/CFDI/40/sellar-timbrar
Producción
La dirección donde se encuentra publicada la API para producción es la siguiente: URL:
https://api.paxfacturacion.com.mx/CFDI/40/sellar-timbrar
Consulta las credenciales para pruebas en la sección Autenticación.
Petición
La estructura de la petición para enviar el layout es la siguiente:
Petición de tipo POST
Cuerpo de petición
co?Version@4.0|Serie@PRU|Folio@0000429|Fecha@2024-08-07T08:53:53|Sello@|NoCertificado@20001000000100005867|Certificado@|SubTotal@0|Moneda@XXX|Total@0|TipoDeComprobante@T|Exportacion@01|LugarExpedicion@31105
re?Nombre@FACTURACION|RegimenFiscal@601|Rfc@AAA010101AAA
rr?Nombre@FACTURACION|DomicilioFiscalReceptor@31105|RegimenFiscalReceptor@601|UsoCFDI@S01|Rfc@ AAA010101AAA
cc?ClaveProdServ@31181701|Cantidad@1.00|ClaveUnidad@XPK|Unidad@SERVICIO|Descripcion@Paquetes.|ValorUnitario@4310.34|Importe@4310.34|NoIdentificacion@ABCD123456789|ObjetoImp@01
cc?ClaveProdServ@31181701|Cantidad@1.00|ClaveUnidad@XPK|Unidad@SERVICIO|Descripcion@Paquetes|ValorUnitario@4310.34|Importe@4310.34|NoIdentificacion@ABCD234567891|ObjetoImp@01
cc?ClaveProdServ@31181701|Cantidad@1.00|ClaveUnidad@XPK|Unidad@SERVICIO|Descripcion@Paquetes|ValorUnitario@4310.34|Importe@4310.34|NoIdentificacion@ABCD345678912|ObjetoImp@01
Cabeceras de petición
| Key | Value |
|---|---|
Connection |
Keep-alive |
Content-Type |
plain/text;charset=UTF-8 |
Authorization |
Bearer |
Content-Length |
4672 |
Host |
apitest.paxfacturacion.com.mx |
User-Agent |
Apache-HttpClient/4.5.3 (Java/1.8.0_401) |
Accept |
application/json ó application/xml |
| [no cookies] |
Enviar el header Accept con este tipo de contenido: application/json ó application/xml. Depende del formato deseado en la salida.
Asegúrate de enviar los siguientes encabezados en tu solicitud:
-
Header Content-Type: Debe tener el valor plain/text;charset=UTF-8.
-
Header Authorization: Debe tener el valor Bearer Token.
El siguiente token es el que debes ingresar como valor en la llave Authorization.
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1bmlxdWVfbmFtZSI6IndzZGxfcGF4Iiwicm9sZSI6IlVzdWFyaW8iLCJuYmYiOjE3MDk2NTg1NDIsImV4cCI6MTcwOTY4MDE0MiwiaWF0IjoxNzA5NjU4NTQyLCJpc3MiOiJodHRwczovL3Rlc3QucGF4ZmFjdHVyYWNpb24uY29tLm14OjQ5MCIsImF1ZCI6Imh0dHBzOi8vdGVzdC5wYXhmYWN0dXJhY2lvbi5jb20ubXg6NDkwIn0.aDK-95uWY8rzBJE9zhS_CwEj0iAz64wpG83JyZ6z2C8
Respuesta
La respuesta dependerá de cómo se envíe el header Accept: en JSON o en XML.
<?xml version="1.0" encoding="utf-8"?>
<cfdi:Comprobante Version="4.0" Serie="104" Folio="1040037793" Fecha="2023-03-02T08:25:51" Sello="m1dE+yk2xxCltdeMwdL99XSSly12i0swDr0gY30WqD4d931YvO4dPajqbCeHzIoptachFNiMi8MBONPTh5pk0q4GsIZ/WdK9xqvhAb3Y6OnhA02yLo8rapSUESMsTg8zTaLF7mnZzrxoe7yLJMQ3QmUwXvbUFtzytTBPMF86B84=" FormaPago="99" NoCertificado="20001000000100005867" Certificado="MIIEdDCCA1ygAwIBAgIUMjAwMDEwMDAwMDAxMDAwMDU4NjcwDQYJKoZIhvcNAQEFBQAwggFvMRgwFgYDVQQDDA9BLkMuIGRlIHBydWViYXMxLzAtBgNVBAoMJlNlcnZpY2lvIGRlIEFkbWluaXN0cmFjacOzbiBUcmlidXRhcmlhMTgwNgYDVQQLDC9BZG1pbmlzdHJhY2nDs24gZGUgU2VndXJpZGFkIGRlIGxhIEluZm9ybWFjacOzbjEpMCcGCSqGSIb3DQEJARYaYXNpc25ldEBwcnVlYmFzLnNhdC5nb2IubXgxJjAkBgNVBAkMHUF2LiBIaWRhbGdvIDc3LCBDb2wuIEd1ZXJyZXJvMQ4wDAYDVQQRDAUwNjMwMDELMAkGA1UEBhMCTVgxGTAXBgNVBAgMEERpc3RyaXRvIEZlZGVyYWwxEjAQBgNVBAcMCUNveW9hY8OhbjEVMBMGA1UELRMMU0FUOTcwNzAxTk4zMTIwMAYJKoZIhvcNAQkCDCNSZXNwb25zYWJsZTogSMOpY3RvciBPcm5lbGFzIEFyY2lnYTAeFw0xMjA3MjcxNzAyMDBaFw0xNjA3MjcxNzAyMDBaMIHbMSkwJwYDVQQDEyBBQ0NFTSBTRVJWSUNJT1MgRU1QUkVTQVJJQUxFUyBTQzEpMCcGA1UEKRMgQUNDRU0gU0VSVklDSU9TIEVNUFJFU0FSSUFMRVMgU0MxKTAnBgNVBAoTIEFDQ0VNIFNFUlZJQ0lPUyBFTVBSRVNBUklBTEVTIFNDMSUwIwYDVQQtExxBQUEwMTAxMDFBQUEgLyBIRUdUNzYxMDAzNFMyMR4wHAYDVQQFExUgLyBIRUdUNzYxMDAzTURGUk5OMDkxETAPBgNVBAsTCFVuaWRhZCAxMIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQC2TTQSPONBOVxpXv9wLYo8jezBrb34i/tLx8jGdtyy27BcesOav2c1NS/Gdv10u9SkWtwdy34uRAVe7H0a3VMRLHAkvp2qMCHaZc4T8k47Jtb9wrOEh/XFS8LgT4y5OQYo6civfXXdlvxWU/gdM/e6I2lg6FGorP8H4GPAJ/qCNwIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQUFAAOCAQEATxMecTpMbdhSHo6KVUg4QVF4Op2IBhiMaOrtrXBdJgzGotUFcJgdBCMjtTZXSlq1S4DG1jr8p4NzQlzxsdTxaB8nSKJ4KEMgIT7E62xRUj15jI49qFz7f2uMttZLNThipunsN/NF1XtvESMTDwQFvas/Ugig6qwEfSZc0MDxMpKLEkEePmQwtZD+zXFSMVa6hmOu4M+FzGiRXbj4YJXn9Myjd8xbL/c+9UIcrYoZskxDvMxc6/6M3rNNDY3OFhBK+V/sPMzWWGt8S1yjmtPfXgFs1t65AZ2hcTwTAuHrKwDatJ1ZPfa482ZBROAAX1waz7WwXp0gso7sDCm2/yUVww==" CondicionesDePago="Anticipado" SubTotal="3866.00" Descuento="0.00" Moneda="USD" TipoCambio="18.344800" Total="3866.00" TipoDeComprobante="I" Exportacion="02" MetodoPago="PPD" LugarExpedicion="78395"
xmlns:cce20="http://www.sat.gob.mx/ComercioExterior20" xsi:schemaLocation="http://www.sat.gob.mx/cfd/4 http://www.sat.gob.mx/sitio_internet/cfd/4/cfdv40.xsd http://www.sat.gob.mx/ComercioExterior20 http://www.sat.gob.mx/sitio_internet/cfd/ComercioExterior20/ComercioExterior20.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:cfdi="http://www.sat.gob.mx/cfd/4">
<cfdi:Emisor Rfc="FIM970306PH5" Nombre="ONNERA MEXICO" RegimenFiscal="601" />
<cfdi:Receptor Rfc="XEXX010101000" Nombre="TORREZ ZAMORA, MIGUEL ANGEL" ResidenciaFiscal="BOL" NumRegIdTrib="2862563013" DomicilioFiscalReceptor="78395" RegimenFiscalReceptor="616" UsoCFDI="S01" />
<cfdi:Conceptos>
<cfdi:Concepto ClaveProdServ="48101615" NoIdentificacion="19085306" Cantidad="2.000" ClaveUnidad="H87" Unidad="UN" Descripcion="GE-H500 SA 220-240V 3N 60Hz-LAVAVAJILLAS DE CAPOTA N.Serie 8102626097;8102626100" ValorUnitario="1933.00" Importe="3866.00" Descuento="0.00" ObjetoImp="02">
<cfdi:Impuestos>
<cfdi:Traslados>
<cfdi:Traslado Base="3866.00" Impuesto="002" TipoFactor="Tasa" TasaOCuota="0.000000" Importe="0.000000" />
</cfdi:Traslados>
</cfdi:Impuestos>
</cfdi:Concepto>
</cfdi:Conceptos>
<cfdi:Impuestos TotalImpuestosTrasladados="0.00">
<cfdi:Traslados>
<cfdi:Traslado Base="3866.00" Impuesto="002" Importe="0.00" TasaOCuota="0.000000" TipoFactor="Tasa" />
</cfdi:Traslados>
</cfdi:Impuestos>
<cfdi:Complemento>
<cce20:ComercioExterior Version="2.0" ClaveDePedimento="A1" CertificadoOrigen="0" Incoterm="FOB" TipoCambioUSD="18.344800" TotalUSD="3866.00">
<cce20:Emisor>
<cce20:Domicilio Calle="Circuito Exportacion" NumeroExterior="201" Municipio="028" Estado="SLP" Pais="MEX" CodigoPostal="78395" />
</cce20:Emisor>
<cce20:Receptor NumRegIdTrib="2862563013">
<cce20:Domicilio Calle="CALLE ANTEZANA" NumeroExterior="432" Localidad="ENTRE VENEZUELA Y PACCIERI, COCHABA" Municipio="ENTRE VENEZUELA Y PACCIERI, COCHABA" Estado="BO" Pais="BOL" CodigoPostal="00000" />
</cce20:Receptor>
<cce20:Destinatario NumRegIdTrib="2862563013" Nombre="TORREZ ZAMORA, MIGUEL ANGEL">
<cce20:Domicilio Calle="CALLE ANTEZANA" NumeroExterior="432" Localidad="ENTRE VENEZUELA Y PACCIER" Municipio="ENTRE VENEZUELA Y PACCIER" Estado="BO" Pais="BOL" CodigoPostal="00000" />
</cce20:Destinatario>
<cce20:Mercancias>
<cce20:Mercancia NoIdentificacion="19085306" FraccionArancelaria="8302499902" CantidadAduana="232.000" UnidadAduana="01" ValorUnitarioAduana="16.66" ValorDolares="3866.00">
<cce20:DescripcionesEspecificas Marca="ASBER" Modelo="GE-H500" NumeroSerie="8102626097" />
<cce20:DescripcionesEspecificas Marca="ASBER" Modelo="GE-H500" NumeroSerie="8102626100" />
</cce20:Mercancia>
</cce20:Mercancias>
</cce20:ComercioExterior>
<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/TimbreFiscalDigitalv11.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Version="1.1" UUID="1D45F43A-9334-724B-8BA8-1B8A39F3EA18" FechaTimbrado="2024-03-04T16:36:06" RfcProvCertif="SPR190613I52" SelloCFD="m1dE+yk2xxCltdeMwdL99XSSly12i0swDr0gY30WqD4d931YvO4dPajqbCeHzIoptachFNiMi8MBONPTh5pk0q4GsIZ/WdK9xqvhAb3Y6OnhA02yLo8rapSUESMsTg8zTaLF7mnZzrxoe7yLJMQ3QmUwXvbUFtzytTBPMF86B84=" NoCertificadoSAT="30001000000400002495" SelloSAT="KKrnRIctrLO2v6H+/yw7PqSt/P3NlNDd3+Z0xo0GLlz++pD4FIbt6HMb8UXRpWgVUJiok2hqtVao8c25H27NiUP5ftPkWp2bZ+tLe23uBFMRpQM2kIvA7q4LwGlohA/eCNP743w9mTZVWKvaUTZLk700Zo1uYjA4X5tiSSu7xCwsi2Z7G+iwUB2iqZa5zgfiE1AYd09KVV3OKZdZ8KWUakeR3Va5eUYH8jLS3nfuhkTlLPH09AZTCLGL1lH+FXk05JWid4G35DNUsdUlHlMD/ISqvXRX//JShTS+dO5Oao/NhJ96VoflEnTb0UBXchS5uDPEVgN2OyvnJ+ya1Ki/bw==" />
</cfdi:Complemento>
</cfdi:Comprobante>
Códigos de error
A la hora de utilizar nuestro servicio es posible que te encuentres con ciertos errores. La siguiente lista tiene como objetivo ayudarte a comprender qué significa cada código de error y a solucionar problemas de manera más eficiente.
| Código | Descripción |
|---|---|
301 |
XML mal formado. |
302 |
Sello mal formado o inválido. |
303 |
Sello no corresponde a emisor o caduco. |
304 |
Certificado revocado o caduco. |
305 |
La fecha de emisión no está dentro de la vigencia del CSD del Emisor. |
306 |
El certificado no es de tipo CSD. |
307 |
El CFDI contiene un timbre previo. |
308 |
Certificado no expedido por el SAT. |
401 |
Que el rango de la fecha de generación no sea mayor a 72 horas para la emisión del timbre. |
402 |
Que exista el RFC del emisor conforme al régimen autorizado (Lista de validación de régimen) LCO. |
403 |
Que la fecha de emisión sea posterior al 01 de Enero 2011. |
509 |
Verifique el RFC del receptor. |
404 |
La fecha de emisión es posterior a la fecha de timbrado. |
100 |
El archivo de texto está mal formado. |
406 |
El nombre de documento no corresponde a ninguno del sistema. |
570 |
No se pudo recuperar el certificado del comprobante. |
622 |
El servicio no está disponible. |
817 |
No se pudo generar el sello del PAC. |
999 |
Error durante el registro del comprobante. |
96 |
Usuario o contraseña incorrecta. |
97 |
No hay créditos disponibles. |
El costo del Servicio es de 1.5 Créditos por petición.