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 |
| 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. |