Pendiente

Lo que está decidido y todavía no se puede usar. Para que no lo esperes donde no está, y para que sepas qué viene.

Llave de tienda

Hoy la llave la crea el delivery. Va a existir la llave de tienda (msk_live_…), que el dueño de la tienda crea desde su propio panel y no está atada a un delivery. Con ella, POST /v1/orders acepta:

{ "operator": "slug-del-delivery", ... }

• Con operator → el pedido va directo a ese delivery (tiene que estar asociado a la tienda y cubrir el destino).
• Sin operator → el pedido queda en la bandeja de la tienda, y desde su panel alguien lo despacha al delivery que toque.

Una tienda con varios deliveries integra una vez y elige por pedido. La llave de tienda no depende del plan del delivery que recibe.

Modo prueba

Llaves mck_test_… / msk_test_… contra una tienda y un delivery de prueba, para que puedas desarrollar sin que tu cliente tenga que firmar con un delivery real ni mandar pedidos de verdad.

Reintentos de webhooks

Hoy un webhook es un intento. Va a reintentar con espera creciente durante varias horas y a marcar el endpoint como caído si nunca responde. Cuando exista, un mismo evento puede llegarte más de una vez: descarta por event + data.id.

Más eventos

order.received, order.in_transit, order.returned, order.rejected. Hoy solo hay cuatro; los demás estados se consultan.

OpenAPI

Un openapi.yaml publicado aquí, generado desde el código, para que armes tu cliente sin transcribir tablas.