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:- Recibís un error
5xx. - Recibís
RATE_LIMITEDy ya esperaste el tiempo indicado enRetry-After. - La conexión falló antes de recibir una respuesta.
Idempotency-Key. Para errores 4xx de validación o permisos, corregí el problema antes de volver a enviar.
