LojaVendaItemTroca (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 item de troca na venda.

Cabeçalho e identificação

Subprocesso do recurso loja_venda: inclusão de linha de mercadoria de troca em LOJA_VENDA_TROCA quando ainda não existir para ticket, item e data.

Descrição geral

Pode resolver filial de origem a partir de COD_FILIAL_ORIGEM para preencher códigos de filial e cliente de origem. Monta item com dados de produto, quantidades, preço, custo e referências opcionais de origem (ticket, item, NF, datas, terminal, ECF).

Não atualiza registro existente: evita duplicidade pela chave.

Estrutura de Dados

Nome	Tipo
TICKET	string
CODIGO_FILIAL	string
DATA_VENDA	string
ITEM	string
ITEM_DEVOLUCAO	string
CODIGO_BARRA	string
PRODUTO	string
COR_PRODUTO	string
TAMANHO	string
QTDE	number
PRECO_LIQUIDO	number
CUSTO	number
DEMARCADO	number
COD_FILIAL_ORIGEM	string
TICKET_ORIGEM	string
ITEM_ORIGEM	string
NUMERO_CUPOM_FISCAL_ORIGEM	string
DATA_VENDA_ORIGEM	string
TERMINAL_ORIGEM	string
ECF_ORIGEM	string
ROMANEIO_AJUSTE	string
FILIAL_AJUSTE	string

Fonte

Origem consultada e gravação: LOJA_VENDA_TROCA; quando aplicável FILIAIS e LOJAS_VAREJO para origem.

Integração

Persistência LINX.

Tratamento de dados

Define número do item com padding ou usa item de devolução quando informado. Propaga demarcado para desconto do item.

Tratamento de retorno

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

Critérios de aceitação

Processo	Subprocesso	Descrição	Situação esperada
Integração LINX PDV	Item troca	Item novo na chave.	Inclusão em LOJA_VENDA_TROCA.
Integração LINX PDV	Item troca	Filial de origem informada.	Códigos de filial de origem resolvidos via cadastros.
Integração LINX PDV	Item troca	Linha já existente.	Nenhuma nova gravação neste fluxo.