LojaReservaSaidaCancelamento

Documentação Técnica

Nome do cliente	OSKLEN
Nome do projeto	Integração LINX → ILLI (Cancelamento Reserva Saída)
Biblioteca	wosk_loja_reserva_saida_cancelamento
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 Reserva Saída Cancelamento (LINX).

Descrição

Este serviço cancela movimentos de saída vinculados à reserva no LINX, marcando a saída como cancelada e zerando quantidades e valores nos itens de LOJA_SAIDAS_PRODUTO conforme o fluxo implementado.
Não há integração HTTP com o ILLI no arquivo analisado.

Endpoint (API)

Após validação e resolução de FILIAL, o processamento localiza o romaneio em LOJA_SAIDAS, atualiza flags de cancelamento e propaga zeragem para os itens em LOJA_SAIDAS_PRODUTO.

• Chamada: Requisição HTTP
• Recurso: /bibliotecas/988f11fd-2965-4c21-afb9-35fcbec90f44/wosk_loja_reserva_saida_cancelamento
• Método HTTP: POST

Estruturação de Dados

Parâmetros de entrada do endpoint (payload recebido no processamento principal)

Campo	Tipo	Obrigatório	Descrição
key	string	não	Chave de autenticação/controle da chamada.
eventId	string (UUID)	não	Identificador do evento de origem; o método executa o processamento principal desta biblioteca não utiliza este campo.
COD_FILIAL	string	sim	Código da filial (consulta em FILIAIS e LOJAS_VAREJO).
NUMERO	string	sim	Romaneio (ROMANEIO_PRODUTO) da saída a cancelar.
DATA	string (datetime)	não	Pode integrar o payload; o método executa o processamento principal desta biblioteca não utiliza este campo.
NF_CHAVE	string	não	Chave de acesso da NF; não referenciada no fluxo de cancelamento deste arquivo.
NF_SERIE, NF_MODELO, NF_NUMERO	number	não	Dados fiscais de referência; não utilizados no registra saídas da loja analisado.
DATA_CANCELAMENTO	string (datetime)	não	Data/hora do cancelamento fiscal; não gravada diretamente pelos campos deste fluxo (o código atualiza DATA_PARA_TRANSFERENCIA com a data/hora do processamento).
PROTOCOLO_CANCELAMENTO	string	não	Protocolo de cancelamento da NF; não persistido no trecho analisado.

Exemplo de payload enviado para o endpoint (JSON):

{
  "key": "df9b5d7f-da04-42f1-80b2-6b6bbbc39152",
  "DATA": "2026-03-24 11:00:08",
  "NUMERO": "I0387317",
  "eventId": "feb79851-762b-41ee-96bf-24658dfdbbcf",
  "NF_CHAVE": "33260335943604008300550550000261331835829560",
  "NF_SERIE": 55,
  "NF_MODELO": 55,
  "NF_NUMERO": 26133,
  "COD_FILIAL": "000424",
  "DATA_CANCELAMENTO": "2026-03-24 11:13:01",
  "PROTOCOLO_CANCELAMENTO": "233260131405633"
}

Operações com Dados

No fluxo principal do endpoint:

• Validação: validação base do serviço (valida os dados).
• Filial: consulta em FILIAIS pelo COD_FILIAL; preenche-se FILIAL.
• Loja: consulta em LOJAS_VAREJO por FILIAL; preenchem-se CODIGO_FILIAL e GERENTE_LOJA.
• Cancelamento: registra saídas da loja localiza o cabeçalho em LOJA_SAIDAS por FILIAL e ROMANEIO_PRODUTO (NUMERO), aplica o UPDATE do romaneio e, em seguida, lê todas as linhas de LOJA_SAIDAS_PRODUTO do romaneio e atualiza cada uma com zeragem de quantidades e valores.

Tratamento de Dados

Modificações explícitas aplicadas aos dados de entrada ou aos registros atualizados:

• Consulta de filial: COD_FILIAL é alinhado com preenchimento à esquerda até 6 posições antes da busca em FILIAIS.
• LOJA_SAIDAS (cabeçalho): definem-se QTDE_TOTAL e VALOR_TOTAL como zero, SAIDA_CANCELADA como 1 e DATA_PARA_TRANSFERENCIA com a data/hora corrente do processamento.
• LOJA_SAIDAS_PRODUTO (itens): para cada produto/cor do romaneio, definem-se VALOR, QTDE_SAIDA e PRECO1 como zero, todas as colunas EN1–EN48 como zero e DATA_PARA_TRANSFERENCIA com a data/hora corrente do processamento.

Tratamento de retorno

Sucesso: Mensagem OK. Falha: ERROR com mensagem da exceção (registro não encontrado, falha de update, etc.).

Fluxo do Processo

Critérios de Aceitação

Processo	Subprocesso	Descrição	Situação esperada
Endpoint (API)	Cancelamento	Deve localizar saída e itens e aplicar cancelamento e zeragem conforme regra.	Tabelas atualizadas ou erro retornado.