Distribuidor - Tickets

Métodos relacionados con los tickets.

Lista de datos para generar ticket - getdataticket

POST https://api.service24gps.com/api/v1/getdataticket

Obtiene los datos de plataforma, clasificación, tipo y acción.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/getdataticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "plataforma": {
            "1": "Backoffice",
            "2": "OnTracking",
            "3": "Backoffice",
            "4": "OnReports",
            "5": "Aplicaciones Móviles",
            "6": "OnBus",
            "8": "Alertas",
            "10": "OnDriving",
            "11": "OnTool",
            "12": "OnRouting",
            "13": "OnRoad",
            "15": "OnWall",
            "16": "OnAlert",
            "17": "OnPatrol",
            "18": "OnDocs",
            "19": "OnDelivery",
            "22": "OnNavigate",
            "67": "OnDash",
            "70": "OnStatus",
            "80": "OnMobile"
        },
        "clasificacionTicket": {
            "1": "facturacin",
            "2": "baja-de-activo",
            "3": "alta-de-activo",
            "4": "siniestrosreposiciones",
            "5": "calidadfuncionamiento-del-servicio",
            "6": "comunicacin-con-operadorrepresentante",
            "7": "ventas",
            "8": "soporte",
            "9": "desarrollo"
        },
        "TipoTicket": {
            "1": "pedido",
            "2": "reclamo",
            "3": "consulta",
            "4": "sugerencia",
            "0": "urgencia"
        },
        "AccionTicket": {
            "1": "asignar",
            "2": "comentar",
            "4": "cancelar",
            "3": "cerrar",
            "0": "en-espera-de-respuesta"
        },
        "StatusTicket": {
            "1": "Pendiente",
            "2": "En resolución",
            "3": "Cerrado",
            "4": "Cancelado",
            "0": "En espera de respuesta",
            "5": "Reabierto"
        }
    }
}
Ver campos de respuesta:
Campo

Descripción

 Formato
plataforma

listado de plataformas.

 JSON
clasificacionTicket

Listado de clasificaciones.

 JSON
TipoTicket

Listado de tipos.

 JSON
AccionTicket

Listado de acciones.

 JSON
StatusTicket

Listado de status ticket.

 JSON

Listado de tickets - gettickets

POST https://api.service24gps.com/api/v1/gettickets

Obtiene el listado total de tickets o los tickets de un cliente en especifico.

Nota: El método gettickets solo muestra los tickets de clientes que están habilitados,  si están eliminados no se mostrará la información en la respuesta.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
idCliente  (Opcional) Identificador único del cliente.
-Consultar el id de los clientes en el método getClients.		 16572
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/gettickets' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
--form 'idCliente="16572"'
Respuesta de ejemplo:
{
   "status":200,
   "data":{
      "909081":[
          {
             "idTicket":"12313",
             "cliente":"Luis",
             "nombre":"Ticket de prueba1",
             "telefonoContacto":"2222123453",
             "emailContacto":"usuario1@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"desarrollo",
             "tipo":"consulta",
             "descripcion":"Solicitud de activos",
             "status":"En resolución",
             "fecha":"2024-03-07",
             "hora":"13:30:19"
          },
          {
             "idTicket":"12314",
             "cliente":"Enrique",
             "nombre":"Ticket de prueba2",
             "telefonoContacto":"2222123454",
             "emailContacto":"usuario2@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"desarrollo",
             "tipo":"sugerencia",
             "descripcion":"Equipo : dvr J03554455",
             "status":"Cerrado",
             "fecha":"2022-04-22",
             "hora":"17:34:28"
          },
      ],
      "909082":[
          {
             "idTicket":"12315",
             "cliente":"Julio",
             "nombre":"Ticket de prueba3",
             "telefonoContacto":"2222123455",
             "emailContacto":"usuario3@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"alta-de-activo",
             "tipo":"pedido",
             "descripcion":"instalcion hora tecnico",
             "status":"Cerrado",
             "fecha":"2021-10-01",
             "hora":"11:13:59"
          }
      ],
      "909083":[
          {
             "idTicket":"12316",
             "cliente":"Eduardo",
             "nombre":"Ticket de prueba4",
             "telefonoContacto":"2222123455",
             "emailContacto":"usuario4@hotmail.com",
             "plataforma":"Cliente",
             "clasificacion":"alta-de-activo",
             "tipo":"pedido",
             "descripcion":"instalcion hora tecnico",
             "status":"Cerrado",
             "fecha":"2021-10-01",
             "hora":"11:13:59"
          }
      ]
   }
}
Ver campos de respuesta:
Campo

Descripción

 Formato
idTicket

Identificador único del ticket en el sistema.

 Entero
cliente

Nombre del cliente.

 Cadena de Texto
nombre

Nombre asignado al ticket.

 Cadena de Texto
telefonoContacto

Número telefónico del contacto.

Cadena de Texto
emailContacto

Correo electrónico del contacto.

Cadena de Texto
plataforma

Nombre de la plataforma.

Cadena de Texto
clasificacion

Nombre de la clasificación.

Cadena de Texto
tipo

Nombre del tipo del ticket.

 Cadena de Texto
descripcion

Descripción sobre el ticket.

Cadena de Texto
status

Estatus del ticket.

Cadena de Texto
fecha

Fecha del ticket.

Cadena de Texto
hora

Hora del ticket.

Cadena de Texto

Crear ticket - createticket

POST https://api.service24gps.com/api/v1/createticket

Este método permite crear un ticket.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
nombre

Nombre con el que se identificará el ticket dentro de la plataforma.

 cliente

telefono

Número telefónico de contacto

123456789

email

Correo electrónico de contacto

 test@test.com

idPlataforma

Identificador único de plataforma

 1

idClasificacion

Identificador único de clasificación

 1 

idTipo

Identificador único de tipo

 1

idCliente

Identificador único de cliente

 1

activos

Lista de activos separados por coma

 activo 1. activo2, activo 3

fechaInicio

Fecha inicio

 2022-01-01

fechaFin

Fecha fin

 2022-01-21

descripcion

Descripción sobre el ticket.

 Buena tarde, Se solicita apoyo
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/createticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'nombre="cliente"' \
--form 'tipo_cerca="1"' \
--form 'telefono="123456789"' \
--form 'email="test@test.com"' \
--form 'idPlataforma="1"' \
--form 'idClasificacion="1"' \
--form 'idTipo="1"' \
--form 'idCliente="1"' \
--form 'activos="activo1, activo 2, activo 3"' \
--form 'fechaInicio="2022-01-01"' \
--form 'fechaFin="2022-01-21"' \
--form 'descripcion="Buena tarde, Se solicita apoyo"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "idticket": 1
    }
}
Ver campos de respuesta:
idticket

Identificador único del ticket

 Entero

Subir imagenes para ticket - uploadimageticket

POST https://api.service24gps.com/api/v1/uploadimageticket

Este método permite subir imágenes para adjuntar la url en la descripción del ticket

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==

file[]

Arreglo de archivos

file[]=@"/home/Usuario/Escritorio/prueba.jpg"
file[]=@"/home/Usuario/Escritorio/cliente.jpg"
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/uploadimageticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'file[]=@"/home/Usuario/Escritorio/prueba.jpg"' \
--form 'file[]=@"/home/Usuario/Escritorio/cliente.jpg"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": [
        "https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642610073_prueba.png",
        "https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642610074_cliente.png"
    ]
}
Ver campos de respuesta:
Url imagenes

Url de las imagenes

 JSON

Responder ticket - createticketdetalle

POST https://api.service24gps.com/api/v1/createticketdetalle

Este método permite responder un ticket.

Ver parámetros de solicitud:
Parámetros Descripción Ejemplo
apikey (Requerido) Llave de autorización para uso de los Servicios Web. 25sdsd234234aa93sdsdsd37c70118e72
token (Requerido) Token devuelto por el método getToken. wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
IdTicket

(Requerido) Identificador único de ticket a responder.

 288282

IdAccionticket

(Requerido) Identificador único de acción.

3

descripcion

(Requerido) Descripción sobre el detalle del ticket.

 Buena tarde, Se solicita apoyo

alertamail

(Requerido) Bandera para enviar alerta por mail (true) o no (false).

 true

alertasms

(Requerido) Bandera para enviar alerta por sms (true) o no (false).

 false

alertasoporte

(Requerido) Bandera para enviar a soporte  (true) o no (false).

 false

mostraralusuario

(Requerido) Bandera para mostrar al usuario (true) o no (false).

 false

imageurl

(Opcional) Array de url de imágenes devuelto por el método uploadimageticket.

 ['https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png
imageurl', 'https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png' ]

idstatus_ticket

(Opcional) Identificador único de status del ticket.

El catálogo de status ticket se puede obtener en el método getDataTicket.

 3
Solicitud de ejemplo:
curl --location --request POST 'https://api.service24gps.com/api/v1/createticketdetalle' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="' \
--form 'IdTicket="288282"' \
--form 'IdAccionticket="3"' \
--form 'descripcion="Buenas tarde, Se solicita apoyo"' \
--form 'alertamail="true"' \
--form 'alertasms="false"' \
--form 'alertasoporte="false"' \
--form 'mostraralusuario="false"' \
--form 'imageurl="['https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png',
		'https://newspace1.nyc3.digitaloceanspaces.com/Tickets/idDistribuidor-4220/642462376_redgps.png']"'\
--form 'idstatus_ticket="3"'
Respuesta de ejemplo:
{
    "status": 200,
    "data": {
        "idticket": 12871287
    }
}
Ver campos de respuesta:
idticket

Identificador único del detalle del ticket.

 Entero