Detickets cuenta con una API REST por medio de la cual se lleva a cabo la comunicación y el intercambio de datos con la aplicación.
A continuación, encontrará los enlaces para los ambientes productivo y demo, así como algunos de los endpoints más utilizados en ambos ambientes.
URL productiva:
URL demo:
Para utilizar los servicios de la API detickets, es necesario construir la URL completa combinando la URL base del ambiente seleccionado (Productivo o Demo) con el endpoint del servicio que deseas consumir.
Ejemplo de URL completa
https://api-integracion.detickets.mx/apiDeticket/api/Detickets/RegistroTicket
Las siguientes son las funciones disponibles en la API, con las cuales podrá llevar a cabo el flujo del proceso.
POST LoginRegistro
Endpoint: /api/Auth/LoginRegistro
Valida las credenciales para el uso de la API.
Se le envían las credenciales asignadas.
Se obtiene el token de autenticación.
POST RegistroTicket
Endpoint: /api/Detickets/RegistroTicket
Recibe el ticket y lo inserta en base de datos.
Se le envía la información del ticket en formato JSON.
Se obtiene el ID del ticket asignado por el sistema.
GET ConsultaTicket
Endpoint: /api/Detickets/ConsultaTicket
Entrega el ticket y su estado en base al ID.
Se le envía el ID del ticket asignado por el sistema.
Se obtienen los datos y el estatus del ticket.
POST AuthApp
Endpoint: /api/Auth/AuthApp
Autentifica al invitado a través de la URL de la aplicación cliente final.
Se le envía el subdominio de la aplicación.
Se obtiene el token de autenticación para utilizarlo en el endpoint FacturarTicketInvitado.
POST FacturarTicketInvitado
Endpoint: /api/Detickets/FacturarTicketInvitado
Permite al invitado facturar los tickets.
Se le envía la información del ticket y los datos fiscales del receptor en formato JSON.
Se obtiene el ID, FacturaId, RFC, Estatus y el NumTicket.
GET ConsultaTickets
Endpoint: /api/Detickets/ConsultaTickets
Consulta el estado de un grupo de tickets y el número de la factura generada de cada uno de ellos.
Se le envía el intervalo de las fechas de búsqueda.
Se obtiene una lista con los datos de los tickets.
GET GetBase64Pdf
Endpoint: /api/Detickets/GetBase64Pdf
Entrega el PDF de la factura en Base64.
Se le envía el RFC emisor y el facturaId asignado por el sistema.
Se obtiene la representación en Base64 del archivo PDF.
GET GetBase64Xml
Endpoint: /api/Detickets/GetBase64Xml
Entrega el XML de la factura en Base64.
Se le envía el RFC emisor y el facturaId asignado por el sistema.
Se obtiene la representación en Base64 del archivo XML.
GET GetArchivos
Endpoint: /api/Detickets/GetArchivos
Entrega el XML y PDF de la factura en un archivo ZIP en formato binario.
Se le envía el RFC emisor y el facturaId asignado por el sistema.
Se obtiene los datos binarios del archivo ZIP.
POST CancelarTicket
Endpoint: /api/Detickets/CancelarTicket
Cancela un ticket con estatus 1-Disponible.
Se envía el número de ticket, la sucursal, el total, la fecha de emisión, el RFC del emisor y el usuario.
Se obtiene una respuesta con estatus 200 OK y un objeto JSON.
POST EnviaCancelarFactura
Endpoint: /api/Detickets/EnviaCancelarFactura
Envía una o varias facturas al proceso de cancelación.
Se le envían los datos de las facturas a cancelar en un objeto JSON.
Se obtiene una respuesta de la solicitud y un objeto JSON con el detalle individual del envío a cancelación de cada factura.
Para mayor detalle de las funciones y parámetros vea la documentación anexa.
La estructura del archivo JSON para envío del ticket se describe en el diccionario a continuación.
Diccionario de campos del ticket
Para descargar el archivo dé clic en el enlace, y una vez abierto, seleccione la opción de descarga.
Diagrama conceptual de integración con detickets