Processo · TaxCalculation
Cálculo dos tributos (visão geral)¶
Do request do ERP à resposta por item. No modo regra da nota, a ordem é sempre a mesma: nota do fornecedor, regra interna do tenant e, por último, o provedor configurado.
Etapa: Cálculo Cliente InventApps (automático) Cliente e Invent Externo
Outros apps neste processo: Conector SAP S/4HANA
O que fazer em cada app¶
TaxCalculation
Em elaboração
O que fazer neste app ainda está sendo escrito.
Siga o passo a passo do processo: cada passo traz a entrada, a saída, como saber que deu certo e o que fazer se falhar.
Conector SAP S/4HANA
Em elaboração
O que fazer neste app ainda está sendo escrito.
Em elaboração
O que fazer neste app ainda está sendo escrito.
Passo a passo¶
1. Request S4 ao Motor¶
O ERP chama POST /api/v1/calculo/s4 com a credencial de integração. O processo vem em operationNatureCode (P = pedido de compra, PI = fatura da MIRO), o preço em grossOrNet (n = líquido, g = bruto) e, por item, o uso (C, I, A ou R), o usagePurpose e os parceiros SHIP_FROM e SHIP_TO.
Tela: a capturar na DEMO.
2. Natureza, CFOP e tratamento fiscal¶
O Motor resolve no Master Data a natureza de operação de cada item, pelo uso e pela transação do ERP, e o CFOP de entrada (estadual, interestadual ou exterior). Junto vem o tratamento fiscal da natureza: CST e direito a crédito por imposto, conforme o regime da empresa.
Tela: a capturar na DEMO.
3. Espelho ligado? Qual processo?¶
A configuração do tenant decide se a escrituração é consultada. Com o espelho desligado, o Motor segue só o fluxo da regra, igual à versão anterior, e a resposta não ganha campos novos.
Tela: a capturar na DEMO.
4. Busca da nota do fornecedor¶
O Motor lê direto no banco da Escrituração Fiscal a nota de entrada mais recente do fornecedor, para aquela empresa e até a data do request, que tenha o item. No modo regra da nota vale nota escriturada ou pendente: a nota pendente já tem os valores fiscais destacados.
Continua em: Busca da nota do fornecedor (TaxCalculation)
Tela: a capturar na DEMO.
5. Achou a nota?¶
Se a busca falhar ou não achar nenhuma nota, o item segue o fluxo normal do sistema, sem erro para o ERP. No modo espelho, a nota achada é copiada como está e o item sai espelhado.
Tela: a capturar na DEMO.
6. Regra virtual da nota¶
A nota vira a regra do item, montada em memória e sem cadastro: alíquotas, redução derivada da base destacada, MVA e IPI da nota. Quando todos os itens têm nota, o Motor nem procura regra.
Continua em: Montagem da regra virtual da nota (TaxCalculation)
Tela: a capturar na DEMO.
7. Regra interna do tenant¶
Sem nota, o Motor procura a regra aprovada do cadastro. O filtro é por igualdade exata (operação, natureza, UFs, NCM e origem) e a escolha é pela especificidade. Regra pendente de aprovação não é usada.
Tela: a capturar na DEMO.
8. Provedor configurado¶
Sem regra interna, o Motor consulta o provedor configurado para a direção (base de conhecimento, em modo híbrido ou base). Com a criação automática ligada, a regra devolvida é gravada no cadastro do tenant.
Tela: a capturar na DEMO.
9. Cálculo dos tributos¶
Com a regra do item (virtual, interna ou do provedor), o Motor recompõe o preço bruto e calcula ICMS, FCP, ICMS-ST, DIFAL, IPI, PIS e COFINS e, com a reforma ligada, CBS, IBS e IS.
Continua em: Cálculo dos tributos por item (TaxCalculation)
Continua em: Simular no motor de cálculo (TaxCalculation)
Tela: a capturar na DEMO.
10. Conclusão da regra da nota¶
No modo regra da nota, com ou sem regra cadastrada, o Motor reaplica o CST pelo tratamento da natureza depois das reescritas do cálculo, troca o CFOP pelo da natureza e identifica a regra virtual na resposta.
Tela: a capturar na DEMO.
11. Resposta ao ERP¶
O Motor devolve por item o CFOP (taxcode) e, por tributo, CST, base, alíquota, valor, base isenta, base outras e % de redução. Com o espelho ligado, cada linha diz de onde veio o cálculo.
Tela: a capturar na DEMO.
Validações e o que fazer se falhar¶
| Passo | Validação | Se falhar |
|---|---|---|
| Request S4 ao Motor | NCM com 8 dígitos e uso por item | Erro de validação devolvido ao ERP |
| Request S4 ao Motor | CNPJ do fornecedor e da empresa destinatária | Sem fornecedor não há busca da nota: segue o fluxo normal |
| Natureza, CFOP e tratamento fiscal | Natureza cadastrada para o uso informado | Item sem natureza fica sem regra e sai com aviso |
| Espelho ligado? Qual processo? | P · Pedido de compra | Sempre regra da nota |
| Espelho ligado? Qual processo? | PI · Fatura da MIRO | Espelho ou regra da nota, conforme a configuração |
| Espelho ligado? Qual processo? | Outro processo ou espelho desligado | Regra do motor, sem consultar a escrituração |
| Achou a nota? | Sim | Regra virtual da nota, antes de qualquer regra cadastrada |
| Achou a nota? | Não, ou a busca falhou | Regra interna e, depois, o provedor configurado |
| Regra interna do tenant | Regra aprovada para a combinação do item | Segue para o provedor configurado |
| Regra interna do tenant | Campo vazio não é curinga | Regra sem NCM não casa com item que tem NCM |
| Provedor configurado | Modo da direção permite o provedor | Item sai como Sem regra aplicada, com aviso |
| Conclusão da regra da nota | ICMS: natureza com Tomar crédito usa o CST da nota; sem crédito, o CST da natureza | Natureza sem CST de ICMS: fica o CST destacado na nota |
| Conclusão da regra da nota | IPI e PIS/COFINS: CST da natureza no regime da empresa | Sem tratamento cadastrado: fica o CST do motor |
| Conclusão da regra da nota | Forçar substituição de CST ligado | PIS/COFINS com CST 50 sai 56 |
| Resposta ao ERP | cust_escrituracaoOrigem = espelhado, regra_da_nota ou calculado | Sem o campo: espelho desligado ou processo fora de P e PI |
| Resposta ao ERP | cust_componentVersion = RegraDaNota: |
Regra cadastrada sai como |
| Resposta ao ERP | cust_escrituracaoDocumento = chave | número |
Resultado esperado¶
- Documento com tributos no ERP.
Perguntas frequentes¶
Em elaboração
As dúvidas deste processo serão reunidas com o manual do app e com o retorno dos treinamentos.