---
title: "Emite uma NFC-e (modelo 65)"
method: POST
path: "/v1/nfce"
tags: ["Emissão de NFC-e"]
---

# Emite uma NFC-e (modelo 65)

`POST /v1/nfce`

## Request

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

Responde na mesma chamada. Tributos calculados pela Sudrel a partir do produto
(`modo: "calcular"`, o padrão), informados (`informado`) ou conferidos
(`conferir`). Tudo é validado antes de reservar número: erros voltam juntos em
422 `validacao`. Empresa sem caixa ou sem os requisitos é 412
`empresa_nao_pronta` (veja `GET /v1/nfce/prontidao/{empresa_id}`).

## Headers

- `Idempotency-Key` string, required
- `Prefer` string
- `X-Sudrel-Simular` string

## 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 `201`

Autorizada, com o QR Code e os links do cupom.

- Nfce: A NFC-e. Os campos da NF-e (`status`, `chave_acesso`, `protocolo`, `rejeicao`, `ajustes`, `eventos`...) mais os do modelo 65.
  - `id` string
  - `referencia` string
  - `status` string: Os estados da NF-e. A lista cresce.
  - `modelo` 65
  - `modo` string
  - `serie` integer
  - `numero` integer
  - `chave_acesso` string
  - `protocolo` string, nullable
  - `valor_total` string, nullable
  - `troco` string, nullable
  - `caixa` object, nullable
    - `id` string
    - `identificador` string
  - `consumidor` object, nullable
    - `documento` string
    - `nome` string, nullable
  - `qr_code` string, nullable: O texto do QR Code (versão 3, ou 2 quando a UF recusa a 3).
  - `url_consulta` string, nullable: Consulta pela chave de acesso na SEFAZ da UF.
  - `cancelavel_ate` string, date-time, nullable
  - `links` object
    - `self` string
    - `xml` string
    - `danfe` string
    - `danfe_texto` string

## Other responses

- `202`: A SEFAZ não respondeu dentro da espera. Acompanhe por `GET /v1/nfce/{id}` ou pelo webhook.
- `400`: `idempotency_key_obrigatoria`.
- `401`: `nao_autenticado`: chave de API ausente, inválida ou revogada.
- `404`: `caixa_nao_encontrado` ou `empresa_nao_encontrada`.
- `409`: `referencia_duplicada` (o id da NFC-e existente vem em `nfce_id`) ou a mesma `Idempotency-Key` com outro corpo.
- `412`: `empresa_nao_pronta`: as pendências vêm em `itens`.
- `422`: `validacao` (lista em `erros`, com as regras do modelo 65 como `nfce_cfop_invalido` e `nfce_consumidor_obrigatorio`), `nfce_rejeitada` ou `nfce_denegada` (a nota completa vem em `nfce`, com `nfce_id`), `fora_de_cobertura` ou `conferencia_divergente`.
- `429`: `limite_de_requisicoes` (`retentavel: true`): 120 requisições por minuto por chave, janela fixa de 60 s. Sem `Retry-After`: espere a virada do minuto e repita a MESMA requisição (com a mesma `Idempotency-Key`).

---

[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)