Tipo de Integração

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.

A integração OZmap x ERP Voalle é feita em duas direções via API, onde o OZmap realiza principalmente a sincronização de elementos de rede (caixas, splitters, regiões) no ERP Voalle, e o ERP Voalle realiza viabilidade, reserva de porta, ativação e cancelamento de clientes no OZmap.

OBS: É possível escolher qual atributo de conexão dos clientes ERP Voalle será utilizado como código dos clientes OZmap, para os clientes serem encontrados e tratados pelos dois lados da integração. Atualmente, as possibilidades são utilizar o usuário pppoe, código de contrato ou tag.

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

Funcionalidades

Abaixo serão descritas as funcionalidades do serviço de integração OZmap, apresentadas no resumo para entender como funciona o fluxo de sincronização.

Vinculação de OLTs

A vinculação de OLTs OZmap com OLTs ERP Voalle é feita para permitir que os dados dessas OLTs (OLT, slot, pon) possam ser encontradas pela integração para serem trabalhadas, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscadas todas as OLTs do ERP Voalle e do OZmap;

• Para cada OLT ERP Voalle ativa, é buscada uma OLT OZmap com mesmo IP, e caso seja encontrada, essas OLTs com mesmo IP são vinculadas entre os dois sistemas na integração.

• A integração identifica OLTs ERP Voalle desativadas, e caso alguma OLT ERP Voalle desativada já tenha sido vinculada anteriormente com uma OLT OZmap, a integração irá desvincular essas OLTs.

• Caso seja alterado o IP de alguma das OLTs vinculadas em um dos dois sistemas, e assim passem a ter IPs divergentes, a integração irá desvincular essas OLTs.

OBS.: Para a vinculação de OLTs, estas devem ser criadas manualmente no OZmap e no ERP Voalle, com mesmo IP, para serem vinculadas.

Sincronização de Regiões OZmap

A Sincronização de Regiões OZmap se baseia na criação, atualização e exclusão de regiões no ERP Voalle com base nos dados de regiões OZmap, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscadas todas as regiões ERP Voalle e as regiões OZmap que tiveram algum tipo de atualização desde a última sincronização da integração.

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

  • Caso hajam novas regiões OZmap de tipo ativação, manutenção ou comercial configurados na integração (ou caso o parâmetro “Sincronizar todos os tipos de regiões OZmap” estiver ativo) que ainda não estejam vinculados com regiões ERP Voalle, essas regiões OZmap serão criadas no ERP Voalle e vinculadas entre os dois sistemas na integração.

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

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

Sincronização de Condomínios Horizontais OZmap como Regiões ERP Voalle

A Sincronização de Condomínios Horizontais OZmap como Regiões ERP Voalle se baseia na criação, atualização e exclusão de regiões no ERP Voalle com base nos dados de condomínios horizontais OZmap, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscadas todas as regiões ERP Voalle e os condomínios horizontais OZmap que tiveram algum tipo de atualização desde a última sincronização da integração.

• A integração verifica se há novos condomínios horizontais OZmap ainda não vinculados com regiões ERP Voalle, e se algum condomínio horizontal OZmap vinculado anteriormente com região ERP Voalle foi atualizado ou removido do OZmap, para realizar os devidos tratamentos no ERP Voalle:

  • Caso hajam novos condomínio horizontais OZmap ainda não vinculados com um regiões ERP Voalle, esses condomínios horizontais OZmap serão criados como regiões no ERP Voalle e vinculados entre os dois sistemas na integração.

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

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

OBS.: Os condomínios horizontais OZmap são tratados dessa forma pela integração pelo fato de o ERP Voalle não trabalhar com este elemento específico no seu sistema.

Sincronização de Caixas OZmap

A Sincronização de Caixas OZmap se baseia na criação, atualização e exclusão de caixas no ERP Voalle com base nos dados de caixas OZmap, e ocorre da seguinte forma:

• 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 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 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.

Sincronização de Condomínios Verticais OZmap como Caixas ERP Voalle

A Sincronização de Condomínios Verticais OZmap como Caixas ERP Voalle se baseia na criação, atualização e exclusão de caixas no ERP Voalle com base nos dados de condomínios verticais OZmap, e ocorre da seguinte forma:

• 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 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.

OBS.: Os condomínios verticais OZmap são tratados dessa forma pela integração pelo fato de o ERP Voalle não trabalhar com este elemento específico no seu sistema.

Sincronização de Splitters OZmap

A Sincronização de Splitters OZmap se baseia na criação, atualização e exclusão de splitters no ERP Voalle com base nos dados de splitters OZmap, e ocorre da seguinte forma:

• 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 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 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.

OBS.: Os dados de OLT, Slot e PON do splitter OZmap só serão enviados para o splitter correspondente no ERP Voalle caso o parâmetro “Vinculação de OLTs“ esteja ativo e a OLT que atende esse splitter no OZmap esteja vinculada com a OLT correspondente no ERP Voalle.

Vinculação e atualização de dados de Clientes

A Vinculação e atualização de dados de Clientes OZmap com clientes ERP Voalle é feita para que os dados dos Clientes ERP Voalle possam ser repassados aos clientes correspondentes no OZmap, e ocorre da seguinte forma:

Vinculação de Clientes:

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os Clientes ERP Voalle e todos os Clientes OZmap.

• Primeiro são verificados os clientes que não estão implantados no OZmap e possuem um código de reserva ERP Voalle (ex.: 4462|19304):

  • Para cada cliente OZmap que estiver nessas condições, é buscado um cliente correspondente no ERP Voalle compatível com o código de reserva OZmap, e caso seja encontrado, os clientes OZmap e ERP Voalle são vinculados entre os dois sistemas na integração.

• Após a verificação de clientes com status de reserva de porta, são verificados os clientes com conexão ativa no ERP Voalle:

  • Para cada cliente ERP Voalle que ainda não esteja vinculado com nenhum cliente OZmap, é buscado no OZmap um cliente que possua o mesmo código que o atributo do cliente ERP Voalle definido no parâmetro “Código Utilizado para Identificar as Conexões“, e caso seja encontrado um cliente OZmap com código compatível com o ERP Voalle, os clientes dos dois sistemas serão vinculados na integração.

Atualização de dados de Clientes:

• Para todos os clientes vinculados entre os dois sistemas, a integração verifica uma séria de dados dos clientes no ERP Voalle e repassa esses dados para os clientes OZmap:

  • Os dados a seguir são comparados entre os clientes correspondentes no dois sistemas, e se houver divergência, todos os dados divergentes são atualizados no cliente OZmap com base nos dados do cliente ERP Voalle:

    • Código (para clientes implantados);

    • Nome do cliente;

    • Serial number, MAC e usuário PPPoE, atualizados na sessão “ONU” do cliente OZmap;

    • Endereço, atualizado no campo textual de endereço do cliente OZmap;

Atualização de Caixa, Splitter e Porta de Clientes 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.

Cancelamento automático de Clientes no OZmap

O Cancelamento automático de Clientes no OZmap consiste em buscar automaticamente no ERP Voalle os cliente que foram cancelados, e removê-los do OZmap, sem depender da funcionalidade de cancelamento de clientes do serviço de integração Voalle para isso, e ocorre da seguinte forma:

• 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 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“).

OBS.: Quando o imóvel é mantido no OZmap, é adicionado a ele uma observação contendo os dados de splitter e porta onde estava conectado, bem como o código do cliente removido e a data do cancelamento.

Implantação automática de Clientes OZmap por estágio de contrato ERP Voalle

A Implantação automática de Clientes OZmap por estágio de contrato ERP Voalle consiste em identificar os clientes ERP Voalle que estão no estádio de contrato “Aprovado” e implantar os clientes correspondentes no OZmap, sem depender da funcionalidade de Implantação de Clientes do serviço de integração Voalle para isso, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os clientes ERP Voalle e OZmap.

• São identificados no OZmap todos os clientes não implantados (provenientes de nova instalação somente) que estejam vinculados aos clientes ERP Voalle.

• Para cada cliente vinculado entre dos dois sistemas que possua estágio de contrato como “Aprovado” no ERP Voalle, o cliente correspondente no OZmap tem o estado de implantação alterado para “implantado".

Criação automática de Clientes no OZmap

A Criação automática de Clientes OZmap consiste em identificar clientes existentes no ERP Voalle mas que por algum motivo ainda não existem no OZmap, e realizar a sua criação automaticamente no OZmap, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os clientes ERP Voalle que não estejam vinculados com clientes OZmap.

• Para cada cliente ERP Voalle, é verificado se possui um splitter no ERP Voalle, e se esse splitter é reconhecido pela integração (deve existir um correspondente no OZmap e estar vinculado previamente entre os dois sistemas).

• Estando tudo ok com os dados do splitter ERP Voalle e caso a porta do cliente novo esteja livre no OZmap, o cliente será criado no OZmap, e quanto a posição e drop do cliente no OZmap, a integração procede da seguinte forma:

  • Por padrão, o cliente criado no OZmap será posicionado ao redor da sua caixa OZmap, com o drop sendo ligado em linha reta até a caixa.

  • Caso o parâmetro “Utilizar coordenados do ERP Voalle na criação automática de Clientes“ esteja ativo, o cliente será criado no OZmap posicionado na coordenada encontrada no ERP Voalle para este cliente:

    • Usando a coordenada ERP Voalle, por padrão, a integração irá buscar as adjacências disponíveis no OZmap e criar o drop seguindo essas adjacências. Caso não haja adjacência disponível para criação do drop, o mesmo será criado em linha reta até a sua Caixa OZmap.

    • É possível definir que o drop seja criado sempre em linha reta da sua posição até a caixa, basta que o parâmetro “Utilizar adjacências OZmap na criação automática de Clientes“ seja desabilitado na integração.

Bloqueio de portas de Splitters no ERP Voalle

O Bloqueio de portas de Splitters no ERP Voalle consiste em identificar portas de splitters OZmap ocupadas por elementos de rede desconhecidos ao ERP Voalle ou clientes não existentes no ERP Voalle (de redes neutras, por exemplo), e bloquear essas portas no ERP Voalle para não serem usadas, 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 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.

Atualização de coordenadas de Clientes no ERP Voalle

A Atualização de coordenadas de Clientes no ERP Voalle consiste em usar as coordenadas do cliente OZmap para atualizar as coordenadas do cliente correspondente no ERP Voalle, e ocorre da seguinte forma:

• A cada ciclo de execução das funcionalidades da integração, são buscados todos os clientes ERP Voalle, e os clientes OZmap que tiveram algum tipo de atualização desde a última sincronização da integração.

• A integração verifica quais clientes ERP Voalle possuem vínculo com clientes OZmap e compara as coordenadas de cada cliente ERP Voalle com a posição (latitude e longitude) do cliente OZmap correspondente, e caso haja divergência entre os valores dos dois sistemas, as coordenadas do cliente ERP Voalle serão atualizadas com o valor de latitude e longitude do cliente OZmap.

IMPORTANTE: A partir do momento em que essa funcionalidade for ativada, será considerado que as coordenadas do OZmap são as corretas, e qualquer coordenada do ERP Voalle que estiver diferente será sobrescrita com o valor da coordenada OZmap instantaneamente.

Sincronização de códigos de Clientes OZmap em trocas de endereço

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 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 OZloc: Quando é feita uma reserva usando o 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 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

https://docs.google.com/forms/d/1Wu3xgMcnf9mdK2Lif8BhQEZWZ2YDgJy1TH1PVrhayBs/edit

Dados de acesso necessários para buscar informações via API no sistema ERP Voalle. (Estes dados devem ser fornecidos no questionário inicial).

ERP Voalle

Podem ser visualizados ou cadastrados seguindo os menus Suíte / Configurações / Usuá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

Liberação de IPs

Para validação e execução da integração no ambiente de produção, é necessário serem liberados no servidor do cliente os IPs utilizados pelo OZmap:

• Servidor OZmap do cliente (ping cliente.ozmap.com.br)

• 54.207.162.199

Logs

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

Funcionalidades

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 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 OZloc será iniciado.

• O OZloc exibe inicialmente o cliente no mapa na posição encontrada pelo Google para o endereço textual passado pelo ERP Voalle. A posição do Cliente no mapa pode ser refinada ao arrastar a posição do Cliente no mapa do OZloc.

• 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 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 OZloc, 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

A implantação de clientes OZmap consiste em implantar clientes no OZmap com base na aprovação da porta reservada para o cliente no ERP Voalle, podendo ocorrer de forma manual ou automática, e acontece da seguinte forma:

• 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á 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.

Cancelamento de Clientes e Reservas no OZmap

O Cancelamento de Clientes e Reservas no OZmap consiste em remover um cliente do OZmap com base nos contratos ou reservas canceladas no ERP Voalle, e ocorre da seguinte forma:

• Cancelamento de Clientes:

  • Quando o contrato de um cliente é cancelado no ERP Voalle, a funcionalidade de Cancelamento de Clientes e Reservas no OZmap é ativada.

  • O ERP Voalle envia ao OZmap os dados do cliente que teve o contrato cancelado.

  • Caso os dados sejam encontrados pelo OZmap, o cliente será 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“).

• Cancelamento de Reservas:

  • Quando uma reserva de porta para um cliente em ativação ou alteração de endereço é cancelada no ERP Voalle, o ERP Voalle envia ao OZmap os dados da reserva que foi cancelada.

  • Caso os dados sejam encontrados pelo OZmap, o cliente com status de reserva será removido completamente do OZmap (cliente, imóvel e drop são excluídos).

Atualização de Caixa, Splitter e Porta de Clientes OZmap

A atualização de Caixa, Splitter e/ou Porta de clientes no OZmap consiste em repassar ao OZmap qualquer alteração desses dados realizada no ERP Voalle, e ocorre nas seguintes situações:

• Quando um cliente tem a caixa, splitter e/ou a porta alteradas ou removidas na conexão ERP Voalle.

• Quando um cliente tem a caixa, splitter e/ou a porta alteradas ou removidas diretamente pelo menu de portas do splitter ERP Voalle.

• Em ambos os casos, após a alteração ser feita, o ERP Voalle enviará ao OZmap os dados do cliente e as informações novas para Caixa, Splitter e Porta, e caso os dados novos sejam encontrados pelo OZmap, o cliente terá esses dados alterados no OZmap.

Dados Acesso - Serviço de integração ERP Voalle

Dados de acesso necessários para buscar informações via API no Serviço de integração OZmap.

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