...

...

A integração OZmap-ERP Voalle é do tipo Híbrida.

Descrição

O ERP Voalle é uma ferramenta de gestão para provedores de internet, focado em controle administrativo, financeiro, comercial e de clientes (conexões), além de manter cadastro de elementos de rede, como caixas, splitters e OLTs.

...

Resumo das funcionalidades - Serviço de integração OZmap

Resumo das funcionalidades - Serviço de integração ERP Voalle

Serviço de integração OZmap

...

• A cada ciclo de execução das funcionalidades da integração, são buscadas todas as caixas ERP Voalle, e as caixas OZmap que tiveram algum tipo de atualização desde a última sincronização da integração, as que pertençem pertencem a um projeto novo e as caixas OZmap que tiveram algum erro de tratamento em sincronizações anteriores.

• A integração verifica se há novas caixas OZmap ainda não vinculadas com caixas ERP Voalle, e se alguma caixa vinculada anteriormente entre os sistemas foi atualizada ou removida do OZmap, para realizar os devidos tratamentos no ERP Voalle:

  • Caso hajam novas caixas OZmap ainda não vinculadas com caixas ERP Voalle, será feita a seguinte verificação:

    • Será verificado se há no ERP Voalle alguma caixa com mesmo nome de caixas novas OZmap, e caso sejam encontradas caixas com nome igual, essas caixas serão vinculadas entre os dois sistemas na integração

    • Caso não seja encontrada nenhuma caixa ERP Voalle com o mesmo nome das caixas OZmap, as caixas OZmap serão criadas no ERP Voalle e vinculadas entre os dois sistemas na integração, contanto que o status da caixa no OZmap não esteja como “Em projeto” ou que o parâmetro “Sincronizar todos todas as Caixas OZmap” esteja ativo na integração.

  • Caso alguma das caixas vinculadas anteriormente tenha tido alguma alteração no OZmap, essas modificações serão repassadas para suas caixas correspondentes no ERP Voalle.

  • Caso alguma das caixas vinculadas anteriormente tenha sido excluída do OZmap, a integração irá remover as caixas correspondentes do ERP Voalle.

...

• A cada ciclo de execução das funcionalidades da integração, são buscadas todas as caixas ERP Voalle, e os condomínios verticais OZmap que tiveram algum tipo de atualização desde a última sincronização da integração, os que pertençem pertencem a um projeto novo e os condomínios verticais OZmap que tiveram algum erro de tratamento em sincronizações anteriores.

• Caso hajam novos condomínios verticais OZmap ainda não vinculados com caixas ERP Voalle, será feita a seguinte verificação:

  • Será verificado se há no ERP Voalle alguma caixa com mesmo nome de condomínios verticais novos OZmap, e caso seja encontrada alguma com nome igual, essas caixas ERP Voalle serão vinculadas com os condomínios verticais OZmap correspondentes entre os dois sistemas na integração.

  • Caso não seja encontrada nenhuma caixa ERP Voalle com o mesmo nome dos condomínios verticais OZmap, os condomínios verticais OZmap serão criados no ERP Voalle como caixas, e vinculados entre os dois sistemas na integração.

• Caso algum dos condomínios verticais vinculadas anteriormente tenha tido alguma alteração no OZmap, essas modificações serão repassadas para suas caixas correspondentes no ERP Voalle.

• Caso algum dos condomínios verticais vinculados anteriormente tenha sido excluído do OZmap, a integração irá remover as caixas correspondentes do ERP Voalle.

...

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os splitters ERP Voalle, e os splitters OZmap que tiveram algum tipo de atualização desde a última sincronização da integração, os que estejam dentro de alguma caixa OZmap que não esteja como “Em projeto” e que tenha sido atualizada desde a última sincronização, os que pertencem a um projeto novo, splitters conectados a uma OLT vinculada recentemente e os splitters OZmap que tiveram algum erro de tratamento em sincronizações anteriores, contanto que esses splitters não estejam como “Em projeto” também.

• A integração verifica se há novos splitters OZmap ainda não vinculados com splitters ERP Voalle, e se algum splitter vinculado anteriormente entre os sistemas foi atualizado ou removido do OZmap, para realizar os devidos tratamentos no ERP Voalle:

  • Caso a configuração “Sincronizar apenas Splitters conectados a uma OLT no OZmap” esteja ativa, somente splitters OZmap conectados a uma OLT OZmap vinculada com uma OLT Voalle serão considerados para criação e atualização.

  • Caso hajam novos splitters OZmap ainda não vinculados com splitters ERP Voalle, será feita a seguinte verificação:

    • Será verificado se há no ERP Voalle algum splitter com mesmo nome de splitters novos OZmap, e caso sejam encontrados splitters de nome igual, esses splitters serão vinculados entre os dois sistemas na integração.

      • Caso não sejam encontrados splitters com nome correspondente no ERP Voalle, se o parâmetro “Vincular Splitters ERP Voalle pelo nome da Caixa OZmap“ estiver ativo, a integração irá buscar splitters ERP Voalle com nome igual ao da caixa onde está o splitter novo no OZmap, e se for encontrado, o splitter ERP Voalle será vinculado com o splitter OZmap que está dentro dessa caixa no OZmap.

    • Caso não seja encontrado nenhum splitter ERP Voalle pela comparação de nomes com o OZmap, os splitters OZmap serão criados no ERP Voalle e vinculados entre os dois sistemas na integração, contanto que o splitter OZmap esteja definido como de atendimento (Permite a conexão do cliente) ou que o parâmetro “Sincronizar também Splitters de rede OZmap” esteja ativo na integração.

  • Caso algum dos splitters vinculados anteriormente tenha tido alguma alteração no OZmap, essas modificações serão repassadas para seus splitters correspondentes no ERP Voalle.

  • Caso algum dos splitters vinculados anteriormente tenha sido excluído do OZmap, a integração irá remover os splitters correspondentes do ERP Voalle.

...

A Atualização de Caixa, Splitter e Porta de Cliente ERP Voalle consiste em identificar alteração de algum desses dados do cliente no OZmap e replicar essa alteração para o cliente ERP Voalle correspondente, e ocorre da seguinte forma::

• A cada ciclo de execução das funcionalidades da integração, são buscadas todos os splitters OZmap tiveram algum tipo de atualização desde a última sincronização da integração, que estejam dentro de alguma caixa OZmap que tenha sido atualizada desde a última sincronização, pertençam a um projeto novo e os splitters OZmap que tiveram algum erro de tratamento em sincronizações anteriores. Também são buscados todos os clientes ERP Voalle e OZmap.

• A partir desta lista de splitters OZmap, são identificados todos os clientes vinculados que tiveram alteração de porta, splitter ou caixa no OZmap.

• A integração encontra os clientes correspondentes na Voalle e atualiza seus dados de caixa, splitter e porta, com base na informação de caixa, splitter e porta do Cliente OZmap, com as seguintes condições:

  • O splitter ao qual o cliente OZmap foi conectado precisa estar previamente vinculado com um splitter correspondente no ERP Voalle, e precisa estar com a porta do cliente OZmap livre no ERP Voalle.

  • Se o cliente for apenas desconectado do splitter no OZmap, essa informação só será repassado ao ERP Voalle caso o parâmetro “Remover Splitter e Porta de Clientes no ERP Voalle“ esteja ativo na integração.

  • Se o cliente estiver sendo atendido por uma porta de splitter indiretamente no OZmap (em outra caixa, ou através de outro equipamento), a informação de porta e splitter só será atualizada no ERP Voalle caso o parâmetro “Considerar Clientes atendidos em cascata no OZmap para atualização de Splitter e Porta no ERP Voalle” estiver ativo na integração.

...

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os clientes ERP Voalle ativos e excluídos, além dos clientes OZmap.

• Para cada cliente excluído no ERP Voalle, é verificado se não existe o mesmo cliente também na lista de Ativos do ERP Voalle (para o caso de haverem dados duplicados ou algo do tipo).

• São identificados os clientes cancelados através dessa comparação, e sendo assim, todos os clientes ERP Voalle que estão na lista de conexões excluídas mas não se encontram na lista de conexões ativas se tratam de clientes a serem cancelados no OZmap.

• São buscados no OZmap os clientes vinculados aos clientes ERP Voalle identificados como conexões canceladas, e os clientes são removidos do OZMapOZmap. Por padrão, o imóvel e drop do cliente são mantidos no OZmap, com o drop sendo desconectado da porta do splitter, mas isso pode ser alterado através das Configurações Específicas OZmap - Clientes, onde é possível:

  • Manter imóvel e drop no OZmap, mantendo também o drop conectado à porta do splitter (para isso, basta que o parâmetro “Desconectar Drop de Clientes cancelados no OZmap“ esteja desativado).

  • Remover o imóvel e drop junto ao cliente no momento do cancelamento (parâmetro “Remover Imóvel e Drop de Clientes cancelados no OZmap“).

...

• A cada ciclo de execução das funcionalidades da integração, são buscadas todos os splitters OZmap tiveram algum tipo de atualização desde a última sincronização da integração, que estejam dentro de alguma caixa OZmap que tenha sido atualizada desde a última sincronização, pertençam a um projeto novo e os splitters OZmap que tiveram algum erro em sincronizações anteriores.

• São verificados os splitters OZmap que estejam vinculados com algum splitter ERP Voalle, e aplicadas as regras de bloqueio conforme a tabela abaixo:

• As portas em condição de bloqueio nos splitters correspondentes do ERP Voalle, caso estejam livres, serão bloqueadas pela integração, não podendo ser utilizadas no ERP Voalle enquanto estiverem bloqueadas.

• Para o desbloqueio, são verificadas as portas dos splitters que estão bloqueadas no ERP Voalle, mas que ficaram livres no OZmap ou passaram a ser ocupadas por um cliente reconhecido (vinculado entre os dois sistemas), e as portas nessa situação são desbloqueadas no ERP Voalle.

...

A Sincronização de códigos de Clientes OZmap em trocas de endereço consiste em identificar e trabalhar os clientes de trocas de endereço que tiveram seus códigos alterados pelo LOKI OZloc (código do cliente colocado no endereço novo, e código de reserva colocado no endereço antigo), e ocorre da seguinte forma:

• Quando esta funcionalidade está ativa, há um tratamento nos códigos dos clientes OZmap provenientes de trocas de endereço no ERP Voalle, havendo assim duas partes do processo como um todo:

  • Processo LOKIOZloc: Quando é feita uma reserva usando o LOKI OZloc pelo processo de alteração de endereço de cliente ERP Voalle, ao invés do código habitual de reserva, no endereço novo o código do cliente é alterado, passando a usar o código do cliente OZmap do endereço antigo, enquanto o ciente OZmap do endereço antigo usará um código formado pela concatenação da palavra “TROCA_” + o código de reserva do ERP Voalle (ex.: TROCA_344|474747)

  • Processo serviço de integração OZmap:

    • A cada ciclo de execução das funcionalidades da integração, são buscados todos os clientes ERP Voalle, e os clientes OZmap marcados como trocas de endereço pelo processo LOKI OZloc (são buscados o cliente do endereço antigo e o cliente do endereço novo no OZmap).

    • A partir dos clientes de troca de endereço no OZmap, são tratados os casos de cliente com troca de endereço concretizada ou cancelada:

      • Troca de endereço concretizada:

        • A integração identifica as trocas de endereço concretizadas a partir dos endereços novos que foram implantados no OZmap desde o último ciclo de execução das funcionalidades da integração.

        • Para os clientes com troca de endereço concretizada, o cliente no imóvel do endereço antigo é removido do OZmap. Por padrão, o imóvel e drop do cliente são mantidos no OZmap, com o drop sendo desconectado da porta do splitter, mas isso pode ser alterado através das Configurações Específicas OZmap - Clientes, onde é possível:

          • Manter imóvel e drop no OZmap, mantendo também o drop conectado à porta do splitter (para isso, basta que o parâmetro “Desconectar Drop de Clientes cancelados no OZmap“ esteja desativado).

          • Remover o imóvel e drop junto ao cliente no momento do cancelamento (parâmetro “Remover Imóvel e Drop de Clientes cancelados no OZmap“).

      • Troca de endereço cancelada:

        • A integração identifica as trocas de endereço canceladas a partir dos endereços novos que tiveram suas reservas canceladas (removidas) no OZmap desde o último ciclo de execução das funcionalidades da integração.

        • Para os clientes com troca de endereço cancelada, o cliente do imóvel no endereço novo é removido completamente do OZmap (cliente, imóvel e drop), e o código do cliente OZmap no endereço antigo é atualizado novamente para seu código original.

Configurações Base

Configurações Específicas - Clientes

Configurações Específicas OZmap - Caixas / Splitters

Configurações Específicas OZmap - Regiões

Dados Acesso - Serviço de integração OZmap

...

Podem ser visualizados ou cadastrados seguindo os menus Suíte / Configurações / Parâmetros > Integração / Mapa > Dados para acesso do ERP VoalleUsuários

Caso não haja um usuário registrado para uso exclusivo da integração, criá-lo marcando a opção Usuário Integrador e no campo Tipo de Integração selecionar as opções Integração Externa e Integração Mapas - Externa. Após criar o usuário o ERPVoalle irá gerar um Client id e Client Secret que serão utilizado para a autenticação.

OZmap

...

Os logs desta integração estão disponíveis no endereço:

https://cliente.ozmap.com.br/integrations/erpvoalle/logs

Serviço de integração ERP Voalle

...

Abaixo serão descritas as funcionalidades do ERP Voalle, apresentadas no resumo para entender como funciona o fluxo de ação.

Consulta de Viabilidade com Reserva de Porta no OZmap

A Viabilidade com Reserva de Porta no OZmap consiste em utilizar o LOKI OZloc (sistema de viabilidade técnica do OZmap) durante o processo de venda ou alteração de endereço no ERP Voalle, para verificar viabilidade e criar uma reserva de porta para o cliente no OZmap, e ocorre nas seguintes situações:

• Ao utilizar a opção de “Consultar Viabilidade” durante o processo de venda ou alteração de endereço no ERP Voalle, o processo de viabilidade e reserva de porta usando o LOKI OZloc será iniciado.

• O LOKI OZloc exibe inicialmente o cliente no mapa na posição encontrada pelo Google para o através da tradução do endereço textual passado pelo ERP Voalle em coordenadas. A posição do Cliente no mapa pode ser refinada ao arrastar a posição do Cliente no mapa do LOKIOZloc.

• Após indicada a posição do cliente no mapa, automaticamente será apresentada a lista de caixas de atendimento com portas disponíveis (seguindo as opções de viabilidade configuradas para o LOKI OZloc no OZmap).

• A lista indica o nome da caixa, distância em metros, número de portas disponíveis, status de implantação e tipo da caixa. Existe a opção de desenhar o caminho de drop do cliente manualmente pelo botão “Desenhar drop”.

• Ao selecionar a caixa na lista de disponibilidade, um menu para confirmação é exibido, e após ser confirmada a reserva, um cliente será criado no OZmap com o drop conectado a caixa selecionada no OZmap, e com status de implantação “não implantado”.

  • Caso seja uma troca de endereço, o mesmo acontece, e o cliente no imóvel antigo ainda é mantido no OZmap normalmente até a aprovação da porta reservada para o endereço novo ser feita dentro do ERP Voalle.

• Após a confirmação no LOKIOZloc, o ERP Voalle retorna para o procedimento que gerou a consulta de viabilidade inicialmente (nova venda ou alteração de endereço) para ser seguido o restante do processo ERP Voalle.

• O ERP Voalle busca o croqui de instalação do Cliente no OZmap para anexar à solicitação de ativação.

V-Seller: O processo de viabilidade e reserva e de portas ainda pode ser realizado pelo aplicativo V-Seller do ERP Voalle, porém ele não utiliza o OZloc neste processo, apenas realiza uma consulta de viabilidade na api do serviço de integração OZmap e lista as caixas disponíveis para o usuário selecionar e realizar a reserva.

Implantação de Clientes OZmap

...

• Aprovação manual:

  • Ao realizar a aprovação de porta reservada na solicitação de ativação ou alteração de endereço do ERP Voalle, o ERP Voalle irá solicitar ao OZmap a implantação do cliente correspondente a essa reserva de acordo as situações abaixo:

    • Caso seja um cliente novo: o ERP Voalle enviará ao OZmap os dados da reserva, e caso os dados sejam encontrados pelo OZmap, o cliente terá o estado de implantação alterado para “implantado” no OZmap, e o código de reserva será substituido substituído pelo atributo do cliente ERP Voalle definido no parâmetro “Código Utilizado para Identificar as Conexões“.

    • Caso seja uma alteração de endereço: o ERP Voalle enviará ao OZmap os dados da reserva no endereço novo e a identificação do endereço antigo do cliente, e caso os dados sejam encontrados pelo OZmap, o cliente terá o estado de implantação alterado para “implantado” e o código do cliente no endereço antigo é passado para o endereço novo, sendo o cliente do endereço antigo excluído do OZmap. Por padrão, o imóvel e drop do endereço antigo do cliente são mantidos no OZmap, com o drop sendo desconectado da porta do splitter, mas isso pode ser alterado através das Configurações Específicas OZmap - Clientes, onde é possível:

      • Manter imóvel e drop antigos no OZmap, mantendo também o drop conectado à porta do splitter (para isso, basta que o parâmetro “Desconectar Drop de Clientes cancelados no OZmap“ esteja desativado).

      • Remover o imóvel e drop antigos junto ao cliente (parâmetro “Remover Imóvel e Drop de Clientes cancelados no OZmap“).

• Aprovação automática:

  • Para utilizar a aprovação automática de porta, deve ser configurada devidamente no ERP Voalle. Mais detalhes em: https://wiki.grupovoalle.com.br/OZmap

  • Com esse modelo de aprovação, após a venda e reserva de porta, quando efetivada a aprovação do contrato do cliente em questão, o ERP Voalle automaticamente enviará ao OZmap os dados da reserva, e caso os dados sejam encontrados no OZmap, o cliente terá o estado de implantação alterado para “implantado” no OZmap, seguindo as mesmas regras da aprovação manual para clientes novos ou alteração de endereço.

...

Esses dados podem ser cadastrados no ERP Voalle seguindo os menus Suíte / Configurações / Parâmetros > Integração / Mapa > Configurações.

OZmap

Liberação de IPs

Caso o servidor OZmap esteja em ambiente ON-Premisses, é necessário liberar nos firewalls o IP do servidor onde está o ERP Voalle para acessar as portas 80 e 17000 no ambiente do OZmap.

Caso seu servidor seja hospedado pelo OZmap, essas portas já estarão liberadas para o integrador.

Questionário