Módulo Integração

Veja como funciona o módulo de integração dentro do Veniti.

Cleberson Santos avatar
Escrito por Cleberson Santos
Atualizado há mais de uma semana

Para melhor utilização do Veniti, realizamos integrações com outros sistemas. Essas integrações permitem que sua Assistência venha a utilizar sistemas que possuem parceria para diferentes funcionalidades.

O principal uso de API’s de integração no Veniti tem como intuito agilizar o fluxo operacional das Assistências, sendo elas voltadas para:

  • Consulta de beneficiário;

  • Cadastramento de atendimentos;

  • Atualização de status;

  • Informações completas de atendimento;

  • Sincronismos de beneficiários;

  • Sincronismo de faturamento.

Entre os sistemas que realizamos essas integrações temos os que permitem o recebimento de dados e status de ativos e inativos de uma associação e/ou seguradora, fazendo a busca de um beneficiário e todas suas informações.

Chaves API

Para facilitar esse fluxo, é possível gerar a chave de API que será utilizada para realizar a integração com algum sistema dentro do próprio Veniti, sendo necessário apenas indicar o nome do sistema e o cliente a utilizar a integração.

Para realizar isso, o primeiro passo será verificar se o seu usuário está com permissão de gerar uma chave. Basta acessar no menu lateral [Configurações > Acessos > Perfil] e verificar se a permissão [Cadastrar Chaves API] está habilitada.


​Com a permissão habilitada, já é possível gerar a chave. No menu lateral, acesse [Integrações > Chaves API]. Em seguida, clique na aba [Cadastrar]. No campo [Nome] insira uma descrição ou nome que ajudará a identificar o sistema que está sendo realizado a integração. Em seguida, no campo [Cliente], selecione o cliente corporativo (seguradora/associação) que vai ser realizado a integração. Nesta etapa, é muito importante que seja cadastrado apenas o cliente que vai utilizar da integração, para que não dê erro no sincronismo de beneficiários. Por fim, clique no botão [+Cadastrar].

Após realizar este cadastro, a página atualizará e será disponibilizado a chave. No campo [Chave], você consegue copiar a sequência gerada para enviar o sistema realizar a integração.

Verificar Integração

Com esses sistemas consumindo as nossas APIs, é possível verificar o status da integração, fazendo um comparativo. Para isso, acessando no menu lateral [Integrações > Verificar Integrações], é possível subir um documento com os dados do lado do sistema parceiro, selecionar o cliente que deseja verificar o sincronismo e qual status considerar, podendo ser:

  • Verificar status atual do veículo;

  • Verificar status durante um período do veículo.

Após inserir essas informações, o Veniti fará uma leitura do documento e do sincronismo para compreender o status da integração. Com isso, será exibido para a Assistência os seguintes dados:

  • Total de itens;

  • Total de itens corretos;

  • Total de itens divergentes;

  • Total de itens ativos;

  • Total de itens inativos;

  • Total de itens não encontrados.

Além disso, é exibido uma listagem com a informação verificada por beneficiário, mostrando o status no arquivo e o status no sistema.

Integração SGA

Além desses sistemas, também temos a integração com o SGA. Há uma aba dedicada para fazer o controle e verificação do sincronismo com o SGA.

Clientes

Para habilitar a integração com o SGA de um cliente, basta ir no menu lateral [Integrações > Configurações > Clientes].

Aba de Configuração:

O primeiro passo para habilitar a integração do SGA com o Veniti é inserir a chave/token fornecido no SGA para liberar o acesso ao SGA para a busca de dados dos associados. Ao inserir a chave, o sincronismo dará início e será realizado a cada uma hora para atualizar a listagem de ativos e inativos. Logo abaixo do campo para inserir a chave, há informações da última sincronização e a quantidade de itens que retornou dessa sincronização.

Aba de Códigos Produtos

Nesta aba é exibido uma tabela de relacionamento entre os produtos/planos vindos do SGA e como são considerados no Veniti. É preciso vincular cada código trazido do SGA a um plano cadastrado no Veniti. Para fazer a relação entre o código e o plano, basta clicar no código que ainda não possui um plano e fazer a vinculação a um plano já cadastrado no Veniti.

Aba de Situação Beneficiário

Nesta aba é exibido uma listagem com a nomenclatura da situação dos beneficiários/associados do SGA. Na coluna “Descrição” é exibido o que é considerado no SGA e na coluna “Status Veniti” é como o sistema entende cada uma da situação. Atualmente, no Veniti, é considerado apenas o status de “Ativo” e “Inativo”, portanto, é necessário fazer um comparativo entre o que o SGA exibe com o que o Veniti vai passar a exibir.

Caso necessário mudar algum status, basta clicar na descrição desejada e realizar a edição manualmente inserindo a situação correta.

Aba de Situação Veículo

Nesta aba é exibido uma listagem com a nomenclatura da situação dos veículos do SGA. Na coluna “Descrição” é exibido o que é considerado no SGA e na coluna “Status Veniti” é como o sistema entende cada uma da situação. Atualmente, no Veniti, é considerado apenas o status de “Ativo” e “Inativo”, portanto, é necessário fazer um comparativo entre o que o SGA exibe com o que o Veniti vai passar a exibir.

Caso necessário mudar algum status, basta clicar na descrição desejada e realizar a edição manualmente inserindo a situação correta.

Aba de Tipos de Veículos

Nesta aba é exibido uma listagem com a nomenclatura dos veículos do SGA, levando em consideração o que está cadastrado no sistema deles. Na coluna “Descrição” é exibido o tipo de veículo que é considerado no SGA e na coluna “Status Veniti” é como o sistema entende cada um desses veículos. Atualmente, no Veniti, é considerado apenas o tipo específico do veículo (ex.: automóvel, moto, caminhão, etc.), desconsiderando marcas ou especificações do veículo. Assim, é necessário fazer um comparativo entre o que o SGA exibe com o que o Veniti vai passar a exibir.

Caso necessário mudar algum tipo de veículo, basta clicar na descrição desejada e realizar a edição manualmente inserindo o veículo correspondente corretamente.

Aba de Itens SGA

Nesta aba é exibido os itens do último sincronismo, de forma mais detalhada, mostrando cada beneficiário e a situação deles, além de outras informações, como:

  • Veículos;

  • Associados;

  • Veículos Ativos;

  • Veículos Inativos;

  • Associados Ativos;

  • Associados Inativos.

Status do SGA

Para acompanhar a integração com o SGA de um cliente, basta ir no menu lateral [Integrações > SGA > Status do SGA]. Nessa aba, você consegue visualizar o status da integração dos seus clientes e o total de itens sincronizados.

Ficou com alguma dúvida? Entre em contato com o nosso chat de suporte 😉

Respondeu à sua pergunta?