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