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