# Upload logistics information

Interface should be called on the server side, seeHattori API。

# Interface Dxplaination

# Interface name

uploadShippingInfo

# Functional description

1. Call this interface to upload logistics information
2. This interface is used for merchants to access shopping order business. After the merchant is connected, it helps the user to view the/Manage orders within WeChat, track order progress, obtain after-sales service, etc. Users can follow up from WeChatI-service-Wallet-billYou can also backtrack the purchase order by entering the billing details page from the payment voucher message.
3. Specific service introduction and complete access guide can be found at Shopping Order。

# Note

1. According to the specified order number type, different parameters are used to upload the order information for the specified order. When uploading logistics information for the order, it must be consistent with when uploading order information.
   • In the form of merchant side order number (enumerating value 1), an order is determined by placing single merchant number and merchant side order number.
   • WeChat Pay order number (enumerating value 2), through WeChat Pay order number to determine an order
2. Delivery mode selected according to the specific delivery situation
   • Unified shipment (enumerate value 1), one order unified shipment, only one logistics order number, this type no longer need to specify the goods in the package
   • Split shipment (enumerate value 2), one order split shipment, including multiple logistics order numbers. You need to specify the specific items contained in each logistics list. System usageUpload Shopping DetailsTo identify specific goods by using the "merchant side product ID" in the
3. Logistics company code, seeAccess to capacity id Listget_delivery_list
4. Upload time, used to identify the order of the request, if you want to update the logistics information, upload time must be updated than the previous request, please fill in the Rfc3399 format
5. Logistics information must be uploaded after payment is completed

# Calling mode

# HTTPS call

POST https://api.weixin.qq.com/user-order/orders/shippings?access_token=ACCESS_TOKEN 

# Third Party Invocation

• The calling method and parameters are the same as HTTPS, only the calling token is different

• The permission sets to which this interface belongs are: 120, 121, 142

• After the service provider has been authorized with one of the permission sets, it can do so by usingauthorizer_access_TokenCalling on behalf of the merchant

# Request parameters

# Return parameters

# Call Example

Example Dxplaination: JS Fetch API

# Sample Request Data

// Assemble URL
let url = `https://api.weixin.qq.com/user-order/orders/shippings`


// Json Package
let jsonBody = {}
jsonBody["order_key"] = {
   初始值_number_type": "WXPAY_TRADE_NUMBER",
   "transaction_id": "nep9a",
   "mchid": "8wu3m",
   "out_trade_no": "x5mr9"
}
jsonBody["delivery_mode"] = "SPLIT_DELIVERY"
jsonBody["shipping_list"] = [
   {
      "tracking_no": "323244567777",
      "express_company": "DHL",
      "item_list": [
         {
            "merchant_item_id": "1246464644"
         },
         {
            "merchant_item_id": "1246464644"
         初始值
         {
            "merchant_item_id": "1246464644"
         }
      ],
      "contact": {
         "consignor_contact": 初始值**2-******23-10",
         "receiver_contact": "****123-8008"
      }
   },
   {
      "tracking_no": "323244567777",
      "express_company": "DHL",
      "item_list": [
         {
            "merchant_item_id": "1246464644"
         },
         {
            "merchant_item_id": "1246464644"
         },
         {
            "merchant_item_id": "1246464644"
         }
      ],
      "contact": {
         "consignor_contact": "0**2-***1234",
         "receiver_contact": "0**2-******23-10"
      }
   }
]
jsonBody["upload_time"] = "2021-05-20T13:29:35.120 08:00"
jsonBody["pay"] = {
   "opens": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
}

// Set the header
let headers = {"Content-Type": "application/json"}


// Send Request
fetch(url, {
  body: JSON.stringify(jsonBody),
  headers: headers,
  method: "POST"
})
  .then(response => response.json())
  .then(response => console.log("Success:", JSON.stringify(response)))
  . catch(error => console.error("Error:", error)) 

# Return Data Example

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

# Error code