Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
7
minLevel1
maxLevel6
outlinefalse
styledefault
typelist
printabletrue

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 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 se já existem Caixas com o mesmo nome de caixas das novas OZmap, e caso sejam encontradas caixas com nome igual, essas caixas serão vinculadas Caixas do OZmap. Caso sejam encontradas, será analisado se a Caixa no OZmap possui um Splitter de drop. Se possuir, a Caixa será vinculada 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.

...

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

...

Parâmetro

Descrição

Padrão

Usar ID do Splitter OZmap como código do Splitter ERP Voalle

Substitui o código do Splitter ERP Voalle pelo ID do Splitter OZmap vinculado a ele.

Ex: 507f191e810c19729de860ea

Desativado.

Adaptar o nome de Splitters e Caixas no ERP Voalle

Abrevia código e título dos splitters e caixas criados no ERP Voalle, para atender limites de caracteres que o ERP Voalle possui. Para o código, serão usados os 32 caracteres iniciais do nome original configurado para esses elementos, e para o título, 64 caracteres iniciais.

Desativado.

Adicionar o Identificador do Projeto OZmap ao nome do Splitter ERP Voalle

Na criação de splitters OZmap no ERP Voalle, adiciona o identificador de projeto OZmap ao nome do splitter ERP Voalle.

EX: SS 01 - SP

(SP sendo o ident. de projeto)

Desativado.

Adicionar o nome da Caixa OZmap ao nome do Splitter ERP Voalle

Na criação de splitters OZmap no ERP Voalle, adiciona o nome da caixa OZmap ao nome do splitter ERP Voalle.

Ex: SS 01 [CTO 06-00]

Ativado.

Adicionar iniciais do Projeto OZmap ao nome do Splitter ERP Voalle

Os splitters OZmap criados no ERP Voalle terão acrescentados ao nome original de criação as iniciais do nome do projeto em que estão localizados no OZmap.

OBS.: Só pode ser usada caso o parâmetro “Adicionar o nome da Caixa OZmap ao nome do Splitter ERP Voalle” esteja ativado.

EX: SS 01 [(S) CTO 06-00]

Desativado.

Quantos caracteres considerar como iniciais dos Projetos OZmap

Número de caracteres iniciais do nome de Projeto OZmap que serão usados para compor os nomes das Caixas e Splitters ERP Voalle.

1

Sincronizar também Splitters de rede OZmap

Realizar a criação / atualização de todos os tipos de splitters OZmap no ERP Voalle. Caso desativada, somente os splitters de atendimento OZmap serão sincronizados.

Desativado.

Sincronizar apenas Splitters conectados a uma OLT no OZmap

Realizar a criação / atualização de splitters OZmap no ERP Voalle somente caso esses splitters estejam conectados a uma OLT no OZmap que possua vinculo com OLT correspondente no ERP Voalleno OZmap que possua vinculo com OLT correspondente no ERP Voalle.

Desativado.

Sincronizar todas as Caixas OZmap

Realiza a sincronização de todas as Caixas do OZmap (com exceção das caixas com status “Em projeto”), independentemente de possuírem Splitter de drop ou não.

Desativado.

Vincular Splitters ERP Voalle pelo nome da Caixa OZmap

Caso não seja encontrado um splitter ERP Voalle com nome igual ao splitter OZmap para vinculação, a integração buscará um splitter ERP Voalle com nome igual ao da caixa do splitter no OZmap.

Desativado.

Usar ID da Caixa OZmap como código da Caixa ERP Voalle

Substitui o código da Caixa ERP Voalle pelo ID da Caixa OZmap vinculada a ela.

Ex: 507f191e810c19729de860ea

Desativado.

Adicionar o Identificador do Projeto OZmap ao nome da Caixa ERP Voalle

Na criação de caixas OZmap no ERP Voalle, adiciona o identificador de projeto OZmap ao nome da caixa ERP Voalle.

EX: (S) CTO 06 - SP

(SP sendo o ident. de projeto)

Desativado.

Sincronizar todas as Caixas OZmap

Realizar a criação / atualização de todas as Caixas OZmap no ERP Voalle. Caso desativada, somente as caixas que não estejam com status “Em projeto” no OZmap serão sincronizadas.

Desativado.

...

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

https://docs.google.com/forms/d/e/1Wu3xgMcnf9mdK2Lif8BhQEZWZ2YDgJy1TH1PVrhayBs/edit1FAIpQLSfOdl78YFrUxVIWAmcDXSXoMa9uEv-k9Wtn5WUHt456se8J4A/viewform?usp=sf_link

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

...

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

...

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

...

Pergunta

Resposta

Funcionalidade

Alguma das funcionalidades do Serviço de integração OZmap é opcional?

Sim.

Todas as funcionalidade do Serviço de integração OZmap são opcionais.

Ao criar/excluir um cliente diretamente no OZmap, esse cliente será criado/excluído no ERP Voalle?

Não, a criação/exclusão de clientes segue sempre o fluxo do ERP Voalle para o OZmap, nunca o contrário.

-

Ao criar/excluir um splitter, caixa ou região no ERP Voalle, o elemento será criado/excluído automaticamente pela integração no OZmap?

Não, a criação/exclusão de elementos de rede segue sempre o fluxo do OZmap para o ERP Voalle, nunca o contrário.

-

O que é “vinculação” entre elementos na integração?

É quando um elemento OZmap é atrelado ao seu elemento correspondente no ERP Voalle, para facilitar operações e encontrar um mesmo elementos nos dois lados da integração. Essa vinculação é feita com a atribuição do ID do elemento OZmap como atributo de “integration code” nos elementos ERP Voalle.

-

É possível sincronizar todas as Caixas do OZmap com o sistema Voalle, ou apenas as que possuem Splitter de drop?

Sim, é possível. Isso pode ser feito ativando a configuração "Sincronizar todas as Caixas OZmap".