Errores
Cómo reporta errores la API de Lynx — códigos de estado, el cuerpo de error y el caso 422 de regla de negocio.
El Edge Function de facturación devuelve un cuerpo JSON con un campo error cuando algo falla:
{ "error": "Falta org_id." }Códigos de estado
| Estado | Cuándo |
|---|---|
400 |
Entrada faltante o inválida — p. ej. sin org_id, sin invoice_ids, o más de 50 facturas. |
401 |
Sin sesión válida. |
403 |
El rol no alcanza — /integrations/* exige admin. |
404 |
El recurso no existe en esta organización, o la ruta es desconocida. |
405 |
Un método distinto de POST. |
422 |
Una regla de negocio — por ejemplo, una credencial que no autentica. El cuerpo trae message. |
500 |
Error inesperado del servidor. |
El 422 es una respuesta con sentido, no una caída
En /integrations/save, una clave que no autentica no se guarda y la llamada
responde 422 con un message. Trátalo como un resultado, no como un error de transporte.
Reintentos
/transmit acepta hasta 50 facturas y procesa cada una por separado: el fallo de una vuelve en su entrada de results con status: "error" mientras las demás sí salen. Reintenta solo las facturas que fallaron.