Files
baiyue-firstleg/warehouse-overseas-service/src/main/resources/openapi/pallet-label-v1.yaml
T

36 lines
1.8 KiB
YAML
Raw Normal View History

2026-09-15 14:18:18 +08:00
openapi: 3.0.3
info:
title: Overseas pallet label
version: 1.0.0
paths:
/api/platform/v1/warehouse-admin/{warehouseId}/pallets/{id}/label:
get:
operationId: printOverseasPalletLabel
summary: 下载指定托盘的一页标签 PDF
2026-09-16 15:21:08 +08:00
description: 平台公共资源,要求 platform:overseas-warehouse:pallet:list。校验仓库和托盘归属后,有 FBA 仓码的托盘统一调用 Print FBA_PALLET_A4_LANDSCAPE_V1(297×210mm),顶部显示 SCK8 等 FBA 仓码,托盘完整编码同时作为 Code 128 内容和底部文字;内部编号如 141 原样保留。FBA 编码限 1–80 位可打印 ASCII,禁止首尾空格。不创建或修改托盘。其他托盘继续使用其现有 INBOUND_MARK_V1(100×100mm,编码限 1–34 位)。
2026-09-15 14:18:18 +08:00
security:
- bearerAuth: []
parameters:
- { name: warehouseId, in: path, required: true, schema: { type: integer, format: int64 } }
- { name: id, in: path, required: true, schema: { type: integer, format: int64 } }
- { name: X-Request-Id, in: header, required: false, schema: { type: string } }
responses:
'200':
description: 成功返回单页 PDF;业务失败返回 JSON 信封(A0403、A0404、A0422 或 S0503)。
content:
application/pdf:
schema: { type: string, format: binary }
application/json:
schema:
type: object
required: [code, message]
properties:
code: { type: string }
message: { type: string }
requestId: { type: string }
'401': { description: 未认证 }
'403': { description: 权限不足 }
components:
securitySchemes:
bearerAuth: { type: http, scheme: bearer, bearerFormat: JWT }