Glossário da Captura Fiscal
Termos transversais à recepção automática de NF-e, CT-e e NFS-e.
| Termo | Definição |
|---|---|
| AN | Ambiente Nacional da SEFAZ; origem de NF-e e CT-e via webservice NFeDistribuicaoDFe (SOAP). |
| ADN | Ambiente de Distribuição Nacional da SEFIN; origem da NFS-e padrão nacional (REST). |
| CBS | Contribuição sobre Bens e Serviços; tributo federal da Reforma Tributária que substitui PIS e COFINS. |
| Certificado A1 | Certificado digital em arquivo (.pfx); obrigatório para captura de NF-e/CT-e. |
| Chave de acesso | Identificador único de um documento autorizado: 44 dígitos (NF-e/CT-e), 50 (NFS-e), 42 (DPS). |
| Circuit breaker | Mecanismo que desativa automaticamente a captura de uma empresa após falhas consecutivas no polling. |
| DANFE / DANFSe | Documento Auxiliar (PDF) da NF-e / da NFS-e. |
| DFe | Documento Fiscal Eletrônico (termo guarda-chuva para NF-e, CT-e, NFS-e). |
| DPS | Declaração de Prestação de Serviço; pré-autorização que origina a NFS-e (chave de 42 dígitos). |
environmentSEFAZ | Campo que define o ambiente da SEFAZ na captura: Production ou Test. |
| IBS | Imposto sobre Bens e Serviços; tributo dual (estadual + municipal) que substitui ICMS e ISS. |
| Inbound | Recepção; documentos em que você é o destinatário/tomador (oposto de outbound/emissão). |
| IS | Imposto Seletivo; tributo federal da Reforma Tributária sobre bens/serviços nocivos. |
| Manifestação | Comunicação do destinatário/tomador à SEFAZ/SEFIN sobre um documento (ciência, confirmação, rejeição etc.). |
| NSU | Número Sequencial Único atribuído por CNPJ pelo ambiente nacional; base da deduplicação. |
| NT 2025.002 | Nota Técnica que define os eventos de manifestação da Reforma Tributária. |
| Resumo | Versão de NF-e só com metadados (sem XML completo), enviada antes da manifestação/liberação. |
| SEFAZ | Secretaria da Fazenda estadual; autoriza NF-e e CT-e. |
| SEFIN | Sistema responsável pela NFS-e padrão nacional. |
| SVRS | Sefaz Virtual do Rio Grande do Sul; recebe os eventos de manifestação da Reforma Tributária. |
| Webhook | Notificação HTTP POST enviada ao seu sistema quando um documento ou evento é capturado. |
x-hub-signature | Header de assinatura HMAC-SHA1 (sha1=<hex>) que valida a autenticidade do webhook. |
| Conta guarda-chuva | Conta principal da organização; agrupa usuários e todas as empresas (CNPJs). |
| Prestador | Quem emite a NFS-e (presta o serviço). |
| Tomador | Quem contrata o serviço — você, na recepção de NFS-e. |
| Polling | Consulta periódica da NFE.io ao ambiente nacional em busca de NSUs novos. |
| Cursor (cursor-based) | Paginação por ponteiro (no OData, $skiptoken = NSU do último item), em vez de página numérica. |
| OData | Protocolo de consulta usado na listagem de NF-e/CT-e ($filter, $top, $skiptoken). |
| Bulk export | Exportação em massa (XML/PDF/CSV) por período, processada de forma assíncrona. |
| Confirmação Tácita | Confirmação automática da operação por decurso de prazo, sem manifestação expressa. |
| NCM / CFOP | Classificações fiscais de produtos (NCM) e da natureza da operação (CFOP), presentes na NF-e. |