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 ApiAvl México JSON 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 Codelco Chile JSON Consuman Argentina JSON ControlT General XML Copec Chile JSON Coyote México XML Ctac Chile JSON CyberMapa (CERSAT) Argentina STRING Conafe Chile JSON CAT BC México JSON 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 Falabella 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 GPFleet México JSON Guardian Mobility Argentina JSON Gestya Argentina JSON GPS Events Integrador México JSON GPS Goldcar Perú JSON GpsIntegrator Colombia 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 Liderman Perú 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 Microbox Chile JSON Navi 3.0 General XML Nettek General JSON Nexsat Argentina JSON Nexus México JSON Numaris 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 Protege Perú JSON Pepsico México JSON Paquetes descartados México JSON QMGPS General XML QuadMinds Argentina JSON Recurso Confiable Mex (Irontracking) General XML Rolbox IPS Chile JSON RsRurales (CAESSAT v2) Argentina JSON RNDC Colombia XML 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 SmartReport Chile JSON Systempro Chile JSON Segursat Perú JSON Sysnet Perú JSON Sitmercc Colombia JSON SRV SGL (CAESSAT v2) Argentina string Skynav Antucoya Chile JSON Tecnologistica (CAESSAT v2) Argentina JSON Torre de Control México JSON Torre dedicada mabe México JSON Tracklog Peru JSON TrackTec Chile JSON TI México 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 Walmart México XML WS Microboxlabs Chile JSON Wing Suite Chile JSON WS Aker Sadi (CERSAT) Argentina string Ziyu Chile JSON Zoho Panama 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 ": Con el botón "Asignar activos" se seleccionan los clientes y las unidades que van a retransmitir al Servicio Web Genérico. 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:   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 ": Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para configurar las credenciales:   Se abrirá una ventana con las siguientes pestañas: Credenciales Ubicación Alertas Eventos Paquetes     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. API REST TCP/UDP 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. Acceso por TCP/UDP: Deberá proporcionar los siguientes parámetros. Ip Puerto Protocolo: Debe especificar si usará TCP o UDP.   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...) Es posible habilitar el envío de la geocerca correspondiente a la posición de ubicación registrada en la plataforma: 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 geocerca_ubicacion_actual       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. 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. 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   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:   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   } geo Información de la geocerca String Nombre de la geocerca Ejemplo del envío: {        "device":"111111111111111",        "latitude":"4.608071",        "longitude":"-74.175262",        "geo":"Oficina",        "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 ": Con el botón "Configurar Acceso" (icono anaranjado) abriremos la interfaz para realizar las configuraciones de envío: 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: Configurar Recurso Podemos seleccionar dos tipos de recursos para el envío de datos. API REST TCP/UDP 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.   Acceso por TCP/UDP: Deberá proporcionar los siguientes parámetros. Ip Puerto Protocolo: Debe especificar si usará TCP o UDP. Asignación de clientes y sus activos para el reenvío de paquetes al recurso previamente configurado: 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:   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: