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.
| Você quer | Use | Precisa 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
- Abra taxnera.com.br e clique em Calcular um item agora.
- Escolha o estado e o município da operação.
- Informe o NCM do item, com 8 dígitos. Pode digitar com os pontos (6109.10.00) ou sem (61091000).
- Informe o valor do item, em reais.
- Escolha a classificação tributária. A lista mostra só algumas, como exemplo; o catálogo completo fica no painel.
- 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
- Clique em Criar conta e informe nome, e-mail e senha.
- Abra o e-mail de confirmação e clique no link.
- Cadastre a empresa, com o CNPJ.
Fazer um cálculo
- Abra Novo cálculo.
- 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.
- 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.
- 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.
- 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.
- 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.
- Confira, corrija o que for preciso e clique em Calcular.
- 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
- Resumo: a base de cálculo, a CBS, o IBS e o total de tributos da operação.
- Por item: a base, a alíquota e o valor de cada tributo, com o CST e o cClassTrib usados.
- Memória de cálculo: o texto que explica o enquadramento do item e a fundamentação legal.
O guia Como calcular IBS e CBS explica cada parte com um exemplo.
Gerar o relatório em PDF
- Na tela do resultado de um cálculo concluído, vá até o bloco Exportar o resultado.
- Clique em Imprimir ou salvar em PDF.
- 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:
- o e-mail de quem vai fazer a integração;
- 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
GET /health: confere a conexão, sem chave.-
GET /v1/fiscal/catalogcom o cabeçalhoAuthorization: Bearere a sua chave: confere a chave. -
POST /v1/tax/calculatecom o cabeçalhoIdempotency-Key: faz o cálculo. Guarde ocalculationIdda resposta. GET /v1/calculations/{id}: consulta o cálculo depois.
- Use dados de teste: não é preciso enviar dado de cliente.
- A chave é entregue uma única vez e pode ser trocada quando você pedir. Não a envie em mensagem de suporte.
- Ao relatar um problema, mande o
calculationIde otraceIdda resposta. - O acesso à API não faz parte do teste gratuito do painel. As condições para usar a API depois do piloto são combinadas com você durante o piloto.
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
- Como calcular IBS e CBS: do item ao resultado
- cClassTrib e CST do IBS e da CBS: o que são e como consultar
- Reforma tributária do consumo: o que muda com o IBS e a CBS
Experimente
Teste grátis: 5 cálculos por pessoa, depois de confirmar o e-mail e cadastrar a empresa.
Criar contaO Taxnera é uma ferramenta de apoio e não substitui a análise de um contador ou especialista.