### Example Order Submission Payload Source: https://yundaex.apifox.cn/api-7039548 An example JSON payload demonstrating a complete order submission, including authentication details and order specifics. This serves as a practical guide for integrating with the Yunda API. ```json { "appid": "999999", "partner_id": "201700101001", "secret": "123456789", "orders": [ { "collect_branch": "", "collection_value": 126.5, "cus_area1": "", "cus_area2": "", "isProtectPrivacy": "", "items": [ { "name": "衣服", "number": 1, "remark": "袜子" } ], "khddh": "2012121715001", "node_id": "350", "order_serial_no": "2012121715001", "order_type": "common", "platform_source": "", "receiver": { "address": "上海市，青浦区，盈港东路 6679 号", "city": "上海市" } } ] } ``` -------------------------------- ### YundaEX API Success Example (Response) Source: https://yundaex.apifox.cn/api-7039548 Provides a sample successful response from the YundaEX API. This example includes a success code, message, and detailed order information, including shipping details and status. ```json { "code": "0000", "message": "请求成功", "result": true, "data": [ { "order_serial_no": "0000019876576897", "pdf_info": "[[{\"order_id\":\"5160533654\",\"order_serial_no\":\"test_191021002\",\"partner_id\":\"2017001068\",\"partner_orderid\":\"test_191021002\",\"order_type\":\"common\",\"mailno\":\"4060005469862\",\"customer_id\":\"\",\"sender_name\":\"王小虎\",\"sender_company\":\"凯利\",\"sender_area_ids\":\"\",\"sender_area_names\":\"江苏省，徐州市，新沂市\",\"sender_address\":\"湖东路999号\",\"sender_postcode\":\"221435\",\"sender_phone\":\"021-85926525\",\"sender_mobile\":\"13761960078\",\"sender_branch\":\"201700\",\"receiver_name\":\"陆大有\",\"receiver_company\":\"千千\",\"receiver_area_ids\":\"310118\",\"receiver_area_names\":\"上海市,上海市,青浦区\",\"receiver_address\":\"上海市青浦区盈港东路6633号\",\"receiver_postcode\":\"201700\",\"receiver_phone\":\"020-57720341\",\"receiver_mobile\":\"13761960075\",\"receiver_branch\":\"200230\",\"weight\":\"11.00\",\"remark\":\"\",\"status\":\"rs10\",\"time\":\"2019-10-21 11:16:26\",\"position_no\":\"G096-00 20\",\"position_zz\":\"0\",\"options\":\"\",\"send_num\":\"0\",\"nb_ckh\":\"2001123\",\"cus_area1\":\"订单号:test_191021002\n订单号：123 \n批次号：456212\",\"cus_area2\":\"\",\"position\":\"300\",\"receiver_flag\":\"1\",\"package_wd\":\"J200000\",\"callback_id\":\"\",\"wave_no\":\"\",\"node_id\":\"\",\"ems_flag\":\"\",\"cus_area3\":\"\",\"trade_code\":\"\",\"shi1\":null,\"sheng1\":null,\"shi2\":\"310100\",\"sheng2\":\"310000\",\"collection_value\":\"100.00\",\"value\":\"20.00\",\"zffs\":\"0\",\"innerProvinceName\":\"省内件\",\"package_wdjc\":\"集包地：上海分拨包 \",\"sender_branch_jc\":\"青浦区分拨\",\"bigpen_code\":\"G096-00\",\"lattice_mouth_no\":\"20\",\"mailno_barcode\":\"406000546986204240\",\"tname\":\"mailtmp_s12\",\"dispatch_code\":\"20\",\"qrcode\":\"4060005469862/300 G096-00 20\",\"privacy_receiver_name\":\"陆**\",\"privacy_receiver_phone\":\"020-****0341\",\"privacy_receiver_mobile\":\"137****0075\"},[\"0424\",0]]]", "mailno": "5300010219368", "status": "1", "remark": null } ] } ``` -------------------------------- ### API Success Response Example (JSON) Source: https://yundaex.apifox.cn/api-7039553 An example of a successful API response, demonstrating the expected format and values for code, message, result, and data. ```json { "result": true, "code": "0000", "message": "接收成功", "data": { "orderid": "14437042180846542" } } ``` -------------------------------- ### E-commerce Order Submission Example (JSON) Source: https://yundaex.apifox.cn/api-7039556 An example JSON payload for submitting an e-commerce order to the Yundaex API. It includes details such as order serial number, sender and receiver information, item details, and various order markings like insurance, duties, and COD. ```json { "appid": "999999", "partner_id": "201700101001", "secret": "123456789", "orders": [ { "collect_branch": "", "collection_value": 126.5, "cus_area1": "", "cus_area2": "", "isProtectPrivacy": "", "items": [ { "name": "衣服", "number": 1, "remark": "袜子" } ], "khddh": "2012121715001", "node_id": "350", "order_serial_no": "2012121715001", "order_type": "common", "platform_source": "", "receiver": { "address": "上海市，青浦区，盈港东路 6679 号", "city": "上海市", "company": "", "county": "青浦区", "mobile": "17601206977", "name": "李四", "province": "上海市" }, "remark": "", "sender": { "address": "上海市，青浦区，盈港东路 7766 号", "city": "上海市", "company": "", "county": "青浦区", "mobile": "17601206977", "name": "张三", "province": "上海市" }, "size": "0.12,0.23,0.11", "special": 0, "value": 126.5, "weight": 0, "multi_pack": { "mulpck": "", "total": 0, "endmark": 0 }, "markingInfos": [ { "type": "INSURED", "markingValue": { "value": 2100 } }, { "type": "DF", "markingValue": { "value": 15 } }, { "type": "COD", "markingValue": { "value": 15 } }, { "type": "RETURN", "markingValue": { "value": "1,2" } }, { "type": "PRI" }, { "type": "VIR" }, { "type": "MUL", "markingValue": { "value": 10 } }, { "type": "CONTACT" } ] } ] } ``` -------------------------------- ### API Response Example (Failure) Source: https://yundaex.apifox.cn/api-7039552 This example demonstrates a typical failure response from the Yundaex API. It includes fields for result status, error code, a descriptive message, and sub-code/sub-message for more granular error details. The 'required' field indicates mandatory elements in a valid response. ```json { "result": false, "code": "7777", "message": "内部接口服务失败", "sub_code": "s10", "sub_msg": "参数校验不合法" } ``` -------------------------------- ### Yundaex API Successful Order Creation Example Source: https://yundaex.apifox.cn/api-7039548 This snippet demonstrates a successful response from the Yundaex API for order creation. It includes details like order serial number, PDF info, mail number, status, and a success message. This is part of the 'Electronic Waybill' functionality. ```json { "code": "0000", "message": "请求成功", "result": true, "data": [ { "order_serial_no": "0000019876576897", "pdf_info": "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", "mailno": "5300010219368", "status": "1", "remark": null, "msg": "订单创建成功" } ] } ``` -------------------------------- ### Yundaex API Failed Order Creation Example Source: https://yundaex.apifox.cn/api-7039548 This snippet illustrates a failed response from the Yundaex API for order creation. It includes error details such as a code, message, sub-code, and sub-message, indicating the reason for failure. This is also related to the 'Electronic Waybill' functionality. ```json { "result": false, "code": "7777", "message": "内部接口服务失败", "sub_code": "s10", "sub_msg": "参数校验不合法" } ``` -------------------------------- ### 微信小程序跳转其他小程序 Source: https://yundaex.apifox.cn/doc-345776 使用 `wx.navigateToMiniProgram` API 可以实现从小程序跳转到另一个小程序。需要提供目标小程序的 `appId` 和页面路径。本示例展示了跳转到韵达快递小程序的配置。 ```javascript { "navigateToMiniProgramAppldList": [ "wxdeb5309aa3e93fd1" ] } ``` -------------------------------- ### 散件下单接口 Source: https://yundaex.apifox.cn/api-7039552 Interface for placing orders for individual items. ```APIDOC ## POST /order/v1/piece ### Description This endpoint allows you to place an order for individual items. ### Method POST ### Endpoint /order/v1/piece ### Parameters #### Query Parameters - **customer_id** (string) - Required - The ID of the customer placing the order. - **recipient_name** (string) - Required - The name of the recipient. - **recipient_phone** (string) - Required - The phone number of the recipient. - **recipient_address** (string) - Required - The address of the recipient. #### Request Body - **items** (array) - Required - A list of items to be included in the order. - **item_id** (string) - Required - The ID of the item. - **quantity** (integer) - Required - The quantity of the item. ### Request Example ```json { "items": [ { "item_id": "item123", "quantity": 2 }, { "item_id": "item456", "quantity": 1 } ] } ``` ### Response #### Success Response (200) - **order_id** (string) - The unique identifier for the created order. - **status** (string) - The current status of the order (e.g., "PENDING", "PROCESSING"). #### Response Example ```json { "order_id": "ord789", "status": "PENDING" } ``` ``` -------------------------------- ### Piece Order - Place Order API Source: https://context7_llms API for placing new piece orders. ```APIDOC ## POST /api/piece_order/place_order ### Description This endpoint is used to place new piece orders. ### Method POST ### Endpoint /api/piece_order/place_order ### Parameters #### Request Body - **order_details** (object) - Required - Contains the details of the order. - **sender_name** (string) - Required - Name of the sender. - **sender_address** (string) - Required - Address of the sender. - **receiver_name** (string) - Required - Name of the receiver. - **receiver_address** (string) - Required - Address of the receiver. - **package_info** (object) - Required - Information about the package. - **weight** (number) - Required - Weight of the package. ### Request Example { "order_details": { "sender_name": "Sender Name", "sender_address": "Sender Address", "receiver_name": "Receiver Name", "receiver_address": "Receiver Address", "package_info": { "weight": 1.5 } } } ### Response #### Success Response (200) - **order_id** (string) - The ID of the placed order. - **tracking_number** (string) - The tracking number for the shipment. #### Response Example { "order_id": "ORDER123456789", "tracking_number": "TY987654321CN" } ``` -------------------------------- ### Get PDF Parameters Source: https://yundaex.apifox.cn/api-7039546 Retrieves PDF parameter information, which can be returned as JSON data or encrypted JSON data based on customer requirements. ```APIDOC ## GET /pdf/parameters ### Description Retrieves PDF parameter information. The response can be in JSON format or encrypted JSON format, tailored to customer needs. ### Method GET ### Endpoint /pdf/parameters ### Parameters #### Query Parameters - **mail_no** (string) - Required - The tracking number for the shipment. ### Response #### Success Response (200) - **code** (string) - Response status code, '0000' indicates success. - **message** (string) - Success or error message. - **result** (boolean) - Indicates if the request was successful. - **data** (array) - An array of objects containing shipment details. - **order_serial_no** (string) - The order serial number. - **pdf_info** (string) - Encrypted or formatted PDF information. - **mail_no** (string) - The tracking number. - **status** (string) - The status of the shipment ('1' for success, '0' for failure). - **remark** (null) - Additional remarks, can be null. - **msg** (string) - A message indicating success or failure. #### Response Example ```json { "code": "0000", "message": "请求成功", "result": true, "data": [ { "order_serial_no": "0000019876576897", "pdf_info": "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 "mail_no": "5300010219368", "status": "1", "remark": null, "msg": "订单创建成功" } ] } ``` #### Error Response (Non-200 Status Codes) - **code** (string) - Response status code, '0000' indicates success. - **message** (string) - Success or error message. - **result** (boolean) - Indicates if the request was successful. - **data** (array) - An empty array or an array with error details. #### Error Response Example ```json { "code": "1001", "message": "无效的运单号", "result": false, "data": [] } ``` ``` -------------------------------- ### GET /openapi-api/order Source: https://yundaex.apifox.cn/api-7039553 Retrieves a list of orders with tracking information. This endpoint is used to fetch order details and their current logistics status. ```APIDOC ## GET /openapi-api/order ### Description Retrieves a list of orders with tracking information. This endpoint is used to fetch order details and their current logistics status. ### Method GET ### Endpoint /openapi-api/order ### Parameters #### Query Parameters - **orderId** (string) - Required - The ID of the order to retrieve. ### Response #### Success Response (200) - **code** (string) - Response code. - **message** (string) - Response message. - **result** (boolean) - Indicates if the operation was successful. - **data** (array) - An array of order objects. - **orderId** (string) - The ID of the order. #### Response Example ```json { "result": true, "code": "0000", "message": "接收成功", "data": [ { "orderid": "14437042180846542" } ] } ``` ``` -------------------------------- ### POST /api/orders Source: https://yundaex.apifox.cn/api-7039552 Creates a new shipping order. Requires detailed sender, receiver, and item information. ```APIDOC ## POST /api/orders ### Description This endpoint allows you to create a new shipping order by providing all necessary details for the sender, receiver, and the package. It returns a success or failure status along with tracking information. ### Method POST ### Endpoint /api/orders ### Parameters #### Request Body - **appid** (string) - Required - Application ID. - **backparam** (string) - Required - Additional parameter for callbacks. - **backurl** (string) - Required - URL for callback notifications. - **freight** (number) - Optional - Shipping freight cost. - **items** (array) - Required - List of items in the shipment. - **name** (string) - Required - Name of the item. - **number** (integer) - Required - Quantity of the item. - **remark** (string) - Optional - Remark for the item. - **other_charges** (number) - Optional - Other charges associated with the shipment. - **premium** (integer) - Optional - Premium service indicator. - **receiver** (object) - Required - Receiver's information. - **address** (string) - Required - Receiver's street address. - **city** (string) - Required - Receiver's city. - **company** (string) - Optional - Receiver's company name. - **county** (string) - Required - Receiver's county or district. - **mobile** (string) - Required - Receiver's mobile number. - **name** (string) - Required - Receiver's full name. - **phone** (string) - Optional - Receiver's landline phone number. - **postcode** (string) - Optional - Receiver's postal code. - **province** (string) - Required - Receiver's province. - **remark** (string) - Required - General remark for the order. - **sendendtime** (string) - Optional - Desired delivery end time (yyyy-MM-dd HH:mm:ss). - **sender** (object) - Required - Sender's information. - **address** (string) - Required - Sender's street address. - **city** (string) - Required - Sender's city. - **company** (string) - Optional - Sender's company name. - **county** (string) - Required - Sender's county or district. - **mobile** (string) - Required - Sender's mobile number. - **name** (string) - Required - Sender's full name. - **phone** (string) - Optional - Sender's landline phone number. - **postcode** (string) - Optional - Sender's postal code. - **province** (string) - Required - Sender's province. - **sendstarttime** (string) - Required - Desired pickup start time (yyyy-MM-dd HH:mm:ss). - **size** (string) - Optional - Package dimensions (length,width,height) separated by commas. - **special** (integer) - Required - Type of goods (refer to goods type field). - **value** (number) - Optional - Declared value of the goods. - **weight** (integer) - Optional - Weight of the goods. - **orderid** (string) - Required - Unique identifier for the order. ### Request Example ```json { "appid": "000001", "backparam": "散单测试", "backurl": "", "freight": 10, "items": [ { "name": "衣服", "number": 1, "remark": "袜子" } ], "other_charges": 0, "premium": 1, "receiver": { "address": "青浦区盈港东路 6679 号", "city": "上海市", "company": "", "county": "青浦区", "mobile": "17601205970", "name": "李四", "phone": "", "postcode": "string", "province": "上海市" }, "remark": "string", "sendendtime": "2019-09-03 11:00:00", "sender": { "address": "盈港东路 7766 号", "city": "上海市", "company": "string", "county": "青浦区", "mobile": "17601205970", "name": "张三", "phone": "", "postcode": "", "province": "上海市" }, "sendstarttime": "2019-09-03 10:00:00", "size": "0.12,0.23,0.11", "special": 0, "value": 126.5, "weight": 0, "orderid": "14437042180846542" } ``` ### Response #### Success Response (200) - **code** (string) - Response code. - **message** (string) - Response message. - **result** (boolean) - Indicates if the request was successful. - **data** (array) - Array of results for each processed order. - **order_serial_no** (string) - Customer order number. - **pdf_info** (string) - PDF information or encrypted data. - **mail_no** (string) - Waybill number. - **status** (string) - Status of the order (1 for success, 0 for failure). - **remark** (null) - Remark field. - **msg** (string) - Success or error message. - **orderId** (string) - Order ID. #### Response Example ```json { "result": true, "code": "0000", "message": "请求成功", "data": [ { "order_serial_no": "", "pdf_info": "string", "mail_no": "string", "status": "1", "remark": null, "msg": "", "orderId": "14437042180846542" } ] } ``` #### Error Response (e.g., 400 Bad Request) - **result** (boolean) - Indicates failure. - **code** (string) - Error code. - **message** (string) - Error message. ```