Files
baiyue-firstleg/warehouse-overseas-service/src/main/resources/openapi/pallet-label-v1.yaml
T
2026-09-16 15:21:08 +08:00

36 lines
1.8 KiB
YAML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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
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 位)。
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 }