LojaVendaControleTicketPdv (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 controle de ticket e lançamento por C.O. do PDV.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: associação do número de controle do PDV ao ticket e ao lançamento de caixa na tabela de controle de vendas do PDV Ilimitar.

Descrição geral

Exige o envio do C.O. (controle). Se ainda não existir registro para esse controle, gera ticket e lançamento de caixa ou usa valores alternativos informados, validando colisão com outro controle.

Se o registro já existir, harmoniza ticket e lançamento com o payload, recusando divergências.

Estrutura de Dados

Nome	Tipo
CO	string
CODIGO_FILIAL	string
TERMINAL	string
DATA_VENDA	string
DATA_DIGITACAO	string
TICKET	string
LANCAMENTO_CAIXA	string
ALT_TICKET	string
ALT_LANCAMENTO	string

Fonte

Origem consultada e gravação: tabela ILLIMITAR_PDV_CONTROLE_VENDA; para ticket sequencial, consulta de máximo ticket por filial; para lançamento, função de sequência de pagamento do caixa.

Integração

Apenas LINX.

Tratamento de dados

• Novo controle: insere linha com C.O., ticket e lançamento; verifica unicidade do par filial/terminal/data/lançamento.
• Controle existente: devolve ticket e lançamento gravados; valida consistência com valores enviados.

Tratamento de retorno

Retorna parâmetros com TICKET e LANCAMENTO_CAIXA definidos. Erros com prefixo da entidade de controle.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Controle de ticket	C.O. novo sem colisão.	Inclusão e retorno de ticket e lançamento gerados.
Integração LINX PDV	Controle de ticket	C.O. já registrado.	Retorno dos valores existentes; divergência gera erro.
Integração LINX PDV	Controle de ticket	C.O. ausente.	Exceção indicando envio obrigatório.