...
Resumo das funcionalidades - Serviço de integração OZmap
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Vinculação de OLTs | Vinculação entre OLTs existentes no ERP Voalle e no OZmap. | OZmap => ERP Voalle |
Sincronização de Regiões OZmap | Criação, exclusão e atualização de regiões no ERP Voalle, com base nos dados de regiões OZmap. | OZmap => ERP Voalle |
Sincronização de Condomínios Horizontais OZmap como Regiões ERP Voalle | Criação, exclusão e atualização de regiões no ERP Voalle, com base nos dados de condomínios horizontais OZmap. | OZmap => ERP Voalle |
Sincronização de Caixas OZmap | Criação, exclusão e atualização de caixas no ERP Voalle, com base nos dados de caixas OZmap. | OZmap => ERP Voalle |
Sincronização de Condomínios Verticais OZmap como Caixas ERP Voalle | Criação, exclusão e atualização de caixas no ERP Voalle, com base nos dados de condomínios verticais OZmap. | OZmap => ERP Voalle |
Sincronização de Splitters OZmap | Criação, exclusão e atualização de splitters no ERP Voalle, com base nos dados de splitters OZmap. | OZmap => ERP Voalle |
Vinculação e atualização de dados de Clientes | Vinculação de clientes ERP Voalle com clientes OZmap correspondentes e atualização de informações de nome, código, endereço e dados de ONU dos clientes OZmap com base nos dados dos clientes ERP Voalle. | ERP Voalle => OZmap |
Atualização de Caixa, Splitter e Porta de Clientes ERP Voalle | Ao mudar um cliente de porta, splitter e/ou caixa no OZmap, integração atualiza esses dados na conexão do cliente correspondente no ERP Voalle. | OZmap => ERP Voalle |
Cancelamento automático de Clientes no OZmap | Identificação e remoção automática de clientes no OZmap, com base na leitura de conexões canceladas no ERP Voalle. | ERP Voalle => OZmap |
Implantação automática de Clientes OZmap por estágio de contrato ERP Voalle | Implantação automática de clientes no OZmap, com base no estágio de contrato dos clientes correspondentes no ERP Voalle. | ERP Voalle => OZmap |
Criação automática de Clientes no OZmap | Criação automática de clientes no OZmap, com base nos clientes ERP Voalle que possuem dados de caixa, splitter e porta mas ainda não existem no OZmap. | ERP Voalle => OZmap |
Bloqueio e Desbloqueio de portas de Splitters no ERP Voalle | Identificação de portas de splitters ocupadas por elementos de rede no OZmap e bloqueio dessas portas nos splitters correspondentes do ERP Voalle, fazendo o desbloqueio no ERP caso sejam liberadas no OZmap. | OZmap => ERP Voalle |
Atualização de coordenadas de Clientes no ERP Voalle | Atualização de coordenadas dos clientes ERP Voalle com base na leitura de coordenadas dos clientes OZmap. | OZmap => ERP Voalle |
Sincronização de códigos de Clientes OZmap em trocas de endereço | Identificação de clientes de troca de endereço com códigos trocados pelo OZloc no OZmap, remoção de imóveis antigos quando endereço novo é ativado, e restauração do código original do cliente no endereço antigo caso a troca de endereço seja cancelada. | ERP Voalle => OZmap |
Resumo das funcionalidades - Serviço de integração ERP Voalle
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consulta de Viabilidade com Reserva de Porta no OZmap | Buscar viabilidade técnica no OZloc para um endereço de cliente ERP Voalle e reservar uma porta no OZmap para sua instalação. | ERP Voalle => OZmap |
Implantação de Clientes OZmap | Implantação de clientes ERP Voalle no OZmap, através do procedimento de aprovação de portas reservadas nas Solicitações de ativação do ERP Voalle. | ERP Voalle => OZmap |
Cancelamento de Clientes e Reservas no OZmap | Remoção de clientes ERP Voalle do OZmap, com base nos contratos ou reservas cancelados no ERP Voalle. | ERP Voalle => OZmap |
Atualização de Caixa, Splitter e Porta de Clientes OZmap | Ao modificar clientes de caixa, splitter e/ou porta no ERP Voalle, o ERP Voalle atualiza esses dados para os clientes no OZmap. | ERP Voalle => OZmap |
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 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 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 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:
Serão BLOQUEADAS no ERP as portas ocupadas por: | Não serão bloqueadas as portas ocupadas por: |
|---|---|
Elementos de rede (Splitters, switchs, cabos sem cliente, etc..) | Imóveis vazios |
Clientes reconhecidos pela integração (vinculados entre OZmap e ERP Voalle). | |
Clientes não vinculados entre ERP Voalle e OZmap (clientes cancelados não removidos do OZmap, com erro de vinculação ou clientes de redes neutras, por exemplo) | Reservas de porta do ERP Voalle (clientes não implantados que possuem um “|” no código). |
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.
...
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
Parâmetro | Descrição | Padrão |
|---|---|---|
Tempo entre Sincronizações | Tempo aguardado entre as sincronizações realizadas pela integração. | 15 minutos |
Vinculação de OLTs | Usar a funcionalidade de Vinculação de OLTs na integração. | Ativado. |
Sincronização de Regiões OZmap | Usar a funcionalidade de Sincronização de Regiões OZmap na integração. | Desativado. |
Sincronização de Condomínios Horizontais OZmap como Regiões ERP Voalle | Usar a funcionalidade de Sincronização de Condomínios Horizontais OZmap como Regiões ERP Voalle na integração. | Ativado. |
Sincronização de Caixas OZmap | Usar a funcionalidade de Sincronização de Caixas OZmap na integração. | Ativado. |
Sincronização de Condomínios Verticais OZmap como Caixas ERP Voalle | Usar a funcionalidade de Sincronização de Condomínios Verticais OZmap como Caixas ERP Voalle na integração. | Desativado. |
Sincronização de Splitters OZmap | Usar a funcionalidade de Sincronização de Splitters OZmap na integração. | Ativado. |
Vinculação e atualização de dados de Clientes | Usar a funcionalidade de Vinculação e atualização de dados de Clientes na integração. | Ativado. |
Cancelamento automático de Clientes no OZmap | Usar a funcionalidade de Cancelamento automático de Clientes no OZmap na integração. | Desativado. |
Implantação automática de Clientes OZmap por estágio de contrato ERP Voalle | Usar a funcionalidade de Implantação automática de Clientes OZmap por estágio de contrato ERP Voalle na integração. | Desativado. |
Criação automática de Clientes no OZmap | Usar a funcionalidade de Criação automática de Clientes no OZmap na integração. | Desativado. |
Bloqueio e Desbloqueio de portas de Splitters no ERP Voalle | Usar a funcionalidade de Bloqueio e Desbloqueio de portas de Splitters no ERP Voalle na integração. | Desativado. |
Atualização de coordenadas de Clientes no ERP Voalle | Usar a funcionalidade de Atualização de coordenadas de Clientes no ERP Voalle na integração. | Desativado. |
Sincronização de códigos de Clientes OZmap em trocas de endereço | Usar a funcionalidade de Sincronização de códigos de Clientes OZmap em trocas de endereço na integração. | Desativado. |
Configurações Específicas - Clientes
Parâmetro | Descrição | Padrão |
|---|---|---|
Código Utilizado para Identificar os Clientes | Atributo de conexão ERP Voalle a ser utilizado como código de cliente no OZmap na criação e vinculação de clientes entre os dois sistemas, sendo possível utilizar o código de contrato, usuário PPPoE ou tag. | Usuário PPPoE. |
Utilizar coordenados do ERP Voalle na criação automática de Clientes | Os clientes criados pela funcionalidade de criação automática de clientes serão posicionados no OZmap usando a coordenada do cliente no ERP Voalle. Caso desativada, clientes serão criados ao redor da caixa no OZmap. | Desativado. |
Utilizar adjacências OZmap na criação automática de Clientes | Os clientes criados pela funcionalidade de criação automática de clientes terão seus drop criados seguindo as adjacências disponíveis no OZmap. Caso desativada, os drops são criados em linha reta até a caixa. OBS.: Só pode ser usada caso o parâmetro “Utilizar coordenados do ERP Voalle na criação automática de Clientes” esteja ativado. | Ativado. |
Desconectar Drop de Clientes cancelados no OZmap | Quando um cliente for removido do OZmap por cancelamento de conexão ERP Voalle, o drop do imóvel será desconectado da porta do splitter OZmap. OBS.: Só pode ser usada caso o parâmetro “Remover Imóvel e Drop de Clientes cancelados no OZmap” esteja desativado. | Ativado. |
Remover Splitter e Porta de Clientes no ERP Voalle | Quando o drop de um cliente for desconectado do splitter no OZmap, remove os dados de splitter e porta do cliente também no ERP Voalle. | Desativado. |
Considerar Clientes atendidos em cascata no OZmap para atualização de Splitter e Porta no ERP Voalle | Verifica clientes que estão sendo atendidos por uma porta de splitter indiretamente (em outra caixa, por exemplo) no OZmap, para replicar a informação de uso desse splitter e porta na conexão do cliente correspondente no ERP Voalle. | Desativado. |
Remover Imóvel e Drop de Clientes cancelados no OZmap | Quando um cliente for removido do OZmap por cancelamento de conexão ERP Voalle, o drop e o imóvel também serão excluídos do OZmap. | Desativado. |
Configurações Específicas OZmap - Caixas / Splitters
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 Voalle. | 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. |
Configurações Específicas OZmap - Regiões
Parâmetro | Descrição | Padrão |
|---|---|---|
Tipo de região ERP Voalle para condomínios horizontais OZmap | Nome a ser usado como tipo de regiões provenientes de condomínios horizontais OZmap criadas no ERP Voalle. | V_COND_H |
Tipo de regiões comerciais ERP Voalle | Nome a ser usado como tipo de regiões comerciais OZmap criadas no ERP Voalle. | V_COMERCIAL |
Tipo de regiões de manutenção ERP Voalle | Nome a ser usado como tipo de regiões de manutenção OZmap criadas no ERP Voalle. | V_MANUTENCAO |
Tipo de regiões de ativação ERP Voalle | Nome a ser usado como tipo de regiões de ativação OZmap criadas no ERP Voalle. | V_ATIVACAO |
Sincronizar todos os tipos de regiões OZmap | Realizar a criação / atualização de todos os tipos de regiões OZmap no ERP Voalle. Caso desativada, somente as regiões de tipo comercial, ativação ou manutenção serão consideradas pela integração. | Desativado. |
Dados Acesso - Serviço de integração OZmap
...
URL
...
Podem ser visualizados ou cadastrados seguindo os menus Suíte / Configurações / Parâmetros > Integração / Mapa > Dados para acesso do ERP Voalle.
...
Parâmetro
...
Descrição
...
Exemplo
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.
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | URL do servidor que contém o serviço externo para conexão. | https://erp.cliente.com.br |
Usuário Voalle
ozmap_integracao
Senha
Client Id | Id do cliente gerado no ERP Voalle para o OZmap enviar requisições API. |
e4ea8e10-850c-4e7d-9791-133ccef4311c | |
Client Secret | Secret do cliente gerado no ERP Voalle para o OZmap enviar requisições API. |
5d2021d2-eda3-4e86-a4f4-b8b276f9a8db | ||
Syndata | Chave ERP Voalle que identifica para qual ambiente a requisição será direcionada (Produção ou Homologação). | TWpNMU9EYzVaakk1T0dSaU1USmxaalprWldFd00ySTFZV1JeSSJRMFptUT06WlhsS1ZHVlhOVWzySSA0d1NXcHZhVTFVWXpOTWFsa3lUR3BKTUU1NU5ERk9VMGx6U1d4T05XSnJVbWxKYW05cFdrZEtiR0pZUVhkTlJGRXdUbWxLT1E9PTpaVGhrTWpNMVlqazBZemxpTkRObVpEZzNNRGxrTWpZMll6QXhNR00zTUdVPQ== |
OZmap
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
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.
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
...
Esses dados podem ser cadastrados no ERP Voalle seguindo os menus Suíte / Configurações / Parâmetros > Integração / Mapa > Configurações.
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
Servidor e Servidor Mapa | Endereço do serviço de integração OZmap, em ambos os campos. | https://cliente.ozmap.com.br/integrations/erpvoalle |
Servidor LOKI | Endereço de acesso ao OZloc pelo serviço de integração OZmap | https://cliente.ozmap.com.br/integrations/erpvoalle/loki |
Usuário | Usuário cadastrado no OZmap para o ERP Voalle enviar requisições API. | voalle_integracao |
Senha | Senha do usuário cadastrado no OZmap para o ERP Voalle enviar requisições API. | No ERP Voalle: exemplosenha No OZmap: 1e57b11f4a0e54578f135ca73a369d33 |
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
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. | - |