LojaVendaCancelamentoForaPrazo
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 fora do prazo (referência fiscal). |
Cabeçalho e identificação
Subprocesso do recurso loja_venda: atualização do pagamento da venda com número e série da nota fiscal de cancelamento emitida fora do prazo usual, mantendo referência ao cupom fiscal original.
Descrição geral
Resolve filial e loja, localiza controle pelo C.O. e carrega o pagamento. Grava número fiscal de cancelamento com padding e série informados, além do carimbo de transferência.
Não altera demais entidades da venda neste trecho.
Estrutura de Dados
| Nome | Tipo |
COD_FILIAL |
string |
TERMINAL |
string |
CO |
string |
DATA_VENDA |
string |
NF_NUMERO |
number |
NF_SERIE |
string |
Fonte
Origem consultada e atualização: FILIAIS, LOJAS_VAREJO, ILLIMITAR_PDV_CONTROLE_VENDA, LOJA_VENDA_PGTO.
Integração
Atualização LINX.
Tratamento de dados
Preserva o número do cupom fiscal original em variável local antes da atualização (referência no fluxo). Escreve NUMERO_FISCAL_CANCELAMENTO e SERIE_NF_CANCELAMENTO no pagamento.
Tratamento de retorno
Retorna parâmetros. Erros com prefixo indicando cancelamento fora do prazo.
Critérios de aceitação
| Processo | Subprocesso | Descrição | Situação esperada |
| Integração LINX PDV | Cancelamento prazo | Pagamento localizado pelo controle. | Campos de NF de cancelamento atualizados. |
| Integração LINX PDV | Cancelamento prazo | Número de NF informado. | Valor gravado com nove dígitos preenchidos à esquerda. |
| Integração LINX PDV | Cancelamento prazo | Pagamento inexistente. | Exceção na leitura de LOJA_VENDA_PGTO. |