Criar recebimento de mercadoria

{
  "external_store_id": "loja-principal",
  "external_supplier_id": "fornecedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "NF-2026-001",
  "lines": [
    {
      "external_item_id": "tomate",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 8.50
    }
  ],
  "external_user_id": "almoxarife_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z"
}

POST

api

public

vendors

{vendorId}

operations

goods-receipts

{
  "external_store_id": "loja-principal",
  "external_supplier_id": "fornecedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "NF-2026-001",
  "lines": [
    {
      "external_item_id": "tomate",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 8.50
    }
  ],
  "external_user_id": "almoxarife_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z"
}

string

obrigatório

API key do BOH com escopo inventory:write.

string

obrigatório

UUID do vendor.

string

UUID do estabelecimento de destino.

string

ID externo do estabelecimento.

string

UUID do fornecedor.

string

ID externo do fornecedor.

string

Quando ocorreu o recebimento (ISO 8601).

string

Número de referência ou nota fiscal.

string

Notas em texto livre.

object[]

obrigatório

Mostrar campos da linha

string

UUID do item.

string

ID externo do item.

number

obrigatório

Quantidade recebida.

string

obrigatório

UUID da unidade.

number

Custo unitário.

string

obrigatório

Ator responsável.

string

Chave de idempotência.

{
  "external_store_id": "loja-principal",
  "external_supplier_id": "fornecedor-fresco",
  "occurred_at": "2026-08-07T09:00:00.000Z",
  "reference": "NF-2026-001",
  "lines": [
    {
      "external_item_id": "tomate",
      "quantity": 10,
      "unit_id": "unit_kg_01...",
      "unit_cost": 8.50
    }
  ],
  "external_user_id": "almoxarife_01"
}

{
  "id": "gr_01...",
  "status": "COMPLETED",
  "store_id": "str_principal_01...",
  "occurred_at": "2026-08-07T09:00:00.000Z"
}

Visão geral

Identidade

Estabelecimentos

Fornecedores

Itens do catálogo

Sincronização de catálogo

Receitas

Recebimentos de mercadoria

Contagens de estoque

Eventos de perda

Transferências

Lotes de produção

Rastreamento

Níveis de reposição

Pedido sugerido

Pedidos de compra

Linhas de PC

Webhooks

Criar recebimento de mercadoria