Código estable. Decide tu lógica sobre este campo, nunca sobre message.
message
Siempre
Texto en inglés para depuración humana. No lo muestres al pagador ni lo traduzcas para decidir un flujo.
field
Cuando aplica
El campo del cuerpo o la cabecera que causó el error.
request_id
Siempre
Identificador único de la request (req_ y 32 caracteres hexadecimales). Compártelo con Neat al pedir ayuda: con él encontramos tu request en nuestros registros. Nunca compartas tu API key, tu webhook_secret ni datos de tarjeta.
El request no se pudo aceptar como vino; el caso típico es un cuerpo que no coincide con su Content-Length.
400
INVALID_PATH
El path no es una URL válida.
414
INVALID_PATH
Un parámetro del path excede el largo permitido.
404
ROUTE_NOT_FOUND
La ruta no existe. Revisa el método y el path.
413
PAYLOAD_TOO_LARGE
El cuerpo supera 16 KiB.
415
UNSUPPORTED_MEDIA_TYPE
Falta Content-Type: application/json o el cuerpo viene con otro tipo.
500
INTERNAL_ERROR
Cualquier falla no clasificada del lado de Neat.
Todos menos el último son errores de tu lado: corrige el request antes de reintentar, sin reintento
automático. 429 RATE_LIMITED sí se reintenta, esperando lo que diga Retry-After, y
500 INTERNAL_ERROR también, con espera creciente.
Estos códigos aparecían en un borrador anterior del contrato de integración y no existen en v1:
IDEMPOTENCY_IN_PROGRESS, INSUFFICIENT_SCOPE. Si tu integración ya los maneja por haber seguido ese
borrador, puedes dejar el manejo; hoy no los vas a recibir.