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

Roteamento multi-host / multi-chave

A plataforma NFE.io não é uma única API: são vários serviços em hosts distintos, e há duas chaves — a principal (apiKey) e a de dados (dataApiKey). O SDK roteia cada recurso para o host/chave corretos; você só precisa fornecer as chaves na configuração.

Hosts e chaves por recurso​

HostChaveRecursos
api.nfe.io/v1principalserviceInvoices, serviceInvoicesRtc, companies, legalPeople, naturalPeople, notifications
api.nfe.io/v2principalwebhooks (nível de conta)
api.nfse.ioprincipalconsumerInvoices (NFC-e), taxCodes
api.nfse.iodadosproductInvoices, productInvoicesRtc, stateTaxes, municipalTaxes, certificates, transportationInvoices, inboundProductInvoices
address.api.nfe.io/v2dadosaddresses
legalentity.api.nfe.iodadoslegalEntityLookup (CNPJ)
naturalperson.api.nfe.iodadosnaturalPersonLookup (CPF)
nfe.api.nfe.iodadosproductInvoiceQuery, consumerInvoiceQuery
Fallback de chave

dataApiKey faz fallback para apiKey quando não informada. Se você usa uma só chave com todos os escopos, basta configurar apiKey.

Contas com chaves separadas

Se sua conta usa chaves distintas para dados e emissão, garanta que a chave principal tenha acesso aos produtos de emissão/consulta que você vai usar (NFС-e, tax-codes e emissão usam a chave principal). Uma chave sem escopo retorna 403.

Por que isso importa​

O SDK já embute o mapeamento acima. Isso evita erros clássicos como montar o host/caminho errado ou usar a chave sem permissão para um endpoint. Ao abrir um chamado ou depurar um 403/404, confira se a chave informada cobre o escopo do recurso na tabela.

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.