API этикеток Amazon FBA для seller и warehouse backend
Рендерьте PDF-этикетки в стиле Amazon FBA для товаров, коробов и shipment из данных seller или warehouse system: с векторными штрихкодами и template output.
/api/v1/pdf/render Рендерить PDF-этикетки для товаров, коробов или shipment в процессах подготовки Amazon FBA после того, как ваша seller, prep или warehouse system уже определила правильные идентификаторы, barcode payloads и правила этикетки.
Когда использовать эту API
- В вашей системе уже есть FNSKU, carton, shipment или prep-service label data.
- Нужны PDF-этикетки с векторными штрихкодами для seller или warehouse print stations.
- Повторяемые layouts этикеток должны стать контрактами Template Render.
- Нужна детерминированная перепечатка для prep, audit или exception handling.
Что она не заменяет
- Нужна официальная интеграция Amazon, app или SP-API connector от gPdf.
- Нужно, чтобы Amazon сертифицировал этикетку через gPdf.
- Нужно управление inventory, listings или shipment plans.
Какой endpoint вызывать
/api/v1/pdf/render
JSON Render — путь по умолчанию для этого сценария.
/api/v1/template-render
Используйте, когда сценарию нужен связанный API-путь, контракт шаблона или проверка возможностей.
Минимальный запрос
POST /api/v1/pdf/render - product label с FNSKU-style barcode payload.
{
"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
- PDF-рендеринг label-size страниц из JSON Render payloads.
- Векторные штрихкоды, текст, SKU blocks, рамки и template binding.
- Повторяемый вывод этикеток через Template Render.
- PDF responses для print stations, seller tools или warehouse workflows.
Что контролирует ваша система
- Интеграцию с Amazon account, SP-API calls, shipment plan data, FNSKU values и marketplace rules.
- Корректные barcode payloads, размеры этикеток, product data и scan acceptance.
- Seller UX, prep workflow, хранение и разрешение на перепечатку.
Production-чеклист
- Подтвердите активный marketplace и fulfillment requirements перед рендерингом.
- Проверьте barcode payloads и физическое качество печати на production label stock.
- Держите Amazon integration и credential handling вне gPdf.
- Храните исходные label data, чтобы перепечатка была детерминированной.
- Перенесите утвержденные layouts в Template Render для интеграций print stations.
Границы заявлений
- gPdf не является официальным Amazon app или SP-API connector.
- gPdf рендерит PDF; Amazon compliance и правила seller workflow остаются на вашей стороне.
- Не считайте PDF-рендеринг сертификацией Amazon label.
FBA labels — это data-driven PDF labels
Процессы подготовки Amazon FBA часто требуют этикеток для товаров, коробов или shipment. Задача рендеринга здесь прямолинейна: ваша система передает идентификаторы и правила этикетки, а gPdf рендерит PDF.
Держите marketplace integration отдельно от рендеринга. Получите или вычислите правильные идентификаторы в seller или warehouse system, затем вызовите gPdf с финальным label payload.
FAQ
- gPdf — это официальный Amazon FBA app?
- Нет. Seller, prep или warehouse backend может вызывать gPdf, но gPdf не заявляет официального Amazon app или SP-API integration.
- Может ли gPdf рендерить FNSKU labels?
- gPdf может рендерить PDF-этикетки с элементами штрихкода. Ваша система отвечает за FNSKU value, правила этикетки и Amazon workflow.
- Стоит ли FBA labels делать через templates?
- Используйте JSON Render, пока тестируете координаты. Используйте Template Render после утверждения label design и field contract.
- Сертифицирует ли gPdf этикетки для Amazon?
- Нет. Качество печати, scan acceptance и marketplace compliance остаются вашей ответственностью.