Integrate the authorization interface code of intra city distribution account of multiple express companies nationwide - Express 100

One 、 Intra city distribution account authorization interface

Obtain the merchant account authorization code through third-party authorization

1.1 Interface format

Provide a uniform format for HTTP POST or GET Call interface , And return to the unified format JSON data .

1.2 Request address

https://order.kuaidi100.com/sameCity/order

Request parameters ：

Parameter name	If required	type	explain
method	yes	string	Business types （ Default ：auth）
key	yes	string	Authorization code , Express, please 100 Page application enterprise version interface access https://api.kuaidi100.com/register
sign	yes	string	32 Bit capital , Signature , For authentication , Press MD5 (param +t+key+ secret) In the order of MD5 encryption , No need to add “+” Number secret There's in the authorization email
t	yes	string	Timestamps such as ：1576123932000
param	yes	param	Spliced by other fields

param data structure ：

Parameter name	If required	type	explain
com	yes	string	Courier Services Company , All in small letters , See parameter dictionary
storeId	yes	string	Authorized stores id
callbackUrl	yes	String	The information callback address of the information after authorization

1.3 Return results

Field	type	explain	remarks
result	boolean	Submit results	true Submit successfully ,false Failure
returnCode	string	Return code
message	string	Return message description
data	data

data data structure

Field	type	explain	remarks
url	string	Authorization link

1.4 Provide data content

{

  "returnCode": "200",

  "result": true,

  "message": " Submit successfully ",

  "data": {

   "url": "http://open.s.bingex.com/auth?response_type=code&client_id=ssTQhMCPkKfdz38Le&state=null&scope=shop_open_api&thirdStoreId=null&redirect_uri=http://api.kuaidi100.com/callback/ss/auth"

  }

}

explain ： Click the link to enter the authorization , Log in to the account of the corresponding service provider to complete the authorization ; After the authorization is successful, the page will jump , Save the corresponding parameters , Used to place an order ;

1.5 Information code meaning

Information code	Information content description	Reasons and suggestions for treatment
200	success	success
400	Parameter error, etc	The submitted data is incomplete , Check that the submitted format is x-www-form-urlencoded Of post Format
500	Server error	Courier 100 There is a gap or temporary exception on the server , Sometimes if the request is not submitted according to the specification , For example, the parameters of the express company are not filled in according to the document regulations , This error will also be reported
501	Repeated submission	Courier 100 There is a gap or temporary exception on the server , Sometimes if the request is not submitted according to the specification , For example, the parameters of the express company are not filled in according to the document regulations , This error will also be reported
503	Failed to verify signature	Please check the encryption ,param + t + key+ secret In the order of MD5 encryption , After encryption, the string is converted to uppercase
601	key Has expired	There is no single quantity available , The account needs to be recharged

Two 、 Authorization callback interface

After successful authorization, the authorization information will be automatically recalled .

2.1 Interface format

Provide a uniform format for HTTP POST or GET Call interface , And return to the unified format JSON data .

2.2 Request address

https://order.kuaidi100.com/sameCity/order

Request parameters ：

Parameter name	If required	type	explain
param	yes	string	Parameter body

2.3 Return results

Field	type	explain	remarks
result	boolean	Submit results	true Submit successfully ,false Failure
returnCode	string	Return code
message	string	Return message description
data	data

data data structure

Field	type	explain	remarks
partnerId	string	to grant authorization partnerId
partnerKey	String	to grant authorization key
com	String	Express company code
expireTime	String	Expiration time

2.4 Provide data content

Input example

{

  "returnCode": "200",

  "result": true,

  "message": " Submit successfully ",

  "data": {

    "com": "shansong",

    "partnerId": " 863B2B9A8A934014B39E1B237D2AD7D3",

    "expireTime": "2022-03-12 17:16:25"

  }

} 

Request to return results

{

  		"returnCode": "200",

  		"result": true,

  		"message": " success "

}

2.5 Push response message and error code interpretation

Field name	Field meaning
result	true It means success ,false It means failure . If the address of the callback interface fails to be submitted ,30 Call back after minutes ,3 Times still failed , Give up automatically
returnCode	200: Submit successfully 500: Server error Please define other errors by yourself
message	Prompt returned

One 、 Product introduction

Intra city distribution services API It is a set of solutions for enterprises and express companies . Through the interface, the enterprise can 、 Online retailers 、 Wechat Business 、 Express outlets 、 Collection point and other regular mail users , The price is low , And it can automatically distribute the solution for riders to take parts .

Two 、 City Distribution API Application scenarios

Self owned brand merchants , For businesses with development capabilities , It can be connected to its own background system ;

Platform service provider , For independent third-party software and hardware 、 Plug-ins, etc. ISV partners , Provide standardized applications ;

3、 ... and 、 City Distribution API Charging mode

1. Charging method

The intra city distribution service uses the prepaid payment method , Charge by order , stay <a href="https://api.kuaidi100.com/register/enterprise" target="_blank"> register API account number </a> Later <a href="https://api.kuaidi100.com/service/local" target="_blank"> View the package </a> And buy a single quantity .

2. Charge price

Please see the table below for the charging standard of intra city distribution service ：

Price / element	Intra city delivery order quantity	The unit price / element
5000	130000	about 0.038
2000	45000	about 0.044
1000	18000	about 0.055
500	6500	about 0.076
200	2500	0.08

Every time the enterprise successfully calls the interface , Will deduct the order quantity , If the single quantity has been deducted , Need to recharge to buy .

3. Invoicing

Courier 100 It supports issuing VAT invoices , After the purchase, the user can go to the enterprise management background - Cost center - Payment record - Request Invoicing . By default, an electronic VAT ordinary invoice will be issued ,1000 Special VAT invoices can be issued if the amount is more than RMB .

Official documents ：

http://api.kuaidi100.com/document/606436974344bf6fb00db217.html

http://api.kuaidi100.com/document/60643820122cae053a5f6f52.html