Eventos

`return.close`

Devolução fechada.

Para agentes e terminalEsta página em Markdown: /eventos/return.close.mdÍndice das páginas: /llms.txt

A Kernos faz o POST no endereço cadastrado no webhook da conexão. Responda 2xx em até 10 s; sem isso, ela tenta de novo com espera crescente (30 s × 2ⁿ, até 1 h) por 3 dias. Confira a Kernos-Signature antes de confiar no corpo.

Cabeçalhos

Kernos-Signature string OBRIGATÓRIO

t=<unix>,v1=<hex>, com v1 = HMAC-SHA256(webhook_secret, "<t>.<corpo>"). Recuse t velho: barra o replay.

Kernos-Event-Id uuid OBRIGATÓRIO

O id do evento: o mesmo em cada nova tentativa. Use para não processar duas vezes.

Corpo

created_at data e hora OBRIGATÓRIO

data objeto OBRIGATÓRIO

13 campos

dispositions objeto

Na devolução: as unidades por destino decidido.

divergent_lines integer

Linhas em que o contado difere da nota.

id uuid

kind string

purchase para a nota do fornecedor, return para a devolução do cliente.

legs lista de objeto

Para onde cada parte vai.

4 campos

location_code string

place_kind string

qty integer

stock_status string

nfe_key string, ou nulo

receive_cancelled integer

receive_work_order_id uuid, ou nulo

sales_order_id uuid, ou nulo

status "closed"

stops integer

As paradas da OS de guarda.

work_order_id uuid, ou nulo

A OS de guarda que nasceu do fechamento.

written_off_lines integer

id uuid OBRIGATÓRIO

O id do fato, igual ao Kernos-Event-Id.

object objeto OBRIGATÓRIO

2 campos

id uuid

type "receipt"

tenant string OBRIGATÓRIO

A empresa, pelo endereço (minha-empresa em minha-empresa.kernos.com.br).

type "return.close" OBRIGATÓRIO

Exemplo

A forma do corpo, sem dado real.

return.close

{
  "created_at": "2026-10-03T12:00:00Z",
  "data": {
    "dispositions": {},
    "divergent_lines": 0,
    "id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
    "kind": "…",
    "legs": [
      {
        "location_code": "…",
        "place_kind": "…",
        "qty": 0,
        "stock_status": "…"
      }
    ],
    "nfe_key": "…",
    "receive_cancelled": 0,
    "receive_work_order_id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
    "sales_order_id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
    "status": "closed",
    "stops": 0,
    "work_order_id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
    "written_off_lines": 0
  },
  "id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
  "object": {
    "id": "3f1e0c8a-5b7d-4c21-9a3e-0b1c2d3e4f50",
    "type": "receipt"
  },
  "tenant": "…",
  "type": "return.close"
}