Обзор заказов закупки
/v1/orders/* покрывает внутреннюю закупку — заказы у продавцов 1688/Taobao для доставки на входящий адрес в Китае. Это не международная доставка; используйте фулфилмент после поступления на склад.
Суммы указаны в CNY fen (分). Задавайте response_format согласно формату ответа.
Сопоставляйте id товаров из товаров: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id.
Жизненный цикл {#lifecycle}
- Preview — проверка lines, prices, freight
- Create — размещение procurement order
- Pay — оплата через marketplace wallet
- Detail / list — отслеживание статуса
- Domestic trace — продавец → склад
- Cancel — когда разрешено
Справочник endpoint
| Шаг | Путь | Документация |
|---|---|---|
| Preview | POST /v1/orders/preview | Order preview |
| Create | POST /v1/orders/create | Создать заказ |
| Pay | POST /v1/orders/pay | Оплатить заказ |
| Detail | POST /v1/orders/detail | Детали заказа |
| List | POST /v1/orders/list | Детали заказа |
| Cancel | POST /v1/orders/cancel | Отменить заказ |
| Domestic trace | POST /v1/orders/logistics/trace | Внутренний логистический трек |
| Taobao purchases | POST /v1/orders/purchase/query | Детали заказа |
| Схемы ответов | — | Модели ответов заказов |
Channel shortcuts: /v1/orders/1688/*, /v1/orders/taobao/* (body может опускать channel).
Внутренняя vs международная логистика {#domestic-vs-international}
| Участок | API |
|---|---|
| Продавец → склад в Китае | Domestic trace |
| Склад → зарубежный покупатель | Международное отслеживание |