Erros

`version_unknown`

A Kernos-Version pedida não existe. Use uma das versões declaradas no cabeçalho, ou não o mande.

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

Status: HTTP 400 · Pedido mal formado.

Por que acontece

O Kernos-Version pedido não existe.

Como consertar

Use uma versão declarada (hoje, 2026-10-03) ou não mande o cabeçalho: sem ele, vale a mais nova.

A resposta

Envelope

{
  "ok": false,
  "data": null,
  "error": "A `Kernos-Version` pedida não existe. Use uma das versões declaradas no cabeçalho, ou não o mande.",
  "error_code": "version_unknown",
  "field": null,
  "trace_id": "…"
}

Rotas que emitem este erro

Rota	O que faz
GET `/v1/events`	Lista os eventos públicos desde o último lido, do mais antigo para o mais novo.
GET `/v1/objects/product`	Lista o cadastro, com o saldo de cada item.
POST `/v1/objects/product`	Cadastra um item.
GET `/v1/objects/product/find`	Acha um item pelo EAN ou pelo SKU.
GET `/v1/objects/product/{id}`	Lê um item: saldo, posições, bloqueios, política e atributos.
PATCH `/v1/objects/product/{id}`	Atualiza um item: descrição, SKU, unidade, atributos ou ativo.
GET `/v1/objects/receipt`	Lista os recebimentos de um CD, os mais antigos primeiro.
POST `/v1/objects/receipt`	Abre um recebimento a partir da NF-e do fornecedor.
GET `/v1/objects/receipt/{id}`	Lê um recebimento, com as linhas da nota e o que foi contado.
GET `/v1/objects/sales-order`	Lista os pedidos de um CD, os mais antigos primeiro.
POST `/v1/objects/sales-order`	Cria um pedido de venda aberto, com a reserva feita.
GET `/v1/objects/sales-order/{id}`	Lê um pedido, com as linhas, os volumes e a nota.
POST `/v1/objects/sales-order/{id}/cancel`	Cancela um pedido, e o que já saiu da prateleira volta à posição.
GET `/v1/objects/shipment/{id}`	Lê um envio, com a transportadora, a doca e os volumes com rastreio.
GET `/v1/objects/stock`	Lista o saldo de um CD, posição por posição e lote por lote.
GET `/v1/objects/work-order`	Lista as OS de um CD, pela visão de quem pede.
POST `/v1/objects/work-order`	Abre uma OS de guarda, separação, contagem, movimento ou retirada.
GET `/v1/objects/work-order/{id}`	Lê uma OS, com a origem e as paradas.
POST `/v1/objects/work-order/{id}/cancel`	Cancela uma OS aberta ou em andamento, com o motivo.
GET `/v1/requests`	Lista os últimos pedidos feitos com a chave, o mais novo primeiro.
GET `/v1/requests/{request_id}`	Lê um pedido do registro, com o corpo da resposta.
GET `/v1/webhook-endpoint`	Lê o webhook da empresa e as últimas 50 entregas.
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.
POST `/v1/webhook-endpoint/ping`	Manda agora um evento de teste ao webhook e diz o que ele respondeu.