Taxnera

Ajuda · Atualizado em

Como usar o Taxnera: calculadora, painel e API

O Taxnera calcula o IBS e a CBS de três jeitos: na página inicial, sem cadastro; no painel, com uma conta gratuita; e pela API, para quem tem um sistema próprio. Esta página mostra o passo a passo de cada um.

Qual usar
Você querUsePrecisa de conta?
Ver quanto dá o IBS e a CBS de um item A calculadora da página inicial Não
Calcular uma operação com vários itens, ver a memória de cálculo, guardar e gerar um relatório O painel Sim, gratuita
Calcular dentro do seu sistema (ERP ou emissor de nota) A API Um acesso de teste, pedido por e-mail

1. Calculadora da página inicial, sem cadastro

  1. Abra taxnera.com.br e clique em Calcular um item agora.
  2. Escolha o estado e o município da operação.
  3. Informe o NCM do item, com 8 dígitos. Pode digitar com os pontos (6109.10.00) ou sem (61091000).
  4. Informe o valor do item, em reais.
  5. Escolha a classificação tributária. A lista mostra só algumas, como exemplo; o catálogo completo fica no painel.
  6. Clique em Calcular.

O resultado aparece na hora: a alíquota e o valor da CBS, do IBS estadual e do IBS municipal, e o total dos dois tributos.

A calculadora faz um item por vez e não guarda o cálculo. A memória de cálculo, o histórico e o relatório em PDF ficam no painel.

2. Painel, com conta gratuita

O teste é gratuito: 5 cálculos por pessoa, sem cartão, depois de confirmar o e-mail e cadastrar a empresa.

Criar a conta

  1. Clique em Criar conta e informe nome, e-mail e senha.
  2. Abra o e-mail de confirmação e clique no link.
  3. Cadastre a empresa, com o CNPJ.

Fazer um cálculo

  1. Abra Novo cálculo.
  2. Em Operação, dê uma identificação sua (o número do pedido ou da nota), informe a data e a hora do fato gerador, o estado e o município.
  3. Em Itens, informe o NCM e o valor tributável e escolha a classificação tributária. O CST é preenchido junto. Para mais de um item, use + Adicionar item.
  4. Clique em Calcular.

Calcular a partir do XML da nota

Quem tem o XML de uma NF-e ou de uma NFC-e não precisa digitar os itens.

  1. Em Novo cálculo, no bloco Tem o XML da nota?, arraste o arquivo para a área tracejada ou clique em Escolher o XML da nota.
  2. Os campos são preenchidos com o que a nota traz: a data, o município e, em cada item, o NCM, a quantidade, o valor e a classificação tributária. A tela diz de onde tirou cada dado.
  3. Confira, corrija o que for preciso e clique em Calcular.
  4. No resultado, o bloco Conferência com a nota mostra, em cada item, a base de cálculo, a CBS e o IBS que a nota declara ao lado dos valores calculados. Uma diferença de mais de um centavo fica em destaque.

O arquivo é lido no seu aparelho, pelo navegador, e não é enviado ao Taxnera. Para o cálculo seguem só os dados que aparecem nos campos; o nome, o CNPJ e o CPF do emitente e do destinatário e a chave de acesso da nota ficam de fora. Uma nota é um cálculo, e a leitura vai até 50 itens por nota.

Uma diferença não quer dizer que a nota está incorreta: pode vir de arredondamento, de um campo alterado antes do cálculo ou de uma regra que a nota aplica e o cálculo não recebeu. A conferência aparece só naquela tela e não fica guardada; o cálculo continua no Histórico.

Ler o resultado

O guia Como calcular IBS e CBS explica cada parte com um exemplo.

Gerar o relatório em PDF

  1. Na tela do resultado de um cálculo concluído, vá até o bloco Exportar o resultado.
  2. Clique em Imprimir ou salvar em PDF.
  3. Na janela de impressão do navegador, escolha Salvar como PDF no lugar da impressora.

O relatório traz a empresa e o CNPJ da conta, o resumo, cada item com a memória de cálculo, o identificador do cálculo e a data de emissão. Não é documento fiscal, e o arquivo fica só com você: o Taxnera não guarda o PDF.

Baixar a planilha (Excel)

No mesmo bloco, Baixar planilha (Excel) gera um arquivo .xlsx com cada item (CST, cClassTrib, base, alíquota e valor de cada tributo e a memória de cálculo) e os totais. Os valores vêm como número, prontos para somar e filtrar, e os códigos mantêm os zeros à esquerda. Abre no Excel, no LibreOffice e no Google Planilhas. Quando o cálculo saiu do XML de uma nota, a conferência vem numa segunda aba. A planilha é gerada no seu navegador e o Taxnera não guarda o arquivo.

Rever um cálculo

Todo cálculo fica no Histórico. Clique em Ver cálculo para abrir o resultado de novo e gerar o relatório.

Achar a classificação tributária

O Catálogo fiscal lista as classificações vigentes. Pesquise pelo código ou por parte da descrição. O guia cClassTrib e CST explica os dois códigos.

3. API, para software houses e ERPs

O Taxnera tem uma API REST para o seu sistema calcular o IBS e a CBS na emissão da nota. O sistema envia a operação com os itens e recebe, para cada item, a base, a alíquota, o valor de cada tributo e a memória de cálculo.

A documentação é aberta, com todas as rotas e exemplos: api.taxnera.com.br/docs.

Como pedir o acesso de teste

O teste da API é um piloto gratuito de 30 dias, num ambiente de testes. Para pedir, escreva para contato@taxnera.com.br e informe:

  1. o e-mail de quem vai fazer a integração;
  2. qual sistema vai chamar a API e se o cálculo será na emissão da NF-e, da NFC-e ou das duas.

Você recebe uma chave de acesso e uma empresa de teste já cadastrada. Os 30 dias contam a partir da entrega da chave.

Primeiros passos com a chave

  1. GET /health: confere a conexão, sem chave.
  2. GET /v1/fiscal/catalog com o cabeçalho Authorization: Bearer e a sua chave: confere a chave.
  3. POST /v1/tax/calculate com o cabeçalho Idempotency-Key: faz o cálculo. Guarde o calculationId da resposta.
  4. GET /v1/calculations/{id}: consulta o cálculo depois.

Dúvidas comuns

O Taxnera emite nota fiscal?

Não. Ele calcula o IBS e a CBS a partir do que você informa.

O Taxnera diz qual classificação tributária usar?

Não. A classificação é uma decisão fiscal: o catálogo ajuda a encontrar o código, e a escolha é sua e do seu contador.

O cálculo foi recusado. E agora?

A tela do resultado mostra o motivo. Os casos mais comuns são classificação incompatível com a operação e data do fato gerador fora da vigência. O cálculo recusado também fica no histórico.

Não achei o que procurava

Escreva para contato@taxnera.com.br. Quem tem conta também encontra a Ajuda no menu do painel.

Guias

Experimente

Teste grátis: 5 cálculos por pessoa, depois de confirmar o e-mail e cadastrar a empresa.

Criar conta

O Taxnera é uma ferramenta de apoio e não substitui a análise de um contador ou especialista.