Timbrado ZIP

Servicio de timbrado que recibe un XML en formato .zip debido al tamaño del documento, el servicio únicamente devuelve la versión 1(v1) de repuesta. El servicio recibe un XML con un rango de entre 10,000 y 180,000 nodos concepto, y un tamaño máximo de 76 MB (en productivo).

💡 Notas Importantes

Peso máximo del XML antes de comprimir: Productivo 76 MB | Pruebas 40 MB
Numero de Conceptos: Productivo 180k | Pruebas 100k
Rate limit: Pruebas 1 req/min | Productivo 10 req/min (recomendado 5)
El servicio puede demorar hasta 2:30 min en entregar respuesta, por lo que recomendamos configurar un timeout de al menos 5 min

URL´s

🛠️ Pruebas:

https://services.test.sw.com.mx 📄

🚀 Productivo:

https://services.sw.com.mx 📄

ℹ️ Para realizar pruebas en volumen o con archivos de mayor peso, contacte a soporte@sw.com.mx o a su ejecutivo de cuenta para coordinar el soporte necesario y ajuste a la infraestructura.

Emisión Timbrado

Servicio que realiza el sellado y timbrado de un comprobante que se recibe en formato .zip

💡 Si buscas el mejor rendimiento, recomendamos utilizar el servicio de Timbrado.

🔗 Endpoint

Método	Ruta
POST	/cfdi/issue/v1/zip

🔐 Autenticación y Headers

Header	Value
Authorization	Bearer Token
Content-Type	multipart/form-data

🧾 Parámetros Form

Propiedad	Uso	Descripción
xml	Requerido	XML del comprobante a timbrar en formato .zip

Ejemplo Request

curl --location 'https://services.test.sw.com.mx/cfdi/issue/v1/zip' \
--header 'Authorization: Bearer Token' \
--form 'xml=@"/C:/Users/xml.zip"'

Ejemplo Response

{
    "data": {
        "tfd": "<?xml version=\"1.0\" encoding=\"utf-8\"?><tfd:TimbreFiscalDigital xsi:schemaLocation=\"http://www.sat.gob.mx/TimbreFiscalDigital http://www.sat.gob.mx/sitio_internet/cfd/TimbreFiscalDigital/TimbreFiscalDigitalv11.xsd\" Version=\"1.1\" UUID=\"237f6a41-41df-4152-860a-8d884e7bdbc8\" FechaTimbrado=\"2023-08-21T12:05:36\" RfcProvCertif=\"SPR190613I52\" SelloCFD=\"s4PSZTCcC6Tk2LrhZGsgYhhUG9MUrxPXjo4zCEZt/e3H6vaH2Qe0tsMSUtlyA2qjaMbSG1pw7HRxNOsbqkyz0zcz+JI6tYVwZXKjKMndw/ETpQlmhWZwgoRjGa/udl1LQ2jIGjBZZd21cSDsExbZ4Qpq7TukjyywEtjMWWXb3x40Ld+Y2Up3yUTOAeZNsvvx5WQgM6y2b42XUnlGj+q7rN8752rP8VQTEgSPAWi1wbrrnjZabiRVPpx33XZcLA1JIVDQn5YlWuhoWTRgfvBi9gml34v4Z2Q43t2CcY+T8ZtWys+IdfKnEBjxVqnXpCtLQUDa+JpsNOreUKvgpgdxvA==\" NoCertificadoSAT=\"30001000000500003456\" SelloSAT=\"V49zaIQNACpRJ/kTeDHpVW7g9zZalnaXmLzLubbSzztGHWe8N0158+d1kSv7Qo6YgmtnO9oEFT+F4g4Jyi5MymLj/JkNtVsp3d0koYbIlhBxdmKyo2XC8TxSLUsOi5FQLtgMa2AN3t4yt/xgWDVQDBBDiSHUQwoui6JnRStaUEXS03xanWyamismMb6rGQZhfIwKwbvXHrUHWRrNzJSaxZPl0VvDeE9Oh7J5Jy6UQHbVVW6zeWz1sasP37DsD3yF/hWbGM6prdzxZwPpCrswW4M881c+tssFFthNIWo/7y2+lRv0lclDTMSw05DRogk9dvmRIwe9Hxed7QaVDvaSYg==\" xmlns:tfd=\"http://www.sat.gob.mx/TimbreFiscalDigital\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" />"
    },
    "status": "success"
}

{
    "message": "El archivo es mayor al tamaño permitido, tamaño permitido 45 MB, tamaño del archivo xml 69 MB",
    "messageDetail": null,
    "data": null,
    "status": "error"
}

Atributo	Tipo	Descripción
message	String	Código regresado cuando existe un error.
messageDetail	String	Mensaje más descriptivo del error cuando existe uno.
data	object/null	Objeto con el TFD (TimbreFiscalDigital) cuando el timbrado es exitoso. El servicio retorna únicamente la respuesta V1.
status	String	“success” o “error”

Timbrado

Servicio que realiza el timbrado de un comprobante que se recibe en formato .zip