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	라인을 구매할 수 없으면 `false`; `unavailable_lines` 확인
`total.payment`	Money	총 결제 금액
`total.shipping`	Money	중국 내 배송비 부분
`sellers[]`	array	판매자별 그룹, `lines[]`와 수수료 포함
`unavailable_lines[]`	array	검증 실패 또는 재고 부족
`trade_types[]`	array	1688 전용
`promotions`	object	존재하는 경우 1688 프로모션

StandardOrderCreateResult {#standard-order-create-result}

필드	타입	설명
`order_id`	string	pay, detail, trace에 사용
`total.payment`	Money	결제할 금액
`order_list[]`	array	하위 주문 / 판매자별 분리
`failed_offers[]`	array	`success: true`에서도 부분 생성 실패 가능
`outer_purchase_id`	string	Taobao 멱등성 키
`payment_url`	string	Taobao 선택적 결제 URL

StandardOrderPayResult {#standard-order-pay-result}

필드	설명
`success`	결제 접수 여부
`pay_channel`	1688 결제 수단
`error_code` / `error_message`	`success: false`인 경우

StandardOrderDetail {#standard-order-detail}

필드	설명
`status`	예: `wait_payment`, `wait_shipment`, `shipped`
`refund_status`	읽기 전용; 환불 API는 공개되지 않음
`amounts`	`total`, `product_total`, `shipping_fee`, `refund`(fen)
`line_items[]`	`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[]`	1688 크로스보더 노드 — 국제 풀필먼트가 아님

StandardOrderCancelResult {#standard-order-cancel-result}

필드	설명
`success`	취소 접수 여부(계속 처리될 수 있음)
`pending`	Taobao 비동기 취소
`sub_order_ids`	부분 취소가 영향을 준 id