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

Primeira integração — NFS-e Inbound

Você vai habilitar a captura automática de NFS-e do padrão nacional para o CNPJ da sua empresa e consultar o primeiro documento recebido via API.

Pré-condição

Sem empresa cadastrada + certificado digital válido, o serviço não é ativado. Conclua a cadência conta → empresa → certificado antes — veja Conta → Empresa → Ativação.

Pré-requisitos​

  • Conta NFE.io com a empresa (CNPJ) cadastrada e certificado digital enviado.
  • API Key com papel Nota Fiscal ou NFSeDist (header Authorization, sem prefixo) — veja Autenticação.
  • Cliente HTTP (cURL, Postman ou SDK).
  • Endpoint HTTPS público para webhook — opcional, recomendado.

Fluxo​

export NFEIO_API_KEY="<sua-chave>"
export COMPANY_ID="<id-da-empresa>"

Passo 1 — Habilitar a captura de NFS-e​

POST /v2/companies/inbound/nfse informando companyId, initialNsu (use 0) e o webhookUrl.

curl -X POST "https://api.nfse.io/v2/companies/inbound/nfse" \
  -H "Authorization: $NFEIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "'$COMPANY_ID'",
    "initialNsu": 0,
    "webhookUrl": "https://meu-sistema.com/webhook/nfse",
    "isAutomaticManifestationEnabled": false
  }'

Resposta esperada: HTTP 201 Created com o objeto da empresa (isActive: true).

Passo 2 — Receber e consultar o primeiro documento​

A NFE.io passa a fazer polling no ADN a cada ~30 s. Ao capturar a primeira NFS-e, envia POST ao seu webhookUrl com eventName: inbound.serviceInvoice.received. Para confirmar via API:

curl "https://api.nfse.io/v2/companies/$COMPANY_ID/inbound/nfse?pageCount=10" \
  -H "Authorization: $NFEIO_API_KEY"

A resposta lista os documentos (documents[]) com nsu, accessKey (50 dígitos), provider, borrower, servicesAmount, status. Baixe o XML via GET .../inbound/nfse/{id}/xml — retorna 302 para uma URL assinada (HMAC-SHA256, ~30 min).

Próximos passos​

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.