# Introduction to Logistics Query Plugin

Logistics query plug-inIt is a business operation tool provided by WeChat. By calling the plug-in, the merchant can display the order logistics information in the Mini Program, and send a message to the user when the logistics status changes. Follow the instructions below to access and introduce in your Mini ProgramLogistics Query ModuleCan be achieved. If you encounter any problems during use, you canWeChat Open Community Post communication.

# Application for qualification and regulatory penalties

• Mini Programs that meet all of the following conditions are eligible for application:
  You need to open a Mini Program of WeChat payment
  2, past 30 There's a deal.
  Category (internal test is not required)
  
• Frequency limitation
  

1. One appid Up to 10w second/day
   The maximum number of calls made by a user 100 times/day
   

• Supervision and penalties
  

1. Query only supportedOn the Mini Program that references the plug-inThe logistics order that produces the order.
   
2. Support only toSubscribe to WeChat Express ServiceAnd the actual order to send a message.
   If the regulation is violated, the corresponding penalties, including but not limited to reducing the frequency of calls, disable plug-in capabilities, etc.
   

# Introduction of plugin

Use theThird party platform interface call token authorizer_access_tokenTo call the interface.

# 1. Logistics query plug-inHow to introduce

Declare in apagejson of the Mini Program

"logisticsPlugin": {
      "version": "2.1.5",
      "provider": "wx9ad912bf20548d92"
}

# 2. Logistics query plug-inHow to use

Then introduce a plug-in package, such as test. js, into the js file that needs to use the plug-in api

Plugin API Name: openWaybillTracking Parameter is waybillToken: Pass theBackground interface(- ：https://api.weixin.qq.com/cgi-bin/express/delivery/open_msg/trace_waybill?access_token=XXX)Returned waybill_Token (developers store, and then use this token to query logistics list) Call example:

where plugin = requirePlugin("logisticsPlugin")

Page({
	data:{
		waybillToken: '', //Values obtained through the background interface
	},
	// Here by calling the api to query WeChat express service details
	searchDetail:(){
		const {waybillToken} = this.data
 		plugin.openWaybillTracking({
     			waybillToken: waybillToken
		})
	}
})

# Background API Interface Dxplaination

QuotedLogistics inquiryPlug-in businesses, before they can call the background API。

# 1. Interface authentication

WeChat API interface default use access_Token for interface authentication. So you need to add the parameter access after all the API interface addresses_token。 For example: The original call address is:https://api.weixin.qq.com/cgi-bin/test/api Finally, the actual address of the call needs to add access_The token parameter, which is: https://api.weixin.qq.com/cgi-bin/test/api?access_Token = xxxxxx Of which access_For the generation and management of tokens, seeBackground Interface Call Credential Dxplaination

# 2. List of interfaces

# Waybill interface trace_waybill

• Description: Merchants use this interface to provide WeChat with a transaction number corresponding to the waybill number. WeChat background will track the status of the waybill changes
• Request method: POST application/json
• Address requested:https://api.weixin.qq.com/cgi-bin/express/delivery/open_msg/trace_waybill?access_token=XXX
• Request parameters

*This update: sender_phone，receiver_phone。

Among goods_Info is as follows:

Among goods_info.detail_Each item on the list reads as follows:

• Return parameters

• Example Request parameters

{
  "openid":"ovtZW4yB7DIj3CxOb6ii-nk4HhFo",
  "waybill_id":"WXTESTEXPRESS0000014",
  "transmitter_phone":"12345678901" ,
  "receiver_phone":"123456566" ,
  "goods_info":{
  	"detail_list":[
     {
       "goods_Name ":" test name, "
       "goods_img_url":"www.qq.com"
     },
     {
       "goods_Name ":" Test Name 2, "
       "goods_img_url":"www.qq.com"
     }
    ]
  }
}

Return parameters

{
    "errcode": 0,
    "errmsg": "ok",
    "waybill_token": "the_ARWHaxIxzWHmdui-AIw9KBr8qNnbmc08V0KhDyXE-IMLo6AcOqJkPsNLcLzfTb"
}

# Query waybill interface query_trace

• Description: the merchant calls in the end trace_Waybill interface, you can use this interface to query the details of the corresponding waybill
• Request method: POST application/json
• Address requested:https://api.weixin.qq.com/cgi-bin/express/delivery/open_msg/query_trace?access_token=XXX
• Request parameters

• Return parameters

Which waybill_The info is as follows:

Which shop_Info is as follows:

Which shop_info.goods_Info is as follows:

Which shop_info.goods_info.detail_Each entry in the list is as follows

Of which delivery_Info is as follows:

• Example Request parameters

{
  "waybill_token":"o_ARWHaxIxzWHmdui-AIw8SuE1QtaUZK8aUnZguAn1nsZ72ZjWlq8btV8j-wAc94",
  "openid":"ovtZW4yB7DIj3CxOb6ii-nk4HhFo"
}

Return parameters

{
    "errcode": 0,
    "errmsg": "ok",
    "waybill_info": {
        "status": 0,
        "waybill_id": "WXTESTEXPRESS0000014"
    },
    " shop_info": {
        "goods_info": {
            "detail_list": [
                {
                    "goods_name": "Test name,"
                    "goods_img_url": "www.qq.com"
                },
                {
                    "goods_name": "Test Name 2,"
                    "goods_img_url": "www.qq.com"
                }
            ]
        }
    }
}

# Update logistics information interface update_waybill_goods

• Description: Update item information
• Request method: POST application/json
• Address requested:https://api.weixin.qq.com/cgi-bin/express/delivery/open_msg/update_waybill_goods?access_token=XXX
• Request parameters

Among goods_Info is as follows:

Among goods_info.detail_Each item on the list reads as follows:

• Return parameters

• Example Request parameters

{
  "waybill_token":"o_ARWHaxIxzWHmdui-AIw8SuE1QtaUZK8aUnZguAn1nsZ72ZjWlq8btV8j-wAc94",
  "openid":"ovtZW4yB7DIj3CxOb6ii-nk4HhFo",
  "goods_info":{
     "detail_list":[
        {
         "goods_Name ":" test update product " ,
         "goods_img_url":"www.qq.com"
        }
     ]
  }
}

Return parameters

{
    "errcode": 0,
    "errmsg": "ok"
}

# 3. Interface error code

# 4. Waybill Status