LojaVendaVendedoresComissao (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 vendedores e comissão da venda.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: manutenção do vendedor principal da venda em LOJA_VENDA_VENDEDORES e, no modo alteração de vendedor, recálculo da comissão em LOJA_VENDA.

Descrição geral

No fluxo padrão insere ou atualiza o único vendedor do ticket com comissão em valor absoluto derivada do percentual e do valor pago.

Com o flag de alteração, resolve filial e loja, localiza venda pelo C.O., compara vendedor anterior e novo e atualiza comissão na cabeça do cupom antes de gravar o vendedor.

Estrutura de Dados

Nome	Tipo
CODIGO_FILIAL	string
TICKET	string
DATA_VENDA	string
VENDEDOR	string
COMISSAO	number
VALOR_PAGO	number
CODIGO_CLIENTE	string
ACESSO_GERENCIAL	number
CO	string
COD_FILIAL	string
TERMINAL	string
LANCAMENTO_CAIXA	string

Segundo parâmetro

Nome	Tipo
alteraVendedor	boolean

Fonte

Origem consultada e gravação: LOJA_VENDA_VENDEDORES, LOJA_VENDA, ILLIMITAR_PDV_CONTROLE_VENDA, FILIAIS, LOJAS_VAREJO no modo alteração.

Integração

Persistência LINX.

Tratamento de dados

• Inclusão: primeiro vendedor do ticket quando não há linha.
• Atualização: quando vendedor gravado difere do enviado, ajusta vendedor, comissão e carimbo de transferência.
• Alteração de vendedor: zera valor pago de entrada, recarrega valor da venda e recalcula comissão na cabeça se o código mudou.

Tratamento de retorno

Retorna parâmetros atualizados. Erros prefixados pela entidade de vendedores da venda.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Vendedores	Primeiro vendedor do ticket.	Inclusão com comissão calculada.
Integração LINX PDV	Vendedores	Troca de código de vendedor com registro existente.	Atualização de vendedor e comissão.
Integração LINX PDV	Vendedores	Modo alteração com C.O. válido e vendedor distinto.	Cabeça da venda atualizada antes do detalhe de vendedor.