Обзор международного фулфилмента

/v1/fulfillment/* охватывает международную логистику после поступления товара на склад HIOBuy. Внутренние закупки: заказы на выкуп.

Приложению нужен складской фулфилмент (авторизация в портале). Приложения с самостоятельной доставкой получают 403 FULFILLMENT_MODE_NOT_SUPPORTED.

Денежная единица {#monetary-unit}

Стандартные JSON-ответы денежных маршрутов фулфилмента содержат верхнеуровневое monetary_unit: "CNY_minor". Во всех { amount, currency } поле amount — это китайские фэни (1 юань = 100 фэней). См. модели ответов фулфилмента.

Доступность API {#availability}

ПутьСтатус
/v1/fulfillment/inbounds/createLive склад simple-store в складском режиме; mock в песочнице
/v1/fulfillment/packagesLive склад packages/index в складском режиме; mock в песочнице
/v1/fulfillment/packages/{package_id}Live склад packages/detail/{id} в складском режиме; mock в песочнице
/v1/fulfillment/packages/{package_id}/trackingLive склад packages/logs/{id} в складском режиме; mock в песочнице
/v1/fulfillment/unclaimed-packagesLive список + претензия в складском режиме; mock в песочнице
/v1/fulfillment/returnsMock — создание / список / подтверждение / отмена возвратов продавцу
/v1/fulfillment/locationsLive склад warehouse в складском режиме; mock в песочнице
/v1/fulfillment/value-added-servicesLive склад services в складском режиме; mock в песочнице
/v1/fulfillment/service-requestsMock — создание / список / детали / подтверждение
/v1/fulfillment/shipments/{id}/interceptLive склад shipments/set-exceptional в складском режиме; mock в песочнице
/v1/fulfillment/shipmentsLive склад shipments/index в складском режиме; mock в песочнице
/v1/fulfillment/shipping/channelsLive-каталог каналов в складском режиме; mock в песочнице
/v1/fulfillment/shipping/quotesLive-расчёт в складском режиме; mock в песочнице
/v1/fulfillment/shipments/*Доступно (HTTP склада при настройке, иначе mock)
/v1/fulfillment/balanceДоступно
/v1/shipments (устаревший)Не рекомендуется

Сквозной процесс {#end-to-end-flow}

  1. Создать заказ на выкуп → продавец отправляет на склад
    или уведомление о поступлении для посылок, которыми вы уже управляете
  2. Детали / трекинг посылки → измерения склада / исключения / VAS / таймлайн
    или детали заказа → tracking_numbers[] после поступления из закупки
  3. Каналы доставки для возможностей, затем расчёт доставки → выбрать quotes[].channel.code
  4. Создать отправление → id / order_sn (PENDING)
  5. Упаковка и финальный обмер на складе → boxes[], итоговый вес / габариты / фрахт
  6. Отправление готово к оплате (WAIT_PAYMENT) → см. детали; слишком ранняя оплата даёт 409 SHIPMENT_NOT_READY_FOR_PAYMENT
  7. Оплатить отправление → списание с кошелька
  8. Список / детали → лёгкие строки или короба / файлы упаковки / timeline / номера первой и последней мили
    Необязательно: перехват, чтобы удержать отправление WAIT_SHIP / SHIPPED
  9. Международный трекинг → события сканирования

Впервые подключаете складской фулфилмент? Пройдите руководство по тестированию WH-DEV, включая упаковку и расчёты.

Начать тест WH-DEV →

Справочник эндпоинтов

ТемаПутьДокумент
Уведомление о поступленииPOST .../inbounds/createПоступления
Детали / трекинг / невостребованныеGET .../packages/* · unclaimed-packagesПосылки
ВозвратыPOST/GET .../returns · confirm/cancelВозвраты
ЛокацииGET .../locationsЛокации
Доп. услугиGET .../value-added-servicesVAS
Заявки на услугиPOST/GET .../service-requests · confirmЗаявки на услуги
Каналы доставкиGET .../shipping/channelsКаналы доставки
Расчёт доставкиPOST .../shipping/quotesРасчёт доставки
Создать / оплатить / отменить / перехватитьPOST .../shipments/create · {id}/pay · {id}/cancel · {id}/interceptОтправления
Список отправленийGET .../shipmentsОтправления · список
Детали отправленияGET .../shipments/{id}Отправления · детали
Международный трекингGET .../shipments/{id}/trackingТрекинг
Баланс кошелькаGET /v1/fulfillment/balanceБаланс
Поля ответа—Модели ответов
Атрибуты товараGET .../item-attributesРасчёт доставки

Закупки в складском режиме

Пути /v1/orders/* не меняются; шлюз пересылает их в HIOBuy. Товарные API по-прежнему вызывают маркетплейсы напрямую.

Внутренний трекинг: трасса логистики заказа (проксируется в складском режиме).

Диаграммы жизненного цикла {#lifecycle}

Схемы состояний: Посылки, Отправления, Возвраты.

Ошибки

FULFILLMENT_MODE_NOT_SUPPORTED, SHIPMENT_CREATE_EXCEPTION, SHIPMENT_CREATE_FAILED, PARCEL_NOT_FOUND, EXTERNAL_ORDER_ID_ALREADY_EXISTS, SHIPMENT_NOT_READY_FOR_PAYMENT, SHIPMENT_ALREADY_PAID, INSUFFICIENT_BALANCE, NOT_FOUND (SHIPMENT_NOT_EXISTS), коды перехвата (SHIPMENT_NOT_FOUND, SHIPMENT_NOT_INTERCEPTABLE, SHIPMENT_INTERCEPTION_ALREADY_REQUESTED) — см. Ошибки и Отправления.

Get Support

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

Email support