Skip to main content
O módulo de Vendas cobre o fluxo de faturamento: um Pedido de Venda é processado e dá origem a uma Nota Fiscal (de Produto ou de Serviço), que passa por uma etapa de inserção e depois por uma etapa separada de emissão junto à SEFAZ/prefeitura.

​
Criar uma Nota Fiscal de Produto (NF-e)

Use POST /v2/faturamento/nfe. A nota é criada em situação pendente de emissão.

Campos obrigatórios

codigoDaFilial, codigoDaNotaFiscal, tipoDeOperacao, naturezaDaOperacao, codigoDaFormaDePagamento, codigoDoCliente, nomeDoCliente e cep.
O parâmetro tipoDeOperacao define o sentido da nota: Exemplo:
Resposta:
Campos obrigatórios ausentes ou inválidos retornam 400 com o detalhe em notifications/errors.

​
Emitir a Nota Fiscal

Depois de conferida, use POST /v2/faturamento/nfe/processar/{id} para emiti-la de fato.
Esta rota emite/processa a Nota Fiscal de Produto (NF-e) de forma definitiva. Garanta que os dados foram conferidos — o documento passa a valer perante a SEFAZ/prefeitura e o cancelamento segue regras fiscais próprias.
Após a emissão, a nota consultada via GET /v2/faturamento/nfe/{id} já traz numeroDaNotaFiscalEletronica e chaveDaNotaFiscalEletronica preenchidos.

​
Nota Fiscal de Serviço (NFS-e)

POST /v2/faturamento/nfs segue a mesma lógica de duas etapas (inserir → processar/{id} para emitir), trocando os dados de produto pelos campos de serviço prestado (codigoDoServicoPrestado, valorDoServico, aliquotaISSRetido, entre outros).

​
Pedido de Venda

O POST /v2/faturamento/pedido registra um pedido de venda antes do faturamento. Use POST /v2/faturamento/pedido/processar/{numeroPedido} para processá-lo — etapa que tipicamente gera a Nota Fiscal correspondente.
Assim como a Nota Fiscal, o Pedido de Venda separa a inserção do dado da ação que efetiva a operação (processar) — confira sempre o resultado dessa segunda chamada antes de considerar a venda concluída.

​
Previsão de Serviços

Para contratos recorrentes de prestação de serviço, o cadastro de Previsão de Serviços (/v2/faturamento/previsao) permite configurar reajuste, condição de pagamento e emissão automática, gerando as Notas Fiscais de Serviço a cada ciclo sem a necessidade de recriar a cobrança manualmente.