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

Conta, empresa, certificado e ativação

A recepção automática não é ativada na conta — ela é ativada em cada empresa (CNPJ), e depende do certificado digital da empresa.

Pré-condição obrigatória

Sem empresa cadastrada + certificado digital válido, o serviço não é ativado. A captura no ambiente nacional usa o certificado da empresa (mTLS); sem ele, a empresa é desativada automaticamente (deactivationReason de certificado).

O modelo​

Conta (guarda-chuva)              ← uma por organização; agrupa usuários e CNPJs
  └─ Empresa (CNPJ)               ← cadastrada na conta; uma ou mais
       └─ Certificado digital     ← enviado na empresa — OBRIGATÓRIO para a captura
            └─ Distribuição ativada  ← por tipo (NF-e / CT-e / NFS-e), em cada empresa

Cadência base (todas as jornadas seguem esta ordem)​

  1. Criar a conta (guarda-chuva da organização).
  2. Criar a empresa (CNPJ) na conta.
  3. Subir o certificado digital da empresa.
  4. Habilitar a recepção (por tipo de documento).
  • A conta principal agrupa usuários, permissões e todos os CNPJs.
  • Cada empresa é um CNPJ; você pode ter várias e habilitar cada uma isoladamente.
  • O certificado é pré-requisito: a captura no ambiente nacional o usa via mTLS.
  • A recepção é habilitada por empresa e por tipo de documento; ao habilitar, a captura entra ativa (isActive: true).

Onde fazer cada passo (plataforma)​

A criação de conta, empresa e o envio do certificado são passos de plataforma (comuns a Emissão, Consultas e Distribuição):

Com a empresa cadastrada, você obtém o companyId usado em todos os endpoints (/v2/companies/{companyId}/inbound/...).

Inscrição Municipal e ambiente​

A Inscrição Municipal (IM) aparece como um card no painel da empresa (app.nfe.io/companies) — cadastro ou edição em um clique (como cadastrar).

  • Para receber NFS-e, a IM é opcional.
  • Mas é a IM que define o ambiente do documento. No console, a IM é criada em Development (Teste, sem valor fiscal) por padrão da interface; em Production tem valor fiscal real. Via API, se environment for omitido e não houver IM com ambiente definido, o backend resolve Production (ResolveEnvironment → DefaultEnvironment).
  • Para emitir NFS-e, a IM é obrigatória no município.

Card de Inscrição Municipal no painel da empresa

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.