Documentación › Emisión de NF-e
NF-e por planilla y en lote
La planilla Básica de NF-e (una fila por producto), la de productos, y el lote con tipo nfe.
Para quien no integra: la NF-e por planilla, en el panel o por POST /v1/lotes
con "tipo": "nfe". La planilla no tiene un camino propio: cada nota se convierte en el cuerpo
de POST /v1/nfe en modo calcular, y el resultado por fila es el mismo en el
panel y en la API.
1. Productos, una sola vez
La planilla de notas cita el producto solo por el código. Un producto nuevo entra por la
planilla de productos (o POST /v1/produtos), con las mismas validaciones: NCM,
CEST y GTIN rechazados en la fila, con el motivo.
| Columna | Observación |
|---|---|
| Código | El código que va en la planilla de notas. |
| Descrição, NCM, Unidade | Obligatorias. |
| Origem | En blanco: 0 (nacional). |
| GTIN, CEST | Opcionales. |
| Perfil fiscal | El nombre de un perfil ya aprobado de la empresa (perfil_fiscal_nome). |
2. La planilla de notas (Básica)
Una fila por producto. Las filas con el mismo número en la columna Nota (1, 1, 2...) se convierten en una sola NF-e. Los datos de la nota (destinatario, pago) pueden quedar en blanco en las filas siguientes; un valor diferente en la misma nota pone toda la nota en error, explicando las dos filas.
| Columna | En la API |
|---|---|
| Nota | Agrupa las filas (no va a la API). |
| CPF ou CNPJ do destinatário | /destinatario/documento |
| Nome, CEP, Número | Solo para CPF: /destinatario/nome, /destinatario/endereco/cep y /numero. |
| Código do produto | /itens/*/produto |
| Quantidade, Valor unitário | /itens/*/quantidade, /itens/*/valor_unitario |
| Forma de pagamento | /pagamentos/0/forma. En blanco: Pix (pix_estatico). |
La Completa agrega operación, descuento, flete, quién paga el flete, e-mail del
destinatario e información adicional. Todo lo demás viene de reglas, y aparece en
ajustes: operación venda (venda_consumidor_final para CPF), presencia
outros, la serie de la planilla, modo calcular, sin flete.
Un ítem fuera de la cobertura del motor queda con error y el motivo del motor; la nota nunca sale con un valor estimado.
3. El lote de NF-e
POST /v1/lotes con "tipo": "nfe": JSON (itens = cuerpos de
POST /v1/nfe) o multipart con planilha. Mismos estados, mismo
ao_validar y el mismo webhook LOTE_EMISSAO_CONCLUIDO del lote de NFS-e. El
límite (5.000, o 100 con la clave de prueba) cuenta los ítems de las notas, no las
notas. GET /v1/lotes/{id}/itens trae una entrada por NF-e, con las linhas
de la planilla y el error de cada una (linha, coluna, campo).
4. El destinatario recibe el XML y el DANFE
Con e-mail del destinatario, Sudrel envía el XML y el DANFE en la autorización, y el XML de la cancelación y de la carta de corrección. La homologación no envía e-mail.