Open Platform(API)

v8.0


Open Platform is an open platform based on the sales business. Provide the our partners and customers products information, order information, shipping charge calculation , parcel tracking information and so on , users can easily integrated into our website or system, to realize the seamless connection of all the information.

How to Use

1
First of all, you need to have a account
2
.Enter into the user center enable the API service, access to get the secret key(Identifier)
3
The API service request Address: "http://网址/webservice/APIWebService.asmx"

Authorization


  • First

    .Use API need to apply from the user center,the system will generate an identifier automatically,the identifier can be blocked up or changed.
  • Second

    API Can only take out your own account information.

Function


API user authorization types

need

Acquire the country names


  1. Application scenarios: queries supported by the by the state
  2. Function Name:getCountry(secretkey)
  3. Submit parameters:secretkey(API Key)
  4. Authorization: need
  5. Return:JSON

Input parameters

Field Type Whether must Default Description Example
Secretkey String Must Key d0fc2606-611f-443a-aea2-aa209673a32c10000

Return result

Field Type Whether must Default Description Example
ShortName String Must The national shorthand AF
EnName String Must Country English name Afghanistan
Cnname String Must Country Chinese name 阿富汗
Base_placeId String Must Country Code 20

Error code

Field Type Whether must Example Description
complete Boolean No true The success of that submission

API sample tool

For Example

.NET For Example

  1. First step:In your own project:asp.net,add web quotation,Provide the API service website address offered by. Be assumed to be:"{Website}/webservice/APIWebService.asmx"
  2. Second step:Initialization,then use the method,can obtain the data
    mzl.apiwebservice p=new mzl.apiwebservice();
    string result = p.getCountry(secretkey);

Returns the sample

 [{"ShortName":"AF","EnName":"Afghanistan","Cnname":"\u963F\u5BCC\u6C57","Base_placeId":"20"}]

Search supporting service modes


  1. Application of scene:Gets a list of valid means of transport(Chinese name,English name,code,delivery time,icon)
  2. Function:getChannel(secretkey)
  3. Submit parameters:secretkey(API Key)
  4. Authorization: need
  5. Return:JSON

Input parameters

Field Type Whether must Default Description Example
Secretkey String Must Key d0fc2606-611f-443a-aea2-aa209673a32c10000

Return result

Field Type Whether must Default Description Example
Base_ChannelInfoID String Must Channel code 46
ChannelCode String Must Transport code CNDHL
CnName String Must Transport Chinese name 大陆DHL普货价
EnName String Must Transport English name CNDHL
Reftime String Must Prescription 2 - 4
ShortenImage String Optional Transport icons 635195880046832907_dhl.gif

Error Code

Field Type Whether must Example Description
complete Boolean No true The success of that submission

API sample tool

For Example

.NET For Example

  1. First step:In your own project:asp.net,add web quotation,Provide the API service website address offered .Be assumed to be: "{Website}/webservice/APIWebService.asmx"
  2. Second step:Initialization,then use the method,can obtain the data
    mzl.apiwebservice p=new mzl.apiwebservice();
    string result = p.getChannel (secretkey);

Returns the sample

 [{"base_Channelinfoid":"46","ChannelCode":"CNDHL","CnName":"\u5927\u9646DHL\u666E\u8D27\u4EF7","enname":"CNDHL","reftime":"2 - 4","shortenimage":"635195880046832907_dhl.gif"}

Shipping query


  1. Application of scene:According to the country and the weight and volume to get all transportation prices(Transportation Chinses name CHCnName,English name.
  2. CHEnName,code ChannelCode,delivery time RefTime,icon,totao amount MinSaleAmountTotal)
  3. Function name:getFeeByCWV(string country,stringweight,stringvolume,stringcustomerid, string secretkey)
  4. If you can identify the account of the total cost of discount
  5. Submit the parameter:country code, weight, volume, customerID ,scretkey --identifier
  6. Authorization: need
  7. Back:JSON

Input parameters

Field Type Whether must Default Description Example
country String Must Country code Austria-澳大利亚
Weight String Must Weight 0.25(kg)
Volume String Must Volume 0.25cm³
Customer ID String Must Customer ID 10000
Identifier String Must Key d0fc2606-611f-443a-aea2-aa209673a32c10000

Return result

Field Type The return value Description
CHCnName string 香港邮政航空大包 Service Chinese name
CHEnName string HKBPOST Service English name
ChannelCode string HKBPOST Channel code
RefTime string 7 - 14 Reference prescription
MinSaleAmountTotal string 109.740 Total amount

Error Code


API sample tool

For Example

.NET For Example

  1. First step:In your own project:asp.net,add web quotation,Provide the API service website address offered.Be assumed to be:"{Website}/webservice/APIWebService.asmx"
  2. Second step:Initialization,then use the method,can obtain the data
    mzl.apiwebservice p=new mzl.apiwebservice();
    string result = p.getFeeByCWV(country,weight, volume,stringcustomerid, secretkey);

Returns the sample

    [{"CHCnName":"\u9999\u6E2F\u90AE\u653F\u822A\u7A7A\u5927\u5305","CHEnName":"HKBPOST","ChannelCode":"HKBPOST","RefTime":"7 - 14","MinSaleAmountTotal":"200.620"} 

Parcel information checking


  1. Application of scene:Get through the order number or a tracking number(order state,total amount,order number,tracking number)
  2. Function name:getPackage(string orderNo,stringcustomerid, string secretkey)
  3. Submit the parameter:strwhere(order number or tracking number), customerid(customerID),scretkey(Key)
  4. Authorization: need
  5. Return:JSON

Input parameters

Field Type Whether must Default Description Example
OrderNo String Must Order No R100001407290002
CustomerId String Must Customer number 10000
SecretKey String Must Key d0fc2606-611f-443a-aea2-aa209673a32c10000
Remark String Optional Remark Null

Return result

Field Type The return value Description
OrderNo String R100001407290002 Order No
TrackingNo String RS12345678910 Tracking number
field1 String 234234 Turn number
OrderStatus String 6 Order status 1
OrderStatus2 String 已发货 Order status 2
TotalAmount String 6027.250 The total cost
EnName String Albania Recipient countries
ChannelCode String GBPOST Channel Code

Error code


API sample tool

For Example

.NET For Example

  1. First step:In your own project:asp.net,add web quotation,Provide the API service website address offered.Be assumed to be:"{Website}/webservice/APIWebService.asmx"
  2. Second step:Initialization,then use the method,can obtain the data
    mzl.apiwebservice p=new mzl.apiwebservice();
    string result = p.getPackage(orderNO, string customerid, secretkey);

Returns the sample

[{"OrderNo":"R100001411160002","TrackingNo":"DDU1371690781102767","field1":"","OrderStatus2":"\u5DF2\u53D1\u8D27","TotalAmount":"26.500","ChannelCode":"GBPOST","EnName":"Argentina","OrderStatus":"6"}] 

Create Order


  1. Application scenarios: users can set up by API order information into the system
  2. The requested address: "{Website}/webservice/APIWebService.asmx"
  3. Authorization: need
  4. The input parameters:Such as

Input parameters

Field Type Whether must Default Description Example
Secretkey String Must Key d0fc2606-611f-443a-aea2-aa209673a32c10000
OrderType String Must Order types(Fulfillment orders or Ordinary orders)Fulfillment orders is 1,Ordinary orders is 2 2
CustomID String Must Customer ID 10000
ConsigneeName String Must The recipient name