LojaVendaCabecalhoCupom (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 cabeçalho da venda no cupom.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: inclusão do registro principal da venda em LOJA_VENDA quando ainda não existir para a chave filial, terminal, lançamento de caixa e data da venda.

Descrição geral

Agrega valores monetários, quantidades, 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 existente neste trecho: se o ticket já estiver presente, apenas confirma e devolve o ticket.

Estrutura de Dados

Nome	Tipo
LANCAMENTO_CAIXA	string
TICKET	string
CODIGO_FILIAL	string
DATA_VENDA	string
DATA_DIGITACAO	string
VENDEDOR	string
OPERACAO_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 e gravação: LOJA_VENDA.

Integração

Persistência LINX.

Tratamento de dados

• Comissão: percentual sobre valor pago quando ambos positivos.
• Desconto: sinal invertido para gravar conforme convenção do serviço.
• Mobile: campo de origem da venda distingue PDV de mobile.
• C.O. longo: força valores de ticket e pagamento não negativos onde aplicado.

Tratamento de retorno

Retorna parâmetros com TICKET confirmado. Erros com prefixo da entidade de venda.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Cabeçalho cupom	Venda ainda inexistente na chave.	Inclusão e leitura de confirmação com ticket.
Integração LINX PDV	Cabeçalho cupom	Registro já existente.	Retorno do ticket sem novo insert neste fluxo.
Integração LINX PDV	Cabeçalho cupom	Cliente com código longo (CPF/CGC).	CPF_CGC_ECF preenchido no registro.