Conflict
Estado HTTP: 409 Conflict
Un conflicto de unicidad o de estado impidió que la operación se completara.
Códigos
ALREADY_VERIFIED
Se llamó a POST /v1/resend-verification para una dirección de correo cuya cuenta ya está activa (correo ya verificado). No hay nada que reenviar.
Qué hacer: No se requiere ninguna acción — la cuenta está verificada y puede usarse con normalidad.
CONFLICT (respaldo)
Se proporcionó un encabezado Idempotency-Key con un valor que ya fue usado para un payload de solicitud diferente, o se violó otra restricción de unicidad. Lee detail.
Qué hacer:
Reutilización de llave de idempotencia — Cada
Idempotency-Keydebe ser única por comprobante que se pretende crear. Si estás reintentando la misma factura después de un fallo, reutiliza la misma llave y el mismo payload — la API devolverá el comprobante existente (200). Si pretendes crear una factura nueva, genera una llave nueva (p. ej. un nuevo UUID).Otros conflictos — p. ej. un par duplicado de
(branch_code, issue_point_code)de emisor. Leedetailpara conocer la restricción específica.
Ejemplos de respuesta
{
"type": "https://docs.comprobify.com/errors/conflict",
"title": "Conflict",
"status": 409,
"code": "ALREADY_VERIFIED",
"detail": "Esta cuenta ya está verificada.",
"instance": "/v1/resend-verification"
}{
"type": "https://docs.comprobify.com/errors/conflict",
"title": "Conflict",
"status": 409,
"code": "CONFLICT",
"detail": "Reutilización de Idempotency-Key: el cuerpo de la solicitud no coincide con la solicitud original",
"instance": "/v1/documents"
}