LojaVendaRegistroLancamentoCaixa (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 abertura e fechamento de caixa por terminal. |
Cabeçalho e identificação
Subprocesso do recurso loja_venda: garante registro de abertura (00) ou fechamento (RT) de caixa em LOJA_CAIXA_LANCAMENTOS, com validação de filial, loja e terminal.
Descrição geral
Resolve COD_FILIAL em cadastro de filiais e loja varejo, obtém gerente e valida terminal. Monta data de operação, digitação (manhã ou final do dia no fechamento) e histórico descritivo.
No fechamento, verifica se houve abertura no período; se não houver abertura, pode pular o registro. Gera sequência de lançamento via função do banco quando necessário e confere inserção.
Estrutura de Dados
| Nome | Tipo |
COD_FILIAL |
string |
TERMINAL |
string |
DATA |
string |
| Nome | Tipo |
fechamento |
boolean |
Fonte
Origem consultada: FILIAIS, LOJAS_VAREJO, LOJA_TERMINAIS, LOJA_CAIXA_LANCAMENTOS; sequência via função fn_GetNextPaymentSequence no fluxo de geração de lançamento.
Integração
Persistência no LINX; sem Protheus.
Tratamento de dados
- Inserção: quando não existe lançamento do tipo e data para terminal e filial, insere com hidratação definida no serviço.
- Fechamento sem abertura: não insere fechamento e zera identificador de lançamento no retorno quando aplicável.
- Pós-inserção: valida que o número gerado coincide com o gravado.
Tratamento de retorno
Retorna o array de parâmetros enriquecido com PERIODO_FECHAMENTO e, em fechamento quando registrado, LANCAMENTO_CAIXA. Erros encapsulados com prefixo da entidade de caixa.
Critérios de aceitação
| Processo | Subprocesso | Descrição | Situação esperada |
| Integração LINX PDV | Lançamento de caixa | Filial, loja e terminal válidos; primeira abertura do dia. | Inclusão em LOJA_CAIXA_LANCAMENTOS tipo 00. |
| Integração LINX PDV | Lançamento de caixa | Fechamento com abertura prévia existente. | Inclusão tipo RT ou reconhecimento de já existente conforme regra de duplicidade. |
| Integração LINX PDV | Lançamento de caixa | Gerente não definido na loja. | Exceção com mensagem explícita. |