Ever Connect
v1.4.0中文·EN·한국어로그인접근 신청
드롭쉬핑 주문

드롭쉬핑 주문 생성(수취인 + 명세)

POST/api/v1/dropship-orders토큰 필요df:write쓰기2포인트

요청 본문(JSON)

필드타입설명
warehouse_code 필수string창고 코드: AU(호주 전체 — 합계 뷰), AUSYD2(시드니 메인, Rosehill), AUSYD1(시드니 액세서리), CN(중국 전체 — 합계 뷰), CHNZJ1(전장). 전체 목록: GET /api/v1/warehouses.
sku 필수stringSKU / 바코드 — 색상 + 사이즈 단위, 예: OB0021611. 스타일 전체는 product_code 를 쓰세요.
최대 길이 64
quantity 필수integer수량(양의 정수, 예: 2). 예약 조정 / 장바구니에서 0 은 해당 행 삭제.
1–99999
recipient 필수object수취인 객체 { name, phone, address, country_code, state, city, postal_code }. country_code 는 AU / CN / NZ; 호주·뉴질랜드는 state, city, postal_code 필수. 국제 배송은 전화번호에 국가번호(+61…), 주소에 번지까지 포함하세요 — 주소 불완전이 배송 실패의 가장 흔한 원인입니다.
recipient.name 필수string수취인 이름.
최대 길이 128
recipient.phone 필수string수취인 전화번호. 국제 배송은 국가번호 포함(예: +61…).
최대 길이 64
recipient.address 필수string배송 주소(번지 포함) — 주소 불완전은 배송 실패의 가장 흔한 원인입니다.
최대 길이 512
recipient.country_code 필수string수취 국가: AU / CN / NZ (드롭쉬핑은 이 세 나라만 지원).
recipient.statestring주/도, 예: NSW. 호주·뉴질랜드 주소는 필수.
최대 길이 64
recipient.citystring도시, 예: Sydney. 호주·뉴질랜드 주소는 필수.
최대 길이 128
recipient.postal_codestring우편번호, 예: 2000. 호주·뉴질랜드 주소는 필수.
최대 길이 16
senderobject발송인 객체 { name, phone } (선택), 운송장에 인쇄됩니다.
sender.namestring수취인 이름.
최대 길이 128
sender.phonestring수취인 전화번호. 국제 배송은 국가번호 포함(예: +61…).
최대 길이 64
shipping_methodstring배송 방식: normal(기본), express 또는 ems.
auto_confirmboolean즉시 제출 여부(선택). 생략 = 초안만 생성되며 ERP 에서 사람이 확인해야 효력이 생깁니다 — 의도된 기본값입니다. 제출된 드롭쉬핑 주문은 즉시 배정되며 더 이상 수정할 수 없습니다.
client_order_numberstring내 시스템의 주문번호(드롭쉬핑 주문 생성 시 보낸 값).
최대 길이 64
notestring비고(선택, 최대 500자).
최대 길이 500

응답

봉투는 HTTP 상태 코드만으로 판단합니다: 2xx 는 { data: … }(목록은 page / page_size / has_more 또는 total_count 포함); 4xx / 5xx 는 { error: { code, message, hint, request_id, doc_url } }.

쓰기 요청에는 Idempotency-Key 헤더(UUID 등 고유 문자열)를 보내세요. 네트워크 재시도로 주문이 두 번 생기지 않습니다. 주문은 ERP에서 사람이 확인하기 전까지 초안입니다.