Testar o cálculo com a Reforma Tributária

Antes de começar

Confirme que você está autenticado no ambiente sandbox da API do AvaTax Brasil.

Sobre esta tarefa

Aprenda a testar a API do AvaTax Brasil e interpretar os resultados retornados no array taxDetails[], com foco nos tributos da Reforma Tributária e seus impactos no cálculo.

Etapas

1. Abra a collection no Postman e escolha um cenário de teste.
Na coleção Reforma Tributária Brasileira, selecione o exemplo mais próximo da sua operação (NFe, NFCe ou NFSe). Altere apenas os dados necessários para simular transações reais, mas mantenha a estrutura da requisição.

2. Envie a requisição para o endpoint adequado.
Use /v3/simulations ou /v3/calculations.

3. Localize taxDetails[] no corpo da resposta.
Esse array traz os resultados por item da nota: tributos, créditos e valores informativos.

4. Identifique o tributo ou tipo de retorno com taxType.

5. Verifique se existe contabilização.
Em taxImpact.accounting, verifique:

• liability (devido)
• asset (crédito)
• none (informativo)

6. Verifique o impacto.

• impactOnFinalPrice: indica como o valor final da transação é impactado pelo tributo em questão.
• impactOnNetAmount: indica como o valor a receber ou pagar é impactado pelo tributo em questão. Por exemplo, tipicamente uma retenção não afeta o valor de um serviço, mas afeta o valor a ser recebido.
• Em ambos parâmetros, os valores possíveis são: Add, Included, Subtracted, ou Informative.

7. Analise base, alíquota e valor.
Os principais campos são:

• subtotalTaxable (base)
• rate (alíquota)
• tax (valor do tributo)

8. Se houver redutores na requisição, confira:

• pRedAliq, pGovRedAliq e pEffRate
• Fórmula: pEffRate = rate × (1 - pRedAliq) × (1 - pGovRedAliq)

9. Para tributos ad rem, confira se modBC: "1".

10. Confirme a jurisdição de incidência.
Verifique jurisdictionType e jurisdictionName.
Para IBS municipal, valide também cMunFG (código IBGE do município de consumo).

Resultado

Você terá classificado os itens de taxDetails[] por tipo de tributo ou retorno, entendido se contabilizam, identificado os impactos nos valores e reconhecido a jurisdição onde incidiram (UF, Município ou País).