...
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 | ||||
|---|---|---|---|---|
|
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 (
) a viabilidade disponível, e caso de sinal negativo (
) 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 (
)
...
, 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. | |
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 |
|---|---|