Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Image RemovedImage Added

Essa documentação trata da integração com o sistema Odoo. A integração é realizada através de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.

Table of Contents
minLevel1
maxLevel7

Tipo de Integração

A integração OZmap-Odoo é do tipo Passiva-direta.

Descrição

O Odoo é uma suíte de aplicativos empresariais de código aberto que ajuda as empresas a gerenciar e automatizar seus processos de negócios, contando com implementações em várias áreas.

O Odoo Flexxoone é uma implementação do sistema Odoo voltada para empresas de telecomunicações, e sua integração com o OZmap tem como objetivo principal a consulta de viabilidade de atendimento, reserva de portas, implatanção e cancelamento de clientes e troca de portas de reservas feitas no OZmap.

Resumo de funcionalidades

Funcionalidade

Descrição

Direção da integração

Viabilidade com Reserva de Porta no OZmap

Buscar viabilidade técnica no OZmap para um endereço de cliente Odoo e reservar uma porta no OZmap para sua instalação.

Odoo => OZmap

Implantação de Clientes no OZmap

Implantação de clientes Odoo no OZmap, através da conclusão de um serviço de instalação de cliente no Odoo.

Odoo => OZmap

Cancelamento de Clientes e Reservas no OZmap

Remove reservas e clientes no OZmap, através do cancelamento de um serviço de cliente pelo Odoo.

Odoo => OZmap

Troca de Porta do Cliente para instalação

Realiza a troca de portas de reservas feitas no OZmap, durante o processo de instalação de um cliente no Odoo.

Odoo => OZmap

Busca de dados de conexão do Cliente no OZmap

Realiza a busca de dados de conexão do cliente no OZmap (como OLT, Caixa, Splitter e Porta) e as disponibiliza no Odoo.

Odoo => OZmap

Funcionalidades

Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona o fluxo de sincronização.

Viabilidade com Reserva de Porta no OZmap

A Consulta de Viabilidade realizada pelo Odoo no OZmap consiste em verificar a disponibilidade de atendimento para um novo cliente em determinada localidade, e ocorre da seguinte forma:

  • Através da interface da plataforma de vendas Odoo, é feito um pré-cadastro de um cliente interessado em contratação de internet;

  • A partir do endereço informado pelo cliente, o Odoo realiza a consulta de viabilidade no OZmap, enviando as coordenadas correspondentes ao endereço do cliente para buscar caixas que não estejam “Em projeto”, e possuam splitter de atendimento com portas disponíveis no OZmap;

    • A busca de viabilidade realizada no OZmap é feita por raio, e a distância máxima para este raio de busca será a que estiver definida nas configurações do Odoo (Parâmetro “OzMap Raio”).

  • Após a busca de viabilidade no OZmap, é disponibilizado a viabilidade como um sinal de positivo ou negativo, sendo o caso de sinal positivo ((thumbs up)) a viabilidade disponível, e caso de sinal negativo ((thumbs down)) a viabilidade indisponível;

  • Em caso de viabilidade disponível, a contratação do serviço é cadastrada;

  • Após o usuário confirmar o cadastro de venda do cliente, que é feito com o cliente aceitando a contratação do serviço, é criado uma reserva no OZmap usando o atributo “client code” do serviço do cliente no Odoo, a caixa informada no processo de viabilidade e a primeira porta disponível nessa caixa.

Implantação de Clientes no OZmap

A Implantação de clientes no OZmap realizada pelo Odoo consiste em implantar clientes que tiveram suas instalações feitas e confirmadas no Odoo, e ocorre da seguinte forma:

  • Através da interface da plataforma de projetos Odoo, é encontrado o serviço de instalação de um produto para um cliente ao qual sua reserva foi feita anteriormente;

  • Imediatamente após o serviço de instalação ter sido confirmado no Odoo, o Odoo implanta o cliente que possui código no OZmap igual ao atributo “client code” do serviço do cliente no Odoo;

Cancelamento de Clientes e Reservas no OZmap

O Cancelamento de clientes no OZmap realizada pelo Odoo consiste em remover clientes com serviços cancelados pelo Odoo no OZmap, e ocorre da seguinte forma:

  • Quando o serviço de um cliente ativo ou com reserva de porta é cancelado no Odoo, o Odoo remove o cliente que possui código no OZmap igual ao atributo “client code” do serviço do cliente no Odoo.

    • O cliente é removido completamente do OZmap (cliente, imóvel e drop são excluídos).

Troca de Porta do Cliente para instalação

A Troca de porta de reserva realizada pelo Odoo no OZmap consiste em alterar a porta de reservas feitas no OZmap para usar uma caixa diferente da reserva no momento da instalação pelo técnico, e ocorre da seguinte forma:

  • Através da interface da plataforma de projetos Odoo, o usuário encontra o serviço de instalação de um serviço para um cliente ao qual sua viabilidade e reserva foram feitas anteriormente;

  • Após escolher a opção “CHANGE BOX”, o Odoo realiza uma consulta de nova viabilidade utilizando as coordenadas da reserva, retornando as caixas com viabilidade e as disponibiliza para escolha;

  • Após selecionar uma das caixas e o usuário confirmar a seleção desta caixa, a reserva do cliente que possui código no OZmap igual ao atributo “client code” do serviço do cliente no Odoo, é atualizada com a nova caixa e a primeira porta disponível nesta caixa no OZmap.

Busca de dados de conexão de Cliente no OZmap

A Busca de dados de conexão de Cliente realizada pelo Odoo no OZmap consiste em realizar uma busca dos dados de conexão de clientes para visualização no Odoo, e ocorre da seguinte forma:

  • Através da interface da plataforma de vendas Odoo, é selecionado um cliente que já teve sua viabilidade e reserva feita no OZmap;

  • Após selecionar o botão sinalizando um sinal de positivo ((thumbs up) ), o Odoo busca no OZmap os dados de conexão do cliente que possui código no OZmap igual ao atributo “client code” do serviço do cliente no Odoo, e suas informações de conexão incluindo OLT, caixa, splitter e porta do OZmap são disponibilizadas para visualização no Odoo.

Dados Acesso

Dados de acesso necessários para as operações realizadas pelo integrador são:

Saiba mais como configurar esses dados acionando o suporte do Odoo.

OZmap

Parâmetro

Descrição

Exemplo

URL

Endereço do OZmap.

https://cliente.ozmap.com.br

Token

Token associado a conta do usuário de integração cadastrado no OZmap. (O usuário deve ter acesso aos projetos que a integração irá trabalhar (Escolha do usuário). Tutorial de como gerar usuário/chave.)

eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtb2R1bGUiOiJhcGkiLCJ1c2VyIjoiNWQ5ZjNmYjgyMDAxNDEwMDA2NDdmNzY4IiwiY3JlYXRpb25EYXRlIjoiMjAyMC0wOC0yNFQxNjoxMjoyMS43MTdaIiwiaWF0IjoxNTk6Mjg1NTQxfQ.S215vbHlBLtZSzxmORIc2sH1lEKi5VALKBqZB1VcFCE

Porta OZmap

Porta de serviço padrão do OZmap.

9994

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 Odoo para acessar as portas 80 e 9994 no ambiente do OZmap.

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

Questionário

Pergunta

Resposta