«Este registo já existe.» ou «Outra pessoa alterou…» (conflict, 409)

Sintoma

Ao gravar aparece «Este registo já existe.», «Outra pessoa alterou estas definições. Atualize e repita.» ou uma mensagem semelhante ("mudou entretanto"). A API responde 409 conflict.

Causa

• Duplicado: já existe uma pessoa com esse email, um grupo com esse nome, um cliente com esse identificador ou um intervalo de endereços RADIUS já usado noutro cliente.
• Concorrência: outro administrador gravou o mesmo objeto depois de o abrir; a sua versão já não é a atual (o servidor compara a revisão esperada).
• Idempotência: numa integração, a mesma Idempotency-Key foi usada com um corpo diferente.
• Estado: a operação não se aplica ao estado atual (por exemplo, cancelar um pedido já decidido).

Solução

1. Atualize a vista (ou reabra o diálogo) para ler o estado atual.
2. Reveja o que mudou e repita a alteração, se ainda for necessária.
3. Num duplicado, escolha outro nome ou edite o objeto existente.
4. Numa integração, use uma chave de idempotência por operação e nunca a reutilize com outro corpo; leia o estado do recurso.

Quando escalar

Se o conflito se repete sem que ninguém mais esteja a editar, contacte o suporte com a hora, a vista e a mensagem.