LojaTransferenciaEntradaCancelamento (STATUS: DOCUMENTADO)

Documentação Técnica

Nome do cliente	OSKLEN
Nome do projeto	Integração LINX → ILLI (Transferência Entrada Cancelamento)
Biblioteca	wosk_loja_transferencia_entrada_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 Transferência Entrada Cancelamento (LINX → ILLI).

Descrição

Este serviço envia cancelamentos de transferência de entrada ao ILLI a partir de registros em LOJA_ENTRADAS com situação de cancelamento.
Se o retorno indicar transferência não encontrada, o fluxo pode tratar como sucesso para não reter o registro em erro.

Capturador

Descrição Conceitual

A captura automática consulta LOJA_ENTRADAS quando o serviço LojaTransferenciaEntradaCancelamento está apto, com filtro de data e paginação conforme o limite configurado para o serviço LojaTransferenciaEntradaCancelamento. Chave ROMANEIO_PRODUTO-FILIAL.

Fonte

Consulta principal:

SELECT
    ROMANEIO_PRODUTO,
    FILIAL,
    CODIGO_TAB_PRECO,
    TIPO_ENTRADA_SAIDA,
    FILIAL_ORIGEM,
    NUMERO_NF_TRANSFERENCIA,
    ROMANEIO_NF_SAIDA,
    EMISSAO,
    DATA_SAIDA,
    ENTRADA_CANCELADA,
    DATA_PARA_TRANSFERENCIA,
    chave_nfe
FROM
    LOJA_ENTRADAS (NOLOCK)

Operações com Dados

Persistência: grava na Fila de Processamento com serviço LojaTransferenciaEntradaCancelamento e chave ROMANEIO_PRODUTO-FILIAL.

Fila de Processamento

Descrição Conceitual

Define CODIGO_TAB_PRECO como LM quando vazio. Envia ao ILLI e, se a mensagem indicar transferência não encontrada (padrão textual do retorno), força situação de sucesso.

Estruturação de Dados

Campo	Tipo	Obrigatório	Descrição
key	string	não	Chave de API quando exigida pela plataforma.
ROMANEIO_PRODUTO	string	sim	Romaneio cancelado.
FILIAL	string	sim	Filial.
ENTRADA_CANCELADA	string	sim	Indicador de cancelamento no LINX.

Exemplo de payload enviado para o endpoint (JSON):

{
  "ROMANEIO_PRODUTO": "<ROMANEIO>",
  "FILIAL": "<FILIAL>",
  "CODIGO_TAB_PRECO": "LM",
  "ENTRADA_CANCELADA": "1"
}

Tratamento de Dados

Preenchimento padrão de tabela de preço; regra especial de sucesso quando a mensagem corresponde a transferência inexistente no destino.

Integração com o ILLI

• Chamada: Requisição HTTP
• Recurso: /bibliotecas/4415a517-b13e-4d39-9e4c-eaccb1386dfc/ilx_transferencia_entrada/setCancelamentoOrigemCD
• Método HTTP: POST

Tratamento de retorno

Situação 2 quando success presente; em erro, se a mensagem casar com transferência não encontrada, situação 2; caso contrário 4.

Notificação

A notificação de erros consulta registros com falha na tabela da fila de integração para o serviço LojaTransferenciaEntradaCancelamento e situação de erro, ordenando pelo horário de processamento para priorizar ocorrências mais antigas.

Fluxo do Processo

Critérios de Aceitação

Processo	Subprocesso	Descrição	Situação esperada
Fila de Processamento	Cancelamento ILLI	Deve enviar cancelamento e tratar "não encontrada" como concluído quando aplicável.	Situação final coerente.