Skip to content

Los dos escenarios ​

Hay dos formas de integrar, y las dos son válidas. Elige según cómo trabaja la tienda.

1. Directo: al delivery que ya elegiste ​

La tienda trabaja con un delivery. Cada venta con envío se convierte en un pedido en ese delivery en el momento en que se confirma.

Tu sistema ──POST /v1/orders──▶ Delivery ──▶ motorizado

Es el escenario que la API cubre hoy: la llave es del delivery, y con ella el pedido entra directo a su bandeja de recepción. El despachador lo ve, lo recibe cuando llega el paquete y lo asigna.

Qué hacer en tu sistema:

  1. Al confirmar la venta, POST /v1/orders.
  2. Guardar id y guide_code en tu venta.
  3. Registrar un webhook para order.delivered y order.cancelled y cerrar la venta cuando llegue.

2. Bandeja: a tu tienda, y de ahí a uno u otro delivery ​

La tienda trabaja con varios deliveries y decide a cuál mandar cada pedido: por distrito, por día, por quién contestó primero. Los pedidos entran a la bandeja de la tienda en Motochaski, y desde su panel alguien los despacha.

Tu sistema ──POST /v1/orders──▶ Bandeja de la tienda ──▶ Delivery A
                                                     └──▶ Delivery B

Pendiente

Este escenario todavía no está disponible por API. Hoy el pedido siempre entra a un delivery concreto (el dueño de la llave). Cuando esté, será el mismo endpoint con un campo operator opcional: presente → escenario 1, ausente → escenario 2. Ver Pendiente.

Mientras tanto, una tienda con dos deliveries pide una llave a cada uno y elige en su sistema a cuál mandar cada pedido. Es el escenario 1 dos veces.

Un pedido va a un solo delivery ​

"Varios deliveries" significa que la tienda reparte sus pedidos entre operadores, no que un pedido vaya a dos. Un pedido siempre tiene un delivery, un motorizado y un código de guía.

¿Y si mi cliente no es una tienda sino el delivery? ​

Si el que integra es el propio operador —para llevar su contabilidad, su tablero, su sistema de nómina—, usa una llave sin tienda: ve todos los pedidos del delivery y los webhooks le llegan de todas sus tiendas. Los endpoints son los mismos.

API pública de Motochaski · v1