# 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:
```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/getdataticket' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
```
##### Respuesta de ejemplo:
```JSON
{
"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 |
---|
| listado de plataformas.
| JSON |
| Listado de clasificaciones.
| JSON |
| Listado de tipos.
| JSON |
| Listado de acciones.
| JSON |
| 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](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef)**. | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
idCliente | **(Opcional)** Identificador único del cliente.
-Consultar el id de los clientes en el método **[getClients](https://docs.redgps.com/books/webservice/page/getclients)**. | 16572 |
##### Solicitud de ejemplo:
```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/gettickets' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'
--form 'idCliente="16572"'
```
##### Respuesta de ejemplo:
```JSON
{
"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 |
---|
| Identificador único del ticket en el sistema.
| Entero |
| Nombre del cliente.
| Cadena de Texto |
| Nombre asignado al ticket.
| Cadena de Texto |
| Número telefónico del contacto.
| Cadena de Texto
|
| Correo electrónico del contacto.
| Cadena de Texto
|
| Nombre de la plataforma.
| Cadena de Texto
|
| Nombre de la clasificación.
| Cadena de Texto
|
| Nombre del tipo del ticket.
| Cadena de Texto |
| Descripción sobre el ticket.
| Cadena de Texto
|
| Estatus del ticket.
| Cadena de Texto
|
| Fecha del ticket.
| Cadena de Texto
|
| 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:
```shell
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:
```JSON
{
"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:
```shell
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:
```JSON
{
"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](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef)**[.](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef) | 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://docs.redgps.com/books/webservice/page/subir-imagenes-para-ticket-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**.](https://docs.redgps.com/books/webservice/page/lista-de-datos-para-generar-ticket)
| 3 |
##### Solicitud de ejemplo:
```shell
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:
```JSON
{
"status": 200,
"data": {
"idticket": 12871287
}
}
```
Ver campos de respuesta:
idticket | Identificador único del detalle del ticket.
| Entero |
# Obtener detalle del ticket - getTicketAnswer
##### POST https://api.service24gps.com/api/v1/getTicketAnswer
Obtiene el detalle del 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](https://docs.redgps.com/books/webservice/page/metodo-de-autenticacion-gettoken-7ef).** | wfszR/oPIQKjt5HT5NgjDnZ2SAZQ== |
Idticket | **(Requerido)** Identificador único del ticket. | 898915 |
##### Solicitud de ejemplo:
```shell
curl --location --request POST 'https://api.service24gps.com/api/v1/getTicketAnswer' \
--form 'apikey="25sdsd234234aa93sdsdsd37c70118e72"' \
--form 'token="wfszR/oPIQKjt5HT5NgjDnZ2SAZQ=="'\
--form 'Idticket="898915"'
```
##### Respuesta de ejemplo:
```JSON
{
"status": 200,
"data": {
"Id": "898915",
"Descripcion": "Estimados, solicito el apoyo para obtener la información de mi equipo.
\n",
"Detalle": [
{
"Idticket_detalle": "33547,
"Usuario": "cliente1",
"Fecha": "2023-07-10",
"Hora": "09:01:52",
"Respuesta": "Hola buenos días:\n\nle daremos seguimiento al tema.",
"Leido": "No"
},
{
"Idticket_detalle": "33546
"Usuario": "cliente1",
"Fecha": "2023-07-05",
"Hora": "15:49:34",
"Respuesta": "Hola buenos dias, pueden enviar el número del equipo.",
"Leido": "Sí"
},
{
"Idticket_detalle": "33545,
"Usuario": "cliente1",
"Fecha": "2023-07-05",
"Hora": "09:27:42",
"Respuesta": "Buenos días, se envió la información. \n\nsaludos",
"Leido": "Sí"
}
]
}
}
```
Ver campos de respuesta:
Campo | Descripción
| Formato |
---|
| Identificador único del ticket.
| Entero |
| Descripción del ticket.
| Texto |
| Detalle del ticket.
| JSON |