LojaVendaPedidoVitrine (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 pedido vitrine único.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: registro do pedido de vitrine no encerramento da venda em UNICO_VITRINE_PEDIDO, com NSU gerado e valores de pedido, desconto e frete.

Descrição geral

Usa identificador do pedido vitrine, filial, ticket, datas de vitrine e venda, cliente, número de título e valores monetários. Gera NSU composto por data e sequência calculada no serviço.

Se já existir pedido para filial, ticket e data de venda, apenas atualiza desconto de loja quando divergir; caso contrário insere linha confirmada e não cancelada.

Estrutura de Dados

Nome	Tipo
ID_PEDIDO_VITRINE	number
CODIGO_FILIAL	string
TICKET	string
DATA_VENDA	string
DATA_VITRINE	string
NUMERO_TITULO_VITRINE	string
CODIGO_CLIENTE	string
VALOR_VITRINE	number
VALOR_DESCONTO_VITRINE	number
VALOR_FRETE	number

Fonte

Origem consultada e gravação: UNICO_VITRINE_PEDIDO; NSU via consulta SQL interna ao serviço de geração de sequência de vitrine.

Integração

Persistência LINX.

Tratamento de dados

• Valores: valor original do pedido, desconto (tratando sinal negativo) e frete opcional.
• Atualização seletiva: somente desconto de loja quando já existe pedido e o valor difere.

Tratamento de retorno

Retorna parâmetros. Erros prefixados pela entidade de pedido vitrine.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Pedido vitrine	Primeiro pedido para filial/ticket/data de venda.	Inclusão com NSU e flags de confirmação.
Integração LINX PDV	Pedido vitrine	Pedido existente e desconto alterado.	Atualização apenas do desconto de loja.
Integração LINX PDV	Pedido vitrine	Pedido existente sem mudança de desconto.	Nenhuma atualização adicional.