TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • DDVENDAS-55892 - DT - Nova Opção de Recálculo na Rotina 820

Versões comparadas

Versão antiga 1

changes.mady.by.user Edward Sampaio Souza

Gravado em

comparado com

Nova versão 2

changes.mady.by.user Edward Sampaio Souza

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


01. DADOS GERAIS

Produto:

Solucoes_totvs
SolucaoTOTVS Distribuição e Varejo

Solucoes_totvs_cross
SolucaoCross

Solucoes_totvs_parceiros
SolucaoParceiros

Solucoes_totvs_parceirosexptotvs
SolucaoParcsExpsTOTVS

Linha de Produto:

Linhas_totvs
LinhaLinha Winthor

Segmento:

Segmentos_totvs
SegmentoDistribuição

Módulo:

Modulos_cross_segmentos

Modulos_framework

Modulos_totvs_construcao

Modulos_totvs_juridico

Modulos_totvs_logistica

Modulos_totvs_manufatura

Modulos_totvs_rh

Modulos_totvs_saude

Modulos_totvs_prestadores_de_servicos
Vendas

Função:Integrações
País:Brasil
Requisito/Story/Issue (informe o requisito relacionado) :DDVENDAS-5587755892


02. SITUAÇÃO/REQUISITO

Havia a necessidade de recalcular os tributos de um item do pedido de venda (devido a alterações de vigência, figura tributária) garantindo que o preço de venda final (PVENDA) negociado com o cliente permanecesse inalterado.
O sistema precisava ajustar as bases de cálculo e valores de impostos (IPI, ST, FECP, etc.) "de trás para frente", mantendo o valor total do item e preservando as proporções de descontos (Preço de Tabela - PTABELA) e conta corrente (Base RCA - PBASERCA).automatizar o recálculo de pedidos de venda pendentes quando houvesse uma "virada" de vigência tributária programada.
O objetivo era garantir que, ao processar as atualizações de tributação programadas (Rotinas 514, 574, 271), os pedidos impactados tivessem seus impostos e preços recalculados automaticamente, sem intervenção manual pedido a pedido.  

03. SOLUÇÃO

Foi

...

implementada uma nova

...

O fluxo de execução da solução compreende:

...

Cálculo Reverso: O sistema utiliza o preço de venda atual como alvo para encontrar o novo preço base sem impostos.

funcionalidade na Rotina 820 (WTA), adicionando a opção "Recalcular pedidos".

  • Esta opção funciona como uma flag dependente, ou seja, ela só é habilitada para marcação quando a opção principal "Atualizar tributação programada" estiver marcada.   

  • Ao executar o processo, o sistema aciona um serviço de recálculo que identifica apenas os pedidos contendo itens que sofreram alteração na figura tributária ou no vínculo entre produtos (Rotinas 574/271).   

  • O recálculo afeta pedidos nas posições Bloqueado (B), Pendente (P), Liberado (L) e Montado (M).   

  • Pedidos já Faturados (F) não sofrem alteração.   

...

Cálculo de Tributos: Aplica-se a tributação vigente (Desonerações, IPI, ST, Partilha, FECP, CBS, IBS, IS) sobre o novo preço base.

...

Persistência (Update): Atualiza os campos fiscais na tabela PCPEDI mantendo o PVENDA original.

...

Ajuste de Referências: Recalcula proporcionalmente os impostos para o PTABELA e PBASERCA, garantindo a integridade de descontos e comissões/flex.

...


Totvs custom tabs box
tabsSaiba como funciona,Passo a Passo
idspasso1,passo2

A funcionalidade é executada via chamada de API (REST). Siga os passos abaixo para atualização e uso:

1. Atualização do Serviço

  • Acesse a rotina 801 no WinThor Anywhere (WTA).

  • Localize e atualize o serviço winthor-venda para a versão indicada.

2. Consumo da API

Realize uma requisição POST para o endpoint de recálculo:

URL:

http://{URL-WTA}:{PORTA-WTA}/winthor/venda/v0/pedido/item/recalculoTributos

Parâmetros da Requisição (Query Params):

Totvs custom tabs box items
defaultyes
referenciapasso1
Rotinas

1. Atualizações e Dependências

Para a utilização correta da funcionalidade, o ambiente deve possuir as seguintes atualizações:

  • Rotina: 801 - Atualização de Serviços (WinThor Anywhere).

    • Serviço: winthor-venda - Versão 0.38.28.13 ou superior.
Totvs custom tabs box items
defaultno
referenciapasso2
ParâmetroTipoObrigatórioDescrição
numeroPedidoNumberSimNúmero do pedido de venda (NUMPED).
codigoProdutoNumberSimCódigo do produto (CODPROD).
numeroSequencialNumberSimSequencial do item no pedido (NUMSEQ).
ignorarRecalculoCabecalhoBooleanNão

Define se o cabeçalho (PCPEDC) será recalculado.

false (Padrão): Recalcula o cabeçalho.

true: Mantém os totais do cabeçalho inalterados (útil para correção de itens isolados em vendas futuras/assistidas).

acaoStringNão

Ação a ser executada.

MANTER_PRECO_VENDA (Padrão).

Outros valores: REPASSAR_PRECO_VENDA, QUEBRAR_PEDIDO, CORTAR_ITEM.

Bash

curl --location --request POST 'http://localhost:8080/winthor/venda/v0/pedido/item/recalculoTributos?numeroPedido=19072&codigoProduto=106&numeroSequencial=2&ignorarRecalculoCabecalho=false' \
--header 'Authorization: Bearer {TOKEN}'

Comportamento Esperado:

  • Sucesso (200 OK): O retorno JSON confirmará: "mensagem": "Recálculo dos tributos executado com sucesso".

  • PVENDA: Permanecerá inalterado.

  • Impostos (ST, IPI): Serão atualizados na tabela PCPEDI conforme a regra fiscal vigente (Rotina 514/574/271).

  • Cabeçalho (PCPEDC): Se ignorarRecalculoCabecalho for false (padrão), o valor total do pedido será atualizado. Se for true, o totalizador será mantido.

Observações:

Para o funcionamento correto, certifique-se de que o ambiente esteja atualizado com as versões mínimas abaixo:

  • Rotinas WinThor: 271, 514 e 574 atualizadas para versão 37 ou superior.  
  • Serviços (WTA - Rotina 801):
    • winthor-fer-0820 (Rotina 820): Versão 1.38.2.1 ou superior.  
      • Atualizar a dependência: winthor-atualizacao-dados: Versão 1.38.3.5 ou superior. 

2. Parametrização de Acesso

É necessário liberar a permissão de acesso para o usuário que executará a rotina:

  1. Acesse a Rotina 530 - Permitir Acesso a Rotina.
  2. Pesquise pela rotina 820.
  3. Marque a permissão 35 - Recalcular Pedidos.   
  4. Clique em Salvar.

Image Added

3. Passo a Passo de Utilização

  1. Acesse a Rotina 820 - Atualização de Dados no WinThor Anywhere.
  2. Nas Opções Gerais, certifique-se de que o modo de atualização esteja como Manual (para execução imediata) ou Automático (com agendamento realizado).
  3. Na seção VENDAS, localize a opção "Atualizar tributação programada" e marque-a.
  4. Observe que a opção "Recalcular pedidos" ficará habilitada. Marque-a também.   
  5. Clique no botão Executar.   

Image Added


Modo manual: 

Image Added

Modo automático: 

Image Added

Comportamento do Sistema:

  • O sistema processará a vigência programada (tabelas PCTRIBUT_PROGRAMADA, etc.) alterando o status para aplicada.   
  • Imediatamente após, o serviço de recálculo será executado para os pedidos elegíveis.   
  • Pedidos que não possuem itens nas figuras tributárias alteradas manterão seus valores originais.   



Observações importantes:

  • A opção de recálculo não pode ser executada isoladamente; ela depende da atualização de vigências.  
  • O recálculo respeita as configurações de preço fixo ou variável conforme a parametrização do pedido e do sistema

  • Esta API é utilizada internamente pelas rotinas de recálculo de pedidos (como na rotina 820) para garantir integridade fiscal sem afetar o acordo comercial com o cliente.

  • O recálculo respeita a parametrização de Usa Tributação por UF (Parâmetro 1092) e Utiliza Tributação Endereço de Entrega (Parâmetro 3922).

  • Validação de Inconsistências: A API valida a existência do pedido e a integridade dos dados, retornando mensagens de erro (400/404) caso o pedido não seja encontrado ou os parâmetros estejam incorretos.


04. DEMAIS INFORMAÇÕES


Aviso

Importante!

As versões estarão disponíveis para download no CCW. 

https://centraldecontrole.pcinformatica.com.br/


Mantenha suas rotinas sempre atualizadas!

...