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

Manutenção administrativa da captura de NFS-e

Há um conjunto de endpoints operacionais sob .../inbound/nfse/maintenance:

  • fetch-now — força a captura imediata da própria empresa. Acessível com uma API Key de cliente (papel Nota Fiscal / NFSeDist) ou com o papel Management (ops). O disparo é escopado ao próprio tenant: a empresa precisa pertencer à conta da API Key, senão retorna 404.
  • notifications, statistics, reactivate — administrativos, restritos ao papel Management (chamadas sem ele retornam 403).

Todas as rotas abaixo são prefixadas por https://api.nfse.io/v2/companies/{companyId}/inbound/nfse/maintenance.

Forçar captura imediata​

curl -X POST ".../maintenance/fetch-now" \
  -H "Authorization: SUA_API_KEY"

Dispara um ciclo de captura fora da cadência normal de polling, continuando do currentNsu da empresa. Resposta 202 Accepted.

Risco de NOVAS COBRANÇAS ao alterar o NSU

O corpo opcional aceita forcedStartNsu, que reposiciona o cursor de NSU da empresa. Informar um NSU menor que o currentNsu faz o sistema re-capturar documentos já processados — e cada documento re-capturado é COBRADO NOVAMENTE (a bilhetagem do NFS-e Inbound é por documento capturado).

Para uma busca normal, não envie forcedStartNsu — o sistema continua a partir do currentNsu e não re-cobra o que já foi capturado. Use forcedStartNsu apenas quando souber exatamente o efeito.

# ⚠️ forcedStartNsu reposiciona o cursor de NSU — pode gerar novas cobranças (ver aviso acima)
curl -X POST ".../maintenance/fetch-now" \
  -H "Authorization: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "forcedStartNsu": 10000 }'

Consultar notificações operacionais​

curl ".../maintenance/notifications?severity=Critical" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"

Filtros: severity (Info / Warning / Critical) e type.

Estatísticas​

curl ".../maintenance/statistics" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"

Retorna contadores operacionais da empresa.

Reativar empresa​

Empresas desativadas automaticamente pelo circuit breaker (ex.: falhas consecutivas) podem ser reativadas:

curl -X POST ".../maintenance/reactivate" \
  -H "Authorization: SUA_API_KEY_MANAGEMENT"

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.