LojaVendaValidacaoProdutos (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 validação e enriquecimento de produtos da venda.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: validação de códigos de barra e EAN, resolução de produto/cor/grade/tamanho e cálculo de valor demarcado por listas de produtos da venda, troca e vitrine.

Descrição geral

O subprocesso percorre arrays de produtos e, para cada item, localiza o cadastro em PRODUTOS_BARRA pelo código de barra ou, opcionalmente, pelo EAN alternativo.

Normaliza códigos de tabela de preço com padding à esquerda. Acrescenta ao item o valor demarcado conforme a tabela aplicável (venda, troca ou vitrine). Mensagens de falha são acumuladas, exceto para itens marcados como insumo.

Estrutura de Dados

Nome	Tipo
CODIGO_TAB_PRECO	string
PRODUTOS	array
PRODUTOS_TROCA	array
PRODUTOS_VITRINE	array
CODIGO_TAB_PRECO_TROCA	string
CODIGO_TAB_PRECO_VITRINE	string

Elementos de PRODUTOS, PRODUTOS_TROCA e PRODUTOS_VITRINE (campos usados na validação)

Nome	Tipo
CODIGO_BARRA	string
CODIGO_EAN	string
INSUMO	string

Fonte

Origem consultada: tabela PRODUTOS_BARRA; para demarcado, view VW_ILLI_TAB_PRECOS_PRODUTOS_LINHAS (via subprocesso de preço demarcado).

Integração

Leitura no LINX; sem destino externo além do próprio retorno ao fluxo chamador.

Tratamento de dados

• Tabelas de preço: CODIGO_TAB_PRECO e, quando informados, CODIGO_TAB_PRECO_TROCA e CODIGO_TAB_PRECO_VITRINE são preenchidos à esquerda até dois dígitos.
• Resolução de item: cada linha recebe PRODUTO, COR_PRODUTO, GRADE, TAMANHO e o código de barra efetivo usado na consulta.
• Demarcado: preenchido por tabela própria (venda, troca com fallback na tabela da venda, vitrine com fallback na tabela da venda).
• Insumo: falha de resolução não entra na lista de erros quando INSUMO está preenchido.

Tratamento de retorno

Retorna um par: primeiro elemento é o conjunto de parâmetros atualizado; segundo é array de mensagens de texto para itens não resolvidos (exceto insumo). O chamador decide se interrompe o fluxo.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Validação de produtos	Código de barra existente em PRODUTOS_BARRA.	Item enriquecido com dados do produto e demarcado quando aplicável.
Integração LINX PDV	Validação de produtos	Barra inexistente e EAN alternativo válido.	Mesmo comportamento, usando o EAN para localizar o cadastro.
Integração LINX PDV	Validação de produtos	Barra inexistente, sem insumo.	Mensagem descritiva na lista de validação retornada.