TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • DDVENDAS-55877 - DT - API Recálculo de Tributos Mantendo Preço de Venda

Versões comparadas

Versão antiga 1

changes.mady.by.user Edward Sampaio Souza

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Edward Sampaio Souza

Gravado em

Chave

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

...

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

Rotinas 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

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):

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.

DEMAIS INFORMAÇÕES


Observações:

  • 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.

...