LojaCendaCancelamentoVenda (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
CANCELADOnos 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. |