# 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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken 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:
CampoDescripció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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken 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:
CampoDescripció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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken devuelto por el método getToken.wfszR/oPIQKjt5HT5NgjDnZ2SAZQ==
nombreNombre 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:
idticketIdentificador ú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ámetrosDescripciónEjemplo
apikeyLlave de autorización para uso de los Servicios Web.25sdsd234234aa93sdsdsd37c70118e72
tokenToken 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 imagenesUrl 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ámetrosDescripciónEjemplo
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:
idticketIdentificador ú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ámetrosDescripciónEjemplo
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:
CampoDescripción Formato
Id
Identificador único del ticket. Entero
Descripcion
Descripción del ticket. Texto
Detalle
Detalle del ticket. JSON