Ever Connect
v1.4.0中文·EN·한국어Sign inRequest access
Drop-ship orders

Create a drop-ship order (recipient + lines)

POST/api/v1/dropship-ordersToken requireddf:writewrite2 pts

Request body (JSON)

FieldTypeDescription
warehouse_code requiredstringWarehouse code: AU (Australia, all warehouses — aggregate view), AUSYD2 (Sydney main, Rosehill), AUSYD1 (Sydney accessories), CN (China, all warehouses — aggregate view), CHNZJ1 (Zhenjiang). Full list: GET /api/v1/warehouses.
sku requiredstringSKU / barcode — the colour + size level, e.g. OB0021611. For the whole style use product_code instead.
max length 64
quantity requiredintegerQuantity, a positive integer, e.g. 2. In reservation adjustments / carts, 0 removes the line.
1–99999
recipient requiredobjectRecipient object { name, phone, address, country_code, state, city, postal_code }. country_code is AU / CN / NZ; state, city and postal_code are required for AU and NZ. Include the country code in the phone for cross-border parcels (e.g. +61…) and the street number in the address — incomplete addresses are the top cause of failed delivery.
recipient.name requiredstringRecipient name.
max length 128
recipient.phone requiredstringRecipient phone; include the country code for cross-border parcels, e.g. +61…
max length 64
recipient.address requiredstringDelivery address including the street number — incomplete addresses are the top cause of failed delivery.
max length 512
recipient.country_code requiredstringDestination country: AU / CN / NZ (drop-ship supports these three).
recipient.statestringState / province, e.g. NSW. Required for AU and NZ addresses.
max length 64
recipient.citystringCity, e.g. Sydney. Required for AU and NZ addresses.
max length 128
recipient.postal_codestringPostcode, e.g. 2000. Required for AU and NZ addresses.
max length 16
senderobjectSender object { name, phone } (optional), printed on the waybill.
sender.namestringRecipient name.
max length 128
sender.phonestringRecipient phone; include the country code for cross-border parcels, e.g. +61…
max length 64
shipping_methodstringShipping method: normal (default), express or ems.
auto_confirmbooleanSubmit immediately (optional). Omitted = draft only, someone confirms it in the ERP before it takes effect — this default is intentional. A submitted drop-ship order is allocated at once and can no longer be edited.
client_order_numberstringThe order number in your own system (the one you sent when creating the drop-ship order).
max length 64
notestringRemark (optional, up to 500 characters).
max length 500

Response

The envelope is decided by the HTTP status alone: 2xx with { data: … } (lists also carry page / page_size / has_more or total_count); 4xx / 5xx with { error: { code, message, hint, request_id, doc_url } }.

Send an Idempotency-Key header (any unique string, e.g. a UUID) on writes: a network retry never creates a second order. Orders are drafts by default until a person confirms them in the ERP.