loja_venda_cabecalho_cupom_documentacao

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 persistênciacabeçalho deda itemvenda deno pedido vitrine na tabela de itens.cupom.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: gravaçãinclusão do itemregistro deprincipal pedidoda devenda vitrine na tabelaem UNICO_VITRINE_PEDIDO_ITEMLOJA_VENDA quando ainda não existe registroexistir para a combinaçãochave filial, terminal, lançamento de filial, ticket, identificador de item do pedidocaixa e data deda venda. Integra o fluxo de venda com produtos de vitrine após validação e montagem de contexto de PDV.

Descrição geral

OAgrega subprocessovalores montamonetários, aquantidades, comissão proporcional, desconto, frete, troca e origem (PDV ou mobile). Associa cliente e CPF/CGC no ECF quando aplicável.

Não atualiza linha aexistente inserirneste a partir dos parâmetros recebidos: chaves do pedido vitrine, código de barras, quantidade, preço líquido unitário, vendedor e desconto do item.

Quantidade e preço unitário gravados iniciam em zero e só recebem valores quando a quantidade e o preço líquido informados são estritamente positivos; o desconto do item segue a mesma lógica em relação ao desconto informado.

Se não existir linha para a chave consultada, executa-se inclusão e em seguida nova leitura para confirmar o registro;trecho: se o itemticket já existir,estiver nenhumapresente, atualizaçãapenas confirma e devolve o é aplicada neste trecho.ticket.

Estrutura de Dados

Nome	Tipo
ID_ITEM_VITRINE	int
ID_PEDIDO	int
CODIGO_FILIALLANCAMENTO_CAIXA	string
TICKET	string
CODIGO_FILIAL	string
DATA_VENDA	string
CODIGO_BARRADATA_DIGITACAO	string
QTDE	number
PRECO_LIQUIDO	number
VENDEDOR	string
DESCONTO_ITEMOPERACAO_VENDA	string
CODIGO_TAB_PRECO	string
COMISSAO	number
VALOR_PAGO	number
DESCONTO	number
QTDE_TOTAL	number
VALOR_FRETE	number
VALOR_VENDA_BRUTA	number
VALOR_TROCA	number
QTDE_TROCA_TOTAL	number
TERMINAL	string
GERENTE_LOJA	string
COD_FORMA_PGTO	string
PERIODO_FECHAMENTO	string
MOBILE	string
CO	string
CODIGO_CLIENTE	string

Fonte

Origem consultada: tabela UNICO_VITRINE_PEDIDO_ITEM, leitura por CODIGO_FILIAL, TICKET, ID_PEDIDO_ITEM (derivado do identificador de item vitrine recebido)consultada e gravação: DATA_VENDALOJA_VENDA, para decidir entre inclusão e ausência de ação..

Integração

Persistência exclusiva no banco LINX via inclusão na tabela UNICO_VITRINE_PEDIDO_ITEM quando aplicável. Não há chamada a serviço HTTP externo nem rotina de integração com o Protheus neste subprocesso.LINX.

Tratamento de dados

O

identificador
• Comissão: percentual sobre valor pago quando ambos positivos.
• Desconto: sinal invertido para gravar conforme convenção do serviço.
• Mobile: campo de linhaorigem doda itemvenda gravadodistingue em ID_PEDIDO_ITEM corresponde ao valor recebido em ID_ITEM_VITRINE. O campo ID_PEDIDO é repassado ao registro. QTDE é convertida para inteiro quando positiva; PRECO_UNITARIO recebe o valor numéricoPDV de PRECO_LIQUIDOmobile.
quando
• C.O. estelongo: éforça positivo; DESCONTO recebe o valor numéricovalores de DESCONTO_ITEMticket quandoe positivo.

  Após inclusão bem-sucedida, uma nova consulta deve retornar o item; caso contrário é lançada exceção indicandopagamento não encontradonegativos naonde tabelaaplicado.

de itens, com filial, ticket, identificador de item e data na mensagem.

Tratamento de retorno

Retorno do array deRetorna parâmetros recebido,com semTICKET estruturaconfirmado. alterada além do esperado pelo chamador. Em falha de execução SQL ou confirmação ausente após inclusão, a exceção é relançadaErros com prefixo identificandoda a tabelaentidade de itens do pedido vitrine, para integrar a mensagem ao retorno do processamento da venda.

Critérios de Aceitaçaceitação

Processo	Subprocesso	Descrição	Situação esperada
VendaIntegração LINX PDV (recurso)	ItemCabeçalho pedido vitrinecupom	NãoVenda existeainda linhainexistente emna UNICO_VITRINE_PEDIDO_ITEM para filial, ticket, item e data informados.chave.	Inclusão executada;e leitura posterior confirma ID_PEDIDO_ITEM; retorno do array de parâmetrosconfirmação semcom exceção.ticket.
VendaIntegração LINX PDV (recurso)	ItemCabeçalho pedido vitrinecupom	JáRegistro existejá linha para a mesma chave.existente.	NenhumaRetorno inclusãodo nemticket atualizaçãosem novo insert neste trecho; retorno do array sem exceção.fluxo.
VendaIntegração LINX PDV (recurso)	ErroCabeçalho de persistênciacupom	FalhaCliente nacom execuçãocódigo SQLlongo ou leitura pós-inclusão sem dados esperados.(CPF/CGC).	ExceçãoCPF_CGC_ECF com prefixo da tabela de itens; venda pode retornar erropreenchido no fluxo principal conforme tratamento global.registro.