Resumen

Esta guía describe cómo utilizar la API de OneRail para determinar las tarifas de envío de una entrega potencial y actualizar progresivamente un pedido mediante actualizaciones parciales. Estas acciones son fundamentales para establecer precios dinámicos en las entregas y gestionar el flujo de trabajo de entrega de manera eficiente.

La utilización del endpoint /delivery/get-rates permite a las organizaciones crear órdenes de entrega preliminares basadas en la información de tarifas obtenida de los transportistas elegibles. Posteriormente, las actualizaciones parciales garantizan que, a medida que se disponga de datos más precisos (como costos finales o asignaciones de transportistas), puedan reflejarse sin volver a enviar todo el contenido de la entrega.

Flujo de Creación de Entrega con Obtención de Tarifas y Actualizaciones Parciales

/delivery/get-rates

Este endpoint obtiene las tarifas de entrega de los transportistas disponibles según los detalles de entrega proporcionados. Está influenciado por la configuración de los socios logísticos (LP) y la configuración organizacional, como las definiciones de paquetes.

• Solo se consideran los transportistas que responden de forma satisfactoria; los transportistas que no responden se excluyen de los resultados.
• Las tarifas devueltas se pueden usar para crear una orden preliminar y presentar opciones al usuario final.
• La configuración de los LP se administra a través de la configuración de contrato del remitente y la lógica de compra de LP.

Para obtener detalles completos de la implementación, consulte: Swagger - Get Rates

/order/{orderID}/partial-update

Después de obtener el proveedor de menor costo, este endpoint se utiliza para actualizar una entrega preliminar existente con información finalizada, como la selección del transportista, el desglose de precios o la generación de etiquetas.

• El momento de la generación de la etiqueta es fundamental; si se requiere de inmediato, la solicitud de actualización debe incluir una marca para requestLabel: true.
• Permite un control detallado de la progresión de la entrega, desde la cotización hasta estar lista para despachar.
• Ideal para sistemas donde la creación y la ejecución de pedidos ocurren en etapas.

Para obtener detalles completos de la implementación, consulte: Swagger - Partial Update

Flujo de trabajo de principio a fin

1. Comparación de tarifas: Use /delivery/get-rates para obtener una vista previa de las opciones de entrega y precios potenciales.
2. Crear entrega preliminar: Según las tarifas preferidas, inicie un objeto de entrega con información parcial (por ejemplo, sin etiquetas ni costos finales).
3. Actualizar entrega: A medida que se finalizan las decisiones, use /delivery/partial-update para reflejar la elección del transportista, actualizar los costos y activar la generación de etiquetas.
4. Finalizar despacho: Una vez que todos los campos estén completos, cambie el estado de la entrega a READY_TO_DISPATCH.

Beneficios

• Separa la determinación de precios de la entrega final.
• Reduce la sobrecarga en las comparaciones de tarifas de los transportistas.
• Admite escenarios de cumplimiento ágiles con actualizaciones dinámicas.