提交

lastleg-service/src/main/resources/openapi/fleet-trips-v1.yaml

@@ -11,7 +11,7 @@ info:
     车辆和司机资格、容量与实际占用由服务端复验；候选可用不表示已预留，临时外配证据依排车主单规则核验。
     调度审核后经理货审核才可真实扫码；PDA拣货核平后，平台和PDA均可确认装车完成及实际发车。
     发车前整车派送安排须完整，正常签收汇总推进排车派送完成；既有异常业务和附加资源能力保留。
-    货物结案不自动释放车辆或司机；各资源任务分别提交实际结束时间、地点和原因，车辆另确认结束状态。
+    全车派送完成自动结案并释放车辆和司机，不需要二次确认；提货全部到仓及本土卡车完成同事务释放，保留车辆主档状态。
     版本、幂等、客户隔离及事务要求以各实际端点及排车公共契约为准；历史数量不授权当前分配。
 security:
   - bearerAuth: []
@@ -290,14 +290,14 @@ paths:
     parameters: [{$ref: '#/components/parameters/TripNo'}]
     post:
       summary: 核对全部货物并结案车次
-      description: '权限：platform:fleet:trip:complete；仅IN_TRANSIT，实发数量由全部已签收或已真实退回派送单覆盖；拒收、待退回、取消不算终态完成。不改写客户单、不新增收费、不释放资源；同键同内容重放，旧版本或不同内容拒绝。'
+      description: '权限：platform:fleet:trip:complete；仅IN_TRANSIT，实发数量由全部已签收或已真实退回派送单覆盖；拒收、待退回、取消不算终态完成。不改写客户单、不新增收费、同事务自动释放车辆和司机；同键同内容重放，旧版本或不同内容拒绝。'
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/Complete'}}}}
       responses: {'200': {$ref: '#/components/responses/Detail'}}
   /api/platform/v1/last-leg/fleet/trips/{tripNo}/resources/release:
     parameters: [{$ref: '#/components/parameters/TripNo'}]
     post:
       summary: 单独结束车辆或司机本次任务并释放占用
-      description: '权限：platform:fleet:trip:release；货物结案后才允许；实际结束时间不早于货物完成且不晚于当前时间，地点及原因必填。车辆状态与释放同事务更新；司机可继续返程而保持占用。原请求重放不释放后来另一个车次的占用。'
+      description: '权限：platform:fleet:trip:release；货物结案后才允许；实际结束时间不早于货物完成且不晚于当前时间，地点及原因必填。该入口仅保留处理未释放记录，当前完成流程自动释放，不要求二次确认。原请求重放不释放后来另一个车次的占用。'
       requestBody: {required: true, content: {application/json: {schema: {$ref: '#/components/schemas/Release'}}}}
       responses: {'200': {$ref: '#/components/responses/Detail'}}
 components: