Essa documentação trata da integração com o sistema CNT. A integração é realizada atraves de chamadas de API partindo do Integrador e utilizando a API disponibilizada pelo OZmap.
Tipo de Integração
A integração OZmap-CNT é do tipo Passiva-indireta.
Descrição
A CNT é uma empresa de desenvolvimento de softwares web, especializada em aplicações web e mobile focada em empresas de comunicação e telecomunicação.
A integração com o OZmap se dá por chamadas API em conjunto com processos do CNT mantendo sincronização em relação as funcionalidades descritas.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consulta de viabilidade de acordo com endereço enviado pelo cliente | O CNT envia o endereço do cliente para o OZmap o qual faz a consulta de viabilidade no local enviado. | OZmap => CNT |
Criação de reservas no OZmap | O CNT cria uma reserva no OZmap através do Loki caso haja viabilidade e for escolhido fazê-la. | CNT => OZmap |
Implantação de clientes no OZmap | O CNT atualiza o status de implantação de clientes no OZmap, identificando quando os mesmos foram ativados | CNT => OZmap |
Atualização de dados de clientes no OZmap | O CNT atualiza o nome, observações do cliente e observações da residência do cliente no OZmap | CNT => OZmap |
Cancelamento de clientes no OZmap | O CNT cancela também clientes no OZmap que foram cancelados no ERP. | CNT => OZmap |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo de forma a entender como funciona a integração.
Consulta de viabilidade de acordo com endereço enviado pelo cliente
A consulta de viabilidade de acordo com o endereço enviado pelo cliente é dada da seguinte forma:
O cliente disponibiliza seu endereço ao atendente.
O atendente então, através da tela fornecida pelo OZmap, verifica a viabilidade do endereço.
Após análise positiva desta viabilidade, o atendente pode abrir o Loki para finalizar o processo de viabilidade.
Criação de reservas no OZmap
A criação de reservas de portas no OZmap é dada da seguinte forma:
Após uma consulta de viabilidade com sucesso, é possível escolher um poste ou caixa em que o cliente será alocado
O cliente, que será identificado pelo código de contrato, então será criado como uma reserva na porta escolhida.
Atualização de clientes no OZmap
A atualização de clientes no OZmap é dada da seguinte forma:
Uma chamada API é feita pelo CNT ao OZmap em casos de atualização de: status de implantação, nome, observações do cliente e observações da residência do cliente, atualizando essas informações do cliente no OZmap usando o código de contrato como identificador
Cancelamento de clientes no OZmap
O cancelamento de clientes no OZmap é dado da seguinte forma:
Uma chamada API é feita pelo CNT ao OZmap quando um cliente é cancelado, removendo o cliente da propriedade e deixando o drop e propriedade conectados à porta escolhida, com possibilidade de configuração para desconectá-los da porta caso seja necessário.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo integrador são:
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | |
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 |
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 CNT 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 |
|---|---|
//Anotar as perguntas e possíveis respostas e quais as funcionalidades relacionadas às respostas.
0 Comments