LojaReservaSaidaCancelamento (STATUS: DOCUMENTADO)

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

Campo	Tipo	Obrigatório	Descrição
key	string	não	Chave de API quando exigida pela plataforma.
COD_FILIAL	string	sim	Filial.
NUMERO	string	sim	Identificador do romaneio (ROMANEIO_PRODUTO) na saída.

Exemplo de payload enviado para o endpoint (JSON):

{
  "key": "<API_KEY_SE_APLICAVEL>",
  "COD_FILIAL": "000001",
  "NUMERO": "<ROMANEIO_PRODUTO>"
}

Tratamento de Dados

Atualização em LOJA_SAIDAS com SAIDA_CANCELADA, zeragem de totais e datas de transferência; para cada linha de LOJA_SAIDAS_PRODUTO, zera valor, quantidade de saída e colunas de grade EN1–EN48.

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.