Skip to main content
La API usa el status HTTP como señal de éxito o error. Cuando una request falla, la respuesta incluye request_id para soporte y un objeto error estructurado.

Campos del error

Cada ítem de error.details puede incluir:

Códigos comunes

Las creaciones y ediciones de compras y las creaciones de ventas usan 422 BUSINESS_REQUIREMENT_UNMET para rechazos de negocio y 409 STATE_CONFLICT para transiciones incompatibles. Si tu integración trataba estos rechazos como 412, actualizala para leer los nuevos códigos. Los detalles conservan el código de dominio y el campo, por ejemplo COST_TARGET_NOT_FOUND en input.cost_target_purchase_id.

Manejar errores en TypeScript

Cuándo reintentar

Reintentá la misma request cuando:
  1. Recibís un error 5xx.
  2. Recibís RATE_LIMITED y ya esperaste el tiempo indicado en Retry-After.
  3. La conexión falló antes de recibir una respuesta.
Para escrituras idempotentes, reintentá con la misma Idempotency-Key. Para errores 4xx de validación o permisos, corregí el problema antes de volver a enviar.