Amazon FBA Label API для бекендів продавців і складів
Рендерте PDF товарних, коробкових і транспортних етикеток у стилі Amazon FBA з даних продавця або складу, векторними штрихкодами й шаблонним виводом.
/api/v1/pdf/render Рендерити PDF товарних, коробкових або транспортних етикеток для процесів підготовки Amazon FBA після того, як система продавця, підготовки або складу визначила правильні ідентифікатори, дані штрихкодів і правила етикеток.
Коли використовувати цю API
- У вашій системі вже є FNSKU, дані короба, відправлення або етикетки сервісу підготовки.
- Потрібні PDF-етикетки з векторними штрихкодами для станцій друку продавця або складу.
- Потрібно, щоб повторювані макети етикеток стали контрактами Template Render.
- Потрібні детерміновані передруки для підготовки, аудиту або обробки винятків.
Що вона не замінює
- Потрібна офіційна Amazon-інтеграція, застосунок або SP-API connector від gPdf.
- Потрібно, щоб Amazon сертифікував етикетку через gPdf.
- Потрібне керування залишками, лістингами або планом відправлення.
Який шлях API викликати
/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
- PDF-рендеринг розміру етикетки з тіла запиту JSON Render.
- Векторні штрихкоди, текст, блоки SKU, рамки й прив’язку шаблону.
- Повторюваний вивід етикеток через Template Render.
- PDF-відповіді для станцій друку, інструментів продавця або складських процесів.
Що контролює ваша система
- Інтеграцію з акаунтом Amazon, виклики SP-API, дані плану відправлення, значення FNSKU і правила маркетплейсу.
- Коректні дані штрихкодів, розміри етикеток, дані товару й прийняття сканером.
- UX продавця, процес підготовки, зберігання й дозвіл на передрук.
Чеклист для робочого запуску
- Підтвердьте активний маркетплейс і вимоги виконання замовлення перед рендерингом.
- Валідуйте дані штрихкодів і фізичну якість друку на бойовому матеріалі етикеток.
- Тримайте інтеграцію Amazon і роботу з обліковими даними поза gPdf.
- Зберігайте вихідні дані етикетки, щоб передруки були детермінованими.
- Переносьте затверджені макети в Template Render для інтеграцій зі станціями друку.
Межі заявлених можливостей
- gPdf не є офіційним застосунком Amazon або SP-API connector.
- gPdf рендерить PDF; відповідність правилам Amazon і процес продавця залишаються вашою відповідальністю.
- Не сприймайте PDF-рендеринг як сертифікацію етикетки Amazon.
FBA-етикетки — це PDF-етикетки, керовані даними
Процеси підготовки Amazon FBA часто потребують товарних, коробкових або транспортних етикеток. Рендерингова задача прямолінійна: ваша система надає ідентифікатори й правила етикетки, а gPdf рендерить PDF.
Тримайте інтеграцію з маркетплейсом окремо від рендерингу. Отримуйте або обчислюйте правильні ідентифікатори в системі продавця або складу, а потім викликайте gPdf з фінальними даними етикетки.
FAQ
- Чи є gPdf офіційним Amazon FBA app?
- Ні. Бекенд продавця, підготовки або складу може викликати gPdf, але gPdf не заявляє офіційний застосунок Amazon або SP-API integration.
- Чи може gPdf рендерити FNSKU-етикетки?
- gPdf може рендерити PDF-етикетки з елементами штрихкоду. Ваша система відповідає за значення FNSKU, правила етикетки й процес Amazon.
- Чи мають FBA-етикетки використовувати шаблони?
- Використовуйте JSON Render під час тестування координат. Використовуйте Template Render після затвердження дизайну етикетки й контракту полів.
- Чи сертифікує gPdf етикетки для Amazon?
- Ні. Якість друку, прийняття сканером і відповідність правилам маркетплейсу залишаються вашою відповідальністю.