LojaTransferenciaEntrada (STATUS: DOCUMENTADO)

Documentação Técnica

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

Descrição

A biblioteca combina um endpoint de conferência de entrada no LINX com captura e fila que envia transferências de entrada ao ILLI.
O monitor lê entradas abertas com enriquecimento fiscal opcional via FATURAMENTO; a fila envia o romaneio ao serviço de origem CD no ILLI com tabela de preço padrão LM quando ausente.

Capturador

Descrição Conceitual

A captura automática consulta LOJA_ENTRADAS com LEFT JOIN FATURAMENTO quando o serviço LojaTransferenciaEntrada está apto, com filtro de data mínima e paginação conforme o limite configurado para o serviço LojaTransferenciaEntrada. Itens do romaneio são carregados por método auxiliar em LOJA_ENTRADAS_PRODUTO e anexados ao conteúdo antes do enfileiramento. A chave é ROMANEIO_PRODUTO-FILIAL.

A captura manual usa a mesma chave composta para reler cabeçalho e itens.

Fonte

Origem consultada: tabela LOJA_ENTRADAS com LEFT JOIN em FATURAMENTO (campos de NF e totais).

Consulta principal (cabeçalho):

SELECT
    LE.ROMANEIO_PRODUTO,
    LE.FILIAL,
    LE.CODIGO_TAB_PRECO,
    LE.TIPO_ENTRADA_SAIDA,
    LE.FILIAL_ORIGEM,
    LE.NUMERO_NF_TRANSFERENCIA,
    LE.ROMANEIO_NF_SAIDA,
    LE.EMISSAO,
    LE.DATA_SAIDA,
    LE.DATA_PARA_TRANSFERENCIA,
    FT.NF_FATURA,
    FT.VALOR_TOTAL AS VALOR_NF
FROM
    LOJA_ENTRADAS LE (NOLOCK)
    LEFT JOIN FATURAMENTO FT (NOLOCK)
        ON (FT.NOME_CLIFOR = LE.FILIAL AND FT.NF_SAIDA = LE.NUMERO_NF_TRANSFERENCIA)

Operações com Dados

Leitura: cabeçalho conforme Fonte; itens via consulta a LOJA_ENTRADAS_PRODUTO por ROMANEIO_PRODUTO e FILIAL.

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

Fila de Processamento

Descrição Conceitual

Se CODIGO_TAB_PRECO estiver vazio, define-se LM. O conteudo é enviado ao ILLI no recurso de transferência de entrada. O fluxo interpreta success e message e persiste situação na tabela da fila de integração.

Estruturação de Dados (fila)

Campos principais do `conteudo` enfileirado
Campo	Tipo	Obrigatório	Descrição
`key`	string	não	Chave de API quando exigida pela plataforma.
`ROMANEIO_PRODUTO`	string	sim	Identificador do romaneio na filial.
`FILIAL`	string	sim	Filial de destino da entrada.
`CODIGO_TAB_PRECO`	string	condicional	Preenchido com `LM` no envio se vazio.
Itens anexados conforme leitura de `LOJA_ENTRADAS_PRODUTO` no monitor.

Exemplo de payload enviado na integração (JSON) — resumo:

{
  "ROMANEIO_PRODUTO": "<ROMANEIO>",
  "FILIAL": "<FILIAL>",
  "CODIGO_TAB_PRECO": "LM",
  "FILIAL_ORIGEM": "<ORIGEM>"
}

Tratamento de Dados (fila)

Definição de CODIGO_TAB_PRECO padrão LM quando ausente.

Integração com o ILLI

Chamada: Requisição HTTP
Recurso: /bibliotecas/4415a517-b13e-4d39-9e4c-eaccb1386dfc/ilx_transferencia_entrada/setOrigemCD
Método HTTP: POST
Corpo: conteudo do registro na fila (com itens quando capturados).

Tratamento de retorno (fila)

A situação quando success presente; caso contrário de erro; ausência de resposta ou JSON não reconhecido conforme tratamento padrão.

Notificação

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

Endpoint (API)

O serviço HTTP de conferência recebe COD_FILIAL, localiza a filial, executa o fluxo que atualiza LOJA_ENTRADAS via procedimento LX_LOJA_ENTRADAS_ILLIMITAR e valida DATA_ENTRADA_CONFERIDA, com referência a NUMERO ou NUMERO_ORIGEM conforme o preenchimento do payload.

Chamada: Requisição HTTP
Recurso: /bibliotecas/6b1349c5-90e0-4344-b9b7-77878e11ae87/wosk_loja_transferencia_entrada
Método HTTP: POST

Estruturação de Dados (endpoint)

Campo	Tipo	Obrigatório	Descrição
`key`	string	não	Chave de API quando exigida pela plataforma.
`COD_FILIAL`	string	sim	Filial (resolvida em `FILIAIS`).
`NUMERO`	string	condicional	Romaneio quando não se usa origem.
`NUMERO_ORIGEM`	string	condicional	Romaneio NF saída quando aplicável.
`DATA_RECEBIDO`	datetime	sim	Data de recebimento/conferência.

Exemplo de payload enviado para o endpoint (JSON):

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

Tratamento de Dados (endpoint)

Execução do procedimento armazenado com parâmetros de conferência e encerramento de entrada; validação de presença de DATA_ENTRADA_CONFERIDA após atualização.

Tratamento de retorno (endpoint)

Sucesso: Mensagem OK. Falha: ERROR com texto da exceção.

Fluxo do Processo

Critérios de Aceitação

Processo	Subprocesso	Descrição	Situação esperada
Capturador	Entrada em trânsito	Deve enfileirar romaneios com itens para o ILLI.	Registro na fila com chave válida.
Fila de Processamento	ILLI	Deve chamar `setOrigemCD` e persistir situação na tabela da fila de integração.	Situação coerente com o retorno.
Endpoint (API)	Conferência	Deve atualizar entrada conferida no LINX via procedimento.	`Mensagem` `OK` ou erro explícito.