Обзор заказов закупки

/v1/orders/* покрывает внутреннюю закупку — заказы у продавцов 1688/Taobao для доставки на входящий адрес в Китае. Это не международная доставка; используйте фулфилмент после поступления на склад.

Суммы указаны в CNY fen (分). Задавайте response_format согласно формату ответа.

Сопоставляйте id товаров из товаров: search/detail id → lines[].id (compatible: offer_id, Taobao mi_id), variants[].sku_id → lines[].spec_id.

Taobao id / mi_id периодически меняется. Не кэшируйте надолго. Устаревшие id ломают detail, similar и заказы. Повторите поиск/detail перед checkout.

Жизненный цикл {#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
Склад → зарубежный покупатель	Международное отслеживание

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support