LojaVendaOrigemTroca (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 vínculo de origem da troca.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: registro da origem fiscal e operacional da mercadoria trocada em LOJA_VENDA_TROCA_ORIGEM.

Descrição geral

Resolve filial de origem via cadastros de filial e loja, normaliza data de venda de origem e item de origem (incluindo variantes de devolução), e grava chave de NF, modelo, ECF e chave de NF-e de origem quando informados.

Insere apenas se não houver linha para o ticket, item e data da venda atual.

Estrutura de Dados

Nome	Tipo
TICKET	string
CODIGO_FILIAL	string
DATA_VENDA	string
ITEM	string
ITEM_DEVOLUCAO	string
COD_FILIAL_ORIGEM	string
TICKET_ORIGEM	string
DATA_ORIGEM	string
ITEM_ORIGEM	string
ITEM_ORIGEM_DEVOLUCAO	string
NUMERO_CUPOM_FISCAL_ORIGEM	string
MODELO_FISCAL_ORIGEM	string
ECF_ORIGEM	string
CHAVE_NFE_ORIGEM	string

Fonte

Origem consultada e gravação: LOJA_VENDA_TROCA_ORIGEM, FILIAIS, LOJAS_VAREJO.

Integração

Persistência LINX.

Tratamento de dados

DATA_VENDA_ORIGEM gravada como meia-noite do dia derivado de DATA_ORIGEM. Itens com padding de quatro dígitos salvo uso de item de devolução explícito.

Tratamento de retorno

Retorna parâmetros. Erros prefixados pela entidade de origem de troca.

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Origem troca	Primeiro registro para chave ticket/item/data.	Inclusão com filial de origem resolvida.
Integração LINX PDV	Origem troca	Registro já existente.	Nenhuma nova linha.
Integração LINX PDV	Origem troca	Chave de NF-e de origem informada.	Campo persistido na entidade de origem.