> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spedy.com.br/llms.txt
> Use this file to discover all available pages before exploring further.
# Emissão de NFC-e
> Como emitir Notas Fiscais de Consumidor Eletrônicas (NFC-e) pela API da Spedy.
A NFC-e (Nota Fiscal de Consumidor Eletrônica, modelo 65) é o documento
fiscal para **venda de produtos a consumidor final**, tipicamente em PDV de
varejo — o cupom fiscal eletrônico que substituiu o antigo ECF. Use
`POST /v1/consumer-invoices` para esse cenário. Se a operação é entre
empresas, ou venda a consumidor que não seja em balcão (ex.: e-commerce B2B,
remessa), use [Emissão de NF-e](/pages/guides/emissao-nfe).
Assim como a NF-e, a emissão de NFC-e é **assíncrona** — a resposta `2xx`
confirma apenas que a nota foi aceita. Veja [Síncrono vs
assíncrono](/pages/guides/sincrono-vs-assincrono) e [Ciclo de vida da
nota](/pages/guides/ciclo-de-vida-da-nota).
## Exemplo de criação
```bash cURL theme={null}
curl -X POST https://sandbox-api.spedy.com.br/v1/consumer-invoices \
-H "X-Api-Key: sua-chave-de-api" \
-H "Content-Type: application/json" \
-d '{
"integrationId": "venda-pdv-98765",
"effectiveDate": "2026-08-03T10:00:00Z",
"operationNature": "Venda de mercadoria",
"isFinalCustomer": true,
"receiver": {
"name": "Consumidor Final",
"federalTaxNumber": "11144477735"
},
"payments": [
{ "method": "creditCard", "amount": 100.0 }
],
"items": [
{
"code": "SKU-001",
"description": "Produto Exemplo",
"ncm": "61091000",
"cfop": 5102,
"unit": "UN",
"quantity": 1,
"unitAmount": 100.0,
"unitTax": "UN",
"quantityTax": 1,
"unitTaxAmount": 100.0,
"totalAmount": 100.0,
"taxes": {
"icms": { "origin": 0, "csosn": 102 },
"pis": { "cst": 49 },
"cofins": { "cst": 49 }
}
}
]
}'
```
Exemplo mínimo para empresas do **Simples Nacional** — a tributação por item
(`icms.csosn` 102, `pis`/`cofins` `cst` 49) tem o mesmo significado da NF-e;
veja [Emissão de NF-e](/pages/guides/emissao-nfe). A NFC-e ainda exige
`tokenId`/`csc` configurados na empresa para gerar o QR Code — veja
**Diferenças em relação à NF-e**, abaixo.
Os valores de tributação deste exemplo têm **fins didáticos** e não
substituem a orientação de um contador. A tributação correta depende do seu
regime, do produto (NCM), da operação e da UF — valide com o seu contador ou
responsável fiscal antes de emitir em produção.
## Diferenças em relação à NF-e
O payload de `POST /v1/consumer-invoices` (`CreateConsumerInvoiceDto`) tem a
mesma forma geral do payload de NF-e — `receiver`, `items`, `payments`,
`transport`, `total` — mas o uso muda porque o cenário é diferente:
* **Venda ao consumidor, não B2B.** `receiver` costuma trazer só o CPF (ou
nem isso, em venda sem identificação do destinatário), sem inscrição
estadual.
* **Pagamento é obrigatório para autorizar.** A SEFAZ exige o grupo de
pagamento em toda NFC-e. Em PDV, `payments[]` com `method` (`money`, `pix`,
`creditCard`, `debitCard`, `foodVoucher` etc.) e `amount` reflete a forma
real no caixa. O schema da API não marca `payments` como obrigatório, mas
sem ele a nota é rejeitada.
* **DANFE-NFC-e tem QR Code**, e o QR Code depende de duas credenciais
específicas configuradas na empresa, não no payload da nota:
| Configuração (`consumerInvoice`) | Uso |
| -------------------------------- | ---------------------------------------------------------------------------------------------- |
| `tokenId` | ID do token usado para gerar o QR Code do DANFE-NFC-e. |
| `csc` | Código de Segurança do Contribuinte (CSC), usado junto com o `tokenId` para assinar o QR Code. |
Sem `tokenId`/`csc` configurados corretamente para o ambiente (produção ou
homologação), a NFC-e **não é autorizada** — o QR Code é obrigatório e não
pode ser gerado. Configure-os em [Configuração
inicial](/pages/guides/configuracao-inicial).
## Contingência offline
NFC-e tem um modo de contingência que NF-e não tem da mesma forma: **emissão
offline** quando a SEFAZ está indisponível. Ele depende de uma configuração
explícita:
| Configuração (`consumerInvoice`) | Efeito |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `allowOfflineContingency` | Habilita a emissão em contingência offline (`tpEmis=9`) quando a SEFAZ está fora do ar. Exige `tokenId`/`csc` válidos, porque o DANFE em contingência é validado pelo QR Code, não por uma resposta síncrona da SEFAZ. |
Enquanto em contingência, a nota fica com `status: inContingent` até a
SEFAZ voltar a operar e o lote ser reprocessado — veja
[Contingência](/pages/guides/contingencia) para o comportamento completo e
como identificar notas nesse estado.
NFC-e **não tem carta de correção**. Diferente da NF-e
(`POST /v1/product-invoices/{id}/corrections`), não existe endpoint de
correção para `consumer-invoices` — qualquer erro em uma nota já
autorizada só pode ser resolvido por cancelamento (dentro do prazo legal)
seguido de nova emissão. Veja [Cancelamento, correção e
inutilização](/pages/guides/cancelamento-correcao-inutilizacao).
## Operações relacionadas
| Operação | Endpoint |
| -------------------------------------------- | ---------------------------------------------- |
| Listar notas | `GET /v1/consumer-invoices` |
| Obter a nota (por ID) | `GET /v1/consumer-invoices/{id}` |
| Baixar PDF (DANFE-NFC-e, com QR Code) | `GET /v1/consumer-invoices/{id}/pdf` |
| Baixar XML | `GET /v1/consumer-invoices/{id}/xml` |
| Consultar diretamente na SEFAZ (reconciliar) | `POST /v1/consumer-invoices/{id}/check-status` |
| Inutilizar faixa de numeração | `POST /v1/consumer-invoices/disablement` |
| Reenviar e-mail ao destinatário | `POST /v1/consumer-invoices/{id}/resend-email` |
Inutilização tem regras de prazo e uso específicas — veja [Cancelamento,
correção e inutilização](/pages/guides/cancelamento-correcao-inutilizacao).
## Próximos passos
* Comportamento em queda de SEFAZ: [Contingência](/pages/guides/contingencia)
* Estados possíveis da nota: [Ciclo de vida da nota](/pages/guides/ciclo-de-vida-da-nota)
* Cancelamento e inutilização: [Cancelamento, correção e inutilização](/pages/guides/cancelamento-correcao-inutilizacao)
* Configurar `tokenId`/`csc`: [Configuração inicial](/pages/guides/configuracao-inicial)