400 Bad Request
El request no cumple reglas de validacion. Ejemplos: falta webhook, faltan datos fiscales, formato invalido.
- Valida payload antes de enviar
- No hagas retries ciegos
- Corrige datos y vuelve a enviar
401 Unauthorized
La API key es invalida o fue revocada.
- Rota la key desde el dashboard
- Confirma que usas el header Bearer correcto
409 EXTERNAL_ID_CONFLICT
El mismo external_id fue enviado con un payload distinto. Esto protege la idempotencia.
- No reutilices ids entre gastos distintos
- Si reenvias, usa exactamente el mismo payload
Estados terminales fallidos
No todos los errores llegan como error HTTP. Un request aceptado puede terminar despues en failed.
- Escucha factura.failed por webhook
- Guarda reason_code y reason_message
- Trata estos casos como errores de negocio, no como errores de transporte
404 FILES_NOT_AVAILABLE
Intentaste pedir archivos finales antes de que la sesion terminara. Espera a completed antes de pedir XML o PDF.