LojaVendaCancelamentoVenda (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 cancelamento integral da venda.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: cancelamento operacional que zera valores e quantidades na venda, pagamento, parcelas, produtos, trocas e marca pedidos de vitrine associados.

Descrição geral

Localiza venda pelo C.O. no controle do PDV, carrega pagamento e cabeça do cupom, aplica motivo e data de cancelamento e propaga cancelamento para parcelas, itens e trocas.

Marca pedidos de vitrine ligados ao ticket como cancelados. Respeita acúmulo de valores já cancelados para não duplicar estornos.

Estrutura de Dados

Nome	Tipo
COD_FILIAL	string
TERMINAL	string
CO	string
DATA_VENDA	string
DATA_CANCELAMENTO	string

Fonte

Origem consultada e atualização: FILIAIS, LOJAS_VAREJO, ILLIMITAR_PDV_CONTROLE_VENDA, LOJA_VENDA_PGTO, LOJA_VENDA, LOJA_VENDA_PARCELAS, LOJA_VENDA_PRODUTO, LOJA_VENDA_TROCA, UNICO_VITRINE_PEDIDO.

Integração

Atualização em lote no LINX; sem destino externo.

Tratamento de dados

• Pagamento: zera totais e desconto; preenche valor cancelado se ainda não havia cancelamento registrado.
• Venda: zera comissão, desconto, quantidades e valores; registra data/hora e motivo de cancelamento; propaga valor e quantidade cancelados quando aplicável.
• Parcelas, produtos e trocas: zera valores ou quantidades com regras de não duplicar cancelamento.
• Vitrine: flag CANCELADO nos pedidos vinculados.

Tratamento de retorno

Retorna parâmetros. Erros encapsulados com prefixo indicando cancelamento na venda.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Cancelamento	C.O. existente com venda e pagamento localizados.	Cabeça e pagamento refletem cancelamento.
Integração LINX PDV	Cancelamento	Parcelas e itens presentes.	Valores/quantidades zerados conforme regra de acúmulo.
Integração LINX PDV	Cancelamento	Pedido de vitrine associado ao ticket.	Registros marcados como cancelados.