Documentação › Emissão de NF-e
NF-e pela planilha e em lote
A planilha Básica de NF-e (uma linha por produto), a de produtos, e o lote com tipo nfe.
Para quem não integra: a NF-e pela planilha, no painel ou por POST /v1/lotes
com "tipo": "nfe". A planilha não tem caminho próprio: cada nota vira o corpo
de POST /v1/nfe no modo calcular, e o resultado por linha é o mesmo pelo
painel e pela API.
1. Produtos, uma vez só
A planilha de notas cita o produto só pelo código. Produto novo entra pela
planilha de produtos (ou POST /v1/produtos), com as mesmas validações: NCM,
CEST e GTIN recusados na linha, com o motivo.
| Coluna | Observação |
|---|---|
| Código | O código que vai na planilha de notas. |
| Descrição, NCM, Unidade | Obrigatórias. |
| Origem | Em branco: 0 (nacional). |
| GTIN, CEST | Opcionais. |
| Perfil fiscal | O nome de um perfil já aprovado da empresa (perfil_fiscal_nome). |
2. A planilha de notas (Básica)
Uma linha por produto. As linhas com o mesmo número na coluna Nota (1, 1, 2...) viram uma NF-e só. Dado da nota (destinatário, pagamento) pode ficar em branco nas linhas seguintes; valor diferente na mesma nota põe a nota inteira em erro, explicando as duas linhas.
| Coluna | Na API |
|---|---|
| Nota | Agrupa as linhas (não vai para a API). |
| CPF ou CNPJ do destinatário | /destinatario/documento |
| Nome, CEP, Número | Só para CPF: /destinatario/nome, /destinatario/endereco/cep e /numero. |
| Código do produto | /itens/*/produto |
| Quantidade, Valor unitário | /itens/*/quantidade, /itens/*/valor_unitario |
| Forma de pagamento | /pagamentos/0/forma. Em branco: Pix (pix_estatico). |
A Completa acrescenta operação, desconto, frete, quem paga o frete, e-mail do
destinatário e informações adicionais. Tudo o mais vem de regra, e aparece em
ajustes: operação venda (venda_consumidor_final para CPF), presença
outros, a série da planilha, modo calcular, sem frete.
Item fora da cobertura do motor fica com erro e o motivo do motor; a nota nunca sai com valor estimado.
3. O lote de NF-e
POST /v1/lotes com "tipo": "nfe": JSON (itens = corpos de
POST /v1/nfe) ou multipart com planilha. Mesmos estados, mesmo
ao_validar e o mesmo webhook LOTE_EMISSAO_CONCLUIDO do lote de NFS-e. O
limite (5.000, ou 100 com a chave de teste) conta os itens das notas, não as
notas. GET /v1/lotes/{id}/itens traz uma entrada por NF-e, com as linhas
da planilha e o erro de cada uma (linha, coluna, campo).
4. O destinatário recebe o XML e o DANFE
Com e-mail do destinatário, a Sudrel manda o XML e o DANFE na autorização, e o XML do cancelamento e da carta de correção. Homologação não manda e-mail.