# 参数说明

## 地址 JSON（--sender / --recipient）

```json
{
  "address": "北京市朝阳区融新科技中心A座",  // 完整地址，楼号直接拼入此字段
  "houseNumber": "",                          // 固定留空，填写会触发风控（11004~11008）
  "lat": 40019368,                            // 纬度，整数×1e6
  "lng": 116469191,                           // 经度，整数×1e6
  "name": "",                                 // 固定留空，填写会触发风控
  "phone": "138xxxx5678",                     // 联系电话（地址簿返回的脱敏号码可直接使用）
  "cityId": 110100                            // 城市ID，见城市表
}
```

> ⚠️ `houseNumber` / `name` / `remark` 必须留空，填写会触发风控（11004~11008）。

**单地址场景**（取号/帮搬/帮扔/医院帮忙/其他帮忙）：`--sender` 和 `--recipient` 传同一个地址 JSON。

---

## 物品 JSON（--goods）

```json
{
  "goodsName": "文件",
  "goodsWeight": 1,          // 物品实际重量（公斤数），值是多少就是多少公斤，如 15 表示 15kg。重量越大配送费越贵
  "goodTypes": [4],          // 物品类型数组
  "goodTypeNames": ["文件"]  // 物品类型名称数组（与 goodTypes 一一对应）
}
```

| 用户描述关键词 | goodTypes | goodTypeNames | goodsWeight 默认值 |
|---|---|---|---|
| 餐饮、外卖、食物、饭、菜、奶茶、饮料 | `[2]` | `["餐饮"]` | 1 |
| 文件、合同、资料、单据、证件、文书 | `[4]` | `["文件"]` | 1 |
| 生鲜、水果、蔬菜、肉、海鲜 | `[3]` | `["生鲜"]` | 2 |
| 蛋糕、甜品 | `[9]` | `["蛋糕"]` | 2 |
| 鲜花、花束、花 | `[1]` | `["鲜花"]` | 1 |
| 数码、手机、电脑、平板、耳机、电子产品 | `[5]` | `["数码"]` | 1 |
| 服饰、衣服、鞋、包、服装 | `[7]` | `["服饰"]` | 1 |
| 快递、包裹、箱子 | `[8]` | `["快递"]` | 2 |
| 五金、工具、零件、螺丝、管件 | `[2]` | `["五金"]` | 2 |
| 汽配、汽车配件、车零件 | `[2]` | `["汽配"]` | 3 |
| 其他、物品、东西、不明确 | `[8]` | `["其他"]` | 1 |

> ⚠️ `goodsWeight` 值即公斤数。如用户明确说"15公斤"，传 `15`；说"5公斤左右"，传 `5`。默认值仅供参考，**以用户实际告知为准**。

---

## businessType 与 bizTypeSceneTag

`businessType` 只有两个合法值，**严禁传 3/4/5/6**（会导致 10002 错误）：

| 用户意图 | --business-type | --biz-type-scene-tag |
|---|---|---|
| 帮取送文件/物品（A→B） | 1 | 0（默认） |
| 餐厅取号 | 1 | 1 |
| 医院帮忙 | 1 | 2 |
| 其他取号 | 1 | 3 |
| 帮搬装 | 1 | 4 |
| 其他帮忙 | 1 | 5 |
| 帮扔杂物 | 1 | 6 |
| 帮买东西 | 2 | 0 |

**purchaseGoodDetail**：帮买场景（businessType=2）**必传**，如 `"一瓶矿泉水"`。其他场景留空。

---

## businessTypeTag

`businessTypeTag` 与 `bizTypeSceneTag` 是两个完全独立的参数，无关联。**仅在帮买场景（businessType=2）下生效**，用于区分购买地址来源：

| 场景 | --business-type-tag | 含义 |
|------|---------------------|------|
| 帮买 - 用户指定购买地址 | `0` | 骑手前往 `--sender` 指定地址购买 |
| 帮买 - 就近购买 | `1` | 骑手自行决定购买地点，`--sender` 传收件地址 |
| 帮取送（businessType=1） | `0` | 不适用 |

---

## 城市表

默认使用**北京**。用户提到城市时查此表获取 `cityId` 和参考坐标。

| 城市 | cityId | --city | lat | lng |
|------|--------|--------|-----|-----|
| 北京 | 110100 | 北京 | 39904200 | 116407400 |
| 上海 | 310100 | 上海 | 31231700 | 121472600 |
| 广州 | 440100 | 广州 | 23129100 | 113264400 |
| 深圳 | 440300 | 深圳 | 22543000 | 114057900 |
| 成都 | 510100 | 成都 | 30572700 | 104066500 |
| 杭州 | 330100 | 杭州 | 30274200 | 120153600 |
| 武汉 | 420100 | 武汉 | 30592800 | 114305500 |
| 南京 | 320100 | 南京 | 32060300 | 118796400 |
| 西安 | 610100 | 西安 | 34341600 | 108939500 |
| 重庆 | 500100 | 重庆 | 29563000 | 106551600 |

> ⚠️ lat/lng 为城市中心参考坐标，仅用于 `search_poi` 提升精度，不作为下单地址坐标。不在表中的城市直接告知用户不支持。

---

## 坐标格式

整数×1e6（如 40.019368° → 40019368）。地址簿返回的 `lat`/`lng` 已是此格式，**可直接用于下单，无需转换**。