Ir para o conteúdo

Extrator CTC

O CTC Extrator é uma alternativa à integração direta via API para parceiros sem capacidade de desenvolvimento de integração. Também pode ser usado para viabilizar uma interação temporária enquanto é implementada a integração proprietária.

Atualmente tem suporte à banco de dados Oracle 11g, 19c e superior. Para outros bancos de dados, entre em contato com o CTC para verificar viabilidade.

Em vez de o parceiro implementar chamadas HTTP ao Hub de Integração, o Extrator é instalado na infraestrutura do parceiro e cuida de todo o ciclo automaticamente: conecta ao banco Oracle, extrai os dados de forma incremental, autentica com OAuth2 e envia para a API CTC.

Quando usar o Extrator

Cenário API Direta Extrator
ERP com capacidade de chamar APIs REST ✅ Recomendado —
Banco Oracle legado (11g, 19c, 21c+) sem camada de integração — ✅ Recomendado
Parceiro sem capacidade de desenvolvimento de integração — ✅ Recomendado
Controle fino sobre timing e formato do payload ✅ —

Como funciona

Banco Oracle do parceiro
        │
        │  JDBC / node-oracledb (Thick/Thin mode)
        ▼
  CTC Extrator (Docker)         ← roda na infra do parceiro
        │
        │  Query incremental com controle de timestamps
        ▼
  Controle de estado (SQLite)   ← persiste o último registro processado
        │
        │  OAuth2 Client Credentials (Azure Entra ID)
        ▼
  Hub de Integração CTC (API)   ← mesma API dos parceiros diretos
  1. O Extrator roda um job agendado (cron) configurável.
  2. A cada execução, consulta o banco Oracle a partir do último timestamp processado.
  3. Os dados são enviados em lotes para o Hub de Integração com um Bearer Token OAuth2.
  4. O timestamp da última execução é persistido localmente para evitar re-ingestão.

Domínios suportados

O Extrator suporta todos os domínios disponíveis no Hub de Integração:

Domínio Prefixo .env Scope exigido
Produtividade PROD productivity.write
Plantio PLANT planting.write
CTT CTT ctt.write
Ordem de Serviço ORDEM order.write
Pragas PRAGAS pests.write
Clima CLIMA climate.write

Pré-requisitos

  • Pacote .zip do Extrator fornecido pelo CTC
  • Docker e Docker Compose instalados na infraestrutura do parceiro
  • Acesso de rede ao banco Oracle (host, porta e service name)
  • Credenciais OAuth2 fornecidas pelo CTC (CLIENT_ID e CLIENT_SECRET)
  • Conectividade HTTPS de saída para a API CTC

Próximos passos