FORMAT: 1A HOST: https://sandbox.99minutos.com/ # 99minutos.com Que tal, te presentamos la documentación oficial de APIS de 99minutos.com , donde te mostraremos cada una de nuestras APIS, llevándote de la mano para la creación de órdenes y de guías. ## ¿ Cómo comenzar a usar nuestras APIS ? 1.- Primero debes darte de alta con nosotros en la siguiente liga: - https://www.client.99minutos.com/register 2.- Terminando el registro deberás activar tu cuenta via correo. 3.- Una vez dentro de nuestro dashboard deberás ingresar a la opción de "Mi cuenta". 4.- Una vez dentro de "Mi cuenta" desplegarás las opciones y deberás dar clic a la opción "Developers" en la cual encontrarás las apikey , estas que te servirán para consumir nuestras APIS. IMPORTANTE: Si vas a desarrollar pruebas haz los mismos pasos que arriba pero en el link: - https://client-staging.web.app/register Nota: Nuestras APIS son servicios REST que se consumen a través de via HTTP con encabezados con una respuesta en formato JSON. ## URL'S Base Endpoint para consumir los servicios mediante HTTPS.
Producción | https://delivery.99minutos.com/api/v1/ |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/ |
Producción | Lo encontrarás en el link de producción: https://www.client.99minutos.com/developers una vez registrado |
Sandbox/Pruebas | Lo encontrarás en el link de pruebas: https://www.stclient.99minutos.com/developers una vez registrado |
Producción | https://delivery.99minutos.com/api/v1/autorization/order |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/autorization/order |
Campo | Descripción | Longitud |
---|---|---|
apikey | Valor obtenido de la plataforma 99minutos.com | Cadena máxima de 30 caracteres |
deliveryType | Método de envío puede ser: sameDay (Día siguiente) , nextDay (Día siguiente), 99minutos (Express,menos de 99 minutos), CO2 (Día siguiente) | Cadena máxima de 30 caracteres |
packageSize | Tamaño del paquete a enviar puede ser: xs , s, m, l, xl, | Cadena máxima de 20 caracteres |
notes | Puedes colocar alguna referencia extra o adicional de la orden. | Cadena máxima de 2000 caracteres |
cahsOnDelivery | Valor booleano que indica si será una orden contra cobro, puede ser (True | False) | Valor booleano True o False |
amountCash | Cantidad a cobrar de ser una orden contra cobro | Valor flotante con dos decimales como máximo |
SecurePackage | Valor booleano que indica si la orden será asegurada, puede ser (True | False) | Valor booleano True o False |
amountSecure | Cantidad por el cual será asegurado el paquete. | Valor flotante con dos decimales como máximo |
receivedId | Contador único o incremental del pedido interno del cliente. | Cadena máximo de 30 carácteres |
sender | Nombre completo de quien envía el paquete | Cadena máxima de 200 carácteres |
nameSender | Nombre de quien envía el paquete | Cadena máxima de 50 carácteres |
lastNameSender | Apellido de quien lleva el paquete | Cadena máxima de 50 carácteres |
emailSender | Correo de la persona que envía el paquete | Cadena máxima de 50 carácteres |
phoneSender | Teléfono de la persona que envía el paquete | Cadena máxima de 50 carácteres |
addressOrigin | Dirección de retiro o recolección del paquete deber ser: Calle, números ext. o int. , código postal, pais y localidad (sólo para México) , para Chile debera ser : Calle , comuna , país . | Cadena máxima de 1000 caracteres |
numberOrigin | Número interno o externo de la dirección. | Cadena máxima de 20 carácteres |
codePostalOrigin | Código postal, sólo aplica para México , para Chile deberá ser omitido. | Cadena máxima de 10 caracteres |
country | País donde se llevará a cabo la recolección puede ser (MEX O CL) | Cadena máxima de 50 caracteres |
receiver | Nombre completo de quien recibirá el paquete | Cadena máxima de 200 caracteres |
nameReceiver | Nombre de quien recibirá el paquete. | Cadena máxima de 50 caracteres |
lastNameReceiver | Apellido de quien recibirá el paquete | Cadena máxima de 50 caracteres |
emailReceiver | Correo de quien recibirá el paquete | Cadena máxima de 50 caracteres |
phoneReceiver | Teléfono de quien recibirá el paquete | Cadena máxima de 50 caracteres |
addressDestination | Dirección donde se llevará acabo la entrega deber ser: Calle, números ext. o int. , código postal, país y localidad (sólo para México) , para Chile debera ser : Calle , comuna , país . | Cadena máxima de 1000 carácteres |
numberDestination | Número exterior o interior de la dirección de entrega | Cadena máxima de 20 carácteres |
codePostalDestination | Código postal sólo aplica para México , para Chile deberá ser omitido. | Cadena máxima de 10 carácteres |
country | País donde se llevará a cabo la recolección puede ser (MEX O CHL) | Cadena máxima de 20 carácteres |
Método | Descripción |
---|---|
POST | Usado para generar una nueva orden. |
Código | Descripción |
---|---|
201 | Orden generada exitosamente |
200 | Método ya no permitido, Fuera de cobertura, deliveryType no encontrado, packageSize no encontrado, Saldo insuficiente, Campo requerido |
404 | No existe usuario |
500 | Error de servidor |
Producción | https://delivery.99minutos.com/api/v1/tracking/order?tracking={número de orden} |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/tracking/order?tracking={número de orden} |
Estatus 1 | Orden Creada |
Estatus 2 | Orden Recolectada |
Estatus 3 | Orden Asignada |
Estatus 4 | Orden En Estación |
Estatus 6 | Orden Entregada |
Estatus 7 | Orden Cancelada |
Estatus 8 | Orden No Entregada Primer Intento |
Estatus 9 | Orden Disponible para Segundo Intento |
Estatus 10 | Orden Asignada para Segundo Intento |
Estatus 11 | Orden No Entregada Segundo Intento |
Estatus 12 | Orden Entregada Segundo Intento |
Estatus 13 | Orden Cancelada Segundo Intento |
Estatus 14 | Orden en Devolución |
Estatus 15 | Orden Extraviada o Robada |
Estatus 16 | Orden sin éxito Segundo Intento |
Estatus 17 | Orden En camino Tercer Intento |
Estatus 18 | Orden Cancelada Tercer Intento |
Estatus 19 | Orden Terminada en Tercer Intento |
Estatus 20 | Cancelada sin Tercer Intento |
Estatus 21 | Orden en Estación por Segunda Vez |
Estatus 22 | Orden En Estación Tercer Intento |
Método | Descripción |
---|---|
GET | Usado para rastrear una orden. |
Código | Descripción |
---|---|
200 | Request Exitoso, recibes un body con los detalles de la orden |
404 | No existe la orden |
401 | Token de autorización incorrecto |
Producción | https://delivery.99minutos.com/api/v1/cancel/order |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/cancel/order |
Método | Descripción |
---|---|
POST | Usado para cancelar una orden. |
Código | Descripción |
---|---|
200 | Mensaje correcto, puede ser de orden cancelada u órdenes no encontradas |
404 | No existe la orden |
401 | Token de autorización incorrecto |
99minutos | Orden que se realiza en menos de 99minutos desde la creación de la orden. Funciona de lunes a domingo en las ciudades disponibles. Importante: No esta disponible en todas las ciudades, el horario límite para generar una guía es las 17:00hrs y no se aceptan paquetes XL. |
sameDay | Orden que se realiza Mismo día, horario limite para generar la guía es las 14:00, se opera de lunes a domingo en todas las ciudades. Todos los tamaños disponibles. No se permite de una ciudad a otra, o de un país a otro. |
NextDay | Orden que se realiza Día Siguiente, horario limite para generar la guía es las 19:00, se opera de lunes a domingo en todas las ciudades. Todos los tamaños disponibles. Si se permite de una ciudad a otra. |
CO2 | Orden que se realiza Día Siguiente Sin Emisiones, horario limite para generar la guía es las 19:00, se opera de lunes a domingo en CDMX. Todos los tamaños disponibles. No se permite de una ciudad a otra. |
Producción | https://delivery.99minutos.com/api/v1/shipping/rates |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/shipping/rates |
Método | Descripción |
---|---|
POST | Usado para consultar Métodos de Envío. |
Código | Descripción |
---|---|
200 | Mensaje con los costos de envío |
401 | Token de autorización incorrecto |
Producción | https://delivery.99minutos.com/2/delivery/Code/{folio_personalizado}/order/ZPL |
Ambiente Sandbox | https://sandbox.99minutos.com/2/delivery/Code/{folio_personalizado}/counter/ZPL |
Producción | https://delivery.99minutos.com/api/v1/guide/order |
Ambiente Sandbox | https://sandbox.99minutos.com/api/v1/guide/order |
Método | Descripción |
---|---|
POST | Usado para Generar una Guía. |
Código | Descripción |
---|---|
200 | Con un body de PDF |
401 | Token de autorización incorrecto |