Distribuidor - Tickets
Métodos relacionados con los tickets.
- Lista de datos para generar ticket - getdataticket
- Listado de tickets - gettickets
- Crear ticket - createticket
- Subir imagenes para ticket - uploadimageticket
- Responder ticket - createticketdetalle
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 |
|
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" |
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 |