Glosario fiscal

El vocabulario que usa esta documentación. Cada entrada dice qué es el término, dónde aparece en una llamada a stackin, y lleva a donde la documentación lo trata a fondo.

Documentos

NF-e

Factura electrónica, modelo 55 — el documento para la circulación de mercancía. Exige NCM y CFOP en cada ítem y la dirección completa del destinatario. Es la que acepta carta de corrección e inutilización.Ver en la API

NFS-e

Factura electrónica de servicio. No hay mercancía, así que no hay NCM ni CFOP: cada ítem solo necesita descripción e importe. No acepta carta de corrección.Ver en la API

DPS

Declaração de Prestação de Serviços — lo que envías al estándar nacional de NFS-e para que genere la factura. No armas la DPS: stackin la arma a partir de tus campos de negocio.

DANFE

La representación impresa de la NF-e, un PDF que por ley acompaña la mercancía. El documento con valor fiscal es el XML; el DANFE lo representa.

DANFSe

El equivalente del DANFE para NFS-e, generado por el ADN.

XML

El documento fiscal de verdad. Es el XML firmado que la SEFAZ autoriza y que vale jurídicamente — el PDF lo representa, no lo sustituye.

Quién participa

SEFAZ

La hacienda estatal que autoriza o rechaza la NF-e. Cada estado tiene la suya, y de ella vienen los códigos de rechazo que ves como 502.Ver en la API

ADN

Ambiente de Dados Nacional — el servicio federal por donde pasa la NFS-e del estándar nacional, en lugar del ayuntamiento.

Emitente

Quien emite la factura: la empresa dueña del certificado digital. Su identificador fiscal, dirección, régimen tributario y certificado viven en tu cuenta de stackin y se resuelven desde la API key — nunca viajan en el cuerpo de la petición.

Destinatário

Quien la recibe. Viaja en la petición como client_name, tax_id y, para NF-e, un recipient_address completo.Ver en la API

Campos e identificadores

Chave de acesso

Los 44 dígitos que identifican una NF-e de forma única en todo el país. Codifican el estado, año y mes, el identificador fiscal del emisor, el modelo, la serie, el número y un dígito verificador. Consultas y cancelas por ella — pero no es con lo que reemites.Ver en la API

Protocolo

El número que la SEFAZ devuelve al autorizar. Es la prueba de que el documento fue aceptado, y lo que guardas para demostrarlo después.

Série e número

La numeración secuencial de la NF-e, dentro de una serie. La SEFAZ exige que esa secuencia no tenga huecos: un número reservado y nunca usado es un vacío, y cerrarlo exige inutilizar el rango.Ver en la API

CFOP

Código Fiscal de Operações e Prestações — cuatro dígitos que dicen qué tipo de operación es (venta dentro del estado, fuera, devolución...). Obligatorio por ítem en la NF-e, y debe concordar con el estado del destinatario.Ver en la API

NCM

Nomenclatura Comum do Mercosul — ocho dígitos que clasifican la mercancía. Obligatorio por ítem en la NF-e.Ver en la API

CEST

El código usado cuando la mercancía está sujeta a sustitución tributaria.

CNPJ e CPF

El identificador fiscal de quien recibe: 14 dígitos para empresa, 11 para persona física. Viaja como tax_id, solo dígitos.Ver en la API

Eventos

Cancelamento

Anula una factura ya autorizada. Tiene plazo, exige una justificación de al menos 15 caracteres, y devuelve su propio protocolo. No devuelve el número de la serie.Ver en la API

CC-e

Carta de corrección electrónica. Corrige un error que no cambia el importe, el impuesto, el emisor, el destinatario ni la fecha — nombre de producto, datos de transporte, información complementaria. No altera la factura original: queda adjunta. Solo NF-e, como máximo 20 por factura.Ver en la API

Inutilização

Declara a la SEFAZ que un rango de números nunca se usó, cerrando el hueco en la secuencia. Solo para números que nunca llegaron a la SEFAZ — un número ya autorizado se cancela, no se inutiliza.Ver en la API

Reemissão

Reenvía una emisión que falló, por el id local del documento. Consume crédito como una emisión nueva, porque lo es.Ver en la API

Rejeição

Cuando la SEFAZ rechaza el documento. Viene con el código numérico de la autoridad — el cStat — y un mensaje. stackin pasa ambos.Ver en la API

Entornos

Homologação

El entorno de prueba de la SEFAZ. Un documento emitido aquí no tiene valor fiscal. Una API key se crea para un entorno y se queda en él.Ver en la API

Produção

El entorno real. Un documento emitido aquí cuenta, consume crédito, y hay que cancelarlo si está mal.Ver en la API

Contingência

El modo de emisión para cuando el autorizador está caído. Solo NF-e.