Dúvida: como emitir pedido ao fornecedor, aprovar e o que o documento não faz no estoque.

Dúvida: como lançar um pedido de compra?

Ambiente: Pedidos de Compra /apps/purchase. Tabela FAC009 (itens FAC010).

Pré-requisitos: fornecedor FAW01; produtos; condição de pagamento (usada depois, na NF); permissão purchase-orders.

Caminho

Abra a lista. Novo (ou POST /purchase após POST /purchase/reserve-code/:filialId se a tela reservar numeração).
Cabeçalho: fornecedor, data, data de entrega, condição de pagamento, observações.
Itens: produto, quantidade, preço unitário, total, data de entrega da linha.
Salvar → CREATED.
Se a empresa usa fluxo: Central /apps/purchase/approval ou PATCH /purchase/:id/approve | reject.
Status APPROVED libera o recebimento (NF). FINISHED quando a entrada confirmada fecha o ciclo.

Outros: PARKED, REFUSED, IN_APPROVEMENT_FLOW. Reabrir: PATCH .../reopen. Cancelamento: GET .../cancel-check antes de excluir.

O que o pedido não faz

Não cria FAPOB.
Não cria CP (isso é a NF).
Não reserva estoque de venda (reserva é PV/OP).
GET /purchase/projected-stock/:filialId é consulta de saldo projetado, não empenho.

Incoming no ATP é NF ainda CREATED, não este pedido.

Campos do item

Campo	Nota
Produto	SKU interno
Quantidade	na UM informada; a NF converte para UM de estoque
Preço unitário	base do custo na entrada após conversão
Entrega	prazo da linha

Eventos

PURCHASE_ORDER_CREATED · PURCHASE_ORDER_APPROVED — não estão em SdkEvent (a extensão SDK não assina pelo m3r.json).

API

Tabela completa: API.

Exemplo

1 000 kg farinha a R$ 2,40, condição 30/60, depósito será informado na NF:

{
  "filialId": "<hashid>",
  "supplierId": "<hashid>",
  "paymentConditionId": "<hashid>",
  "date": "2026-08-29",
  "deliveryDate": "2026-09-05",
  "items": [{ "productCode": "HML-IND-FARINHA", "quantity": 1000, "unitPrice": 2.4 }]
}

Saiba mais

Confirmar NF · Estoque — entrada

Pedido de compra