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