Erros

`invalid_idempotency_key`

Toda escrita pede o cabeçalho Idempotency-Key com um UUID.

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

Status: HTTP 400 · Pedido mal formado.

Por que acontece

Toda escrita pede o cabeçalho Idempotency-Key com um UUID.

Como consertar

Mande Idempotency-Key: <uuid> em todo POST, PUT, PATCH e DELETE. Os SDKs mandam sozinhos.

A resposta

Envelope

{
  "ok": false,
  "data": null,
  "error": "Toda escrita pede o cabeçalho `Idempotency-Key` com um UUID.",
  "error_code": "invalid_idempotency_key",
  "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.