LojaTransferenciaSaida (STATUS: DOCUMENTADO)

Documentação Técnica

Nome do cliente	OSKLEN
Nome do projeto	Integração LINX → ILLI (Transferência Saída)
Biblioteca	wosk_loja_transferencia_saida
Data	26/03/2026

Histórico de Versões

Data	Versão	Modificado por	Descrição da Mudança
26/03/2026	1.0	Maykon/Gustavo	Criação da documentação técnica do processo Loja Transferência Saída (LINX).

Descrição

Este serviço de transferência de saída recebe dados pelo endpoint, valida produtos quando informados, resolve filiais de origem e destino e gera ou reutiliza o número de romaneio.
Persiste cabeçalho em LOJA_SAIDAS e itens em LOJA_SAIDAS_PRODUTO com distribuição de quantidades por grade.

Endpoint (API)

O fluxo principal valida entrada, resolve duas filiais em FILIAIS, obtém NUMERO por sequência quando vazio, chama setLojaSaidas e, com PRODUTOS, agrega por produto-cor e preenche colunas EN1–EN48, quantidade e valor.

Chamada: Requisição HTTP
Recurso: /bibliotecas/304a84cd-c134-4265-aa2b-7420f774ea9a/wosk_loja_transferencia_saida
Método HTTP: POST

Estruturação de Dados

Campo	Tipo	Obrigatório	Descrição
`key`	string	não	Chave de API quando exigida pela plataforma.
`COD_FILIAL`	string	sim	Filial de origem.
`COD_FILIAL_DESTINO`	string	sim	Filial de destino.
`CODIGO`	string	sim	Usado na geração do romaneio quando `NUMERO` vazio.
`DATA_EMISSAO`	datetime	sim	Data de emissão para sequência.
`NUMERO`	string	condicional	Romaneio; gerado quando vazio.
`PRODUTOS`	array	condicional	Itens com tamanho, quantidade e preço.

Exemplo de payload enviado para o endpoint (JSON):

{
  "COD_FILIAL": "000001",
  "COD_FILIAL_DESTINO": "000002",
  "CODIGO": "<CODIGO>",
  "DATA_EMISSAO": "<DATA>",
  "NUMERO": "",
  "PRODUTOS": []
}

Tratamento de Dados

Validação de produtos via serviço de venda quando PRODUTOS informado; insert/update em LOJA_SAIDAS e LOJA_SAIDAS_PRODUTO com totais e grades.

Tratamento de retorno

Sucesso: Mensagem OK. Falha: ERROR.

Fluxo do Processo

Critérios de Aceitação

Processo	Subprocesso	Descrição	Situação esperada
Endpoint (API)	Romaneio	Deve criar ou localizar romaneio e gravar itens com grades corretas.	Registros em `LOJA_SAIDAS` e produtos consistentes.