Conflito (409)

Status: 409 Conflict · type: https://api.nobur.com.br/errors/conflict

Quando acontece

• Já existe um registro com o mesmo dado único, como uma parte com o mesmo CPF ou CNPJ.
• O registro está num estado que não permite a operação, como excluir uma etapa do funil que ainda tem negócios.
• A mesma Idempotency-Key foi reenviada enquanto a primeira requisição com ela ainda era processada (conflict.idempotency_key).

O que fazer

Leia o registro de novo e decida com base no estado atual: use o registro que já existe em vez de criar outro, ou mude o estado antes de repetir a operação. Repetir a mesma requisição sem mudar nada dá o mesmo erro. Para conflict.idempotency_key, espere a primeira requisição terminar e reenvie com a mesma chave: a resposta dela é devolvida.

Exemplo

{
  "type": "https://api.nobur.com.br/errors/conflict",
  "title": "Resource Conflict",
  "status": 409,
  "detail": "duplicate party",
  "instance": "/public/v1/parties",
  "code": "conflict.party_exists",
  "request_id": "req_abc123",
  "timestamp": "2026-02-15T12:00:00Z",
  "documentation_url": "https://docs.nobur.com.br/docs/api/erros/conflict"
}