Introducción a la API de Envíos en Ridery
La API de envíos de Ridery está diseñada para facilitar la creación y gestión de envíos, los cuales son realizados por conductores afiliados a Ridery. Un envío típico involucra el traslado de un paquete desde un punto A hasta un punto B. A través de la API, puedes interactuar con diferentes funcionalidades relacionadas con la creación, el monitoreo y la consulta del estado de los envíos en tiempo real o desde el histórico.
A continuación, repasamos las funcionalidades principales:
Cotización de Tarifas
Antes de crear un envío, es posible obtener una cotización de la tarifa. Esto permite conocer el costo estimado del envío basándose en los puntos de origen y destino, además de otros factores como el tipo de vehículo y la distancia.
Creación de Envíos
Una vez que tengas la tarifa cotizada, puedes proceder a crear el envío. Esto implica definir los puntos de recogida y entrega, la información del destinatario y cualquier instrucción adicional para el conductor. Una vez creado, el envío es asignado a un conductor disponible de Ridery.
Monitoreo del Envío
Existen dos formas de monitorear los envíos y estar al tanto de su progreso:
Webhook de cambios de estado: Cada vez que el estado de un envío cambia (por ejemplo, cuando el conductor acepta el envío, llega al punto de recogida o completa la entrega), recibirás notificaciones automáticas a través de un webhook. Estas notificaciones contienen detalles como el ID del envío, el nuevo estado la ubicación del conductor, etc
Endpoint de detalles del envío: También puedes consultar el estado actual del envío en cualquier momento utilizando el endpoint de detalles. Este te proporcionará información detallada sobre el estado actual del envío, el conductor asignado, y la ubicación del conductor.
Histórico y Envíos en Vivo
Para consultas posteriores, puedes acceder a dos tipos de registros:
- Envíos en vivo (Live Trips): Aquí puedes consultar los envíos que están activos o en proceso en el momento actual.
- Histórico de envíos: Puedes acceder al histórico para revisar envíos anteriores, incluyendo la fecha, hora, y cualquier cambio de estado que haya ocurrido durante el proceso.
Locaciones
La API de Ridery también incluye la funcionalidad de CRUD (Crear, Leer, Actualizar y Eliminar) de locaciones fijas. Esta característica te permite gestionar y almacenar ubicaciones predefinidas, como direcciones o coordenadas, para su reutilización en futuros envíos. Esto es especialmente útil para empresas o usuarios que realizan envíos frecuentes desde un punto de origen fijo, optimizando el proceso de creación de envíos al evitar la necesidad de introducir las mismas coordenadas repetidamente.
Beneficios del CRUD de Locaciones
- Reutilización de coordenadas: Al crear locaciones fijas, puedes reutilizarlas fácilmente al generar nuevos envíos, lo que reduce errores y agiliza el proceso.
- Ahorro de tiempo: Gestiona múltiples locaciones predefinidas de origen o destino, sin tener que ingresar las coordenadas manualmente en cada envío.
- Flexibilidad: Puedes crear locaciones tanto para puntos de origen como de destino, lo que te ofrece mayor control sobre la gestión de tus envíos.
- Actualización dinámica: Si una ubicación cambia o necesita ajustes, puedes actualizarla fácilmente en el sistema sin afectar los envíos anteriores.