kuaidihelp 快递公司寄件助手\r

\r

功能\r

• 查价 （查运费/预估运费） \r
• 查物流信息 （查物流轨迹） \r
• 寄件 （寄快递/创建订单） \r
• 取消订单\r \r

环境变量配置\r

查询物流信息，每天有一定的额度，当额度使用完了，就需要到，快宝开放平台注册账号并获取专属 API Key和 ID，然后将 Key和 ID ,配置环境变量 KUAIDIHELP_API_KEY, KUAIDIHELP_API_ID 即可继续使用。\r

export KUAIDIHELP_API_KEY= xxxxxxxxxxxxxxxx\r
export KUAIDIHELP_API_ID= xxxxxxxxxxxxxxxx\r
~~~\r
## 品牌映射\r
申通(sto)，中通(zt)，圆通(yt)，韵达(yd)，ems(ems) ,邮政(postx)，极兔(jt)，京东(jd)，百世(ht)，同城(kbtc)，天天(tt)，丰网(fw)，顺丰(sf)，国通(gt)，众邮(zykd)，德邦(dp)，中通快运(ztky)，安能快运(ane)，壹米滴答(bt)，丹鸟(dn)，顺心捷达(sxjd)，京广速递(kk)，优速快递(ys)，菜鸟速递(cnsd)，笨鸟速运(bn)\r
\r
## 工具使用步骤\r
1. 首先确认用户意图，用户需要查询的功能。\r
2. 然后收集指定功能接口的请求参数，参数完整时，请求指定接口回复用户问题，参数不完整时，提示用户提供缺失的参数。\r
### 一. 报价查询(预估运费)\r
**接口描述**: 通过收寄件人的相关信息，及物品信息，预估运费或者相关运费的查询。\r
\r
**接口参数**:\r
- sender_province (必填) :寄件人所在省份名称\r
- sender_city     (必填) :寄件人所在城市名称\r
- sender_district (必填) :寄件人所在地区（区\县\镇）\r
- sender_address    (必填):寄件人详细地址\r
- recipient_province (必填):收件人所在省份名称\r
- recipient_city (必填):收件人所在城市名称\r
- recipient_district (必填):收件人所在地区（区\县\镇）\r
- recipient_address (必填):收件人详细地址\r
- package_volume (选填) :重量（默认1kg）\r
- package_weight (选填) :体积 \r
\r
**接口调用**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"\x3Csender_province>\",\"city\":\"\x3Csender_city>\",\"district\":\"\x3Csender_district>\",\"address\":\"\x3Csender_address>\"},\"recipient\":{\"province\":\"\x3Crecipient_province>\",\"city\":\"\x3Crecipient_city>\",\"district\":\"\x3Crecipient_district>\",\"address\":\"\x3Crecipient_address>\"},\"pay_type\":\"2\",\"volume\":\"\x3Cpackage_volume>\",\"weight\":\"\x3Cpackage_weight>\"}'\r
~~~\r
**示例**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"广东省\",\"city\":\"佛山市\",\"district\":\"南海区\",\"address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"province\":\"浙江省\",\"city\":\"嘉兴市\",\"district\":\"秀洲区\",\"address\":\"城东路2000号26幢商铺234号海螺电玩\"},\"pay_type\":\"2\",\"volume\":\"\",\"weight\":\"\"}'\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py quotation '{\"sender\":{\"province\":\"广东省\",\"city\":\"佛山市\",\"district\":\"南海区\",\"address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"province\":\"浙江省\",\"city\":\"嘉兴市\",\"district\":\"秀洲区\",\"address\":\"城东路2000号26幢商铺234号海螺电玩\"},\"pay_type\":\"2\",\"volume\":\"1\",\"weight\":\"1\"}'\r
~~~\r
\r
\r
### 二. 物流查询\r
**接口描述**: 通过运单号查询物流信息，当接口返回需要手机尾号时，提示让用户提供尾号。\r
\r
**接口参数**:\r
\r
- waybill_codes_str (必填): 运单号，多个单号之间用","隔开（英文逗号）,最多支持10条\r
- phone_str (选填) : 特定快递公司需要传手机号码后四位尾号，中通：优先用发件人手机号码后四位，如果查询不到可以使用收件人手机号码后四位，京东和顺丰使用收件人手机号码后四位\r
\r
**接口调用**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"\x3Cwaybill_codes_str>\",\"phone\":\"\x3Cphone_str>\",\"result_sort\":\"0\"}'\r
~~~\r
\r
**示例**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"YT8852860437699\",\"phone\":\"\",\"result_sort\":\"0\"}'\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"YT8852860437699,JT3009968654034\",\"phone\":\"\",\"result_sort\":\"0\"}' \r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py logistics '{\"waybill_codes\":\"772058582798206\",\"phone\":\"6515\",\"result_sort\":\"0\"}'\r
~~~\r
\r
### 三. 寄快递(创建订单)\r
**接口描述**:此接口是收集下单所需的收寄件人信息，接口返回下单的图片二维码，用户需微信扫码进行下单操作。\r
\r
**接口参数**:\r
- shipper_province_str (必填): 寄件人所在省份名称\r
- shipper_city_str (必填) : 寄件人所在城市名称\r
- shipper_district_str (必填) : 寄件人所在地区（区\县\镇）\r
- shipper_address_str  (必填) : 寄件人详细地址\r
- shipper_name_str (必填): 寄件人名称\r
- shipper_mobile_str (必填):寄件人手机号码\r
- shipping_province_str (必填):收件人所在省份名称\r
- shipping_city_str (必填): 收件人所在城市名称\r
- shipping_district_str (必填): 收件人所在地区（区\县\镇）\r
- shipping_address_str (必填): 收件人详细地址\r
- shipping_name_str (必填):收件人名称\r
- shipping_mobile_str (必填):收件人手机号码\r
- package_info_str (选填): 物品描述\r
- package_weight_str (选填): 物品重量\r
- package_note_str (选填): 物品备注\r
- package_pics_str (选填):物品图片\r
- brand_str (必填):快递品牌简称，例如 zt 、sto...\r
- place_volume_str (选填):下单体积（长宽高乘积）\r
- reserve_start_time_str (选填): 预约取件时间（开始）\r
- reserve_end_time_str (选填): 预约取件时间（结束）\r
- arrivePay_str (选填):是否到付（0否 1是） 默认1\r
\r
**接口调用**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py order '{\"sender\":{\"shipper_province\":\"\x3Cshipper_province_str>\",\"shipper_city\":\"\x3Cshipper_city_str>\",\"shipper_district\":\"\x3Cshipper_district_str>\",\"shipper_address\":\"\x3Cshipper_address_str>\",\"shipper_name\":\"\x3Cshipper_name_str>\",\"shipper_mobile\":\"\x3Cshipper_mobile_str>\"},\"recipient\":{\"shipping_province\":\"\x3Cshipping_province_str>\",\"shipping_city\":\"\x3Cshipping_city_str>\",\"shipping_district\":\"\x3Cshipping_district_str>\",\"shipping_address\":\"\x3Cshipping_address_str>\",\"shipping_name\":\"\x3Cshipping_name_str>\",\"shipping_mobile\":\"\x3Cshipping_mobile_str>\"},\"package_info\":\"\x3Cpackage_info_str>\",\"package_weight\":\"\x3Cpackage_weight_str>\",\"package_note\":\"\x3Cpackage_note_str>\",\"package_pics\":\"\x3Cpackage_pics_str>\",\"brand\":\"\x3Cbrand_str>\",\"place_volume\":\"\x3Cplace_volume_str>\",\"reserve_start_time\":\"\x3Creserve_start_time_str>\",\"reserve_end_time\":\"\x3Creserve_end_time_str>\",\"arrivePay\":\"1\"}'\r
~~~\r
**示例**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py order '{\"sender\":{\"shipper_province\":\"广东省\",\"shipper_city\":\"佛山市\",\"shipper_district\":\"南海区\",\"shipper_address\":\"南海大道北翠云苑二座802\"},\"recipient\":{\"shipper_name\":\"李忧危\",\"shipper_mobile\":\"15302374691\",\"shipping_province\":\"浙江省\",\"shipping_city\":\"嘉兴市\",\"shipping_district\":\"秀洲区\",\"shipping_address\":\"城东路2000号26幢商铺234号海螺电玩\",\"shipping_name\":\"程序螺\",\"shipping_mobile\":\"15657366015\"},\"package_info\":\"\",\"package_weight\":\"\",\"package_note\":\"\",\"package_pics\":\"\",\"brand\":\"sto\",\"place_volume\":\"\",\"reserve_start_time\":\"\",\"reserve_end_time\":\"\",\"arrivePay\":\"1\"}'\r
~~~\r
**输出要求**\r
\r
- 将接口生成的下单图片二维码地址，展示成可点击的网址。\r
- 只输出下单的基本信息和点击的二维码网址，其他信息不输出。\r
\r
### 四. 取消订单\r
**接口描述**: 通过用户提供的 快递品牌，快宝订单号或者第三方订单号 ,取消订单\r
\r
**接口参数**:\r
- shipper_type_str(必填): 品牌首字母（例如：zt,sto...）\r
- order_id_str (选填): 快宝单号\r
- third_order_id_str (选填): 第三方订单号 （取消订单 使用快宝订单号或者 第三方订单号二选一 ）\r
- reason_str (选填): 取消理由\r
\r
**接口调用**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"\x3Cshipper_type_str>\", \"order_id\": \"\x3Corder_id_str>\", \"third_order_id\":\"\x3Cthird_order_id_str>\", \"reason\":\"\x3Creason_str>\"}'\r
~~~\r
**示例**\r
~~~bash\r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"zt\", \"order_id\": \"1204076252008035\", \"third_order_id\":\"\", \"reason\":\"\"}' \r
OPENCLAW_ALLOW_UNSAFE_EXEC=1 python scripts/kuaidihelp.py cancel '{\"shipper_type\": \"zt\", \"order_id\": \"\", \"third_order_id\":\"1204076252008033\", \"reason\":\"\"}' \r
~~~\r