Fluxo de vendas
Visão geral do fluxo comercial no bitERP — do orçamento ao pedido, à nota e às contas a receber — e como os recursos se conectam.
Esta página é um mapa do fluxo comercial na API de Integrações. Ela costura os quatro recursos de venda e mostra como eles se ligam; cada etapa tem seu guia dedicado com os detalhes de campos.
As etapas
Orçamento ─────► Pedido de venda ─────► Nota / fatura ─────► Contas a receber
(quote) (sales-order) (invoice) (receivables)- Orçamento (quote) — uma proposta comercial com itens e valores, ainda sem compromisso financeiro.
- Pedido de venda (sales-order) — a venda confirmada. Pode nascer a partir de um orçamento.
- Nota / fatura (invoice) — o documento de faturamento gerado para o pedido.
- Contas a receber (receivables) — os valores a receber do cliente, com vencimentos.
Nenhuma etapa é obrigatória para a próxima existir — você pode criar um pedido sem orçamento, ou uma nota sem pedido. Os vínculos são opcionais e servem para rastreabilidade e validação.
Como os recursos se ligam
O bitERP não tem endpoints de "converter" ou "gerar automaticamente" na API de Integrações. Os vínculos são feitos por campos de referência que você envia no POST de cada etapa, e a API valida a coerência entre eles.
| De → Para | Como vincular | O que a API valida |
|---|---|---|
| Orçamento → Pedido | quote_id no POST /sales-orders | O orçamento existe e o product_type do pedido casa com o do orçamento |
| Pedido → Nota | sales_order_id no POST /invoices | customer_id, operation_type e product_type casam com o pedido; só 1 nota ativa por pedido |
| Item da nota → item do pedido | sales_order_item_id em cada item da nota | Rastreia a linha de origem |
| Nota → Contas a receber | array receivables[] no POST /invoices | A soma dos amount deve igualar o total líquido da nota |
Ao vincular, os itens não são copiados automaticamente — você sempre envia os
items[]da etapa atual. Oquote_id/sales_order_idapenas registra a origem e dispara as validações de coerência.
Gerando contas a receber
Contas a receber não são criadas sozinhas ao faturar. Elas surgem quando você inclui um array receivables[] no POST do pedido de venda ou da nota. Nesse caso vale uma regra rígida: a soma de receivables[].amount deve bater exatamente com o total (o total líquido, no caso da nota). Se você enviar mais de um, eles viram um parcelamento (compartilham installment_group_id).
A partir daí, o recebimento segue o ciclo de vida de Contas a receber: alocar transações, parcial/quitado, cancelar.
Do lado das compras
O espelho deste fluxo, para o que a empresa compra, é a nota de compra (purchase-invoice), ligada a um fornecedor e capaz de gerar contas a pagar pela mesma mecânica (array payables[]).