打印箱唛修改 尾程垮桥事件提交

firstleg/src/main/resources/openapi/firstleg-v1.yaml

@@ -6,6 +6,26 @@ info:
 security:
   - bearerAuth: []
 paths:
+  /api/merchant/v1/first-leg/inbounds/{inboundId}/carton-label-pdf:
+    post:
+      summary: 客户端生成本客户入库单箱唛 PDF
+      parameters:
+        - {name: inboundId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: cartonIndex, in: query, required: false, schema: {type: array, items: {type: integer, minimum: 1}}}
+      responses:
+        '200': {description: PDF 文件}
+        '403': {description: 非客户端身份、无订单查看权限或入库单不属于当前客户}
+  /api/merchant/v1/first-leg/orders/{orderId}/carton-label-pdf:
+    post:
+      summary: 客户端按订单生成本客户草稿或正式订单箱唛 PDF
+      description: 后端按登录客户和 orderId 查找真实预入库单；不要求客户端先取得 inboundId。
+      parameters:
+        - {name: orderId, in: path, required: true, schema: {type: string, pattern: '^[1-9][0-9]*$'}}
+        - {name: cartonIndex, in: query, required: false, schema: {type: array, items: {type: integer, minimum: 1}}}
+      responses:
+        '200': {description: PDF 文件}
+        '403': {description: 非客户端身份、无订单查看权限或订单不属于当前客户}
+        '404': {description: 订单尚未生成预入库单}
   /internal/firstleg/v1/customer-dimension-configs/defaults:
     post:
       summary: 幂等初始化客户四箱规默认配置