구매 주문 개요
/v1/orders/*는 중국 내 구매를 다룹니다. 1688/Taobao 판매자에게 주문하고 중국 내 입고 주소로 배송받는 주문입니다. 국제 배송이 아니며, 입고 후에는 Fulfillment를 사용하세요.
금액은 CNY fen(分)입니다. Response format에 따라 response_format을 설정하세요.
Products의 상품 id를 매핑하세요: source_product_id → lines[].offer_id, variants[].sku_id → lines[].spec_id.
수명주기 {#lifecycle}
- Preview — 라인, 가격, 운임 검증
- Create — 구매 주문 생성
- Pay — 마켓플레이스 지갑으로 결제
- Detail / list — 상태 추적
- Domestic trace — 판매자 → 창고
- Cancel — 허용되는 경우
엔드포인트 가이드
| 단계 | 경로 | 문서 |
|---|---|---|
| Preview | POST /v1/orders/preview | Order preview |
| Create | POST /v1/orders/create | Create order |
| Pay | POST /v1/orders/pay | Pay order |
| Detail | POST /v1/orders/detail | Order detail |
| List | POST /v1/orders/list | Order detail |
| Cancel | POST /v1/orders/cancel | Cancel order |
| Domestic trace | POST /v1/orders/logistics/trace | Domestic logistics trace |
| Taobao purchases | POST /v1/orders/purchase/query | Order detail |
| 응답 스키마 | — | Order response models |
채널 단축 경로: /v1/orders/1688/*, /v1/orders/taobao/*(본문에서 channel 생략 가능).
중국 내 물류와 국제 물류 {#domestic-vs-international}
| 구간 | API |
|---|---|
| 판매자 → 중국 창고 | Domestic trace |
| 창고 → 해외 구매자 | International tracking |