Pular para conteúdo

0001 — Mapeamento de preços (a prazo → cheio, à vista → desconto)

Status: Aprovado · Responsável: Gustavo Madruga · Atualizado em: 2026-08-11 · Decidido em: 2026-06-25

Contexto

O X-Adm tem dois preços por produto — preço a vista e preço a prazo — e a API do parceiro espera dois campos — preco_cheio e preco_desconto. A especificação do parceiro não disse qual preço do X-Adm alimenta qual campo, então era preciso decidir o de-para.

Decisão

  • VALOR (preço a prazo, o maior) → preco_cheio
  • PROMOCAO (preço promocional / à vista) → preco_desconto

Consequências

  • Confirmado pela definição oficial do export X-Adm (ProdutosSite.csv / PDF THOMS2026_413248): a coluna VALOR é o preço a prazo e PROMOCAO é o preço promocional / à vista; nas linhas reais VALOR > PROMOCAO.
  • Coerente com a convenção de varejo no Brasil: preço cheio = a prazo; preço com desconto = à vista.
  • Coerente com o exemplo da spec do parceiro, em que preco_desconto fica ~10% abaixo de preco_cheio.
  • Confirmado na verificação contra a API real (2026-06-25): o campo preco_recebido da resposta ecoou o preco_cheio enviado — o parceiro trata o preco_cheio como preço de referência.
  • Uso do preco_desconto — decidido (2026-08-11): o ERP envia sempre os dois preços (a prazo → preco_cheio, à vista → preco_desconto), e como usá-los é decisão da WebStorm. Hoje o e-commerce usa o preco_cheio e aplica um desconto à vista padrão (igual para todos), sem consumir o preco_desconto por produto — mas o contrato entrega ambos, então a WebStorm pode passar a usar o desconto por produto quando quiser, sem mudança do nosso lado. Não há pendência aberta.