{
"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"
}
Recebimentos de mercadoria
Criar recebimento de mercadoria
Registra um recebimento de mercadoria de um fornecedor. Incrementa os níveis de estoque no armazém de destino.
POST
/
api
/
v1
/
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
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"
}