Bestell-API-Antwortmodelle
Typen in packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Alle Beträge: Fen.
StandardOrderPreviewResult {#standard-order-preview-result}
Aus Order Preview.
| Feld | Typ | Beschreibung |
|---|---|---|
success | boolean | Nur true, wenn Zahlbetrag, Verkäufergruppen, angeforderte Positionen, Verfügbarkeit und anwendbarer Handelsmodus geprüft wurden |
total.merchandise | Money | null | Warenzwischensumme; null nur wenn tatsächlich unbekannt |
total.payment | Money | Gesamtbetrag zahlbar |
total.shipping | Money | null | Inlandsversand; bekannter kostenloser Versand ist Money mit amount: 0 |
sellers[] | array | Nach Verkäufer gruppiert mit lines[], Gebühren |
unavailable_lines[] | array | Fehlgeschlagene Validierung oder Bestand |
trade_types[] | array | Nur 1688 |
promotions | object | 1688-Aktionen, wenn vorhanden |
code / message | string | Optionaler Geschäftsstatus, darunter LINE_UNAVAILABLE, UNSUPPORTED_TRADE_MODE, PREVIEW_INCOMPLETE |
monetary_unit | string | Bei standard preview immer CNY_minor |
request_id | string | Korrelations-ID der Anfrage |
Ein interpretierbarer, aber unvollständiger standard preview liefert HTTP 200 mit success:false. Aus Kompatibilitätsgründen behalten ausdrückliche 1688-Fehler zu SKU, Bestand, MOQ und Marktplatzbeschränkungen HTTP 502 CHANNEL_UPSTREAM_ERROR. Bei response_format:"upstream" kann HTTP 200 einen upstream-Geschäftsfehler enthalten; prüfen Sie die Rohfelder upstream.success, code, message und verschachtelte Entsprechungen.
StandardOrderCreateResult {#standard-order-create-result}
| Feld | Typ | Beschreibung |
|---|---|---|
order_id | string | Für Pay, Detail und Trace verwenden |
total.payment | Money | Zu zahlender Betrag |
order_list[] | array | Teilbestellungen / Verkäufer-Splits |
failed_offers[] | array | Teilweises Create mit success: true möglich |
outer_purchase_id | string | Taobao-Idempotenzschlüssel |
payment_url | string | Optionale Taobao-Zahlungs-URL |
StandardOrderPayResult {#standard-order-pay-result}
Taobao self standard liefert success: true erst nach Bestätigung durch die Bestellabfrage. code: "0" oder ein alter Erfolg beweisen keine Abbuchung. pending bedeutet unbestätigt durch den Gateway, keine offizielle Warteschlange.
| Feld | Beschreibung |
|---|---|
success | Taobao self standard: true erst nach Zahlungsbestätigung durch die Bestellabfrage |
pending / payment_status | success / pending / failed / unknown |
payment_submission_status | Neue optionale Felder: submitted / rejected / unknown |
payment_recovery | Neue optionale Felder: action, reason, elapsed_seconds. API |
order_status / order_status_raw | Taobao self |
upstream_request_id | Taobao self |
pay_channel | 1688 |
error_code / error_message | Grund einer ausdrücklichen Ablehnung; kann bei pending/unknown fehlen |
StandardOrderDetail {#standard-order-detail}
| Feld | Beschreibung |
|---|---|
status | z. B. wait_payment, wait_shipment, shipped |
refund_status | Read-only; Refund-APIs sind nicht öffentlich |
amounts | total, product_total, shipping_fee, refund (Fen) |
line_items[] | Produktzeilen mit sku_specs, status |
times | created_at, paid_at, shipped_at, … |
domestic_parcels[] | Warehouse-Modus → Fulfillment |
UnifiedLogisticsTrace {#unified-logistics-trace}
Aus Inland-Trace.
| Feld | Beschreibung |
|---|---|
packages[] | tracking_number, carrier, steps[] |
cross_border_packages[] | 1688-Cross-Border-Knoten - kein internationales Fulfillment |
StandardOrderCancelResult {#standard-order-cancel-result}
| Feld | Beschreibung |
|---|---|
success | Storno akzeptiert (kann noch verarbeitet werden) |
pending | Asynchrones Taobao-Storno |
sub_order_ids | Betroffene IDs bei Teilstorno |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days