LojaVendaPagamentoCupom (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 cabeçalho de pagamento da venda no caixa.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: gravação ou atualização do registro de pagamento da venda em LOJA_VENDA_PGTO por filial, terminal, lançamento de caixa e data da venda.

Descrição geral

Monta totais, forma de pagamento, vendedor no caixa, referências fiscais (NF, troca, SAT) e pedidos auxiliares quando informados.

Se não houver linha, insere; se já existir, atualiza séries, números fiscais e metadados de transferência sem recriar o registro.

Estrutura de Dados

Nome	Tipo
CODIGO_FILIAL	string
TERMINAL	string
LANCAMENTO_CAIXA	string
DATA_VENDA	string
DATA_DIGITACAO	string
TICKET	string
COD_FORMA_PGTO	string
VALOR_PAGO	number
VENDEDOR	string
GERENTE_LOJA	string
PERIODO_FECHAMENTO	string
NF_SERIE	number
NF_NUMERO	number
NF_MODELO	number
NF_SERIE_TROCA	number
NF_NUMERO_TROCA	number
CO	string
PEDIDO_WMS	string
PEDIDO_SITE	string

Fonte

Origem consultada e gravação: LOJA_VENDA_PGTO.

Integração

Persistência LINX.

Tratamento de dados

• Vendedor do caixa: usa vendedor informado ou gerente da loja.
• Modelo 59 (SAT): zera série e número fiscal de saída e preenche GUID derivado do hash do C.O.
• C.O. longo com total negativo: zera total de venda no registro de pagamento.
• Atualização: ajusta campos fiscais e DATA_PARA_TRANSFERENCIA.

Tratamento de retorno

Retorna parâmetros com LANCAMENTO_CAIXA alinhado ao registro encontrado. Erros prefixados pela entidade de pagamento.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Pagamento cupom	Primeira gravação para chave filial/terminal/lançamento/data.	Inclusão validada por nova leitura.
Integração LINX PDV	Pagamento cupom	Registro já existente.	Atualização fiscal sem duplicar linha.
Integração LINX PDV	Pagamento cupom	Nota modelo 59 com C.O. informado.	GUID SAT preenchido conforme regra do serviço.