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

Paginação

Os recursos de listagem retornam envelopes — o array vem sob uma chave específica, não na raiz. O formato varia por recurso.

Envelopes por recurso​

RecursoFormato
serviceInvoices.list{ serviceInvoices, page }
companies.list{ data, page } (via ListResponse<Company>)
municipalTaxes.list / stateTaxes.list{ municipalTaxes | stateTaxes, hasMore }
consumerInvoices.list{ consumerInvoices, hasMore }
certificates.list{ certificates }
notifications.list{ notifications }
const { serviceInvoices = [], page } = await nfe.serviceInvoices.list(companyId, {
  pageIndex: 1,   // 1-based
  pageCount: 20,  // até 50
  issuedBegin: '2026-01-01',
  issuedEnd: '2026-01-31',
});
Índice 1-based e limite de página

As listas page-style da plataforma são 1-based (pageIndex começa em 1) e pageCount tem teto (tipicamente 50). Valores fora disso podem ser rejeitados pela API com 400.

Iterar todas as empresas​

companies oferece iteração automática, cuidando das páginas para você:

// Coleta tudo em memória:
const all = await nfe.companies.listAll();

// Ou itere lazily (async iterator):
for await (const company of nfe.companies.listIterator()) {
  console.log(company.id, company.name);
}

Filtros por data (NFS-e)​

serviceInvoices.list aceita issuedBegin/issuedEnd e createdBegin/createdEnd (formato yyyy-MM-dd), além de hasTotals.

Próximos passos​

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.