Visão Geral

O ContractFlow disponibiliza APIs de integração que permitem a comunicação com sistemas externos de forma segura, estruturada e escalável.

Essas APIs são compostas por rotas dedicadas, projetadas exclusivamente para operações de integração, incluindo:

  • Entrada de dados (criação e atualização)

  • Consulta de informações

Esse modelo viabiliza a interoperabilidade com diferentes sistemas do ecossistema corporativo, como ERPs, sistemas de RH e plataformas de gestão de fornecedores.

O acesso às APIs é protegido por chave de API, associada a uma tenant, garantindo isolamento, controle e rastreabilidade das integrações.

Modelo de Integração

A integração com o ContractFlow é baseada em APIs REST e suporta dois padrões principais:

Envio de dados para a plataforma

Utilizado para:

  • Cadastro de fornecedores

  • Cadastro de prestadores (Outsourced Employees)

  • Criação e atualização de contratos

  • Gestão de alocações e vínculos

Consulta de dados da plataforma

Permite que sistemas externos:

  • Recuperem dados estruturados

  • Alimentem processos internos

  • Apoiem análises e decisões operacionais

Esse modelo suporta integrações:

  • Unidirecionais (apenas envio ou apenas consulta)

  • Bidirecionais (sincronização entre sistemas)

Segurança e Autenticação

O acesso às APIs de integração é realizado exclusivamente por meio de chave de API.

Regras de autenticação

  • Cada requisição deve conter uma chave válida

  • A chave é vinculada a uma tenant específica

  • A autenticação é exigida apenas nas rotas de integração

Gestão de chaves

As chaves de API são gerenciáveis pela organização, permitindo:

  • Controle de uso

  • Revogação

Garantias do modelo

  • Isolamento entre tenants

  • Controle de acesso às integrações

  • Rastreabilidade das operações realizadas

Casos de Uso de Integração

O ContractFlow pode ser integrado a diferentes sistemas corporativos, suportando diversos cenários operacionais, como:

  • Sistemas de RH

    • Carga de gestores e estrutura organizacional

  • Sistemas de SRM (Supplier Relationship Management)

    • Sincronização de fornecedores

  • Active Directory (AD)

    • Importação de prestadores ou usuários corporativos

  • IDM (Identity Management)

    • Gestão de acessos de prestadores ativos com base em status no ContractFlow

Essas integrações permitem que o ContractFlow atue como um ponto central de governança, mantendo consistência entre sistemas.

Intermediação por ETL

Dependendo da arquitetura dos sistemas envolvidos, pode ser necessária a utilização de uma camada intermediária de integração, como um ETL (Extract, Transform, Load) ou Middleware.

Responsabilidades dessa camada

  • Transformação de dados entre diferentes formatos

  • Orquestração de fluxos de integração

  • Tratamento de regras específicas de negócio

  • Controle de execução e reprocessamento

Quando utilizar:

  • Alto volume de dados

  • Múltiplas fontes de informação

  • Necessidade de transformação ou enriquecimento de dados

Considerações

A abordagem de integração do ContractFlow foi projetada para oferecer:

  • Flexibilidade na comunicação com sistemas externos

  • Segurança no acesso aos dados

  • Escalabilidade para diferentes cenários corporativos

  • Governança sobre os fluxos de informação

Público Alvo

Esta documentação é destinada principalmente a profissionais envolvidos na implantação e operação da solução, incluindo:

  • Administradores

  • Analistas e engenheiros de Dados

  • Desenvolvedores responsáveis por integração

  • Equipes de QA durante fases de homologação

  • Times de suporte e operação em ambiente produtivo

ContractFlow Docs