LojaVendaParcelasPagamento (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 parcelas de pagamento da venda.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: inclusão de uma parcela em LOJA_VENDA_PARCELAS quando não existir para filial, terminal, lançamento e número de parcela.

Descrição geral

Trata cartão, título, administradora, troco, TEF, identificadores de PIX e método de pagamento estendido quando informados.

Não atualiza parcela já existente: evita duplicidade pela chave natural.

Estrutura de Dados

Nome	Tipo
CODIGO_FILIAL	string
TERMINAL	string
LANCAMENTO_CAIXA	string
PARCELA	string
TIPO_PGTO	string
VALOR	number
VENCIMENTO	string
PARCELAS	number
TROCO	number
CODIGO_ADMINISTRADORA	string
NUMERO_TITULO	string
NUMERO_APROVACAO_CARTAO	string
CHEQUE_CARTAO	string
REDE_CONTROLADORA	string
DATA_HORA_TEF	string
TXID	string
ENDTOENDID	string
LX_METODO_PGTO	string

Fonte

Origem consultada e gravação: LOJA_VENDA_PARCELAS.

Integração

Persistência LINX.

Tratamento de dados

• Parcela: padding a dois dígitos.
• Chave composta de cheque/cartão: gerada por filial, terminal, lançamento e parcela, salvo valor explícito.
• PIX: TXID e ENDTOENDID podem alimentar título ou aprovação conforme regras do serviço.
• Método LINX: pode estender a lista de colunas hidratadas dinamicamente.

Tratamento de retorno

Retorna os parâmetros recebidos após gravação bem-sucedida. Erros prefixados pela entidade de parcelas.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Parcelas	Parcela nova na chave.	Inclusão confirmada por leitura posterior.
Integração LINX PDV	Parcelas	Parcela já gravada.	Saída sem segundo insert.
Integração LINX PDV	Parcelas	Pagamento com identificador de liquidação instantânea.	Campos de aprovação/título preenchidos conforme mapeamento.