¶ Integração com Sistemas de Mapeamento Geosite
A integração com plataformas de mapeamento, tem como objetivo disponibilizar os equipamentos de atendimento projetados na plataforma para que o provedor possa vincular os clientes do sistema à portas de atendimento.
Ao integrar com um sistema de mapeamento, o HubSoft irá apenas buscar os dados da plataforma. As únicas informações que o sistema enviará para elas são alguns dados informativos do cliente para representação do mesmo no sistema terceiro. Sendo que esse envio só se dá quando o cliente tem seu vínculo confirmado à uma porta de atendimento de um equipamento sincronizado pela integração.
¶ Configuração
Para integrar com a Geosite será necessário que o provedor nos envie os seguintes parâmetros:
- api_url
- senha
- usuario
¶ Adicionado Integração
Para adicionar essa integração, siga os seguintes passos:
Vá em Configurações → Integrações → Mapeamento → Adicionar
Após clicar em adicionar, selecione o Gateway Mapeamento e preencha todos os campos e clique em Salvar
Para essa integração os parâmetros api_url, usuário e senha são necessários e esses dados serão obtidos quando o cliente entrar em contato com a empresa.
Os outros parâmetros são gerados automaticamente.
Elementos que serão sincronizados:
- Poste
- Caixa de Emenda / CTO / CAH
- Terminador Óptico
- Estação
- Splitters
Para toda integração há dicas para preenchimento dos parâmetros
Após salvar a integração, no menu Ações, você encontrará várias opções, incluindo: Visualizar/Editar, Consultar o histórico, Adicionar Projetos, Selecionar os Elementos a serem vinculados, Testar a integração e Inativar a integração.
¶ Vinculando projeto
Para adicionar um projeto à integração ou criar um novo, acesse a opção de Projetos. Se a chave Vincular a projeto existente estiver marcada, um campo com os nomes dos projetos disponíveis será exibido para seleção. Caso contrário, um campo será carregado para que você insira o nome de um novo projeto.
➢ Poderá ser adicionado apenas um projeto para cada integração e a remoção da integração poderá ser feita direto no projeto
➢ A sincronização dos elementos de mapeamento será feita todos os dias, às 04:00 (horário de Braasília).
Após preencher todos os campos necessários, clique em Salvar
¶ Elementos
Na integração com sistemas de mapeamento, você pode personalizar quais elementos serão trazidos e processados pelo sistema.
Para selecionar os elementos desejados, acesse o menu Ações e clique em Elementos.
Alguns elementos, como o Splitter de Atendimento, são essenciais e não podem ser alterados. Além disso, certos elementos exigem que pelo menos um item seja selecionado, como Splitter e Caixa Óptica. O sistema exibirá um erro se nenhum item for escolhido.
Se um elemento, como o CTO, for removido da seleção, todos os itens desse tipo serão excluídos na próxima sincronização. Essa regra se aplica a todos os itens selecionáveis.
Essas opções de personalização garantem que a integração atenda às suas necessidades, processando apenas os elementos relevantes.
¶ Splitters
Para ter a diferenciação de splitters de distribuição com os de atendimento pelo Hubsoft, os equipamentos de atendimento precisam ter a opção Tipo selecionada como Atendimento, na Geosite. Como mostrado na imagem abaixo:
¶ Identificação dos clientes
A identificação dos clientes da plataforma dentro do Hubsoft se dá através do parâmetro do documento (CPF ou CNPJ) e também do parâmetro contrato da Geosite. Sendo que o parâmetro contrato é equivalente ao id_cliente_servico do Hubsoft
¶ Perguntas/Problemas Frequentes
Abaixo serão listadas algumas perguntas/problemas frequentes relacionados com a integração - Geosite. Caso alguma dessas situações aconteça e você tenha dificuldades para resolver, não hesite em chamar nosso suporte, pois estamos aqui para lhe ajudar.
¶ Fiz uma alteração no meu elemento dentro do GeoSite. Quando isso será atualizado no HubSoft?
Os elementos serão sincronizados a partir da última data de sincronização. Por exemplo, se o projeto foi sincronizado em 20/11/2023 às 01:00, ao rodar a sincronização novamente (manual ou automática), o sistema buscará apenas os elementos alterados desde essa data, o que reduz a quantidade de dados e melhora o processamento.
No entanto, como só rastreamos alterações a partir de uma data específica, não conseguimos identificar equipamentos removidos. Para resolver isso, adotamos duas medidas:
1- Nos finais de semana, o sistema fará uma sincronização completa. Assim, se um provedor notar que um equipamento aparece no HubSoft, mas foi excluído no GeoSite, pode aguardar até o fim de semana para que a remoção seja processada corretamente. A sincronização completa nos permitirá comparar todos os elementos recebidos via API com os existentes no sistema, validando quais foram excluídos.
2- Também é possível realizar a sincronização de elementos avulsos. Com o FID da Caixa, o usuário poderá atualizar apenas um elemento, sem precisar rodar a sincronização completa.
¶ Quais elementos do GeoSite serão transferidos para o HubSoft?
Na integração com o GeoSite, os elementos transferidos para o HubSoft incluem:
- Splitters de Atendimentos
Por padrão, somente os Splitters de Atendimentos são migrados. No entanto, é possível configurar a migração de outros elementos através do menu de configuração do HubSoft. Para isso, vá em Configuração > Integração > Mapeamento > Ações > Elementos, onde você pode selecionar quais elementos adicionais deseja sincronizar. Essa flexibilidade permite que você ajuste a integração de acordo com as necessidades específicas do seu projeto.