Ecommerce platforms
面向卖家和仓库后端的 Amazon FBA 标签 API
基于卖家或仓库数据生成 Amazon FBA 风格的商品、箱唛和入仓标签 PDF，支持矢量条码和模板化输出。
主 API JSON Render
ENDPOINT
/api/v1/pdf/render 适用系统 卖家工具 / 仓库后端 / FBA 备货服务 / 电商运营系统
要解决的问题
在你的卖家、备货或仓库系统已经确定标识符、条码内容和标签规则之后，为 Amazon FBA 备货流程生成商品、箱唛或入仓标签 PDF。
什么时候用这个 API
- 你的系统已经有 FNSKU、箱唛、入仓货件或备货服务所需的标签数据。
- 卖家后台或仓库打印工位需要以 PDF 输出矢量条码标签。
- 你希望把复用的标签版式沉淀为 Template Render 合同。
- 备货、审计或异常处理场景需要可重复生成的标签重打。
它不替代什么
- 你需要 gPdf 提供官方 Amazon 集成、应用或 SP-API connector。
- 你需要 Amazon 通过 gPdf 对标签做认证。
- 你需要库存、刊登或货件计划管理能力。
应该调用哪个 endpoint
/api/v1/pdf/render
JSON Render 是这个场景的默认调用路径。
/api/v1/template-render
当流程需要相关 API、模板契约或能力查询时再使用。
最小请求示例
POST /api/v1/pdf/render - 带 FNSKU 风格条码内容的商品标签。
{
"pages": [
{
"width": 70,
"height": 35,
"elements": [
{
"type": "text",
"x": 4,
"y": 4,
"content": "FNSKU X00ABC1234",
"style": { "font_size": 8, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "X00ABC1234",
"x": 4,
"y": 12,
"width": 60,
"height": 12,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 4,
"y": 29,
"content": "SKU: ACME-FILTER-01",
"style": { "font_size": 6, "font_family": "NotoSans-Regular" }
}
]
}
]
}
gPdf 负责什么
- 基于 JSON Render payload 生成标签尺寸的 PDF。
- 绘制矢量条码、文本、SKU 区块、边框，并绑定模板。
- 通过 Template Render 输出复用标签。
- 为打印工位、卖家工具或仓库流程返回 PDF。
你的系统负责什么
- Amazon 账号集成、SP-API 调用、货件计划数据、FNSKU 值和站点规则。
- 正确的条码内容、标签尺寸、商品数据和扫描验收。
- 卖家端体验、备货流程、存储和重打授权。
上线前检查
- 渲染前确认当前 marketplace 和履约要求。
- 在生产标签纸上验证条码内容和实际打印质量。
- 把 Amazon 集成和凭证处理留在 gPdf 之外。
- 保存源标签数据，保证重打结果可确定。
- 将已审核的版式迁移到 Template Render，供打印工位集成使用。
能力边界
- gPdf 不是官方 Amazon 应用，也不是 SP-API connector。
- gPdf 负责渲染 PDF；Amazon 合规和卖家流程规则仍由你的系统负责。
- 不要把 PDF 渲染等同于 Amazon 标签认证。
FBA 标签本质是数据驱动的 PDF 标签
Amazon FBA 备货流程经常需要商品标签、箱唛或入仓货件标签。渲染问题本身很直接：你的系统提供标识符和标签规则，gPdf 负责生成 PDF。
把 marketplace 集成和渲染分开处理。先在卖家系统或仓库系统中获取或计算正确的标识符，再把最终标签 payload 发送给 gPdf。
Endpoint 选择
默认调用 /api/v1/pdf/render。当版式仍在调整、调用方需要完整描述页面结构时，使用 JSON Render；当版式已经审批并需要多个系统复用时，把版式发布为模板，再通过 Template Render 传入业务数据。
如果场景涉及 Factur-X / ZUGFeRD 这类带 EN 16931 CII XML 的 PDF/A-3b 电子发票封装，才使用 E-Invoice Render。普通 PDF、标签、收据和报表不要伪装成电子发票流程。
上线前验证
用真实数据和下游系统验证 Amazon FBA 标签 API。保留 request ID、渲染输出和验收记录，便于支持、审计和重打。gPdf 负责 PDF 渲染；业务规则、外部系统路由、税务判断、承运商验收或 marketplace 合规仍由你的系统负责。
常见问题
- gPdf 是官方 Amazon FBA 应用吗？
- 不是。卖家、备货或仓库后端可以调用 gPdf，但 gPdf 不宣称自己是官方 Amazon 应用或 SP-API 集成。
- gPdf 可以生成 FNSKU 标签吗？
- gPdf 可以生成带条码元素的 PDF 标签。FNSKU 值、标签规则和 Amazon 工作流由你的系统负责。
- FBA 标签应该用模板吗？
- 坐标调试阶段使用 JSON Render；标签设计和字段合同确认后，使用 Template Render。
- gPdf 会为 Amazon 认证标签吗？
- 不会。打印质量、扫描验收和 marketplace 合规仍由你负责。