Inicio
Estructura de error
Todos los errores siguen el mismo formato:
{
"error": "INVALID_RFC",
"message": "El RFC proporcionado no es valido"
}Codigos HTTP
| Codigo | Significado |
|---|---|
| 400 | Request invalido (datos faltantes o mal formateados) |
| 401 | API Key invalida o faltante |
| 403 | Sin permisos para esta operacion |
| 404 | Recurso no encontrado |
| 409 | Conflicto (ej: factura ya cancelada) |
| 429 | Rate limit excedido |
| 500 | Error interno |
| 502 | Error del PAC (Facturapi no disponible) |
Codigos de error comunes
| Codigo | Descripcion | Solucion |
|---|---|---|
INVALID_RFC | RFC con formato invalido | Verificar formato: 12-13 caracteres alfanumericos |
CSD_EXPIRED | Certificado CSD vencido | Renovar CSD en portal del SAT y subir nuevo |
CSD_NOT_FOUND | No hay CSD configurado | Subir CSD en Configuracion > Certificados |
PAC_ERROR | Error del proveedor de timbrado | Reintentar en 30 segundos |
DUPLICATE_FOLIO | Folio duplicado | Sistema asigna folios automaticamente |
EFOS_BLOCKED | RFC en lista negra del SAT (69-B) | El RFC receptor esta en lista de operaciones simuladas |
PLAN_LIMIT | Limite de facturas del plan alcanzado | Upgrade de plan o esperar al siguiente ciclo |
RATE_LIMIT_EXCEEDED | Demasiadas solicitudes | Esperar segun header X-RateLimit-Reset |
Circuit Breaker
Timbrify implementa un circuit breaker para el PAC (Facturapi).
Si el PAC falla 5 veces consecutivas, el circuito se abre durante 60 segundos
y todas las solicitudes de timbrado retornan 502 PAC_UNAVAILABLE.
Despues de 60 segundos, se permite una solicitud de prueba. Si tiene exito, el circuito se cierra y el servicio se reanuda.