---
title: "Valida e mostra o XML sem emitir"
method: POST
path: "/v1/nfce/previas"
tags: ["Emissão de NFC-e"]
---

# Valida e mostra o XML sem emitir

`POST /v1/nfce/previas`

## Request

- Base URL: `https://api.sudrel.com.br/api`
- URL: `https://api.sudrel.com.br/api/v1/nfce/previas`
- Auth: HTTP bearer

Tudo o que a emissão confere, sem reservar número e sem assinar. O XML vem sem o QR Code, que entra depois da assinatura.

## Request body

- NfceEntrada: Pedido de NFC-e. Sem `modo`, a Sudrel calcula os tributos pelo produto cadastrado.
  - `empresa_id` string: Dispensado com chave restrita a uma empresa.
  - `referencia` string, required: A venda no seu sistema; única por empresa, ambiente e modelo.
  - `caixa` string, required: Identificador (ou id) do caixa: a série é a dele.
  - `modo` 'calcular' | 'informado' | 'conferir'
  - `consumidor` object: Opcional. Na BA, obrigatório a partir de R$ 500,00.
    - `documento` string: CPF ou CNPJ.
    - `nome` string
    - `email` string
  - `itens` object[], required: Modo calcular: `produto`, `quantidade`, `valor_unitario` e, se houver, `desconto`. Modos informado e conferir: o item da NF-e (`NfeEntrada`).
  - `pagamentos` object[], required
    - `forma` string, required: A forma da NF-e: dinheiro, pix, pix_estatico, cartao_credito, cartao_debito...
    - `valor` number: Num pagamento só, pode faltar (vira o valor da nota). O que passar do total vira troco.
    - `cartao` object: Cartão e Pix. Sem este grupo, POS sem integração.
      - `integrado` boolean
      - `cnpj_credenciadora` string
      - `bandeira` string: tBand, 2 dígitos.
      - `autorizacao` string
  - `informacoes_complementares` string

## Response `200`

`valida`, `numero_previsto`, `chave_prevista`, `totais` (com o `troco`), `xml`, `ajustes`, `erros` e `prontidao`.

- object

## Other responses

- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.

---

[API](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e.md) · [All operations](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/llms.txt) · [OpenAPI document](https://skmtc.dev/sudrel/apis/api-publica-sudrel-nfs-e-nf-e-e-ct-e/revisions/efd7baba9e37?raw)