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

Ativar a captura de NFS-e via API

Para receber automaticamente as NFS-e emitidas contra o CNPJ da sua empresa, cadastre-a no serviço de recepção. Todas as rotas exigem uma API Key com papel Nota Fiscal (api.nfe.io) ou NFSeDist (dfe.nfe.io) — veja Autenticação.

Base URL: https://api.nfse.io

Cadastrar a empresa​

curl -X POST "https://api.nfse.io/v2/companies/inbound/nfse" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "SEU_COMPANY_ID",
    "initialNsu": 0,
    "webhookUrl": "https://seu-sistema.com/webhooks/nfse"
  }'

initialNsu é obrigatório (use 0 para capturar desde o início disponível). Resposta 201 Created. Se a empresa já estiver cadastrada, a API retorna 409 Conflict.

O campo environment é opcional. Aceita "Production", "Development" ou "Homologation" (case-insensitive). Quando omitido, herda o ambiente da inscrição municipal (TaxPayers); se ausente também ali, assume "Production" por padrão.

Consultar a configuração​

curl "https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/details" \
  -H "Authorization: SUA_API_KEY"

Retorna a configuração atual: webhookUrl, isActive, currentNsu, environment, isAutomaticManifestationEnabled, etc. O webhookVersion não é exposto na resposta (veja Versionamento de webhook).

Atualizar a configuração​

curl -X PUT "https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/details" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "webhookUrl": "https://seu-sistema.com/webhooks/nfse",
    "isAutomaticManifestationEnabled": true,
    "automaticManifestationDelaySeconds": 3600,
    "isActive": true
  }'
  • automaticManifestationDelaySeconds aceita de 0 a 604800 (7 dias).

Desativar​

curl -X DELETE "https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/details" \
  -H "Authorization: SUA_API_KEY"

A captura para, mas os documentos já recebidos continuam acessíveis.

Redefinir o cursor (reset-nsu)​

Para reprocessar a partir de um NSU específico:

curl -X POST "https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/reset-nsu" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "nsu": 0 }'

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.