Integração Quaza × GeoGrid

Como ligar o seu GeoGrid ao Quaza, trazer as caixas para o sistema e usar a consulta de viabilidade e a reserva de portas no dia a dia. — Módulo: Fibra · Mapa

1O que a integração faz

O fluxo, ponta a ponta:

Na prática:

• Consulta de viabilidade ao vivo. Ao informar o endereço do cliente, o Quaza pergunta ao GeoGrid quais caixas existem naquele raio e quais portas estão livres naquele momento — não é uma cópia local desatualizada.
• Reserva de porta. Ao escolher a caixa e a porta, o Quaza reserva a porta dentro do GeoGrid, já vinculada ao cliente.
• Cliente criado automaticamente. Se o cliente ainda não existe no GeoGrid, o Quaza cadastra na hora, usando o CPF/CNPJ como chave.
• Ativação pela ONU. Quando a ONU é cadastrada naquela porta, a reserva vira atendimento efetivo no GeoGrid.
• Importação de caixas. As caixas (terminais) do GeoGrid podem ser trazidas para o Quaza para aparecerem nas telas de fibra.

2Antes de começar

Tenha em mãos:

1. Endereço da sua instância GeoGrid — o mesmo que você usa para acessar a plataforma (ex.: https://suaempresa.geogrid.com.br).
2. Chave de API do GeoGrid — gerada no painel do GeoGrid. É o que autoriza o Quaza a consultar e reservar.
3. Pelo menos um tipo de caixa cadastrado e ativo no Quaza (Fibra → Tipos de caixa). A importação usa esse tipo para as caixas que vierem do GeoGrid; sem nenhum tipo ativo, a importação falha.
4. Módulo de fibra habilitado no Quaza.
5. Cadastro de clientes completo — nome, CPF/CNPJ, endereço, bairro, cidade, estado e CEP. Esses dados são enviados ao GeoGrid quando o cliente é criado lá.

3Configurando

3.1. Cadastrar a integração

Salve.

Os campos Instância e Token aparecem conforme o Gateway escolhido — selecione GeoGrid primeiro e eles surgem na tela.

3.2. Conferir se ficou tudo certo

O teste prático da configuração é importar as caixas (item 3.3). Se a importação trouxer as caixas, endereço e chave estão corretos. Se a chave estiver errada, o próprio Quaza avisa com uma mensagem de "não autorizado".

3.3. Importar as caixas

O que vem do GeoGrid:

1. Todos os itens de rede do tipo terminal.
2. De cada um: a sigla (vira a descrição da caixa no Quaza), a localização no mapa e o status (ativo/inativo).
3. As caixas novas recebem o primeiro tipo de caixa ativo cadastrado no Quaza.

4No dia a dia

4.1. Consultar viabilidade e reservar porta

1. Informe o cliente — obrigatório: a reserva é sempre em nome de alguém.
2. Informe o endereço e clique em Buscar por endereço para o mapa localizar o ponto, ou arraste o pino até o local exato.
3. Ajuste o Raio (m) — o padrão é 100 metros. É a distância que o Quaza vai varrer em volta do ponto.
4. Clique em Avançar. O Quaza consulta o GeoGrid e lista os terminais e caixas dentro daquele raio, com a distância e as portas.
5. Escolha a caixa e a porta livre → Reservar porta.

Situações da reserva: Reservada → Ativa → Cancelada.

4.2. Ativar a reserva — pela ONU

O caminho normal é automático: ao cadastrar a ONU e informar a porta da caixa, o Quaza:

1. Confere no GeoGrid se aquela porta está mesmo livre. Se não estiver, avisa: "Porta selecionada já está reservada ou em uso!".
2. Se a ONU já ocupava outra porta, libera a antiga no GeoGrid.
3. Reserva a porta nova e ativa o atendimento do cliente naquela porta.

Também é possível ativar manualmente em Mapa → Reservas de porta, pelo ícone de Ativar reserva.

4.3. Cancelar uma reserva

Em Mapa → Reservas de porta, use a ação de cancelar. A porta é liberada no GeoGrid e a reserva fica como Cancelada. Reserva já cancelada não pode ser cancelada de novo — o sistema avisa.

4.4. Quando reimportar as caixas

Rode a importação de novo sempre que incluir caixas novas no GeoGrid ou mudar a posição de alguma. Para a viabilidade do dia a dia isso não é obrigatório (ela consulta o GeoGrid ao vivo), mas mantém as telas de fibra do Quaza coerentes com a planta.

5Se algo der errado

6Pontos de atenção

1. Uma integração de mapa ativa por vez. O sistema não deixa salvar uma segunda ativa.
2. O cadastro do cliente vai inteiro para o GeoGrid. Cliente sem endereço, CPF/CNPJ ou cidade tende a falhar na hora de reservar — corrija o cadastro antes.
3. A viabilidade é consultada ao vivo no GeoGrid. Se a plataforma estiver fora do ar, a consulta não funciona.
4. A reimportação não renomeia caixas já existentes nem troca o tipo delas — só atualiza posição e status.
5. Mantenha ao menos um tipo de caixa ativo no Quaza, senão a importação não conclui.
6. A integração só age quando a porta da ONU muda. Corrigir outros dados da ONU não sincroniza nada.
7. Um cliente, uma porta. O GeoGrid recusa vincular o mesmo cliente a duas portas — desfaça o vínculo antigo antes de refazer o atendimento.