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