LojaVendaPrecoDemarcado (Subprocesso)

Documentação Técnica

Nome do cliente	OSKLEN
Nome do projeto	Integração LINX (Venda PDV)
Biblioteca	loja_venda
Data	01/04/2026

Histórico de Versões

Data	Versão	Modificado por	Descrição da Mudança
01/04/2026	1.0	Maykon/Gustavo	Criação da documentação do subprocesso de cálculo de valor demarcado por tabela de preços.

Cabeçalho e identificação

Subprocesso do recurso de integração loja_venda: cálculo do valor demarcado a partir da tabela de preços do produto. A leitura do código fonte concentra-se no serviço PHP de venda PDV no pacote LINX–ILLI.

Descrição geral

Este subprocesso obtém, para produto, cor e tabela de preços informados, o valor de desconto demarcado quando o preço líquido da tabela é menor que o preço de tabela e ambos são válidos.

O retorno é a diferença entre preço de tabela e preço líquido quando essa condição se verifica; caso contrário retorna zero.

Estrutura de Dados

Nome	Tipo
`PRODUTO`	string
`COR_PRODUTO`	string
`CODIGO_TAB_PRECO`	string

Fonte

Origem consultada: view VW_ILLI_TAB_PRECOS_PRODUTOS_LINHAS (campos PRECO_TAB, PRECO_LIQ_TAB), com ordenação por DATA_PARA_TRANSFERENCIA descendente e limite de um registro.

Integração

Consulta ao banco LINX; não há chamada a serviço HTTP externo nem ao Protheus neste trecho.

Tratamento de dados

Arredondamento: valores numéricos de preço são normalizados com duas casas decimais antes da comparação.

Regra de negócio: só calcula demarcado quando PRECO_TAB existe, não é vazio nem igual a .00, o preço líquido da tabela é maior que zero, menor que o preço de tabela e válido da mesma forma.

Tratamento de retorno

Retorna number (diferença demarcada ou 0.00). Não lança exceção no fluxo analisado.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Preço demarcado	Produto com preço líquido estritamente menor que o preço de tabela, ambos válidos.	Retorno positivo igual à diferença entre preço de tabela e preço líquido.
Integração LINX PDV	Preço demarcado	Sem linha válida na view ou preço líquido não menor que o de tabela.	Retorno `0.00`.
Integração LINX PDV	Preço demarcado	Parâmetros de produto, cor e tabela coerentes com cadastro LINX.	Consulta retorna no máximo um registro aplicável à regra.