WebServices de retransmisión de datos

En este documento se podrán consultar los WebServices que tenemos integrados en la plataforma.

Web Services integrados

A continuación se listan los Web Services disponibles, ordenados alfabéticamente:

Web Service País Tipo de envío
Accio (Amazon AWS) México JSON
Aleph México JSON
Alto Movup Chile JSON
Altotrack General XML
Arm Cybermapa (CAESSAT v2) Argentina JSON
Arm Services (CAESSAT v2) Argentina JSON
Assistcargo Argentina XML
Aval (CAESSAT v2) Argentina JSON
AVL Control Chile JSON
Bermann Chile JSON
Blacsolutions México JSON
Boson General JSON
C5 México JSON
Caletabay Chile JSON
Calico Cybermapa (CAESSAT v2) Argentina JSON
Canacar México JSON
Carbess Chile JSON
Carbess (CAESSAT v2) Argentina JSON
Carcoolbox GPS General JSON
Cargas de combustible Panama JSON
CAT México JSON
Cementos Progreso General XML
Centinela México JSON
Centinela V2 México JSON
CMSV General JSON
ControlT General XML
Copec Chile JSON
Coyote México XML
Ctac Chile JSON
CyberMapa (CERSAT) Argentina STRING
Don Pedro (CAESSAT v2) Argentina JSON
Drivin Guatemala JSON
Drive Tech Chile JSON
DS Chile JSON
Ecopetrol - POC Colombia JSON
Ecopetrol V2 Colombia JSON
Ermap (CAESSAT v2) Argentina JSON
Farletza transporte Ecuador JSON
Fleetio General JSON
Freightverify General JSON
Frulog Chile JSON
Generic Web Service General JSON
Geogo-Geopark Colombia XML
GPS Chile Chile XML
GPS Chile V2 Chile JSON
Grupo UDA México XML
GTrack Chile JSON
I-place México JSON
ILSP México JSON
Integra Cemin Chile JSON
Konexa Peru JSON
KRONH México XML
Landstar México XML
Lavorante (CAESSAT v2) Argentina JSON
LogicTracker (CAESSAT v2) Argentina JSON
Logitex General JSON
Logitrack México JSON
Maersk General JSON
Maersk V2 General JSON
MaquinariaAmarilla Colombia JSON
Marchamos General XML
MaxTracker (CAESSAT v2) Argentina JSON
Mercosur (CAESSAT v2) Argentina JSON
Midlog / Zenware Chile XML
Migtra Chile JSON
Motumcloud México JSON
Multitrack México JSON
Navi 3.0 General XML
Nettek General JSON
Nexus México JSON
Orbcomm General JSON
Osinergmin Peru JSON
OTM General JSON
Overhaul GSK México JSON
Paquetes General JSON
Pegaso Colombia JSON
Pegasus Chile JSON
Position endpoint Chile JSON
Project44 V2 General JSON
Protrans México JSON
Pub/Sub Google General JSON
Pxpdu Perú JSON
Pxpdu Colombia Colombia JSON
Pxpdu Ecuador Ecuador JSON
QMGPS General XML
QuadMinds Argentina JSON
Recurso Confiable Mex (Irontracking) General XML
Rolbox IPS Chile JSON
RsRurales (CAESSAT v2) Argentina JSON
Samtech Chile XML
SandBox Tracker General JSON
Sauer (CAESSAT v2) Argentina JSON
Semov México JSON
Service Layer Panama JSON
Siames C5 México XML
Sider Peru Perú JSON
Simpli Route Chile JSON
Simpli Route & iDUX Chile JSON
SIPCOP-M Perú JSON
SISLOGSOS Colombia JSON
Sitrack Chile JSON
Sitrack Connect México JSON
Skynav Chile JSON
Smartsc México JSON
SOS Contingencias Colombia JSON
SuKarne México XML
Sutran Perú JSON
Tecnologistica (CAESSAT v2) Argentina JSON
Torre de Control México JSON
Torre dedicada mabe México JSON
Tracklog Peru JSON
TrackTec Chile JSON
Uber Freight México JSON
Unigis Argentina (antes Assistcargo) Argentina XML
Unigis Bolivia Bolivia XML
Unigis Chile (antes Assistcargo) Chile XML
Unigis Colombia Colombia XML
Unigis México (antes Assistcargo) México XML
Unigis Republica Dominicana República Dominicana XML
Unigis Salvador El Salvador XML
Unisolutions (CAESSAT v2) Argentina JSON
Vigilia seguridad (CAESSAT v2) Argentina JSON
Visor Grupo Acerero México JSON
Wirsolut (CAESSAT v2) Argentina JSON
Wirtrack Argentina JSON
Wisetrack (antes GerdauSider) General JSON
WS Arm GPS Argentina JSON
WS Integrados México JSON
WS Position Chile XML
Ziyu Chile JSON

Webservice de reenvío genérico

A continuación se explica brevemente la interfaz del Servicio Web Genérico de la plataforma de Monitoreo, para sus clientes o empresas externas autorizadas.

 

Tecnología de integración

Para la integración del Servicio Web de la plataforma de Monitoreo, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz que ofrecemos se encuentra desarrollada bajo los estándares de RESTful Web Services según se describe en el presente documento.

 

Intrucciones de uso

Para poder utilizar el Servicio Web, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Generic Web Service":

image-1672951259412.png

Con el botón "Asignar activos" se seleccionan los clientes y las unidades que van a retransmitir al Servicio Web Genérico.

image-1672951397959.png

Una vez que seleccionamos el cliente, con el botón "Credenciales", se puede ingresar las credenciales de seguridad, en caso de que sea necesario, y el hostname, donde podemos indicar la URL a donde se enviará la información.

 

Descripción del reenvío

Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacena la información en la base de datos (BD), el WebService Genérico se encarga de leer la información de los equipos y la reenvía a la URL que el cliente configure en la plataforma, en cuanto llegue un reporte este es inmediatamente reenviado.

La descripción general se puede representar con el siguiente diagrama:

image-1672845315237.png

 

Protocolo del WebService

Se ha creado una estructura de forma API RESTful que utiliza JSON como entrega mediante método POST, que se encarga de estar reenviando la información de los equipos GPS, que tenemos disponible en la plataforma a la URL que el cliente configure.

 

URL : La que el cliente configure.

Método : POST

Usuario: El que el cliente configure.

Contraseña: La que el cliente configure.

 

Identificador

Nombre

Tipo

Observaciones

deviceImei

Equipo

String

4176845511245678

dateTimeUtc

Fecha Hora

String

Y-m-d H:i:s GMT 0 o UTC

dateTimeLocal

Fecha Hora reporte

String

Y-m-d H:i:s 

latitude

Latitud

Double

-14.464430

longitude

Longitud

Double

-75.405083

speed

Velocidad (Km)

Double

19.0

direction

Orientación

Int

285

ignition

Ignición

Int

1 = Encendido / ON, 

0 = Apagado / OFF



Ejemplo del envío:

{

“deviceImei”:”4176845511245678”,

“dateTimeUtc”:”2021-08-21 18:21:22”,

“dateTimeLocal”:”2021-08-21 18:23:25”,

“latitude”:-14.464430,

“longitude”:-75.405083,

“speed”:19.0,

“direction”:285,

“ignition”:1

}

Web Service de Reenvío Genérico (Nueva Versión)

A continuación se explica brevemente la interfaz del Servicio Web Genérico de la plataforma de Monitoreo, para sus clientes o empresas externas autorizadas.

 

Tecnología de integración

Para la integración del Servicio Web de la plataforma de Monitoreo, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz que ofrecemos se encuentra desarrollada bajo los estándares de RESTful Web Services según se describe en el presente documento.

 

Instrucciones de uso

Para utilizar la nueva versión del Servicio Web, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Generic Web Service":

image-1726077126344.png

Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para configurar las credenciales:

image-1726086944665.png

 

Se abrirá una ventana con las siguientes pestañas:

image-1726079164729.png

 

 

Configurar credenciales

Con la pestaña credenciales podemos seleccionar dos tipos de recurso para asignar las recursos de seguridad para el envío de datos.

Acceso por API REST:

Para configurar el acceso por API REST debemos ingresar la url del Host, donde podemos indicar la URL hacia donde se enviará la información.

image-1726077578495.png

Acceso por TCP/UDP:

Deberá proporcionar los siguientes parámetros.

image-1726078826759.png

 

Configurar Ubicación

En esta pestaña podrá seleccionar la información que desea enviar al Web Service, deberá establecer la URL a la que desea enviar la información deseada.

En caso de necesitarlo, podrá definir un alias para los parámetros que necesitará, así como establecer el tipo especifico de dato (texto, entero, flotante, etc...)

image-1726079818787.png

Los valores que puede configurar en la nueva versión del web service genérico se muestran a continuación en la siguiente tabla:

URL idconductor gmt  tiempo fecha hora
latitud longitud timestamp idtipo_dato_gps velocidad  dirección
señal satélites input odómetro bateria_gps bateria_veh
ignicion buffered equipo_gps imei id_vehiculo vehiculo
placa num_economico horometro odometro_vehiculo notas cliente
idcliente rfc distribuidor      

 

Configurar Alertas

En la nueva versión del Web Service es posible seleccionar los tipos de alertas y la información que desee enviar. Es posible editar el nombre y el tipo de dato de cada una de las alertas para tener un mejor control de la información enviada.

Para hacer uso de este servicio debe habilitarlo mediante la opción "¿Enviar datos de alertas emitidas?", posteriormente ingrese la URL de su Web Service y seleccione los tipos de alerta deseados.

image-1726084368909.png

Los valores que puede configurar se muestran a continuación en la siguiente tabla:

equipo fecha hora descripcion latitud
longitud domicilio statusalerta tipoalerta idtipoalerta

 

Configurar Eventos

En la nueva versión del Web Service es posible seleccionar los tipos de evento y la información que desee enviar. Es posible editar el nombre y el tipo de dato de cada una de las alertas para tener un mejor control de la información enviada.

Para hacer uso de este servicio debe habilitarlo mediante la opción "¿Enviar reportes de eventos?", posteriormente ingrese la URL de su Web Service y seleccione los tipos de alerta deseados.

image-1726085586057.png

Los valores que puede configurar se muestran a continuación en la siguiente tabla:

idconductor gmt tiempo fecha
hora latitud longitud timestamp
idtipo_dato_gps velocidad dirección señal
satelites inputs odometro bateria_gps
bateria_veh ignicion buffered equipogps
imei idvehiculo vehiculo placa
num_economico horometro odometro_vehiculo notas
cliente idcliente rfc distribuidor

 

Configurar Paquetes

image-1726086102081.png

 

Los valores que puede configurar se muestran a continuación en la siguiente tabla:

idconductor gmt tiempo fecha
hora latitud longitud  timestamp
idtipo_dato_gps velocidad direccion señal
satélites inputs odometro bateria_gps
bateria_veh ignicion buffered equipogps
imei idvehiculo vehiculo placa
num_economico horometro odometro_vehiculo notas
cliente idcliente rfc distribuidor

 

Descripción del reenvío

Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacena la información en la base de datos (BD), el WebService Genérico se encarga de leer la información de los equipos y la reenvía a la URL que el cliente configure en la plataforma, en cuanto llegue un reporte este es inmediatamente reenviado.

La descripción general se puede representar con el siguiente diagrama:

image-1672845315237.png

 

Protocolo del WebService

Se ha creado una estructura de forma API RESTful que utiliza JSON como entrega mediante método POST, que se encarga de estar reenviando la información de los equipos GPS, que tenemos disponible en la plataforma a la URL que el cliente configure.

 

URL : La que el cliente configure.

Método : POST

Usuario: El que el cliente configure.

Contraseña: La que el cliente configure.

 

Identificador

Nombre

Tipo

Observaciones

device

Equipo

String

345456577489456

latitude

Latitud

Double

4.608071

longitude

Longitud

Double

-74.175262

date

Fecha

String

Y-m-d

time

Hora

String

H:i:s GMT 0 o UTC

timestamp

Fecha_Hora

 timestamp 20240911114802

speed

Velocidad

Int

60

course

Dirección

Int

170
ignition

Ignición

Int

1 = Encendido / ON, 

0 = Apagado / OFF

satellites

Número de satélites

Int

10

idevent

Id del evento

Int

1

event

Descripción del evento

String

Detenido / Movimiento

signal

Intensidad de señal

Int

8

inputs

 

Int

0

isbuffer

 

Int

0

odometer

Odómetro

Double

 203212.34543

address

Domicilio

String

Cl. 33 Norte #43, Bogota, Colombia

asset

Asset Tracking

Int

636

plate

Placas

String

SPP433

idclient

Id de cliente

Int

44222

cliente

Nombre de cliente

String

TOUR COLOMBIA SAS

idgroup

Id de grupo

Int

6943

group

Nombre del grupo

String

COLEGIO SANTA LUISA TOUR COLOMBIA

iddriver

Id del conductor

Int

0

driver

Nombre de conductor

String

 

sensors

Información de los sensores

json

id_sensor:{

        parámetros 

}



Ejemplo del envío:

{

       "device":"111111111111111",
       "latitude":"4.608071",
       "longitude":"-74.175262",
       "date":"2024-09-11",
       "time":"11:48:02",
       "timestamp":"20240911114802",
       "speed":9,
       "course":236,
       "ignition":1,
       "satellites":10,
       "idevent":1,
       "event":"Movimiento",
       "signal":8,
       "inputs":"0",
       "isbuffer":0,
       "odometer":345943.64845408,
       "address":"Cl. 12 Sur #78m-333, México, México",
       "asset":"632",
       "plate":"XXX111",
       "idclient":55524,
       "client":"Cliente Example",
       "idgroup":6943,
       "group":"GRUPO 1",
       "iddriver":0,
       "driver":"",
       "sensors":{
                   "82":{
                         "Bateria_gps":{
                                     "name":"Bateria_gps",
                                     "value":"",
                                     "datetime":"2024-09-11 11:48:02",
                                     "percentage":100
                         }
                   }
              }

 }

 

 

 

 

Web Service Paquetes

A continuación se explica brevemente la interfaz del Servicio Web para el envío o retransmisión de Paquetes generados por los dispositivos reportando en la plataforma de Monitoreo, a sus clientes o empresas externas autorizadas.

Tecnología de integración

Para poder integrar el envío de Paquetes, se ha diseñado una arquitectura abierta, segura y compatible con las tecnologías más utilizadas en la industria actualmente, es por ello que la interfaz ofrecemos se encuentra desarrollada bajo los estándares de RESTful según se describe en el presente documento.

Instrucciones de uso

Para utilizar este Web Service, cada distribuidor deberá ingresar a su Partners e ingresar a la opción "Webservice", ahí se encuentra listado "Paquetes":

08380160-416A-4793-AF38-23C37510D7D8.jpeg

Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para realizar las configuraciones de envío:

4C998140-8BD9-488C-A3DA-FB693B74369A.jpeg

Se abrirá una ventana y debemos de elegir qué tipo de transmisión se va a ocupar para el envío de datos, TCP/UDP o API REST:

CBE1587A-55C8-4CB3-8E64-BF51690E0730.jpeg

Configurar Recurso

Podemos seleccionar dos tipos de recursos para el envío de datos.

Acceso por API REST:

Para configurar el acceso por API REST debemos ingresar la url del Host, donde podemos indicar la URL hacia donde se enviará la información.

6B8B353E-6F1B-48B1-A8E8-E934264878E7.jpeg

 

Acceso por TCP/UDP:

Deberá proporcionar los siguientes parámetros.

A4C51FC6-DFE6-4EA3-B413-D430FF0AE7EB.jpeg

Asignación de clientes y sus activos para el reenvío de paquetes al recurso previamente configurado:

1AFB41FE-DD5A-415D-9CC2-4ECFDA4D93CC.jpeg

Descripción del reenvío

Los equipos GPS del distribuidor/cliente reportan a la plataforma, se almacenan sus paquetes crudos en la base de datos (BD), el Web Service Paquetes se encarga de obtener la información de los paquetes crudos de los equipos y la reenvía a la URL o IP que se haya configurado previamente, en cuanto se obtenga un paquete este es inmediatamente reenviado.

La descripción general se puede representar con el siguiente diagrama:

image-1672845315237.png

 

Estructura del Web Service

Se ha creado una estructura que utiliza JSON como entrega, dependiendo la configuración TCP/UDP o API REST.

Identificador

Nombre

Tipo

Observaciones

device

Equipo

String

345456577489456

package

Paquete

String

 2525A47121111JD124552525

date

Fecha

String

Y-m-d GMT dispositivo

time

Hora

String

H:i:s GMT dispositivo

asset

Nombre del activo

String

AA123

plate

Placa

String

SPP433

 

Ejemplo del envío:

{

       "device":"345456577489456",
       "package":"2525A47121111JD124552525",
       "date":"2024-09-11",
       "time":11:48:02",
       "asset":"AA123",
       "plate":"SPP433"

}

Visualización del log para el envío de paquetes:

8AF43C11-D041-44AF-AE65-7F43E4B51817.jpeg