Erros

`idempotency_key_reused`

Esta Idempotency-Key já foi usada com outro corpo. Gere uma chave nova para uma escrita nova.

Para agentes e terminalEsta página em Markdown: /erros/idempotency_key_reused.mdÍndice das páginas: /llms.txt

Status: HTTP 409 · Conflito.

Por que acontece

A Idempotency-Key já foi usada com um corpo diferente. A chave identifica uma escrita; corpo novo é escrita nova.

Como consertar

Gere um UUID novo para cada escrita nova.
Repita a MESMA chave só para repetir a MESMA chamada (por exemplo, depois de uma falha de rede).

A resposta

Envelope

{
  "ok": false,
  "data": null,
  "error": "Esta `Idempotency-Key` já foi usada com outro corpo. Gere uma chave nova para uma escrita nova.",
  "error_code": "idempotency_key_reused",
  "field": null,
  "trace_id": "…"
}

Rotas que emitem este erro

Rota	O que faz
POST `/v1/objects/product`	Cadastra um item.
PATCH `/v1/objects/product/{id}`	Atualiza um item: descrição, SKU, unidade, atributos ou ativo.
POST `/v1/objects/receipt`	Abre um recebimento a partir da NF-e do fornecedor.
POST `/v1/objects/sales-order`	Cria um pedido de venda aberto, com a reserva feita.
POST `/v1/objects/sales-order/{id}/cancel`	Cancela um pedido, e o que já saiu da prateleira volta à posição.
POST `/v1/objects/work-order`	Abre uma OS de guarda, separação, contagem, movimento ou retirada.
POST `/v1/objects/work-order/{id}/cancel`	Cancela uma OS aberta ou em andamento, com o motivo.
PUT `/v1/webhook-endpoint`	Cadastra ou muda o webhook da empresa.
POST `/v1/webhook-endpoint/deliveries/{delivery}/resend`	Manda de novo uma entrega do webhook.