Pular para o conteúdo principal

Tabelas tributárias (tax_codes)

O recurso tax_codes expõe as quatro listas de referência consumidas ao montar um CT-e: códigos de operação, finalidades de aquisição e os perfis tributários do emitente e do destinatário. Faz parte da família cte, servida por api.nfse.io, e usa a api_key.

Métodos públicos

tax_codes.list_operation_codes(page_index: nil, page_count: nil)        # => Nfe::TaxCodePaginatedResponse
tax_codes.list_acquisition_purposes(page_index: nil, page_count: nil) # => Nfe::TaxCodePaginatedResponse
tax_codes.list_issuer_tax_profiles(page_index: nil, page_count: nil) # => Nfe::TaxCodePaginatedResponse
tax_codes.list_recipient_tax_profiles(page_index: nil, page_count: nil) # => Nfe::TaxCodePaginatedResponse
Paginação page-style (1-based)

Diferente das listas cursor-style do SDK, estes endpoints paginam por página 1-based (page_index/page_count) e devolvem um Nfe::TaxCodePaginatedResponse (não um Nfe::ListResponse). Os parâmetros de paginação só são enviados quando informados.

Exemplos

Listar códigos de operação

require "nfe"

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

# Sem paginação explícita:
client.tax_codes.list_operation_codes

# Página 2, 20 itens (page_index é 1-based):
client.tax_codes.list_operation_codes(page_index: 2, page_count: 20)

Listar perfis tributários e finalidades

client.tax_codes.list_acquisition_purposes
client.tax_codes.list_issuer_tax_profiles
client.tax_codes.list_recipient_tax_profiles

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.