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

Segundo parâmetro do serviço

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.