Модели ответов Order API
Типы в packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Все суммы: fen.
StandardOrderPreviewResult {#standard-order-preview-result}
Из order preview.
| Поле | Тип | Описание |
|---|---|---|
success | boolean | true только после проверки суммы к оплате, групп продавцов, запрошенных позиций, доступности и применимого режима сделки |
total.merchandise | Money | null | Стоимость товаров; null только когда она действительно неизвестна |
total.payment | Money | Общая сумма к оплате |
total.shipping | Money | null | Внутренняя доставка; известная бесплатная доставка — Money с amount: 0 |
sellers[] | array | Сгруппировано по продавцу с lines[], fees |
unavailable_lines[] | array | Ошибка validation или stock |
trade_types[] | array | Только 1688 |
promotions | object | Promotions 1688, когда присутствуют |
code / message | string | Необязательный бизнес-статус, включая LINE_UNAVAILABLE, UNSUPPORTED_TRADE_MODE, PREVIEW_INCOMPLETE |
monetary_unit | string | Всегда CNY_minor в standard preview |
request_id | string | Идентификатор корреляции запроса |
Разбираемый, но неполный standard preview возвращает HTTP 200 с success:false. Для совместимости явные ошибки 1688 по SKU, запасам, MOQ и ограничениям площадки сохраняют HTTP 502 CHANNEL_UPSTREAM_ERROR. В режиме response_format:"upstream" HTTP 200 может содержать бизнес-ошибку upstream; проверяйте исходные upstream.success, code, message и вложенные поля.
StandardOrderCreateResult {#standard-order-create-result}
| Поле | Тип | Описание |
|---|---|---|
order_id | string | Используйте для pay, detail, trace |
total.payment | Money | Сумма к оплате |
order_list[] | array | Sub-orders / seller splits |
failed_offers[] | array | Возможен partial create с success: true |
outer_purchase_id | string | Idempotency key Taobao |
payment_url | string | Опциональный payment URL Taobao |
StandardOrderPayResult {#standard-order-pay-result}
Taobao self standard возвращает success: true только после подтверждения запросом заказа. code: "0" или старый успех не доказывает списание. pending означает неподтверждённый результат Gateway, не официальную очередь.
| Поле | Описание |
|---|---|
success | Taobao self standard: true только после подтверждения оплаты запросом заказа |
pending / payment_status | success / pending / failed / unknown |
payment_submission_status | Новые необязательные поля: submitted / rejected / unknown |
payment_recovery | Новые необязательные поля: action, reason, elapsed_seconds. API |
order_status / order_status_raw | Taobao self |
upstream_request_id | Taobao self |
pay_channel | 1688 |
error_code / error_message | Причина явного отказа; может отсутствовать при pending/unknown |
StandardOrderDetail {#standard-order-detail}
| Поле | Описание |
|---|---|
status | Например wait_payment, wait_shipment, shipped |
refund_status | Read-only; refund APIs не публичные |
amounts | total, product_total, shipping_fee, refund (fen) |
line_items[] | Product rows с sku_specs, status |
times | created_at, paid_at, shipped_at, … |
domestic_parcels[] | Складской режим → fulfillment |
UnifiedLogisticsTrace {#unified-logistics-trace}
Из domestic trace.
| Поле | Описание |
|---|---|
packages[] | tracking_number, carrier, steps[] |
cross_border_packages[] | Cross-border nodes 1688 — не international fulfillment |
StandardOrderCancelResult {#standard-order-cancel-result}
| Поле | Описание |
|---|---|
success | Cancel accepted (может еще обрабатываться) |
pending | Асинхронная отмена Taobao |
sub_order_ids | Affected ids при частичной отмене |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days