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