Autenticação

Requisição do tipo POST com o corpo json { "username": "{usuario}", "password": "{senha}" }

Exemplo autenticação

{urlApplication}/auth/generatetoken

					
Body: { "username": "usuario", "password": "senha" }

A resposta será um token que deverá ser colocado com a chave Authorization no cabeçalho de cada requisição dos outros serviços:

Digicade-Rest-API:{token}

Revalidação do token

O token inicial possui uma validade de 30 minutos depois de gerado. Na autenticação um refreshToken é enviado juntamente com o token inicial para que este possa ser revalidado. Para gerar um novo token deve-se enviar a requisição abaixo, do tipo POST , colocando a chave Authorization no cabeçalho e como valor Digicade-Rest-API:{refreshToken}. O token de revalidação possui uma validade de 30 dias. Após o token expirar, é necessário realizar a autenticação novamente.

{urlApplication}/auth/refresh
					

Feições

Feição Path
Cliente cliente
Caixa de Emenda caixaEmenda
CTO cto
CAH cah
Estação estacao
HUB hub
Lance de Cabo lanceCabo
Poste poste
Splitter splitter
Terminador Óptico terminadorOptico

Serviços

- desc

Obtém a lista de colunas da feição. Requisição do tipo GET . No retorno da requisição, as colunas estão no atributo columns e a descrição é dada pela chave alias

Exemplo requisição:

{urlApplication}/{feicao}/desc
						

- get

Obtém registro único de acordo com o fid. Requisição do tipo GET com o único e obrigatório parâmetro fid :

Exemplo requisição:

{urlApplication}/{feicao}/get?fid={fid}
						

- list

Obtém lista de registro das feições. Requisição do tipo GET .

Parâmetros:

					
limit: quantidade de registros que a requisição deve retornar
columns: parâmetro obrigatório. Indica quais colunas da feição a requisição deve retornar. Devem ser separadas por vírgulas.
filter: Filtro com base nas colunas em linguagem SQL
sorter: Ordenação de acordo com colunas. Separadas por vírgulas
				

Exemplo requisição:

{urlApplication}/poste/list?columns=fid,numero,altura&limit=10&sorter=numero&filter=altura > 12
						

O exemplo acima retorna a lista com o fid, o número e a altura de 10 postes com mais de 12 metros, ordenados pelo número.

- count

Obtém a quantidade de registros da feição. Requisição do tipo GET . Possui o parâmetro filter opcional onde pode ser passado um filtro de acordo com a coluna em linguagem SQL.

Exemplo requisição:

{urlApplication}/poste/count?filter=altura=10
						

- delete

Deleta o registro da feição de acordo com o fid. Requisição do tipo POST com o único e obrigatório parâmetro fid :

Exemplo requisição:

{urlApplication}/{feicao}/delete?fid={fid}
						

- save

Insere o registro da feição. Requisição do tipo POST . Os dados a serem salvos devem ser passados no corpo da requisição em um objeto do tipo application/json .

Exemplo requisição:

{urlApplication}/{feicao}/save
						

- Atributos save Cliente:

fid: Quando não nulo deve ser o fid de um cliente já existente para edição.
codigo: Quando não nulo deve ser único.
nome*
documento
contrato
latitude: parâmetro do tipo double.
longitude: parâmetro do tipo double.
endereco: Na ausência de latitude e longitude é obrigatório.
numeroPorta: parâmetro do tipo inteiro.
complementoEndereco
telefone
fidTipo*: 1 se é cliente residencial, 2 se é comercial.
indDedicado: 1 se é cliente dedicado.
fidFluxoAtendimento*: 1 se é cliente prospectado; 2 interessado; 3 viabilidade técnica; 4 atendimento reservado; 5 ativo; 6 inativo; 7 aguardando ativação; 8 desligado; 9 ativo sem rede.
macOnu
codigoOnu
qtdPortasAtendimento: parâmetro do tipo inteiro e maior que 0.
sinal: parâmetro do tipo double.
comprimentoFibra: parâmetro do tipo double.
infoComplementar
codigoCaixa: parâmetro opcional usado quando deseja-se inserir cliente em uma caixa.
fidTipoCaixa: parâmetro deve ser usado juntamente com codigoCaixa. 1 se Caixa de Emenda; 2 se CTO; 3 se Terminador Óptico; 4 se CAH; e 5 se Hub.
fidCaixa: parâmetro alternativo ao uso de codigoCaixa e fidTipoCaixa. Em vez de informar o código da caixa e seu tipo pode-se apenas informar seu fid para inserir o cliente.

- Atributos save Caixa Emenda/CTO/Terminador Óptico/CAH/HUB:

fid: Quando não nulo deve ser o fid de uma caixa já existente para edição.
codigo*
latitude: parâmetro do tipo double.
longitude: parâmetro do tipo double.
endereco: Na ausência de latitude e longitude é obrigatório.
fidModelo*: parâmetro do tipo inteiro.
fidFabricante*: parâmetro do tipo inteiro.
fidTipoUtilizacaoMaterial*: 1 se é área; 2 subterrânea.
numeroMaxDerivacao: parâmetro do tipo inteiro.
capacidadeBandejas: parâmetro do tipo inteiro.
capacidadeFibrasBandeja*: parâmetro do tipo inteiro.
sangria: 1 se é sangria.
infoComplementar

A requisição abaixo pode ser utilizada para obter modelos de Caixas de Emenda, CTO, Terminador Óptico, CAH e HUB. Para Caixas de Emenda deve-se passar o filtro fidTipoCaixaEmenda=1; para CTO, fidTipoCaixaEmenda=2; para Terminador Óptico, fidTipoCaixaEmenda=3; para CAH, fidTipoCaixaEmenda=4;e para HUB, fidTipoCaixaEmenda=5;:
{urlApplication}/modeloCaixa/list?columns=fid,descricao&filter=fidTipoCaixaEmenda={tipo}
							
A requisição abaixo pode ser utilizada para obter fabricantes de Caixas de Emenda, CTO, Terminador Óptico, CAH e HUB:
{urlApplication}/fabricanteCaixa/list?columns=fid,descricao
							

- Atributos save Poste:

fid: Quando não nulo deve ser o fid de um poste já existente para edição.
numero: Quando não nulo deve ser único.
altura: parâmetro do tipo double;
carga: parâmetro do tipo double;
latitude*: parâmetro do tipo double.
longitude*: parâmetro do tipo double.
dataInstalacao: formato dd/mm/aaaa.
fidPropriedade*: parâmetro do tipo inteiro.
fidTerceiro: parâmetro do tipo inteiro.
fidTipoMaterial*: parâmetro do tipo inteiro. 1 se madeira; 2 se concreto; 3 se ferro.
fidTipoSecao*: parâmetro do tipo inteiro.
indChaveFaca: 1 se possui chave faca
indDescida: 1 se possui descida força
indTransformador: 1 se possui transformador
indVinculacao: 1 se possui vinculação
infoComplementar


A requisição abaixo pode ser utilizada para obter os tipos de propriedades de postes:
{urlApplication}/propriedadePoste/list?columns=fid,descricao,indTerceiroObrigatorio
							
A requisição abaixo pode ser utilizada para obter os tipos de terceiros de postes:
{urlApplication}/terceiroPoste/list?columns=fid,nome
							
A requisição abaixo pode ser utilizada para obter os tipos de seções de poste:
{urlApplication}/secaoPoste/list?columns=fid,descricao
							
A requisição abaixo pode ser utilizada para obter os tipos de materiais de poste:
{urlApplication}/materialPoste/list?columns=fid,descricao
							

- Operações com Clientes em Caixas

Os serviços disponíveis para manipular clientes em Caixas (Caixa de Emenda, CTO, Terminador Óptico,CAH e HUB) são: adicionar Cliente (na Caixa); adicionar Conexão (caso o cliente já esteja inserido na Caixa); remover Cliente e sua conexão (se houver); remover apenas a conexão do Cliente; reservar Porta (destinar uma porta de Splitter para um Cliente específico) e atualizar Reserva (atualizar a o status da Conexão de reservada para ativa).

Atributos para operações em Caixas:

fidCliente: Fid do Cliente a ser inserido na caixa.
codigoCaixa*: código da caixa que deseja-se inserir o cliente.
fidTipoCaixa*: parâmetro deve ser usado juntamente com codigoCaixa. 1 se Caixa de Emenda; 2 se CTO; 3 se Terminador Óptico; 4 se CAH; e 5 se HUB.
fidCaixa*: parâmetro alternativo ao uso de codigoCaixa e fidTipoCaixa. Em vez de informar o código da caixa e seu tipo pode-se apenas informar seu fid para inserir o cliente.
codigoSplitter: parâmetro opcional usado quando deseja-se conectar o cliente em um splitter.
fidSplitter: parâmetro alternativo ao uso de codigoSplitter. Em vez de informar o código do splitter pode-se apenas informar seu fid para conectar o cliente.
numeroPortaCliente: número da porta do Cliente que deseja-se conectar o Splitter. A porta do Cliente não deve estar ocupada. Caso não informado o sistema identifica o valor padrão como porta 0.
numeroPortaSplitter: número da porta do Splitter que deseja-se conectar o Cliente. Parâmetro obrigatório quando se informa o códido do Splitter ou o fid do Splitter. A porta do Splitter não deve estar ocupada.

* codigoCaixa e fidTipoCaixa são obrigatórios na ausência de fidCaixa

- Adicionar Cliente:

Requisição do tipo POST . Os dados a serem salvos devem ser passados no corpo da requisição em um objeto do tipo application/json .

Atributos obrigatórios: fidCliente; fidCaixa ou codigoCaixa e fidTipoCaixa

Atributos opcionais: fidSplitter ou codigoSplitter; numeroPortaSplitter;numeroPortaCliente

Se os parâmetros opcionais não forem passados, o Cliente é adicionado na Caixa, mas sem a criação de uma Conexão.

Caso os parametros relacionados a criação da conexão seja passado e o numero da porta do Cliente não, a conexão será realizada na porta 0 do cliente.

Requisição:

{urlApplication}/fusoesCaixa/inserirCliente
						

- Adicionar Conexão:

Requisição do tipo POST . Os dados a serem salvos devem ser passados no corpo da requisição em um objeto do tipo application/json .

Atributos obrigatórios: fidCliente

Atributos opcionais: fidSplitter ou codigoSplitter; numeroPortaSplitter; numeroPortaCliente

Se os parâmetros relacionados ao Splitter não forem passados, a Conexão é criada automaticamente na primeira porta de Splitter de atendimento disponível. Se o numero da porta do Cliente não for passado, a conexão será criada na porta 0 do cliente.

Requisição:

{urlApplication}/fusoesCaixa/adicionarConexao
						

- Remover Cliente:

Requisição do tipo POST . O Fid do Cliente deve ser passado como parâmetro na URL da requisição.

Requisição:

{urlApplication}/fusoesCaixa/removerCliente?fidCliente={fidCliente}
						

- Remover Conexão do Cliente:

Requisição do tipo POST . O Fid do Cliente deve ser passado como parâmetro na URL da requisição.

Requisição:

{urlApplication}/fusoesCaixa/removerConexaoCliente?fidCliente={fidCliente}
						

- Reservar Porta:

Requisição do tipo POST . Os dados a serem salvos devem ser passados no corpo da requisição em um objeto do tipo application/json .

Atributos obrigatórios: fidCliente; fidCaixa

Atributos opcionais: fidSplitter; numeroPortaSplitter

Se os parâmetros opcionais não forem passados, a Reserva é efetuada automaticamente na primeira porta de Splitter de atendimento disponível.

Requisição:

{urlApplication}/fusoesCaixa/reservarPorta
						

Resposta:

porta: número da porta em que a reserva foi feita
fidSplitter: identificação do splitter
fidConexão: identificação da conexão criada
dataExpiracao: data (no formato 'dd/MM/aaaa HH:mm:ss') em que a reserva expira

- Update da Reserva:

Requisição do tipo POST . Os Fid's do Cliente e da Caixa devem ser passados como parâmetro na URL da requisição.

Requisição:

{urlApplication}/fusoesCaixa/updateReserva?fidCliente={fidCliente}&fidCaixa={fidCaixa}
						

- Listar notas:

Requisição do tipo GET . O fid do tipo de feição e o fid da caixa devem ser passados na URL da requisição.

Requisição:

{urlApplication}/nota/list?columns=fid,texto&limit=10&sorter=texto&filter=fidTipoFeicaoEsquematico=87%AND%fidFeicaoEsquematico={fidCaixa}
						

- Listar clientes conectados ao splitter:

Requisição do tipo GET . O tipo de splitter: 1 – Atendimento e 2 – Distribuição e o status da conexão: 0 - sem reserva e 1 - reservado devem ser informados.

Requisição:

{urlApplication}/splitterCliente/list?columns=nome&limit=10&sorter=nome&filter=tipoSplitter=1%AND%reservado=1%AND%fidSplitter={fidSplitter}
						

- Operações com Splitter

O serviço disponível para manipular splitter funciona como cadastro e edição.

Atributos para operações em Splitter:

fid: Quando não nulo deve ser o fid de uma caixa já existente para edição.
fidModeloSplitter*: Fid do modelo do splitter, conforme tabela de modelos de splitter.
codigo: Campo alfanumérico de até 30 caracteres.
indBalanceado*: 0 – Não balanceado e 1 – Balanceado. Se não informado, será inserido como 0.
indConectorizado*: 0 – Não conectorizado e 1 – Conectorizado. Se não informado, será inserido como 0.
fidTipoConector: Fid do tipo de conector óptico utilizado, conforme a tabela de tipos de conector.
numeroBandeja: Numerção da bandeja onde está instalado.
fidConexaoEstacao: Fid da conexão com a estação.
fidTipoFeicaoInstalacao*: Fid do tipo da feição onde o splitter está instalado: 87 - Caixa de emenda ou 38 – Estação.
fidFeicaoInstalacao*: Fid da feição onde o splitter está instalado.
perdaSinal: Valor alfanumérico de até 1000 caracteres.
fidPropriedade: Fid da propriedade, conforme tabela de propriedades.
fidTerceiro: Fid do terceiro cadastrado. Obrigatório caso o fidPropriedade for 2, 3 ou 4.
fidTipo*: 1 – Atendimento e 2 – Distribuição.
infoComplementar: Informações adicionais de até 1000 caracteres.
sinalMedidoSaida1: Valor número para indicar qual o sinal medido na saída 1.
sinalMedidoSaida2: Valor número para indicar qual o sinal medido na saída 2.
indPortasInvertidas*: 0 – Numeração de portas crescente e 1 – Numeração das portas invertidas ou decrescente. Se não informado, será inserido como 0.

* fidTerceiro é obrigatório caso fidPropriedade seja 2, 3 ou 4.

- Salvar ou alterar splitter:

Requisição do tipo POST . Os dados a serem salvos devem ser passados no corpo da requisição em um objeto do tipo application/json .

Atributos obrigatórios: fidModeloSplitter, fidTipoFeicaoInstalacao, fidFeicaoInstalacao e fidTipo

Atributos opcionais: indBalanceado, indConectorizado e fidModeloSplitter

Se os parâmetros opcionais não forem informados, o valor no banco ficará como 0.

Requisição:

{urlApplication}/splitter/save
						

Tabelas:

Modelos de Splitter
Fid Descrição Qtd. portas de entrada Qtd. portas de saída
1 PLC 2X4 2 4
2 PLC 2X8 2 8
3 PLC 2X16 2 16
4 PLC 2X32 2 32
5 PLC 1X4 1 4
6 PLC 1X8 1 8
7 PLC 1X16 1 16
8 PLC 1X32 1 32
11 PLC 1X64 1 64
12 PLC 1X128 1 128
13 PLC 2X2 2 2
14 PLC 2X64 2 64
15 FBT 1X2 1 2
16 FBT 2X2 2 2
17 FBT 1X2 - 1/99 1 2
18 FBT 1X2 - 2/98 1 2
19 FBT 1X2 - 5/95 1 2
20 FBT 1X2 - 10/90 1 2
21 FBT 1X2 - 15/85 1 2
22 FBT 1X2 - 20/80 1 2
23 FBT 1X2 - 25/75 1 2
24 FBT 1X2 - 30/70 1 2
25 FBT 1X2 - 35/65 1 2
26 FBT 1X2 - 40/60 1 2
27 FBT 1X2 - 45/55 1 2
28 PLC 1X2 - 1/99 1 2
29 PLC 1X2 - 2/98 1 2
30 PLC 1X2 - 5/95 1 2
31 PLC 1X2 - 10/90 1 2
32 PLC 1X2 - 15/85 1 2
33 PLC 1X2 - 20/80 1 2
34 PLC 1X2 - 25/75 1 2
35 PLC 1X2 - 30/70 1 2
36 PLC 1X2 - 35/65 1 2
37 PLC 1X2 - 40/60 1 2
38 PLC 1X2 - 45/55 1 2
39 PLC MODULAR 1X2 1 2
40 PLC MODULAR 1X4 1 4
41 PLC MODULAR 1X8 1 8
42 PLC MODULAR 1X16 1 16
43 PLC MODULAR 1X32 1 32
10 PLC 1X2 1 2
44 PLC 1X6 1 6
Tipos Conector
Fid Descrição
1 OUTROS
2 FC/APC-SM
3 SC-UPC
4 SC/PC-MM-DUPLEX
5 FC/PC-MM
6 FC/PC-SM
7 ST/PC-MM
8 SC/PC-MM
9 SC/PC-SM
10 SC/APC-SM
11 E-200 APC
12 LC/APC-SM
13 LC/PC-MM
14 LC/PC-SM
15 LC/PC-MM-DUPLEX
16 LC/PC-SM-BOTA0.9mm
17 LC/PC-SM-DUPLEX
18 SC/PC-SM-DUPLEX
Propriedades
Fid Descrição IndTeceiroObrigatorio
0 Não definido 0
1 Próprio 0
2 Alugado de terceiros 1
3 Alugado para terceiros 1
4 Terceiros 1

Viabilidade Técnica



- Consulta de Caixas Splitter/FTTH:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.
endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.

**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.

Exemplo requisição:

{urlApplication}/viabilidade/caixas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG
						

O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:

tipoCodigo: Atributo de descrição e tipo da caixa.
distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
qtdTotalDisponivel: Quantidade total de portas disponíveis, resultado da soma de portas splitter e de ethernet.
qtdSplitter: Quantidade total de splitters dentro da caixa.
qtdPortasSplitter: Quantidade total de portas de splitters dentro da caixa.
qtdPortasSplitterDisp: Quantidade total de portas disponíveis de splitters dentro da caixa.
qtdPortasSplitterOcup: Quantidade total de portas ocupadas de splitters dentro da caixa.
qtdEquipamentosPacpon: Quantidade total de equipamentos ethernet dentro da caixa.
qtdPortasEthernet: Quantidade total de portas de equipamentos ethernet dentro da caixa.
qtdPortasEthernetDisp: Quantidade total de portas disponíveis de equipamentos ethernet dentro da caixa.
qtdPortasEthernetOcup: Quantidade total de portas ocupadas de equipamentos ethernet dentro da caixa.

- Consulta de Caixas com rotas sugeridas Splitter/FTTH:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.
endereco**
qtdRotas*: Atributo do tipo integer, menor ou igual a 5. Indica a quantidade máxima de rotas sugeridas.
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.

**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.

Exemplo requisição:

{urlApplication}/viabilidade/caixasRotasSugeridas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG&qtdRotas=5
						

O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:

fid: Atributo identificador da caixa.
qtdPortasSplitter: Quantidade total de portas de splitters dentro da caixa.
fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico e 4 = Caixa de atendimento híbrido).
qtdEquipamentosPacpon: Quantidade total de equipamentos ethernet dentro da caixa.
qtdPortasEthernetOcup: Quantidade total de portas ocupadas de equipamentos ethernet dentro da caixa.
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.
qtdPortasSplitterDisp: Quantidade total de portas disponíveis de splitters dentro da caixa.
capacidade: Capacidade da caixa.
qtdPortasSplitterOcup: Quantidade total de portas ocupadas de splitters dentro da caixa.
qtdClientes: Quantidade de clientes na caixa.
qtdTotalDisponivel: Quantidade total de portas disponíveis, resultado da soma de portas splitter e de ethernet.
qtdSplitter: Quantidade total de splitters dentro da caixa.
distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
qtdPortasEthernetDisp: Quantidade total de portas disponíveis de equipamentos ethernet dentro da caixa.
indAreaAtendimentoCto: Atributo que identifica se a caixa está dentro de uma área de atendimento ou não (1 = sim, 0 = não)
tipoCodigo: Atributo de descrição e tipo da caixa.
qtdPortasEthernet: Quantidade total de portas de equipamentos ethernet dentro da caixa.
distanciaRotaSugerida: Distância em metros da rota sugerida.
geometriaRotaSugerida: Geometria da rota sugerida no formato WKT.

- Consulta de Caixas/Lances:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.
endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.

**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.

Exemplo requisição:

{urlApplication}/viabilidade/caixasLances?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG
						

O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:

tipoCodigo: Atributo de descrição e tipo da caixa.
distancia: Distância radial em metros entre o ponto de análise de viabilidade e a caixa.
fid: Fid da caixa retornada.
qtdClientes: Quantidade total de clientes dentro da caixa.
qtdLancesCabo: Quantidade total de lances de cabo dentro da caixa.
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.

- Consulta de Caixas/Lances com rotas sugeridas:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.
endereco**
qtdRotas*: Atributo do tipo integer, menor ou igual a 5. Indica a quantidade máxima de rotas sugeridas.
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.

**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.

Exemplo requisição:

{urlApplication}/viabilidade/caixasLancesRotasSugeridas?raio=200&endereco=Rua tomé de souza, 845, funcionários, BH - MG&qtdRotas=5
						

O retorno será uma lista de caixas que estão dentro raio com os seguintes atributos:

fid: Atributo identificador da caixa.
fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico e 4 = Caixa de atendimento híbrido).
geometryCaixaEmenda: Geometria que representa a posição da caixa no formato WKT.
capacidade: Capacidade da caixa.
qtdClientes: Quantidade de clientes na caixa.
qtdLancesCabo: Quantidade total lances de cabo associados a caixa.
distancia: Distância radial em metrod entre o ponto de análise de viabilidade e a caixa.
tipoCodigo: Atributo de descrição e tipo da caixa.
distanciaRotaSugerida: Distância em metros da rota sugerida.
geometriaRotaSugerida: Geometria da rota sugerida no formato WKT.

- Distância da rota sugerida:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

fidCliente*: identificador do cliente para qual deseja encontrar a rota sugerida.
fidCaixa: Identificador da caixa que fará o atendimento ao cliente informado.

Exemplo requisição:

{urlApplication}/viabilidade/distanciaRotaSugerida?fidCaixa=216981&fidCliente=2162
						

O retorno será uma rota sugerida entre a caixa e o cliente com os seguintes atributos:

success: Atributo informando o sucesso ou não da requisição.
distancia: Distância da rota entre a caixa e o cliente a ser atendido.
rotaSugerida: Geometria da rota em formato WKT.

- Facilidade:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

raio*: Atributo em metros do tipo double. Indica o raio da consulta de caixas a partir do endereço informado.
endereco**
latitude**: deve ser informada em EPSG:4326.
longitude**: deve ser informada em EPSG:4326.
googlePlaceId**: Identificador de endereços do Google. Pode ser obtido realizando a consulta de endereços do serviço acima.
estacao***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
caixaEmenda***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
cto***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
cah***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
terminalOptico***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.
hub***: Atributo não obrigatório do tipo int. 1 caso queira o retorno, 0 caso não queira.

**Devem ser informados endereco ou googlePlaceId ou latitude e longitude.

***Atributos não obrigatórios. Caso não informar, todos serão retornados. Se setar um ou mais deles com 1, apenas eles serão retornados.

Exemplos requisições:

{urlApplication}/viabilidade/facilidade?raio=100&endereco=Avenida Bias Fortes&latitude=-19.930691478687518&longitude=-43.940275216627946
						
{urlApplication}/viabilidade/facilidade?raio=100&latitude=-19.930691478687518&longitude=-43.940275216627946
						
{urlApplication}/viabilidade/facilidade?raio=100&latitude=-19.930691478687518&longitude=-43.940275216627946&cto=1&caixaEmenda=1
						

O retorno será uma lista de caixas e estações que estão dentro raio com os seguintes atributos:

fidTipoFeicao: Fid do tipo feição, 38 para estação e 87 caixa de emenda.
fidFeicao: Atributo identificador da caixa ou estação.
tipo: Tipo da feição.
codigo: Código da feição.
distancia: Distância radial em metros entre o ponto de análise de facilidade e a caixa/estação.
x: Ponto da longitude da feição.
y: Ponto da longitude da feição.
fidTipoCaixaEmenda: Atributo que determina o tipo da caixa (1 = Caixa emenda, 2 = CTO, 3 = Terminador óptico, 4 = Caixa de atendimento híbrido e 5 = Hub).

Elementos Excluídos



- Consulta de feicões:

Requisição do tipo GET . Os parâmetros devem ser passados na URL.

Atributos:

tipoFeicao: Atributo em texto informando o tipo da feicao. Exibe apenas uma feicao, a qual foi informada. parâmetro pode receber os seguintes valores: poste, caixa, estacao, splitter.
dataInicial: Atributo em texto informando a data inicial em que deseja obter os resultados. parâmetro deve receber os valores em formato yyyy-MM-dd: 2023-12-20, e deve se passar o parâmetro dataFinal.
dataFinal: Atributo em texto informando a data inicial em que deseja obter os resultados. parâmetro deve receber os valores em formato yyyy-MM-dd: 2023-12-20.
sorter*: Atributo em texto informando qual coluna vc deseja ordenar os resultados. parâmetro pode receber os seguintes valores: datahoraExclusao, fid, fidFeicao, fidTipoFeicao.
direction*: Atributo em texto informando o sentido da ordenação. parâmetro pode receber os seguintes valores: ASC, DESC.


Atributos Obrigatórios: sorter e direction

Exemplo requisição:

{urlApplication}/elementoExcluido/get?sorter=datahoraExclusao&direction=desc&dataInicial=2024-01-18&dataFinal=2024-01-19
						

O retorno será uma lista das feicoes que foram excluídas: Caso não seja passado nenhum parâmetro o retorno será uma lista de todas as feicoes que foram excluídas:

datahoraExclusao: Data Hora em que a feição foi excluída.
descricao: Contém informações sobre a feição excluída.
fid: Fid da lista de feições excluídas.
fidFeicao: Fid da feição excluída.
tipoFeicao: Informa o tipo da feição excluída. Poste, caixa, estacao ou splitter.
tipoFeicaoDetalhado: Contém o tipo da feição. Se o tipo da feição for uma caixa, irá mostrar qual o tipo da caixa. CTO/HUB/Caixa de Emenda/CAH/TO