POST
pruebas
produccion
Timbrado CFDI 4.0
Timbrado de CFDI 4.0 usando el proveedor Comercio Digital.
Body y ejemplo de request
{
"ambiente": "pruebas",
"xml_base64": "...",
"tipo_respuesta": "XML",
"email": null,
"zip": false
}
Response exitoso
{
"success": true,
"data": {
"success": true,
"codigo": "000",
"uuid": "98D94EA9-4B98-B545-A0E1-88E241B9D3DE",
"mensaje": "CFDI timbrado correctamente.",
"xml_timbrado": "...",
"ambiente": "pruebas"
},
"message": "CFDI timbrado correctamente.",
"request_id": "REQ-..."
}
Response con error y códigos posibles
{
"success": false,
"error": {
"code": "TIMBRADO_ERROR",
"message": "Error al timbrar el CFDI.",
"details": {
"codigo": "301",
"mensaje": "CFDI40101 - Error de validación SAT",
"codigo_sat": "CFDI40101",
"descripcion_sat": "Descripción encontrada en matriz de errores CFDI 4.0",
"ambiente": "pruebas"
}
},
"request_id": "REQ-..."
}
Códigos de error posibles
TIMBRADO_ERROR: El PAC rechazó la solicitud o devolvió un código distinto de 000.XML_BASE64_INVALID: El XML no está codificado correctamente en base64.CONFIG_URL_MISSING: No existe URL configurada para el ambiente seleccionado.
Notas importantes de uso
- El XML debe enviarse en base64 para evitar problemas de caracteres especiales.
- El ambiente pruebas o producción se toma del body.
- Las URLs y credenciales del proveedor deben venir desde .env.
- El código 000 del proveedor significa timbrado exitoso.
- Si el proveedor devuelve un código SAT, se debe buscar en sat_error_catalogos para mostrar una descripción entendible.