Pular para conteúdo

Glossário — integrador-client

Status: ativo · Responsável: gustavo · Atualizado em: 2026-09-10

  • Fluxo — uma origem de dados que o integrador-client (cliente coringa da plataforma) envia ao X-Adm: conjunto de tabelas-espelho + literal de continuação do handshake (zim/Fluxo.java). O ZIM identifica o fluxo pelo literal; cada arquivo de envio carrega só as tabelas de um fluxo. Ativo: pied (IMPORTA_PIED); prontos mas inativos: abastecimento (Continuar) e encerramento MDF-e (ENCERRA_MDFE, tabela mdf, contrato — aguarda sync rules e confirmação ZIM); previsto: sascar.
  • zim.fluxos — config (properties) que lista os fluxos ativos nesta instância, por chave separada por vírgula/espaço (zim.fluxos=pied,abastecimento). Obrigatória, sem default: ausente/vazio derruba com exit 2 listando os fluxos válidos e exemplos (a instalação declara o que roda em vez de herdar um fluxo implícito). Nome de fluxo nunca contém vírgula nem espaço — são os separadores da chave. Cada chave é resolvida por Fluxo.porChave na largada; chave desconhecida ou fluxo com tabela fora do schema também derruba com exit 2. A ordem é a ordem dos lotes no tick.
  • Agendador (processo/Agendador) — scheduler de thread única, dono do laço de vida do daemon: a cada tick (ou quando o gatilho do PowerSync acorda) roda o ciclo de cada Processador ativo em série, na ordem de zim.fluxos — nunca concorrente. O laço saiu do Processador (que virou só o miolo de um fluxo) quando a instância passou a rodar N fluxos no par de arquivos único.
  • pAbast — programa ZIM chamado via zimrtmu.exe pAbast, que importa no ERP os registros do arquivo de envio e escreve o arquivo de retorno. O nome é por hora o mesmo do programa de abastecimento legado (decisão da equipe ZIM); o que identifica esta integração (pied-maxsul) é a linha IMPORTA_PIED do handshake.
  • Arquivo de envio — arquivo texto fixed-width (1 linha = 1 registro, campo 1 = tipo de registro) que o integrador-client escreve para o pAbast consumir. Nome configurável (default histórico dXpEnvio).
  • Arquivo de retorno — arquivo texto fixed-width que o pAbast escreve antes de encerrar: 1 linha por linha do envio, na mesma ordem (matching por posição) — tipo_registro ecoado + cod_retorno + msg_retorno. Nome configurável (default histórico dXpRetorno).
  • Tabelas-espelho — as 5 tabelas do fluxo de entrada sincronizadas via PowerSync: propriedades, fones, estoque, contratos, itensped.
  • Código de retorno — máquina de status da plataforma: 000 pendente · 001 em processamento · 006 gravado (sucesso) · 1XX erro terminal de dado · 9XX erro de processamento (reprocessável).
  • Write-back — atualização da linha no SQLite local que o SDK PowerSync converte sozinho em POST /api/v1/powersync no integrador (upload queue offline-first).
  • Heartbeat — sinal de vida que a instalação manda na largada e a cada heartbeat.intervaloMinutos (60) ao integrador-server do cliente, que o repassa ao central: versão, fluxos ativos e nome da máquina. Não carrega dado de negócio, e perder um não importa. Quem enxerga o silêncio (6 horas úteis sem sinal) é o central. Contrato: heartbeat.
  • Lote — conjunto de registros pendentes enviados numa única execução do pAbast. Máximo de 999 registros (o contador de linha do arquivo tem 3 dígitos); o excedente fica para o ciclo seguinte.
  • Modo debug (--debug) — modo de homologação em que o operador comanda o processamento pelo console: [i]tem (1 registro por execução), [p]edido (fechamento relacional do contrato num arquivo só) ou [t]udo; os arquivos de troca ficam no disco com a máscara do layout no rodapé e versões .json em pretty print.