docs(first-leg): allow optional courier tracking on express drafts

This commit is contained in:
2026-10-19 17:46:01 +08:00
parent 7ec2f45a10
commit 6426c020a1
@@ -132,7 +132,7 @@
| `shipperSnapshot` | 我司提货时提交必填 | 仅取货方式为 `PICKUP` 时保存提货公司、联系人、电话和地址快照;自送快递、自送卡车不要求 |
| `consigneeCounterpartyId` | 可选 | 兼容后台往来单位引用;企业客户端下单不强制选择 |
| `consigneeSnapshot` | 私人仓时提交必填 | 仅目的仓类型为 `PRIVATE` 时保存私人收件地址快照;FBA 仓、海外仓使用所选公共仓主数据,不重复填写收件资料 |
| `deliveryInfo` | 平台维护 | 可选履约信息,包含快递公司 ID/快照和快递单号;企业客户端只读 |
| `deliveryInfo` | 平台维护 | 包含快递公司 ID/快照和快递单号;客户仅在快递自提(SELF_EXPRESS)下单或编辑草稿时可选填 `expressTrackingNo`(最长 128 字符),复用现有快递单号字段与详情回读;其他状态只读 |
| `transportMode` | 提交必填 | FCL、LCL、AIR、ROAD |
| `businessType` | 提交必填 | 订单与客户支持 EXPORT、IMPORT |
| `origin` | 提交必填 | 起运地或起运港 |
@@ -309,6 +309,8 @@
订单列表包含订单号、参考号、运输方式、起运地、目的地、状态、负责人、预计时间和更新时间;支持关键词、状态、运输方式和创建日期筛选。
头程下单取货方式按“卡车自送、我司提货、快递自提”排序。仅快递自提显示选填快递单号;服务端去除首尾空白,空值清空,其他取货方式不保存单号。复制订单时清空单号,避免复用上一票快递信息。
创建页按以下顺序组织:
1. 运输信息和平台收货仓;
@@ -317,7 +319,7 @@
4. 客户备注;
5. 保存草稿或提交审核;提交前校验企业资料已经平台人工审核通过。
详情页展示订单摘要、发货方/收货方快照、货物明细、服务端时间线、履约快递公司、快递单号和当前可用操作。内部备注、成本和平台内部操作信息不得进入客户响应;企业客户端不能修改快递信息或往来单位档案。
详情页展示订单摘要、发货方/收货方快照、货物明细、服务端时间线、履约快递公司、快递单号和当前可用操作。内部备注、成本和平台内部操作信息不得进入客户响应;企业客户端仅能在快递自提下单或编辑草稿时选填快递单号,不能维护快递公司或往来单位档案。
### 管理后台
@@ -339,7 +341,7 @@
- 往来单位查询只返回当前企业可见且已启用的发货单位和收货单位;跨数据范围 ID 在保存草稿和提交时均被拒绝。
- 往来单位改名、改地址或停用后,历史订单继续展示下单时快照;停用单位不能用于新订单提交。
- 快递公司编码和名称满足唯一规则;停用公司不能新增到履约信息,历史订单继续展示已保存快照。
- 客户端订单详情只读展示快递公司和快递单号,接口不得接受客户修改履约快递信息。
- 客户端订单详情只读展示快递公司和快递单号;客户仅可在快递自提下单或编辑草稿时选填单号,不可修改快递公司或已提交订单的快递信息。
- 我的信息只能读取当前登录成员;修改所属公司或其他成员资料的伪造请求必须拒绝,修改密码必须校验当前密码并写入安全审计。
- 注册成功后无需审核即可登录;公司信息只返回当前企业数据,未通过企业资料审核时服务端拒绝提交订单,审核通过后允许提交。普通成员无写权限时仍可按授权查看,资质文件下载使用受控地址并覆盖过期、缺失、上传失败和无权限状态。
- 快递公司和往来单位批量导入仅允许具备对应导入权限的后台人员调用;企业客户端和普通写权限不能绕过独立导入权限。