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

Consulta de CNPJ (legal_entity_lookup)

O recurso legal_entity_lookup consulta dados cadastrais de pessoa jurídica por CNPJ: informações básicas e inscrição estadual (inclusive a versão adequada para emissão). Faz parte da família de dados legal_entity, servida por legalentity.api.nfe.io. O segmento de versão (/v2) já vem no caminho de cada requisição.

Família de dados — configure data_api_key

Esta é uma família de dados: usa a data_api_key quando presente, com fallback para a api_key. Configure data_api_key: (ou NFE_DATA_API_KEY). Veja Configuração.

Métodos públicos​

legal_entity_lookup.get_basic_info(federal_tax_number, update_address: nil, update_city_code: nil)
# => Nfe::LegalEntityBasicInfoResponse

legal_entity_lookup.get_state_tax_info(state, federal_tax_number)
# => Nfe::LegalEntityStateTaxResponse

legal_entity_lookup.get_state_tax_for_invoice(state, federal_tax_number)
# => Nfe::LegalEntityStateTaxForInvoiceResponse

legal_entity_lookup.get_suggested_state_tax_for_invoice(state, federal_tax_number)
# => Nfe::LegalEntityStateTaxForInvoiceResponse

Exemplos​

Dados básicos de um CNPJ​

require "nfe"

client = Nfe::Client.new(
  api_key: ENV.fetch("NFE_API_KEY"),
  data_api_key: ENV.fetch("NFE_DATA_API_KEY")
)

info = client.legal_entity_lookup.get_basic_info("00.000.000/0001-91")
info

# Opcionalmente força atualização de endereço/código de município:
client.legal_entity_lookup.get_basic_info(
  "00000000000191",
  update_address: true,
  update_city_code: true
)
CNPJ é validado antes do HTTP

O CNPJ precisa ter 14 dígitos (separadores removidos). Um CNPJ inválido levanta Nfe::InvalidRequestError antes de qualquer requisição.

Inscrição estadual para emissão​

# Inscrição estadual em um estado (UF):
client.legal_entity_lookup.get_state_tax_info("SP", "00000000000191")

# Versão adequada para uso em uma nota:
client.legal_entity_lookup.get_state_tax_for_invoice("SP", "00000000000191")

# Sugestão da inscrição estadual para a nota:
client.legal_entity_lookup.get_suggested_state_tax_for_invoice("SP", "00000000000191")
UF e CNPJ validados localmente

state é validado como UF (case-insensitive) e o CNPJ como 14 dígitos. Qualquer um inválido levanta Nfe::InvalidRequestError antes do HTTP.

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.