Processo · TaxCalculation
Busca da nota do fornecedor¶
Dois passos com custo limitado, direto no banco da Escrituração Fiscal. Sem limite de tempo na consulta; falha ou ausência de nota levam ao fluxo normal.
Etapa: Cálculo InventApps (automático)
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.
Passo a passo¶
1. Chave de busca do item¶
O Motor monta a chave de cada item: CNPJ do fornecedor (SHIP_FROM ou CONTRACT_FROM), CNPJ da empresa destinatária, data do request e código. Material casa pelo itemCode; serviço também pelo código da LC 116 (servTypeFed, por prefixo); o frete do CT-e casa com o único item do CT-e da transportadora. No modo regra da nota entram as variáveis fiscais: NCM, EX, CEST e origem.
Tela: a capturar na DEMO.
2. Passo 1 · últimas 50 notas¶
Lê as 50 notas de entrada mais recentes do fornecedor dentro da janela configurada (padrão de 30 dias até a data do request), pelo índice de apuração, e filtra os itens pela chave.
Tela: a capturar na DEMO.
3. Casou algum item?¶
O espelho casa só pelo código. A regra da nota casa pelo código ou pelas variáveis fiscais (NCM, EX, CEST e origem).
Tela: a capturar na DEMO.
4. Passo 2 · busca pelo código¶
Procura o código em todas as notas do fornecedor na janela, pelos índices de expressão do item (código do produto, código do catálogo e código de serviço), até 200 ocorrências.
Tela: a capturar na DEMO.
5. Escolha do item escriturado¶
Vale a nota mais recente. Com várias notas no mesmo dia, desempata pelo valor do item: com preço líquido, o valor da nota × fator líquido; com preço bruto, o valor total. A tolerância é o maior entre 0,01 e quantidade × 0,00005.
Tela: a capturar na DEMO.
6. Falha ou nenhuma nota¶
A consulta roda num savepoint: um erro de banco desfaz só a consulta, e o cálculo segue na mesma sessão.
Tela: a capturar na DEMO.
Validações e o que fazer se falhar¶
| Passo | Validação | Se falhar |
|---|---|---|
| Passo 1 · últimas 50 notas | Nota de entrada não cancelada, denegada ou inutilizada | Nota nessas situações é ignorada |
| Passo 1 · últimas 50 notas | Espelho: só nota escriturada. Regra da nota: escriturada ou pendente | Nota em outro estado é ignorada |
| Casou algum item? | Sim | Escolhe o item escriturado |
| Casou algum item? | Não | Passo 2: busca pelo código |
| Escolha do item escriturado | Valor do request confere com o da nota | Usa a nota e avisa a diferença no warning |
| Falha ou nenhuma nota | Consulta sem erro | Aviso no retorno e fluxo normal do motor |
| Falha ou nenhuma nota | Nota encontrada | Item segue sem nota: regra interna e provedor configurado |
Resultado esperado¶
- Item com ou sem nota de referência.
Perguntas frequentes¶
Em elaboração
As dúvidas deste processo serão reunidas com o manual do app e com o retorno dos treinamentos.