LojaTributacao (STATUS: DOCUMENTADO)

DocumentaçãDocumentação TéTécnica

Nome do cliente	OSKLEN
Nome do projeto	IntegraçãIntegração LINX →→ ILLI (TributaçãTributação)
Biblioteca	wosk_loja_tributacao
Data	26/03/2026

HistóHistórico de VersõVersões

Data	VersãVersão	Modificado por	DescriçãDescrição da MudançMudança
26/03/2026	1.0	Maykon/Gustavo	CriaçãCriação da documentaçãdocumentação tétécnica do processo Loja TributaçãTributação (LINX →→ ILLI).

DescriçãDescrição

Este serviçserviço de exceçõexceções fiscais sincroniza registros de CTB_EXCECAO_IMPOSTO enriquecidos com naturezas de entrada e saísaída e listas de impostos e filtros calculados no monitor.
Cada registro éé enviado ao ILLI com chave ID_EXCECAO_IMPOSTO.

Capturador

DescriçãDescrição Conceitual

A captura automáautomática consulta a projeçãprojeção principal (exceçãexceção com joins em NATUREZAS_SAIDAS e NATUREZAS_ENTRADAS) quando o serviçserviço LojaTributacao estáestá apto, com DATA_PARA_TRANSFERENCIA mímínima e paginaçãpaginação conforme o limite configurado para o serviçserviço LojaTributacao. Antes de enfileirar, anexa IMPOSTO via getImposto e FILTRO via getFiltro.

A captura por chave reprocessa pelo ID_EXCECAO_IMPOSTO.

Fonte

Origem consultada: CTB_EXCECAO_IMPOSTO com LEFT JOIN em NATUREZAS_SAIDAS e NATUREZAS_ENTRADAS conforme a viewQuery completa no arquivo-fonte (dezenas de colunas fiscais e contácontábeis).

Consulta principal:

SELECT
    EI.CODIGO_FISCAL_OPERACAO,
    EI.ID_EXCECAO_IMPOSTO,
    EI.UF,
    EI.DESC_EXCECAO,
    EI.NATUREZA_SAIDA,
    EI.NATUREZA_ENTRADA,
    EI.DATA_PARA_TRANSFERENCIA,
    <demais colunas EI, NS, NE conforme viewQuery do arquivo>
FROM
    CTB_EXCECAO_IMPOSTO EI (NOLOCK)
    LEFT JOIN NATUREZAS_SAIDAS NS (NOLOCK) ON (NS.NATUREZA_SAIDA = EI.NATUREZA_SAIDA)
    LEFT JOIN NATUREZAS_ENTRADAS NE (NOLOCK) ON (NE.NATUREZA = EI.NATUREZA_ENTRADA)

OperaçõOperações com Dados

Leitura: conforme Fonte mais anexos IMPOSTO e FILTRO.

Consulta dinâdinâmica (captura automáautomática): WHERE EI.DATA_PARA_TRANSFERENCIA >= filtro, ordenaçãordenação e paginaçãpaginação conforme limite do serviçserviço LojaTributacao.

PersistêPersistência: grava na Fila de Processamento com serviçserviço LojaTributacao e chave ID_EXCECAO_IMPOSTO.

Fila de Processamento

DescriçãDescrição Conceitual

O conteudo completo (incluindo IMPOSTO e FILTRO) éé enviado ao ILLI sem transformaçãtransformação adicional no processamento da fila.

EstruturaçãEstruturação de Dados

Campos de referêreferência do conteudo

Campo	Tipo	ObrigatóObrigatório	DescriçãDescrição
key	string	nãnão	Chave de API quando exigida pela plataforma.
ID_EXCECAO_IMPOSTO	string	sim	Identificador da exceçãexceção; chave na fila.
Mais colunas da exceçãexceção e joins; objetos IMPOSTO e FILTRO anexados no capturador.

Exemplo de payload enviado para o endpoint (JSON) —— estrutura resumida:

{
  "ID_EXCECAO_IMPOSTO": "<ID>",
  "DESC_EXCECAO": "<TEXTO>",
  "IMPOSTO": [],
  "FILTRO": [],
  "DATA_PARA_TRANSFERENCIA": "<DATA_HORA>"
}

 

Tratamento de Dados

Montagem de IMPOSTO e FILTRO no capturador; fila repassa o objeto integralmente.

Integraçã 

Integração com o ILLI

• Chamada: RequisiçãRequisição HTTP
• Recurso: /bibliotecas/0b2c5127-7e14-4f17-a4bb-1cdc30a741a8/ilx_tributacao/api/setTributacao
• MéMétodo HTTP: POST
• Corpo: conteudo do registro na fila.

 

Tratamento de retorno

PadrãPadrão success/message; situaçãsituação 2 ou 4.

Notificaçã 

Notificação

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

 

Fluxo do Processo

CritéCritérios de AceitaçãAceitação

Processo	Subprocesso	DescriçãDescrição	SituaçãSituação esperada
Fila de Processamento	IntegraçãIntegração	Deve enviar o payload completo ao setTributacao e persistir retorno na tabela da fila de integraçãintegração.	SituaçãSituação coerente com o JSON retornado.