etykiet magazynowych: API dla produkcji
Generowanie etykiet magazynowych ze strukturalnych danych backendu, bez przeglądarki, z jasną granicą między gPdf renderingiem a regułami Twojego systemu.
/api/v1/pdf/render Generowanie etykiet magazynowych jako powtarzalnego PDF ze strukturalnych danych. gPdf tworzy dokument; Twój system odpowiada za znaczenie danych i stan procesu.
Kiedy użyć tej API
- Backend ma już dane dla etykiet magazynowych i potrzebuje stabilnej odpowiedzi PDF.
- Chcesz uniknąć Chromium lub HTML-to-PDF w dokumencie operacyjnym.
- Potrzebujesz powtarzalnego wyniku do reprintów, audytu lub batchy.
Czego nie zastępuje
- gPdf nie kupuje wysyłki, nie rozlicza podatków, nie tworzy zewnętrznych zamówień i nie jest systemem fiskalnym.
- gPdf nie zastępuje reguł biznesowych, walidacji danych ani integracji marketplace.
Który endpoint wywołać
/api/v1/pdf/render
JSON Render to domyślna ścieżka dla tego workflow.
/api/v1/template-render
Użyj, gdy workflow potrzebuje powiązanej API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
/api/v1/pdf/render - etykiet magazynowych
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 6,
"y": 8,
"content": "PALLET LAX-01-2026-00042",
"style": { "font_size": 12, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "sscc-18",
"content": "012345678901234567",
"x": 6,
"y": 30,
"width": 88,
"height": 26,
"barcode_text": { "enabled": true, "position": "bottom" }
},
{
"type": "text",
"x": 6,
"y": 70,
"content": "SKU: CASE-001\nQTY: 48\nLOCATION: A-14-02",
"style": { "font_size": 10, "font_family": "NotoSans-Regular" }
}
]
}
]
}
Co obsługuje gPdf
- Rendering PDF dla etykiet magazynowych ze strukturalnego requestu.
- Tekst, tabele, linie, kody kreskowe, strony, metadane i opcje wyjścia zgodnie z requestem.
- Deterministyczny output dla retry, reprintów i audytu.
Co kontroluje Twój system
- Poprawne dane dla etykiet magazynowych, reguły biznesowe i stan operacji.
- Autentykacja, przechowywanie, zewnętrzne workflow i walidacja u odbiorcy.
Checklist produkcyjny
- Testuj na prawdziwych danych i w systemach, które odbiorą PDF.
- Zachowuj request ID i dowody walidacji dla supportu, audytu i reprintów.
- Zamień zaakceptowany layout w template, gdy ma być współdzielony.
Granice deklaracji
- gPdf renderuje PDF etykiety; nie kupuje wysyłki, nie tworzy shipment i nie certyfikuje akceptacji przewoźnika.
- Twój system odpowiada za payload, drukarki, nośnik etykiety, routing i testy skanowania.
Kształt API
API: etykiet magazynowych to production workflow oparty na publicznych API gPdf. Request opisuje dane, layout, settings i części PDF do renderingu. gPdf tworzy PDF, a Twój system zachowuje semantykę zdarzenia biznesowego.
Wybór endpointu
Domyślny endpoint dla tego workflow to /api/v1/pdf/render. Template Render stosuj po zatwierdzeniu layoutu. E-Invoice Render tylko dla Factur-X / ZUGFeRD PDF/A-3b z osadzonym EN 16931 CII XML.
Walidacja przed produkcją
Waliduj etykiet magazynowych na realnych danych i downstream-systemach. Zachowuj request ID, output i dowody walidacji dla supportu, audytu oraz reprintów.
FAQ
- Czy to osobny endpoint?
- API: etykiet magazynowych mapuje workflow na publiczną API gPdf. Strona pokazuje, który path wywołać i co ma zawierać request.
- Czy można używać templates?
- Tak. JSON Render pasuje, gdy layout jeszcze się zmienia; Template Render po zatwierdzeniu layoutu i przy wysyłaniu samych danych biznesowych.
- Co zweryfikować przed produkcją?
- Sprawdź realne dane oraz downstream: drukarki, skanery, walidatory, księgowość albo marketplace.