Pular para o conteúdo principal

Integração com sistema parceiro de BI

Objetivo​

A presente documentação visa apresentar um processo de integração (carga inicial e cargas incrementais) com um sistema parceiro de BI.

Processo​

O objetivo é gerar uma carga inicial e, posteriormente, cargas incrementais que contemplem apenas as alterações nos dados armazenados.

Todos os serviços disponíveis incluirão um campo denominado dhOperacao, que será utilizado como filtro para as cargas incrementais.

Liberação dos serviços​

Para que a liberação dos serviços seja efetivada, entre em contato com o gestor do setor de marketing a fim de que seja realizada as tratativas de acordo de parceria.

Processo de Integração dos Dados​

1. Carga Inicial dos Dados dos Serviços Disponíveis​

  • Registro da Data e Hora de Início: Registrar a data e hora de início da carga inicial para uso na primeira carga incremental, evitando a desconsideração de dados alterados durante o processo.
  • Limitação de Registros: A carga inicial deve ser realizada com um limite de 1.000 registros por vez para não comprometer a performance. Controlar pelo campo 'id' (identificador interno do registro), registrando o último integrado para que a próxima rodada inclua os próximos 1.000 registros.
  • Integração de Débitos/Lançamentos: Integrar apenas débitos/lançamentos com situação aberto ou pago durante a carga inicial.
  • Execução do Procedimento: Repetir o procedimento até que todos os registros sejam integrados.

2. Cargas Incrementais Após a Carga Inicial​

  • Filtragem pelo Campo dhOperacao: O primeiro valor de dhOperacao para iniciar a carga incremental deve ser superior à data e hora de início da carga inicial.
  • Registro do Último "dhOperacao": Ao final de cada carga incremental, registrar o valor do campo dhOperacao do último registro integrado para uso na próxima rodada.
  • Execução Periódica: Executar o processo de carga incremental periodicamente para manter o sistema do parceiro atualizado, sempre utilizando o campo dhOperacao.
Importante!

Em algumas situações, pode ser necessário executar mais de uma fonte para obter o conjunto completo de dados. Essas situações específicas serão explicadas e exemplificadas conforme necessário.

Documentação dos serviços​