API dla etykiet Amazon FBA dla backendów sprzedawców i magazynów
Renderuj PDF etykiet produktowych, kartonowych i wysyłkowych w stylu Amazon FBA z danych sprzedawcy lub magazynu, z wektorowymi kodami kreskowymi i wyjściem szablonowym.
/api/v1/pdf/render Renderować PDF etykiet produktowych, kartonowych albo wysyłkowych dla procesów przygotowania Amazon FBA po tym, jak system sprzedawcy, usługi przygotowania albo magazynu ustali poprawne identyfikatory, dane kodów kreskowych i reguły etykiet.
Kiedy użyć tej API
- Twój system ma już dane etykiety FNSKU, kartonu, wysyłki albo usługi przygotowania.
- Potrzebujesz etykiet z wektorowymi kodami kreskowymi jako wyjścia PDF dla stanowisk druku sprzedawcy lub magazynu.
- Chcesz, aby powtarzalne układy etykiet stały się kontraktami Template Render.
- Potrzebujesz deterministycznych reprintów dla przygotowania, audytu albo obsługi wyjątków.
Czego nie zastępuje
- Potrzebujesz oficjalnej integracji Amazon, aplikacji albo konektora SP-API od gPdf.
- Potrzebujesz certyfikacji etykiety przez Amazon za pośrednictwem gPdf.
- Potrzebujesz zarządzania stanem magazynowym, listingami albo planem wysyłki.
Który endpoint wywołać
/api/v1/pdf/render
JSON Render to domyślna ścieżka dla tego procesu.
/api/v1/template-render
Użyj, gdy proces wymaga powiązanej ścieżki API, kontraktu szablonu albo sprawdzenia capabilities.
Minimalny request
POST /api/v1/pdf/render - etykieta produktu z zakodowaną wartością w stylu 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" }
}
]
}
]
}
Co obsługuje gPdf
- Renderowanie PDF w rozmiarze etykiety z danych żądania JSON Render.
- Wektorowe kody kreskowe, tekst, bloki SKU, ramki i powiązanie z szablonem.
- Powtarzalne wyjście etykiet przez Template Render.
- Odpowiedzi PDF dla stanowisk druku, narzędzi sprzedawcy albo procesów magazynowych.
Co kontroluje Twój system
- Integrację z kontem Amazon, wywołania SP-API, dane planu wysyłki, wartości FNSKU i reguły marketplace.
- Poprawne dane kodów kreskowych, wymiary etykiet, dane produktów i akceptację skanowania.
- UX sprzedawcy, proces przygotowania, przechowywanie i autoryzację reprintów.
Checklist produkcyjny
- Potwierdź aktywny marketplace i wymagania realizacji zamówień przed renderowaniem.
- Zweryfikuj dane kodów kreskowych i fizyczną jakość druku na produkcyjnym materiale etykiet.
- Trzymaj integrację Amazon i obsługę poświadczeń poza gPdf.
- Przechowuj źródłowe dane etykiety, aby reprinty były deterministyczne.
- Przenieś zatwierdzone układy do Template Render dla integracji ze stanowiskami druku.
Granice deklaracji
- gPdf nie jest oficjalną aplikacją Amazon ani konektorem SP-API.
- gPdf renderuje PDF; zgodność z wymaganiami Amazon i reguły procesów sprzedawcy pozostają po Twojej stronie.
- Nie traktuj renderowania PDF jako certyfikacji etykiety Amazon.
Etykiety FBA to PDF sterowane danymi
Procesy przygotowania Amazon FBA często wymagają etykiet produktowych, kartonowych albo wysyłkowych. Problem renderowania jest prosty: Twój system dostarcza identyfikatory i reguły etykiety, a gPdf renderuje PDF.
Oddziel integrację z marketplace od renderowania. Pobierz albo wylicz właściwe identyfikatory w systemie sprzedawcy lub magazynu, a następnie wywołaj gPdf z finalnymi danymi etykiety.
FAQ
- Czy gPdf jest oficjalną aplikacją Amazon FBA?
- Nie. Backend sprzedawcy, usługi przygotowania albo magazynu może wywoływać gPdf, ale gPdf nie deklaruje oficjalnej aplikacji Amazon ani integracji SP-API.
- Czy gPdf może renderować etykiety FNSKU?
- gPdf może renderować etykiety PDF z elementami kodów kreskowych. Twój system odpowiada za wartość FNSKU, reguły etykiet i proces Amazon.
- Czy etykiety FBA powinny używać szablonów?
- Używaj JSON Render podczas testowania współrzędnych. Przejdź na Template Render po zatwierdzeniu projektu etykiety i kontraktu pól.
- Czy gPdf certyfikuje etykiety dla Amazon?
- Nie. Jakość druku, akceptacja skanowania i zgodność z wymaganiami marketplace pozostają Twoją odpowiedzialnością.