WishPost API Documentation

Order(New)


Create an order(New)

API endpoint: https://wishpost.wish.com/api/v2/create_order

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
api_key string 83-84 Used to verify the identity
mark string 0-50 If you need multiple labels in one PDF file, please use the previous returned mark
bid int 0-99999 Unique submission identifier provided by user
guid string 100 Unique waybill identifier provided by user, returned together with waybill number
otype string 1-50 China Post Unregistered=0
China Post Registered=1
China Post Simplified Tracked Packet=1
--------------------------------------
DLE=10-1
EUB=11-1
MPAK=14-1
IB Express=21-1
IB Standard=22-1
Sinotrans=23-1
DHLe-PKG=30-0
DHLe-PPS=31-1
Wishpost EPC=36-1
Wishpost YunExpress=37-1
Wishpost WiseExpress=44-1
Sunyou Packet Registered=49-1(Online Payment)
Sunyou Packet Unregistered=54-0(Online Payment)
FlyT Registered Packet=55-1
FlyT Unregistered Packet=56-0
TopYou unregistered general cargo=77-0(Online Payment)
TopYou unregistered special cargo=78-0(Online Payment)
TopYou registered general cargo=79-1(Online Payment)
TopYou registered special cargo=80-1(Online Payment)
Europe Economy=200-0
Europe Standard=201-1
Wishpriority=300-1For more channels' otype, please call get channels API
from string 0-100 Sender Name (default info in address book will be used if left blank)
sender_province string 0-100 Sender Province (default info in address book will be used if left blank)
sender_city string 0-100 Sender City (default info in address book will be used if left blank)
sender_district string 0-100 Sender District (default info in address book will be used if left blank)
sender_addres string 0-100 Sender Address (default info in address book will be used if left blank)
sender_phone string 0-20 Sender Phone Number (Default info in address book will be used if left blank. Phone number could start with one + numbers can be connected with - or encapsulated by (). But could not contain any other mark or other language character.)
sender_zipcode string 1-200 Sender postal code to contact for Collection(default info in address book will be used if left blank, if sender postal code is blank in address, 310000 will be used as default)
pickup_service string 1-100 Pick Up Service for EPC, if choose Collection, must fill in 25-1(IVPX PICKUP) or 27-1(WISE PICKUP), if choose self deliver, this field can be noneFor Other channels, wipe this field out
pickup_from_local string 1-100 Sender Name to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_phone string 1-250 Sender Phone to contact for Collection (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_zip_code string 1-200 Sender postal code to contact for Collection
pickup_addres_local string 1-200 Sender Address to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_province_local string 1-1000 Sender Province to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_city_local string 1-1000 Sender City to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_district_local string 1-1000 Sender District to Collect Parcel From
pickup_from string 1-100 Sender Name to Collect Parcel From
pickup_addres string 1-200 Sender Address to Collect Parcel From
pickup_province string 1-1000 Sender Province to Collect Parcel From
pickup_city string 1-1000 Sender City to Collect Parcel From
pickup_district string 1-1000 Sender District to Collect Parcel From
pickup_country_local string 1-500 Sender Country to Collect Parcel From
pickup_country string 1-500 Sender Country to Collect Parcel From
pickup_country_code string 3 Sender Country ISO3 Code to Collect Parcel From
to string 1-100 Recipient Name
recipient_country string 1-50 Recipient Country (in English),optional for Wishpost EPC channel
recipient_country_short string 1-3 Recipient Country Shortcode (e.g. US, GB, UK),optional for Wishpost EPC channel
recipient_province string 1-100 Recipient Province/State (in English),optional for Wishpost EPC channel
recipient_city string 1-100 Recipient City (in English),optional for Wishpost EPC channel
recipient_district string 1-100 Recipient District (in English),optional
recipient_addres string 1-100 Recipient Address (in English),optional for Wishpost EPC channel
recipient_postcode string 1-10 Recipient Postal Code/ZIP,optional for Wishpost EPC channel
recipient_phone string 1-20 Recipient Phone Number(Phone number could start with one + numbers can be connected with - or encapsulated by (). But could not contain any other mark or other language character.),optional for Wishpost EPC channel
to_local string 1-100 Recipient Name (use recipient country’s language, if left blank, use English)
recipient_country_local string 0-50 Recipient Country (use recipient country’s language, if left blank, use English)
recipient_province_local string 0-100 Recipient Province/State (use recipient country’s language, if left blank, use English)
recipient_city_local string 0-100 Recipient City (use recipient country’s language, if left blank, use English)
recipient_district_local string 0-100 Recipient District (use recipient country’s language, if left blank, use English)
recipient_addres_local string 0-100 Recipient Address (use recipient country’s language, if left blank, use English)
receive_from string 0-100 Courier Contact (Must be in Chinese)
receive_province string 0-100 Courier Province Name (Must be in Chinese)
receive_city string 0-100 Courier Country Name (Must be in Chinese)
receive_district string 0-100 Courier Country Name (Must be in Chinese)
receive_addres string 0-100 Courier Information (Must be in Chinese)
receive_phone string 0-20 Courier Phone Number
type_no int 1 Product type:
1=Gift
2=Document
3=Merchandise Sample
4=Others

unit_measurement string 0-20 Unit Of Measurement
unit_measurement_chinese string 0-20 Unit Of Measurement in Chinese
user_desc string 0-500 Merchant-defined Information, such as merchant order ID, product ID, location ID
trade_amount money 0-99999.00 Trade amount on Wish (Unit: US dollar), including product value and shipping fee
warehouse_code int 0-10 Warshouse code(Mandatory for China Post and IB)
----------------------------------------------------------------
Below are China Post Registered/Unregistered Warehouses:
1=Shanghai
2=Guangzhou
3=Shenzhen
4=Yiwu
5=Beijing
6=Nanjing
7=Fuzhou
8=Qingdao
9=Wuhan
10=Dongguan
11=Hangzhou
12=Jinhua
13=Ningbo
14=Wenzhou
15=Xiamen
16=Chongqing
17=Tianjin
18=Suzhou
19=Hefei
20=Changsha
21=Zhengzhou
22=Chengdu
23=Xuchang
24=Quanzhou
25=Foshan
26=Zhangpu
29=Wuxi
30=Nanyang
31=Shijiazhuang
32=Jingzhou
33=Nanchang
34=Dalian
35=Jinan
36=Yichang
37=Nantong
38=Zhongshan
---------------------------------------------------------------
Below are IB Standard/Express Warehouses:
27=EastChina
28=SouthChina

doorpickup int 1 Door pickup or not
0=Customer Drop Off
1=Door Pickup
product_item_from_country string string Product’s original country (in English)
product_item_name string 1-100 Product’s detailed name (in English), which must contain at least one English character
product_item_name_chinese string 1-50 Product’s detailed name (mandatory, must contains Chinese)
product_item_num int 1-99999 Product Quantity
product_item_weight float 0-2.000 Product Weight (in kg, to 3 decimal places)
product_item_single_price money 0-99999.00 Product Price (to 2 decimal places)
wish_order_id string 1-499 Wish order ID in Wish merchant dashboard, mandatory for all channels.
This field must be a string only containing English and numeric characters, with English comma to separate multiple ids if there are. No extra space characters are allowed in the middle of it.
If this order does not belong to Wish platform, please provide default value as NonWishOrder(no limit in upper/lower case), please be noted this logistics order will not be able to fulfilled into Wish merchant dashboard;
If this order does belong to Wish platform, please correctly provide the 24-char Wish order ID provided by Wish merchant dashboard.
This field support a single ID, such as 56f1205a44dc6fb51631f26f.

product_item_has_battery int 1 Has battery or not,
Mandatory
0=Without battery,
1=With battery
EPC order with sentitive goods should use 1 as well
EPC sensitive goods list:
https://s3.cn-north-1.amazonaws.com.cn/wishpost-production-wishpost-announcement/EPC特货清单.xlsx
product_item_product_url string string Product url(Mandatory)

Response

Parameter name Description
Timestamp Timestamp
Status Status
wish_standard_tracking_id WOSP Order Number
barcode Waybill Number
mark mark
PDF_10_EN_URL PDF Label 10*10 English Version Download URL
PDF_10_LCL_URL PDF Label 10*10 Recipient Country Download URL
error_message Error message
PDF_15_EN_URL PDF Label 10*5 Download URL
recipient_country Recipient Country
recipient_country_short Recipient Country Code
c_code Product Code
q_code Channel Code
y_ code Verification Code
user_desc User-defined Information
reference_qrcode Sweden reference QRcode

Example Request

                                
<?xml version="1.0" ?>
<orders>
    <access_token>f06d703a71e4412aad8a579925aef656</access_token>
    <mark/>
    <bid>0</bid>
    <order>
        <guid>12345</guid>
        <otype>0</otype>
        <from>ZENG WEI</from>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>asgfdgs</user_desc>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <warehouse_code>1</warehouse_code>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>12346</guid>
        <otype>1</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>something</user_desc>
        <trade_amount>11.45</trade_amount>
        <receive_from>许勤</receive_from>
        <receive_province>广东</receive_province>
        <receive_city>深圳</receive_city>
        <receive_addres>福田区福中三路市民中心大楼</receive_addres>
        <receive_phone>12345</receive_phone>
        <doorpickup>1</doorpickup>
        <warehouse_code>2</warehouse_code>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>12347</guid>
        <otype>9-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>something</user_desc>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>12348</guid>
        <otype>10-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Jaden Smith</to_local>
        <recipient_addres>322 Edge Street</recipient_addres>
        <recipient_addres_local>322 Edge Street</recipient_addres_local>
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local>United States</recipient_country_local>
        <recipient_province>South Carolina</recipient_province>
        <recipient_province_local>South Carolina</recipient_province_local>
        <recipient_city>Columbia</recipient_city>
        <recipient_city_local>Columbia</recipient_city_local>
        <recipient_postcode>29201</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>something</user_desc>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>12349</guid>
        <otype>11-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>something</user_desc>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>MGP1704200142254</guid>
        <otype>21-1</otype>
        <warehouse_code>27</warehouse_code>
        <pickup_from_local>苏蕙</pickup_from_local>
        <pickup_addres_local>鼓楼区 新三路987弄3号201室</pickup_addres_local>
        <pickup_province_local>福建省</pickup_province_local>
        <pickup_city_local>福州市</pickup_city_local>
        <pickup_phone>13763813216</pickup_phone>
        <from>subilong</from>
        <sender_addres>GulouQu Darushijai</sender_addres>
        <sender_province>Fujiansheng</sender_province>
        <sender_city>Fuzhoushi</sender_city>
        <sender_phone>13763813216</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kalynn Stiles</to>
        <to_local />
        <recipient_addres>25380 County Rd. 21A</recipient_addres>
        <recipient_addres_local />
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local />
        <recipient_province>California</recipient_province>
        <recipient_province_local />
        <recipient_city>Esparto</recipient_city>
        <recipient_city_local />
        <recipient_postcode>95627</recipient_postcode>
        <recipient_phone>(530)787-3999</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>手表 Deng21 1;</user_desc>
        <trade_amount>3.00</trade_amount>
        <receive_from>苏碧龙</receive_from>
        <receive_province>福建省</receive_province>
        <receive_city>福州市</receive_city>
        <receive_addres>鼓楼区大儒世家</receive_addres>
        <receive_phone>13763813216</receive_phone>
        <doorpickup>1</doorpickup>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>12345</guid>
        <otype>33-0</otype>
        <from>ZENG WEI</from>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <type_no>1</type_no>
        <user_desc>asgfdgs</user_desc>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <warehouse_code>1</warehouse_code>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
    <order>
        <guid>MGP1704200142254</guid>
        <otype>300-1</otype>
        <from>subilong</from>
        <sender_addres>GulouQu Darushijai</sender_addres>
        <sender_province>Fujiansheng</sender_province>
        <sender_city>Fuzhoushi</sender_city>
        <sender_phone>13763813216</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kalynn Stiles</to>
        <to_local />
        <recipient_addres>25380 County Rd. 21A</recipient_addres>
        <recipient_addres_local />
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local />
        <recipient_province>California</recipient_province>
        <recipient_province_local />
        <recipient_city>Esparto</recipient_city>
        <recipient_city_local />
        <recipient_postcode>95627</recipient_postcode>
        <recipient_phone>(530)787-3999</recipient_phone>
        <type_no>1</type_no>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <user_desc>烛台 Deng21 1;</user_desc>
        <trade_amount>3.00</trade_amount>
        <receive_from>苏碧龙</receive_from>
        <receive_province>福建省</receive_province>
        <receive_city>福州市</receive_city>
        <receive_addres>鼓楼区大儒世家</receive_addres>
        <receive_phone>13763813216</receive_phone>
        <warehouse_code />
        <doorpickup>1</doorpickup>
        <product_items>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66545</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>LED light</product_item_name>
                <product_item_name_chinese>发光二极管</product_item_name_chinese>
                <product_item_num>3</product_item_num>
                <product_item_weight>0.15</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>1</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
            <product_item>
                <wish_order_id>5a80417edf3b162557f66544</wish_order_id>
                <product_item_from_country>China</product_item_from_country>
                <product_item_name>head</product_item_name>
                <product_item_name_chinese>帽子</product_item_name_chinese>
                <product_item_num>2</product_item_num>
                <product_item_weight>0.1</product_item_weight>
                <product_item_single_price>2</product_item_single_price>
                <product_item_has_battery>0</product_item_has_battery>
                <product_item_product_url> https://www.wish.com/c/561f48726475cc5873cda03e</product_item_product_url>
            </product_item>
        </product_items>
    </order>
</orders>

Success Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <wish_standard_tracking_id guid="12345" state="Created">WOSP000000022891AUS</wish_standard_tracking_id>
    <barcode guid="12345" state="Created">PP001764319BJ</barcode>
    <mark>1e191d851b3b49a248f4ea62f6b06410</mark>
    <PDF_10_EN_URL>http://wishpost.wish.com/api/v2/download_label?access_token
    =f06d703a71e4412aad8a579925aef656&format=10&use_local=false&mark
    =7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_EN_URL>
    <PDF_10_LCL_URL>http://wishpost.wish.com/api/v2/download_label
    ?access_token=f06d703a71e4412aad8a579925aef656&format=10&use_local=true
    &mark=7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_LCL_URL>
</root>

or

<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <wish_standard_tracking_id guid="12345" state="Created">WOSP000000022891AUS</wish_standard_tracking_id>
    <barcode guid="12345" state="Reviewing"></barcode>
    <mark>1e191d851b3b49a248f4ea62f6b06410</mark>
    <PDF_10_EN_URL>http://wishpost.wish.com/api/v2/download_label?access_token
    =f06d703a71e4412aad8a579925aef656&format=10&use_local=false&mark
    =7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_EN_URL>
    <PDF_10_LCL_URL>http://wishpost.wish.com/api/v2/download_label
    ?access_token=f06d703a71e4412aad8a579925aef656&format=10&use_local=true
    &mark=7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_LCL_URL>
</root>


Error Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:54:39</timestamp>
    <status>1</status>
    <error_message>Unauthorized Request</error_message>
</root>

or

<?xml version="1.0" encoding="utf-8"?>
<root>
    <status>2</status>
    <timestamp>2018/05/16 11:59:49</timestamp>
    <error_message guid="0">收件人邮编4501错误,印度的邮编是6位数字,如:456001</error_message>
    <mark>9445c60a58bd11e880c90242ac110005</mark>
    <PDF_10_EN_URL>https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=e7339bc2203f41fdbeaba7c78ba7e37e&amp;format=10&amp;use_local=false&amp;mark=9445c60a58bd11e880c90242ac110005</PDF_10_EN_URL>
    <PDF_10_LCL_URL>https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=e7339bc2203f41fdbeaba7c78ba7e37e&amp;format=10&amp;use_local=true&amp;mark=9445c60a58bd11e880c90242ac110005</PDF_10_LCL_URL>
</root>
        

Order


Create an order

API endpoint: https://wishpost.wish.com/api/v2/create_order

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
api_key string 83-84 Used to verify the identity
mark string 0-50 If you need multiple labels in one PDF file, please use the previous returned mark
bid int 0-99999 Unique submission identifier provided by user
guid string 100 Unique waybill identifier provided by user, returned together with waybill number
otype string 1-50 China Post Unregistered=0
China Post Registered=1
China Post Simplified Tracked Packet=1
--------------------------------------
DLE=10-1
EUB=11-1
MPAK=14-1
IB Express=21-1
IB Standard=22-1
Sinotrans=23-1
DHLe-PKG=30-0
DHLe-PPS=31-1
Wishpost EPC=36-1
Wishpost YunExpress=37-1
Wishpost WiseExpress=44-1
Sunyou Packet Registered=49-1(Online Payment)
Sunyou Packet Unregistered=54-0(Online Payment)
FlyT Registered Packet=55-1
FlyT Unregistered Packet=56-0
TopYou unregistered general cargo=77-0(Online Payment)
TopYou unregistered special cargo=78-0(Online Payment)
TopYou registered general cargo=79-1(Online Payment)
TopYou registered special cargo=80-1(Online Payment)
Europe Economy=200-0
Europe Standard=201-1
Wishpriority=300-1For more channels' otype, please call get channels API
from string 0-100 Sender Name (default info in address book will be used if left blank)
sender_province string 0-100 Sender Province (default info in address book will be used if left blank)
sender_city string 0-100 Sender City (default info in address book will be used if left blank)
sender_district string 0-100 Sender District (default info in address book will be used if left blank)
sender_addres string 0-100 Sender Address (default info in address book will be used if left blank)
sender_phone string 0-20 Sender Phone Number (Default info in address book will be used if left blank. Phone number could start with one + numbers can be connected with - or encapsulated by (). But could not contain any other mark or other language character.)
sender_zipcode string 1-200 Sender postal code to contact for Collection(default info in address book will be used if left blank, if sender postal code is blank in address, 310000 will be used as default)
pickup_service string 1-100 Pick Up Service for EPC, if choose Collection, must fill in 25-1(IVPX PICKUP) or 27-1(WISE PICKUP), if choose self deliver, this field can be noneFor Other channels, wipe this field out
pickup_from_local string 1-100 Sender Name to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_phone string 1-250 Sender Phone to contact for Collection (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_zip_code string 1-200 Sender postal code to contact for Collection
pickup_addres_local string 1-200 Sender Address to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_province_local string 1-1000 Sender Province to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_city_local string 1-1000 Sender City to Collect Parcel From (Mandatory for Sinotrans, IB, EPC, YunExpress and Wiseexpresschannels)
pickup_district_local string 1-1000 Sender District to Collect Parcel From
pickup_from string 1-100 Sender Name to Collect Parcel From
pickup_addres string 1-200 Sender Address to Collect Parcel From
pickup_province string 1-1000 Sender Province to Collect Parcel From
pickup_city string 1-1000 Sender City to Collect Parcel From
pickup_district string 1-1000 Sender District to Collect Parcel From
pickup_country_local string 1-500 Sender Country to Collect Parcel From
pickup_country string 1-500 Sender Country to Collect Parcel From
pickup_country_code string 3 Sender Country ISO3 Code to Collect Parcel From
to string 1-100 Recipient Name
recipient_country string 1-50 Recipient Country (in English),optional for Wishpost EPC channel
recipient_country_short string 1-3 Recipient Country Shortcode (e.g. US, GB, UK),optional for Wishpost EPC channel
recipient_province string 1-100 Recipient Province/State (in English),optional for Wishpost EPC channel
recipient_city string 1-100 Recipient City (in English),optional for Wishpost EPC channel
recipient_district string 1-100 Recipient City (in English),optional
recipient_addres string 1-100 Recipient Address (in English),optional for Wishpost EPC channel
recipient_postcode string 1-10 Recipient Postal Code/ZIP,optional for Wishpost EPC channel
recipient_phone string 1-20 Recipient Phone Number(Phone number could start with one + numbers can be connected with - or encapsulated by (). But could not contain any other mark or other language character.),optional for Wishpost EPC channel
to_local string 1-100 Recipient Name (use recipient country’s language, if left blank, use English)
recipient_country_local string 0-50 Recipient Country (use recipient country’s language, if left blank, use English)
recipient_province_local string 0-100 Recipient Province/State (use recipient country’s language, if left blank, use English)
recipient_city_local string 0-100 Recipient City (use recipient country’s language, if left blank, use English)
recipient_district_local string 0-100 Recipient District (use recipient country’s language, if left blank, use English)
recipient_addres_local string 0-100 Recipient Address (use recipient country’s language, if left blank, use English)
type_no int 1 Product type:
1=Gift
2=Document
3=Merchandise Sample
4=Others

from_country string string Product’s original country (in English)
content string 1-100 Product’s detailed name (in English), which must contain at least one English character
content_chinese string 1-50 Product’s detailed name (mandatory, must contains Chinese)
num int 1-99999 Product Quantity
unit_measurement string 0-20 Unit Of Measurement
unit_measurement_chinese string 0-20 Unit Of Measurement in Chinese
weight float 0-2.000 Product Weight (in kg, to 3 decimal places)
single_price money 0-99999.00 Product Price (to 2 decimal places)
trande_no string 1-499 Wish order ID in Wish merchant dashboard, mandatory for all channels.
This field must be a string only containing English and numeric characters, with English comma to separate multiple ids if there are. No extra space characters are allowed in the middle of it.
If this order does not belong to Wish platform, please provide default value as NonWishOrder(no limit in upper/lower case), please be noted this logistics order will not be able to fulfilled into Wish merchant dashboard;
If this order does belong to Wish platform, please correctly provide the 24-char Wish order ID provided by Wish merchant dashboard.
This field support a single ID, such as 56f1205a44dc6fb51631f26f; or multiple IDs (20 at most), such as 56f1205a44dc6fb51631f26f,56f1205a44dc6fb51631f26f.

trade_amount money 0-99999.00 Trade amount on Wish (Unit: US dollar), including product value and shipping fee
user_desc string 0-500 Merchant-defined Information, such as merchant order ID, product ID, location ID
receive_from string 0-100 Courier Contact (Must be in Chinese)
receive_province string 0-100 Courier Province Name (Must be in Chinese)
receive_city string 0-100 Courier Country Name (Must be in Chinese)
receive_district string 0-100 Courier Country Name (Must be in Chinese)
receive_addres string 0-100 Courier Information (Must be in Chinese)
receive_phone string 0-20 Courier Phone Number
warehouse_code int 0-10 Warshouse code(Mandatory for China Post and IB)
----------------------------------------------------------------
Below are China Post Registered/Unregistered Warehouses:
1=Shanghai
2=Guangzhou
3=Shenzhen
4=Yiwu
5=Beijing
6=Nanjing
7=Fuzhou
8=Qingdao
9=Wuhan
10=Dongguan
11=Hangzhou
12=Jinhua
13=Ningbo
14=Wenzhou
15=Xiamen
16=Chongqing
17=Tianjin
18=Suzhou
19=Hefei
20=Changsha
21=Zhengzhou
22=Chengdu
23=Xuchang
24=Quanzhou
25=Foshan
26=Zhangpu
29=Wuxi
30=Nanyang
31=Shijiazhuang
32=Jingzhou
33=Nanchang
34=Dalian
35=Jinan
36=Yichang
37=Nantong
38=Zhongshan
---------------------------------------------------------------
Below are IB Standard/Express Warehouses:
27=EastChina
28=SouthChina

doorpickup int 1 Door pickup or not
0=Customer Drop Off
1=Door Pickup
has_battery int 1 Has battery or not,
Mandatory
0=Without battery,
1=With battery
EPC order with sentitive goods should use 1 as well
EPC sensitive goods list:
https://s3.cn-north-1.amazonaws.com.cn/wishpost-production-wishpost-announcement/EPC特货清单.xlsx
product_url string string Product url(Mandatory)

Response

Parameter name Description
Timestamp Timestamp
Status Status
wish_standard_tracking_id WOSP Order Number
barcode Waybill Number
mark mark
PDF_10_EN_URL PDF Label 10*10 English Version Download URL
PDF_10_LCL_URL PDF Label 10*10 Recipient Country Download URL
error_message Error message
PDF_15_EN_URL PDF Label 10*5 Download URL
recipient_country Recipient Country
recipient_country_short Recipient Country Code
c_code Product Code
q_code Channel Code
y_ code Verification Code
user_desc User-defined Information
reference_qrcode Sweden reference QRcode

Example Request

                                
<?xml version="1.0" ?>
<orders>
    <access_token>f06d703a71e4412aad8a579925aef656</access_token>
    <mark/>
    <bid>0</bid>
    <order>
        <guid>12345</guid>
        <otype>0</otype>
        <from>ZENG WEI</from>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>asgfdgs</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <warehouse_code>1</warehouse_code>
    </order>
    <order>
        <guid>12346</guid>
        <otype>1</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>something</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <receive_from>许勤</receive_from>
        <receive_province>广东</receive_province>
        <receive_city>深圳</receive_city>
        <receive_addres>福田区福中三路市民中心大楼</receive_addres>
        <receive_phone>12345</receive_phone>
        <doorpickup>1</doorpickup>
        <warehouse_code>2</warehouse_code>
    </order>
    <order>
        <guid>12347</guid>
        <otype>9-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>something</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
    </order>
    <order>
        <guid>12348</guid>
        <otype>10-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Jaden Smith</to_local>
        <recipient_addres>322 Edge Street</recipient_addres>
        <recipient_addres_local>322 Edge Street</recipient_addres_local>
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local>United States</recipient_country_local>
        <recipient_province>South Carolina</recipient_province>
        <recipient_province_local>South Carolina</recipient_province_local>
        <recipient_city>Columbia</recipient_city>
        <recipient_city_local>Columbia</recipient_city_local>
        <recipient_postcode>29201</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>something</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
    </order>
    <order>
        <guid>12349</guid>
        <otype>11-0</otype>
        <from>ZENG WEI</from>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>something</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
    </order>
    <order>
        <guid>MGP1704200142254</guid>
        <otype>21-1</otype>
        <warehouse_code>27</warehouse_code>
        <pickup_from_local>苏蕙</pickup_from_local>
        <pickup_addres_local>鼓楼区 新三路987弄3号201室</pickup_addres_local>
        <pickup_province_local>福建省</pickup_province_local>
        <pickup_city_local>福州市</pickup_city_local>
        <pickup_phone>13763813216</pickup_phone>
        <from>subilong</from>
        <sender_addres>GulouQu Darushijai</sender_addres>
        <sender_province>Fujiansheng</sender_province>
        <sender_city>Fuzhoushi</sender_city>
        <sender_phone>13763813216</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kalynn Stiles</to>
        <to_local />
        <recipient_addres>25380 County Rd. 21A</recipient_addres>
        <recipient_addres_local />
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local />
        <recipient_province>California</recipient_province>
        <recipient_province_local />
        <recipient_city>Esparto</recipient_city>
        <recipient_city_local />
        <recipient_postcode>95627</recipient_postcode>
        <recipient_phone>(530)787-3999</recipient_phone>
        <content>Geneva Fashion Women Small Steel Band Analog Quartz Wrist Watch Watches</content>
        <content_chinese>手表</content_chinese>
        <type_no>1</type_no>
        <weight>0.6</weight>
        <num>1</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>3.00</single_price>
        <from_country>China</from_country>
        <user_desc>手表 Deng21 1;</user_desc>
        <trande_no>595db7cb723b301bb9013584</trande_no>
        <trade_amount>3.00</trade_amount>
        <receive_from>苏碧龙</receive_from>
        <receive_province>福建省</receive_province>
        <receive_city>福州市</receive_city>
        <receive_addres>鼓楼区大儒世家</receive_addres>
        <receive_phone>13763813216</receive_phone>
        <doorpickup>1</doorpickup>
        <product_url>https://www.wish.com/c/575d15bb51127360e5c56921</product_url>
        <has_battery>0</has_battery>
    </order>
    <order>
        <guid>12345</guid>
        <otype>33-0</otype>
        <from>ZENG WEI</from>
        <sender_addres>756 ROOM 2 DANYUAN MEILONGYUAN LONGHUA</sender_addres>
        <sender_province>GUANGDONG</sender_province>
        <sender_city>SHENZHEN</sender_city>
        <sender_phone>18620352867</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kali West</to>
        <to_local>Kali West</to_local>
        <recipient_addres>20/37 Gerrale Street</recipient_addres>
        <recipient_addres_local>20/37 Gerrale Street</recipient_addres_local>
        <recipient_country>Australia</recipient_country>
        <recipient_country_short>AU</recipient_country_short>
        <recipient_country_local>Australia</recipient_country_local>
        <recipient_province>New South Wales</recipient_province>
        <recipient_province_local>New South Wales</recipient_province_local>
        <recipient_city>Cronulla</recipient_city>
        <recipient_city_local>Cronulla</recipient_city_local>
        <recipient_postcode>2230</recipient_postcode>
        <recipient_phone>11</recipient_phone>
        <content>LED light</content>
        <content_chinese>发光二极管</content_chinese>
        <type_no>1</type_no>
        <weight>0.15</weight>
        <num>5</num>
        <single_price>2</single_price>
        <from_country>China</from_country>
        <user_desc>asgfdgs</user_desc>
        <trande_no>1534563462</trande_no>
        <trade_amount>11.45</trade_amount>
        <doorpickup>1</doorpickup>
        <warehouse_code>1</warehouse_code>
    </order>
    <order>
        <guid>MGP1704200142254</guid>
        <otype>300-1</otype>
        <from>subilong</from>
        <sender_addres>GulouQu Darushijai</sender_addres>
        <sender_province>Fujiansheng</sender_province>
        <sender_city>Fuzhoushi</sender_city>
        <sender_phone>13763813216</sender_phone>
        <sender_zipcode>310000</sender_zipcode>
        <to>Kalynn Stiles</to>
        <to_local />
        <recipient_addres>25380 County Rd. 21A</recipient_addres>
        <recipient_addres_local />
        <recipient_country>United States</recipient_country>
        <recipient_country_short>US</recipient_country_short>
        <recipient_country_local />
        <recipient_province>California</recipient_province>
        <recipient_province_local />
        <recipient_city>Esparto</recipient_city>
        <recipient_city_local />
        <recipient_postcode>95627</recipient_postcode>
        <recipient_phone>(530)787-3999</recipient_phone>
        <content>Candlestick Deng21</content>
        <type_no>1</type_no>
        <weight>0.300</weight>
        <num>1</num>
        <unit_measurement>item</unit_measurement>
        <unit_measurement_chinese>个</unit_measurement_chinese>
        <single_price>5.00</single_price>
        <from_country>China</from_country>
        <user_desc>烛台 Deng21 1;</user_desc>
        <trande_no>58f797a22a600eb9455ae5e8</trande_no>
        <trade_amount>3.00</trade_amount>
        <receive_from>苏碧龙</receive_from>
        <receive_province>福建省</receive_province>
        <receive_city>福州市</receive_city>
        <receive_addres>鼓楼区大儒世家</receive_addres>
        <receive_phone>13763813216</receive_phone>
        <warehouse_code />
        <doorpickup>1</doorpickup>
        <product_url>https://www.wish.com/c/
        579726aa9a99900b221cb2dc</product_url>
        <has_battery>0</has_battery>
    </order>
</orders>

Success Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <wish_standard_tracking_id guid="12345" state="Created">WOSP000000022891AUS</wish_standard_tracking_id>
    <barcode guid="12345" state="Created">PP001764319BJ</barcode>
    <mark>1e191d851b3b49a248f4ea62f6b06410</mark>
    <PDF_10_EN_URL>http://wishpost.wish.com/api/v2/download_label?access_token
    =f06d703a71e4412aad8a579925aef656&format=10&use_local=false&mark
    =7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_EN_URL>
    <PDF_10_LCL_URL>http://wishpost.wish.com/api/v2/download_label
    ?access_token=f06d703a71e4412aad8a579925aef656&format=10&use_local=true
    &mark=7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_LCL_URL>
</root>

or

<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <wish_standard_tracking_id guid="12345" state="Created">WOSP000000022891AUS</wish_standard_tracking_id>
    <barcode guid="12345" state="Reviewing"></barcode>
    <mark>1e191d851b3b49a248f4ea62f6b06410</mark>
    <PDF_10_EN_URL>http://wishpost.wish.com/api/v2/download_label?access_token
    =f06d703a71e4412aad8a579925aef656&format=10&use_local=false&mark
    =7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_EN_URL>
    <PDF_10_LCL_URL>http://wishpost.wish.com/api/v2/download_label
    ?access_token=f06d703a71e4412aad8a579925aef656&format=10&use_local=true
    &mark=7fcb4b1c5aa611e6932260a44c5bad70</PDF_10_LCL_URL>
</root>


Error Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:54:39</timestamp>
    <status>1</status>
    <error_message>Unauthorized Request</error_message>
</root>

or

<?xml version="1.0" encoding="utf-8"?>
<root>
    <status>2</status>
    <timestamp>2018/05/16 11:59:49</timestamp>
    <error_message guid="0">收件人邮编4501错误,印度的邮编是6位数字,如:456001</error_message>
    <mark>9445c60a58bd11e880c90242ac110005</mark>
    <PDF_10_EN_URL>https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=e7339bc2203f41fdbeaba7c78ba7e37e&amp;format=10&amp;use_local=false&amp;mark=9445c60a58bd11e880c90242ac110005</PDF_10_EN_URL>
    <PDF_10_LCL_URL>https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=e7339bc2203f41fdbeaba7c78ba7e37e&amp;format=10&amp;use_local=true&amp;mark=9445c60a58bd11e880c90242ac110005</PDF_10_LCL_URL>
</root>
        

Order Status


Get order status

API endpoint: https://wishpost.wish.com/api/v3/order_status

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
wish_standard_tracking_ids list 1-500 Wish Standard Tracking Id List

Response

Parameter name Description
timestamp Timestamp
message Message
code Code
wish_standard_tracking_id wish standard tracking id
logistics_order_code Logistics Order Code
state_code State Code
state_name State Name
reference_qrcode Sweden reference QRcode
message Detail Information
PDF_10_EN_URL PDF Label 10*10 English Version Download URL
PDF_10_LCL_URL PDF Label 10*10 Recipient Country Download URL

Appendix

Status Code State Name
0 Error
1 Created
2 Invalid
3 Rejected
4 Canceled
5 Reviewing
6 Accepted
7 Shipping
8 Completed

Example Request

                                
{
  "access_token": "b1c18f0ba16b44c0bf6a16733da4a36f",
  "wish_standard_tracking_ids": [
    "WOSP000644993647IND",
    "WOSP000644993649IND",
    "WOSP000644993648IND",
    "WOSP000000023915USA"
  ]
}

Success Response

                                
{
  "code": 0,
  "message": "All success",
   "orders":  [
       {
          “wish_standard_tracking_id”: “WOSP000644993647IND”
          "logistics_order_code": "EIM980765110",
           “state_name”: “Accepted”,
           “state_code”: 6,
           "reference_qrcode":"",
           "message": "",
           "PDF_10_LCL_URL": "https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=b1c18f0ba16b44c0bf6a16733da4a36f&order_id=5affbfb3ce82d32b327cfd11&use_local=true&format=10",
           "PDF_10_EN_URL": "https://wishpost.corp.contextlogic.com/api/v2/download_label?access_token=b1c18f0ba16b44c0bf6a16733da4a36f&order_id=5affbfb3ce82d32b327cfd11&use_local=false&format=10"
       },
       {
          “wish_standard_tracking_id”: “WOSP000644993649IND”
          "logistics_order_code": "",
          “state_name”: “Canceled”,
          “state_name”: 4,
          "message": "",
          "reference_qrcode":"",
          "PDF_10_LCL_URL": "",
          "PDF_10_EN_URL": ""
       },
       {
          “wish_standard_tracking_id”: “WOSP000644993648IND”
          "logistics_order_code": "",
          “state_name”: “Reviewing”,
          “state_code”: 5,
          "message": "",
          "reference_qrcode":"",
          "PDF_10_LCL_URL": "",
          "PDF_10_EN_URL": ""
       },
       {
            "PDF_10_LCL_URL": "",
            "reference_qrcode":"",
            "message": "invalid post code",
            "state_name": "Rejected",
            "PDF_10_EN_URL": "",
            "logistics_order_code": "",
            "wish_standard_tracking_id": "WOSP000000023915USA",
            "state_code": 3
        },
   ]
}

{
  "code": 0,
  "message": "Some wish_tracking_ids are invalid",
   "orders":  [
       {
          “wish_standard_tracking_id”: “WOSP000644993649IND”
          "logistics_order_code": "",
          “state_name”: “Canceled”,
          “state_code”: 4,
          "PDF_10_LCL_URL": "",
          "PDF_10_EN_URL": ""
       }
   ]
}

Error Response

                                
{
  "timestamp": "2018-03-09 12:24:17",
  "message": "No valid wish_standard_tracking_ids is provided",
  "code": 1001,
  "orders": []
}

 

Label


Generate a Label

API endpoint: https://wishpost.wish.com/api/v2/generate_label

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
api_key string 83-84 Used to verify the identity
printlang int 1 Label Language: 1=English, 2=Recipient Country Native Language
printcode int 1 Label Format (Imperial Units): 2=4×4,3=4×2(Only for DLP)
barcode string 1-16 Barcode

Response

Parameter name Description
Timestamp Timestamp
Status Status
PDF_URL PDF Label Download URL
error_message Error message

Example Request

                                
<?xml version="1.0" ?>
<root>
    <access_token>f06d703a71e4412aad8a579925aef656</access_token>
    <printlang>2</printlang>
    <printcode>1</printcode>
    <barcodes>
        <barcode>01922451085</barcode>
        <barcode>RQ990073255CN</barcode>
    </barcodes>
</root>

Success Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <PDF_URL>https://wishpost.wish.com/api/v2/download_label?access_token
    =f06d703a71e4412aad8a579925aef656&use_local=False&api_orderid
    =bfff4eb25aa731e6923260a44c5bad70&format=10</PDF_URL>
</root>

Error Response

                                
<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:54:39</timestamp>
    <status>1</status>
    <error_message>Unauthorized Request</error_message>
</root>
        

Tracking


Get tracking info

API endpoint: https://wishpost.wish.com/api/v2/tracking

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
api_key string 83-84 Used to verify the identity
barcode string 1-14 Waybill Number
language string 2 Language: CN or EN

Response

Parameter name Description
Time stamp Time stamp
Status Status
barcode Barcode
date Date
status_number Waybill Status Code
status_desc Waybill Status Description
remark Remark
city City
state State
country_code Country Code

Appendix

Status number Description
1 Wishpost order generated
2 Picked up
3 Arrived at the first mile sorting center
4 Processed at the first mile sorting center
5 Departed from the first mile sorting center
6 Returned from sorting center
7 Arrived at Carrier
8 Processed at Carrier
9 Departed from Carrier
10 Returned from Carrier
11 Arrived at customs of original country
12 Failed original country customs inspection
13 Departed from customs of original country
14 Plan to depart from airport to destination country
15 Arrived at airport of the original country
16 Departed from Airport to destination country
17 Arrived at customs of destination country
18 Failed destination country customs inspection
19 Departed from customs of destination country
20 Arrived at destination country
21 Arrived at Delivery Office
22 Attempt to delivery
23 Delivered
24 Sign off the parcel
25 Returned from overseas
27 Track end
28 Arrived at transit hub
29 Departed from transit hub
30 Arrived at destination airport

Example Request

                                
<?xml version="1.0" ?>
<tracks>
    <language>cn</language>
    <track>
        <barcode>85632702094</barcode>
    </track>
    <track>
        <barcode>RW022229594CN</barcode>
    </track>
</tracks>

Success Response

                                

<?xml version="1.0" encoding="utf-8"?>
<root>
    <status>0</status>
    <timestamp>2017/10/11 19:03:41</timestamp>
    <tracks barcode="85632702094">
        <track>
            <date>2017-09-05 10:51:35</date>
            <status_number>1</status_number>
            <status_desc>Wishpost订单已生成</status_desc>
            <remark></remark>
            <city></city>
            <state></state>
            <country_code></country_code>
        </track>
    </tracks>
    <tracks barcode="RW022229594CN">
        <track>
            <date>2017-09-07 15:30:34</date>
            <status_number>1</status_number>
            <status_desc>Wishpost订单已生成</status_desc>
            <remark></remark>
            <city></city>
            <state></state>
            <country_code></country_code>
        </track>
    </tracks>
</root>

Error Response

                                

<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:54:39</timestamp>
    <status>1</status>
    <error_message>一次最多提交10个barcode</error_message>
</root>

<?xml version="1.0" ?>
<root>
    <timestamp>2014-2-7 11:56:09</timestamp>
    <status>0</status>
    <tracks barcode="WS000000141SH" error_message="无此运单号"/>
    <tracks barcode="RH091135288CN" error_message="">
        <track>
            <date>2014-2-5</date>
            <status_number>1</status_number>
            <status_desc>运单已生成</status_desc>
            <remark/>
        </track>
        <track>
            <date>2014-2-5</date>
            <status_number>2</status_number>
            <status_desc>货物入库扫描</status_desc>
            <remark/>
        </track>
    </tracks>
</root>
                    

Channel


Get Channels

API endpoint: https://wishpost.wish.com/api/v3/get_channels

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
channels list 1-100 Wishpost Channel otype List

Response

Parameter name Description
otype Channel otype
channel_name Channel Name
channel_name_en Channel English Name
is_only_online_payment Only Support Online Payment
allow_battery Allow Battery
is_registered Is Registered
pickup_service Pickup Service
support_warehouses Support Warehouse
warehouses Warehouse List
warehouses_return_address Warehouse Return Address

Example Request

                                
{
  "access_token": "b1c18f0ba16b44c0bf6a16733da4a36f",
  "channels": []
}

Success Response

                                
{
    "channels": [
        {
            "support_warehouses": true,
            "channel_name": "WISH邮中国邮政",
            "channel_name_en": "Wishpost - China Post",
            "is_only_online_payment": false,
            "otype": "0",
            "allow_battery": false,
            "pickup_service": {},
            "is_registered": false,
            "warehouses": {
                "1": "Shanghai Warehouse",
                "2": "Guangzhou Warehouse",
                "3": "Shenzhen Warehouse",
                "4": "Yiwu Warehouse",
                "5": "Beijing Warehouse",
                "6": "Nanjing Warehouse",
                "7": "Fuzhou Warehouse",
                "8": "Qingdao Warehouse",
                "9": "Wuhan Warehouse",
                "10": "Dongguan Warehouse",
                "11": "Hangzhou Warehouse",
                "12": "Jinhua Warehouse",
                "13": "Ningbo Warehouse",
                "14": "Wenzhou Warehouse",
                "15": "Xiamen Warehouse",
                "16": "Chongqing Warehouse",
                "17": "Tianjin Warehouse",
                "18": "Suzhou Warehouse",
                "19": "Hefei Warehouse",
                "20": "Changsha Warehouse",
                "21": "Zhengzhou Warehouse",
                "22": "Chengdu Warehouse",
                "23": "Xuchang Warehouse",
                "24": "Quanzhou Warehouse",
                "25": "Foshan Warehouse",
                "26": "Zhangpu Warehouse",
                "29": "Wuxi Warehouse",
                "30": "Nanyang Warehouse",
                "31": "Shijiazhuang Warehouse",
                "32": "Jingzhou Warehouse",
                "33": "Nanchang Warehouse",
                "34": "Dalian Warehouse",
                "35": "Jinan Warehouse",
                "36": "Yichang Warehouse",
                "37": "Nantong Warehouse",
                "38": "Zhongshan Warehouse"
            },
            "warehouses_return_address": {
                "1": "中国邮政集团公司上海市广商局国际小包业务收寄点",
                "2": "广州小包大宗收寄处理中心",
                "3": "深圳市国际大宗邮件处理中心",
                "4": "中国邮政集团公司浙江省义乌市邮购配送公司",
                "5": "北京快速直封中心",
                "6": "中国邮政集团公司南京市邮政函件局",
                "7": "福州中转仓",
                "8": "青岛市邮政局函件广告局销售部受理中心",
                "9": "武汉大宗收寄中心",
                "10": "东莞市邮政局电商包裹局国际小包处理组",
                "11": "中国邮政集团公司杭州市分公司包裹快递部",
                "12": "金华市小包分局",
                "13": "中国邮政集团公司宁波市电商包裹局",
                "14": "温州市两包集中收寄中心",
                "15": "厦门市大宗邮件集中处理中心",
                "16": "中国邮政集团公司重庆市万盛经济技术开发区万东支局",
                "17": "天津大宗邮件收寄处理中心",
                "18": "中国邮政集团公司苏州市大宗邮件处理中心",
                "19": "合肥大宗处理中心",
                "20": "中国邮政集团公司湖南省长沙县函件班",
                "21": "郑州帐单处理中心",
                "22": "成都市邮政局大宗邮件处理中心",
                "23": "许昌市分公司大宗邮件集中收寄处理中心",
                "24": "泉州市邮政函件局",
                "25": "中国邮政集团公司佛山市函件集邮局",
                "26": "漳浦县盘陀邮政支局",
                "29": "中国邮政集团公司无锡市大宗邮件处理中心",
                "30": "南阳市大宗邮件集中收寄处理中心",
                "31": "中邮石家庄仓",
                "32": "荆州区荆中支局",
                "33": "南昌市函件局",
                "34": "大连大宗收寄中心",
                "35": "中国邮政集团公司济南市函件广告局大宗业务中心",
                "36": "宜昌包裹快递部",
                "37": "南通邮政局函件局",
                "38": "中山市邮政局函件集邮局商函广告公司"
            },
            "channel": 1
        },
    ]
}

Error Response

                                
{
    "timestamp": "2018-06-06 13:56:00",
    "message": "API key is unauthorized",
    "code": 4000
}
 

Announcements


Get Announcements

API endpoint: https://wishpost.wish.com/api/v3/announcements

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
start_date string %Y-%m-%d Announcement start date range
end_date string %Y-%m-%d Announcement end date range
offset int 1-100 Fetch announcement start position
limit int 1-50 Fetch announcement count

Response

Parameter name Description
announcement Announcement List
title Announcement Title
url Announcement URL
text Announcement Text
publish_time Announcement Publish Time
pagination Pagination Dict
total Total Count
next Next Page
limit Next Page Count
offset Next Page Offset
previous Previous Page
limit Previous Page Count
offset Previous Page Offset
start_date Announcement start date
end_date Announcement end date

Example Request

                                
{
  "access_token": "b1c18f0ba16b44c0bf6a16733da4a36f",
  "offset": 3,
  "limit": 3,
  "start_date": "2018-09-17",
  "end_date": "2018-10-17"
}

Success Response

                                
{
    "timestamp": "2018-10-22 15:28:36",
    "message": "All success",
    "code": 0,
    "data": {
        "announcements": [
            {
                "url": "https://wishpost.corp.contextlogic.com/announcement?announcement_id=5b8507913691176b431368b7",
                "text": [
                    "Both cn and en"
                ],
                "publish_time": "2018-08-28",
                "title": "Create test"
            },
            {
                "url": "https://wishpost.corp.contextlogic.com/announcement?announcement_id=5b023ebe04ba544051210e9d",
                "text": [
                    "
尊敬的Wish平台商户:
 
您好!
 
近期部分商户在使用Wish官方物流渠道-中邮小包时出现了一些不合规的操作,请各商户进行自查,避免出现类似问题,影响包裹的正常运输。
 
1、包裹面单打印不规范
主要存在邮件条码打印精度过低、面单过小、收件人名址不全等问题。当操作人员发现邮件条码扫描困难、面单小于10cm*10cm的邮件时,会将包裹退回商户,最终会影响订单的整体配送时效,请相应不合规的商户尽快进行调整。
 
2、 包装封装不规范
超小邮件必须包装包装后邮件最大面积不小于10cm*10cm,封装时严禁使用玻璃胶覆盖面单条码部分,对于圆柱形、圆球形、细条尖锐等异形邮件,请使用矩形硬皮包装。
 
3、禁运产品
严禁使用Wish官方物流产品配送粉末类产品、牙签弩等武器类产品。
近期出现的禁运品的寄送,造成航空安检整票扣留,影响67个邮政大包,900KG、约9000+个Wish邮商户包裹运输,请各位商户知晓此类事件的严重性。
 
感谢您使用Wish邮!
 
Wish Post
 


 
"
                ],
                "publish_time": "2018-05-21",
                "title": "History data No.4"
            },
            {
                "url": "https://wishpost.corp.contextlogic.com/announcement?announcement_id=5b023ebe04ba544051210e9e",
                "text": [
                    "
尊敬的Wish平台商户:
 
从2017年6月23日起,中国邮政将停止接收寄往南极、喀麦隆、加那利群岛、关岛、几内亚比绍、马约特岛、密克罗尼西亚、黑山、纽埃岛、帕劳、圣马丁、斯瓦尔巴群岛、叙利亚、托克劳群岛、美国本土外小岛屿、也门、桑给巴尔、布韦岛、赫德岛和麦克唐纳群岛、英属印度洋领地、法属南部和南极领地、圣巴泰勒米岛、库拉索、圣马丁岛等24个地区的邮件。
 
在6月22日及之前已经交给中国邮政的邮件不受影响,会正常寄送。6月23日及之后接收的邮件,中国邮政将会联系商户安排退回。
 
感谢使用Wish邮!
 
Wish Post

 
"
                ],
                "publish_time": "2018-05-21",
                "title": "History data No.5"
            },
        ],
        "pagination": {
            "total": 66,
            "next": {
                "limit": 3,
                "offset": 6
            },
            "previous": {
                "limit": 3,
                "offset": 0
            }
        },
        "extra_data": null,
        "start_date": "2017-09-17",
        "end_date": "2018-10-17"
    }
}

Error Response

                                
{
    "timestamp": "2018-10-22 15:06:04",
    "message": "End date should be later than start date.",
    "code": 1000
}
{
    "timestamp": "2018-10-22 15:27:17",
    "message": "Start date should not be earlier than 30 days ago.",
    "code": 1000
}
 

Scopes


Get Scopes

API endpoint: https://wishpost.wish.com/api/v3/scopes

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token
scope_names list 1-50 Scope Name List

Response

Parameter name Description
resource Scope Resource
name Scope Name
chinese_name Scope Chinese Name
english_name Scope English Name
role Scope Role
attribute Scope Attribute
action Scope Action
apis Scope Api List

Example Request

                                
{
  "access_token": "e7339bc2203f41fdbeaba7c78ba7e37e",
  "scope_names": []
}

Success Response

                                
{
    "scopes": [
        {
            "resource": "order",
            "name": "user.order.read",
            "apis": [
                "/api/v2/generate_label",
                "/api/v3/order_status",
                "/api/v3/get_channels"
            ],
            "chinese_name": "读取订单",
            "role": "USER",
            "english_name": "Read Order Info",
            "attribute": "PUBLIC",
            "action": "READ"
        },
        {
            "resource": "order",
            "name": "user.order.write",
            "apis": [
                "/api/v2/create_order",
                "/api/v2/generate_label",
                "/api/v3/create_order"
            ],
            "chinese_name": "创建订单",
            "role": "USER",
            "english_name": "create order",
            "attribute": "PUBLIC",
            "action": "WRITE"
        },
        {
            "resource": "tracking",
            "name": "user.tracking.read",
            "apis": [
                "/api/v2/auth_test",
                "/api/v2/tracking"
            ],
            "chinese_name": "读取轨迹",
            "role": "USER",
            "english_name": "Read Tracking",
            "attribute": "PUBLIC",
            "action": "READ"
        }
    ],
    "message": "Success",
    "code": 0,
    "timestamp": "2018-12-15 14:17:59"
}

Error Response

                                
{
    "scopes": [],
    "message": "Success",
    "code": 0,
    "timestamp": "2018-12-15 14:26:17"
}
 

Payment


Get Account Info

API endpoint: https://wishpost.wish.com/api/v3/account_info

Explore API

Parameters

Parameter name Type Length Description
access_token string 1-50 Access token

Response

Parameter name Description
total Total Balance
unavailable Unavailable
debt_frozen Frozen Debt
debt_remaining Remaining Debt
debt_limit Debt Limit
currency Currency
withdrawable Withdrawable Amount
debt Debt
remaining Remaining Cash

Example Request

                                
{
  "access_token": "e7339bc2203f41fdbeaba7c78ba7e37e"
}

Success Response

                                
{
  "timestamp": "2019-03-14 15:55:38",
  "message": "",
  "code": 0,
  "data": {
    "total": "99294.25",
    "unavailable": "60112.67",
    "debt_frozen": "-140.54",
    "debt_remaining": "无上限的",
    "debt_limit": "无上限的",
    "currency": "人民币",
    "withdrawable": "39181.58",
    "debt": "-1636.97",
    "remaining": "39181.58"
  }
}

Error Response

                                
{
  "timestamp": "2019-03-14 17:43:26",
  "message": "API key is unauthorized",
  "code": 4000
}