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:
Endpoints:
Generar el token /api/Auth/LoginRegistro
Enviar el ticket /api/Detickets/RegistroTicket
Obtener el ticket /api/Detickets/ConsultaTicket
Autenticar al invitado /api/Auth/AuthApp
Facturar ticket /api/Detickets/FacturarTicketInvitado
Consultar estado del ticket /api/Detickets/ConsultaTickets
Obtener el PDF de la factura /api/Detickets/GetBase64Pdf
Obtener el XML de la factura /api/Detickets/GetBase64Xml
Obtener ZIP de los archivos /api/Detickets/GetArchivos
Las siguientes son las funciones disponibles en la API, con las cuales podrá llevar a cabo el flujo del proceso.
LoginRegistro
Valida las credenciales para el uso de la API.
Se le envían las credenciales asignadas.
Se obtiene el token de autenticación.
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.
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.
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.
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.
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.
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.
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.
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.
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