Packing Slip PDF API для процесів виконання замовлень
Генеруйте PDF пакувальних листів із даних замовлення, відправлення, короба й товару для електронної комерції, 3PL, OMS та складських процесів виконання.
/api/v1/template-render Рендерити пакувальні листи з даних відправлення, отримувача, товарів і короба, щоб команди виконання замовлень могли друкувати або вкладати послідовний документ до кожного вихідного замовлення.
Коли використовувати цю API
- У вашому OMS або WMS уже є рядки замовлення, кількості, дані отримувача й ідентифікатори відправлення.
- Потрібен PDF пакувального листа для складських станцій друку або вкладень у клієнтські посилки.
- Потрібно повторно використовувати один затверджений макет на складах, брендах або каналах продажу.
- Може знадобитися штрихкод або QR-код для пошуку замовлення або приймання повернення.
Що вона не замінює
- Потрібно купити поштові послуги, розрахувати тариф відправлення або створити етикетку перевізника.
- Потрібне керування складськими залишками, а не рендеринг документів.
- Потрібна семантика юридичного рахунку або електронного рахунку.
Який шлях API викликати
/api/v1/template-render
Template Render — типовий шлях для цього сценарію.
/api/v1/pdf/render
Використовуйте, коли сценарію потрібен пов’язаний API-шлях, контракт шаблону або перевірка можливостей.
Мінімальний запит
POST /api/v1/template-render - шаблон packing_list з одним відправленням.
{
"template_id": "packing_list",
"data": [
{
"shipment": {
"number": "PL-2026-1001",
"date": "2026-05-29"
},
"shipper": {
"name": "Acme Warehouse",
"address": "1200 Logistics Pkwy"
},
"consignee": {
"name": "Receiver Inc.",
"address": "123 Main St"
},
"items": [
{
"item_no": "1",
"description": "Replacement filter",
"quantity": "2",
"unit": "pcs",
"gross_weight": "1.2 kg",
"net_weight": "1.0 kg"
}
]
}
]
}
Що виконує gPdf
- Template Render для опублікованих макетів пакувальних листів.
- JSON Render для власних сторінок пакувального листа під час проєктування або одноразових процесів.
- Таблиці, рядки товарів, адресні блоки, необов’язкові штрихкоди й PDF-вивід.
- Детерміновані передруки, коли використовуються ті самі дані й template.
Що контролює ваша система
- Дані замовлення, кількості товарів, стан відправлення, складську маршрутизацію й повідомлення клієнту.
- Мапінг полів шаблону, маршрутизацію станції друку і політику передруку.
- Будь-який документ перевізника, митниці або рахунку, який має йти разом із посилкою.
Чеклист для робочого запуску
- Тестуйте найдовші SKU, назви товарів і комбінації адрес.
- Валідуйте випадки з одним товаром, кількома коробами, відкладеними позиціями і частковим відправленням.
- Використовуйте Template Render після затвердження макета пакувального листа.
- Логуйте template_id і X-Request-Id для кожного запиту друку в процесі виконання.
- Тримайте генерацію етикеток перевізника окремо від рендерингу пакувальних листів.
Межі заявлених можливостей
- gPdf рендерить PDF пакувального листа; він не керує залишками або станом виконання.
- Пакувальний лист не стає автоматично податковим рахунком або митним документом.
- Купівля етикетки перевізника й рейтингування відправлення залишаються поза gPdf.
Пакувальні листи добре пасують шаблонному шляху
Пакувальні листи зазвичай мають стабільну структуру: відправник, отримувач, номер відправлення, рядки товарів і необов’язкові примітки. Це робить Template Render сильним вибором після затвердження макета.
JSON Render усе ще важливий під час проєктування. Він дає команді змогу
налаштувати колонки, інтервали, розміщення штрихкоду й розриви сторінок перед
публікацією стабільного контракту template_id.
FAQ
- Пакувальний лист — це окремий маршрут gPdf API?
- Ні. Використовуйте Template Render для затвердженого шаблону пакувального листа або JSON Render, коли ваша система описує макет напряму.
- Чи можуть пакувальні листи містити штрихкоди?
- Так. gPdf може рендерити елементи штрихкоду в PDF. Ваша система відповідає за закодовані дані замовлення, короба або повернення.
- Чи створює gPdf етикетки перевізника?
- Ні. Етикетки перевізника — окремий процес. gPdf рендерить PDF із даних, які надає ваш перевізник або shipping-система.
- Чи може один запит рендерити кілька пакувальних листів?
- Template Render приймає масив data для кількох елементів в одному запиті, у межах публічних API-лімітів, задокументованих для цього маршруту.