IClass
- Mateus Carlos de Souza (Unlicensed)
- Leonardo Rosa Bittencourt
- Marcus Vinícius Pires
Essa documentação trata da integração com o sistema IClass. 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-IClass é do tipo Passiva-Direta.
Descrição
O IClass é uma ferramenta de gerenciamento de ordem de serviços, organizando principalmente em torno de prazos de atendimento, através do rastreamento de serviços em painéis e mapas.
A integração com o OZmap visa fornecer informações de equipamentos (caixas, splitters) próximos a clientes para o gerenciamento de ordens de serviço no aplicativo IClass.
Resumo de funcionalidades
Funcionalidade | Descrição | Direção da integração |
|---|---|---|
Consultar CTOs OZmap disponíveis para realização de serviço | O IClass realiza a busca de CTOs OZmap e suas portas disponíveis próximas do endereço de clientes para o gerenciamento de ordens de serviço em andamento. | OZmap => IClass |
Funcionalidades
Abaixo serão descritas as funcionalidades apresentadas no resumo para entender como funciona o fluxo de sincronização.
Consultar portas de CTOs OZmap Disponíveis
A consulta das CTOs OZmap disponíveis para gerenciamento de ordens de serviço, é dada da seguinte forma:
Ao acessar uma ordem de serviço de cliente e essa ordem de serviço possuindo status de “Em Andamento”, usando a funcionalidade de Mapa de Equipamentos é feita uma busca por CTOs próximas ao cliente através de um raio no OZmap, usando como base a coordenada do cliente desta ordem de serviço.
São retornados no mapa do IClass as CTOs próximas ao cliente encontradas no OZmap, podendo ser selecionadas para visualização de suas informações gerais, splitters e detalhes das portas (indisponíveis e livres) desses splitters.
Dados Acesso
Dados de acesso necessários para as operações realizadas pelo Datacake são:
OZmap
Parâmetro | Descrição | Exemplo |
|---|---|---|
URL | Endereço do OZmap, com a porta de serviço padrão. | https://cliente.ozmap.com.br:9994/api/v2 |
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 IClass 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 IClass.
Questionário
Pergunta | Resposta |
|---|---|
O IClass busca no OZmap somente splitters de atendimento? | Não, atualmente são buscados todos os splitters das caixas, sendo eles de atendimento e distribuição. |