Códigos HTTP

Resumen de los códigos HTTP que devuelve la API de LX CloudPos y la acción recomendada para cada uno. Para la lógica de reintentos, ver estrategias de reintento.

Código	Significado	¿Reintentar?	Acción
`200`	OK	—	Consumir respuesta.
`201`	Creado	—	Comprobante emitido y encolado.
`202`	Aceptado (procesamiento asíncrono)	—	Esperar webhook o hacer polling.
`204`	OK sin cuerpo	—	Operación exitosa.
`400`	Bad Request (validación)	❌ No	Corregir el body.
`401`	Unauthorized	❌ No	Revisar la API key.
`403`	Forbidden	❌ No	Falta el scope requerido.
`404`	Not Found	❌ No	Verificar la clave o el recurso.
`409`	Conflict	❌ No	`Idempotency-Key` reutilizada con body distinto.
`413`	Payload Too Large	❌ No	Reducir el body por debajo de 256 KB.
`415`	Unsupported Media Type	❌ No	Usar `Content-Type: application/json`.
`422`	Unprocessable Entity	❌ No	Validación de dominio falló.
`429`	Too Many Requests	✅ Sí	Respetar el header `Retry-After`.
`500`	Internal Server Error	✅ Sí	Backoff exponencial.
`501`	Not Implemented	❌ No	Funcionalidad no disponible.
`502`	Bad Gateway	✅ Sí	Backoff.
`503`	Service Unavailable	✅ Sí	Backoff agresivo.
`504`	Gateway Timeout	✅ Sí	Backoff.