Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Onboarding do zero — NFS-e Inbound

Este guia leva você do zero até a primeira NFS-e capturada.

Pré-condição

Sem empresa cadastrada + certificado digital válido, o serviço não é ativado. A captura usa o certificado da empresa (mTLS) no ambiente nacional.

Cadência base​

1. Criar a conta  →  2. Criar a empresa (CNPJ)  →  3. Subir o certificado  →  4. Habilitar a recepção

Veja Conta → Empresa → Ativação. A recepção é habilitada por empresa.

Etapas​

1. Criar a conta principal​

Acesse app.nfe.io → Criar conta e confirme o e-mail. Detalhe em Criar conta.

2. Criar a empresa (CNPJ)​

No Painel → Empresas → + Nova Empresa, informe CNPJ, razão social, endereço, Inscrição Municipal e regime tributário. Detalhe em Criar empresa.

3. Subir o certificado digital​

Envie o certificado da empresa no painel. Ele é obrigatório — a captura no ambiente nacional o usa via mTLS. Veja Certificado digital.

4. Habilitar a recepção de NFS-e​

Cadastre a empresa no serviço de inbound — via painel ou API. Ao habilitar, a captura entra ativa (isActive: true).

5. Configurar o webhook (recomendado)​

Cada documento dispara um POST assinado (HMAC-SHA1, x-hub-signature) — veja Webhook — eventos.

6. Validar​

Aguarde (ou provoque) uma NFS-e contra o CNPJ e confira via GET .../inbound/nfse.

Autenticação​

As chamadas usam uma API Key com papel Nota Fiscal ou NFSeDist no header Authorization (sem prefixo) — veja Autenticação.

Checklist de prontidão​

  • Conta criada e e-mail confirmado
  • Empresa (CNPJ) cadastrada com Inscrição Municipal
  • Certificado digital válido enviado na empresa
  • Recepção habilitada (isActive: true)
  • Webhook configurado e validação HMAC implementada
  • Primeiro documento recebido e baixado

Veja também​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.