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