> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gestio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Referência

> Pedido de Venda, Nota Fiscal de Produto e de Serviço

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**.

<Card title="Campos obrigatórios" horizontal>
  `codigoDaFilial`, `codigoDaNotaFiscal`, `tipoDeOperacao`, `naturezaDaOperacao`, `codigoDaFormaDePagamento`, `codigoDoCliente`, `nomeDoCliente` e `cep`.
</Card>

O parâmetro **`tipoDeOperacao`** define o sentido da nota:

| Valor | Descrição |
| - | - |
| `Entrada` | Nota de entrada. |
| `Saída` | Nota de saída (venda), a mais comum. |
| `Simples Remessa` | Remessa sem transferência de propriedade. |

**Exemplo:**

```json theme={null}
POST /v2/faturamento/nfe
{
  "codigoDaFilial": 1,                          // obrigatório
  "codigoDaNotaFiscal": 55,                     // obrigatório - modelo cadastrado
  "tipoDeOperacao": "Saída",                    // obrigatório
  "naturezaDaOperacao": "Venda de mercadoria",  // obrigatório
  "codigoDaFormaDePagamento": 2,                // obrigatório
  "codigoDoCliente": 4821,                      // obrigatório
  "nomeDoCliente": "João Silva Materiais de Construção", // obrigatório
  "cep": "01310100",                            // obrigatório
  "produtos": [
    { "idProduto": 1234, "quantidade": 10, "valorUnitario": 3.50 }
  ]
}
```

**Resposta:**

```json theme={null}
{
  "success": true,
  "data": {
    "idNF": 91002,
    "codigoDaFilial": 1,
    "codigoDoCliente": 4821,
    "numeroDaNotaFiscalEletronica": null,
    "chaveDaNotaFiscalEletronica": null
  }
}
```

<Tip>
  Campos obrigatórios ausentes ou inválidos retornam `400` com o detalhe em `notifications`/`errors`.
</Tip>

## Emitir a Nota Fiscal

Depois de conferida, use `POST /v2/faturamento/nfe/processar/{id}` para emiti-la de fato.

<Warning>
  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.
</Warning>

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.

<Note>
  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.
</Note>

## 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.