API per etichette Amazon FBA per backend seller e warehouse
Genera PDF per etichette in stile Amazon FBA per prodotti, colli e spedizioni da dati seller o warehouse, con codici a barre vettoriali e output da template.
/api/v1/pdf/render Renderizzare PDF di etichette prodotto, collo o spedizione per workflow di preparazione Amazon FBA dopo che il sistema seller, prep o warehouse ha determinato identificativi, payload dei codici a barre e regole dell'etichetta corretti.
Quando usare questa API
- Il vostro sistema ha già i dati FNSKU, collo, spedizione o preparazione necessari per l'etichetta.
- Vi servono etichette con codici a barre vettoriali come PDF per postazioni di stampa seller o warehouse.
- Volete trasformare layout di etichette ricorrenti in contratti Template Render.
- Vi servono ristampe deterministiche per preparazione, audit o gestione delle eccezioni.
Cosa non sostituisce
- Vi serve da gPdf un'integrazione Amazon ufficiale, un'app o un connettore SP-API.
- Vi serve che Amazon certifichi l'etichetta tramite gPdf.
- Vi servono gestione inventario, listing o piani di spedizione.
Quale endpoint chiamare
/api/v1/pdf/render
JSON Render è il percorso predefinito per questo flusso.
/api/v1/template-render
Usalo quando il flusso richiede l'API collegata, un contratto di template o una verifica delle capacità.
Request minimo
POST /api/v1/pdf/render - etichetta prodotto con payload barcode in stile 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" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering di PDF in formato etichetta da payload JSON Render.
- Codici a barre vettoriali, testo, blocchi SKU, riquadri e binding dei template.
- Output di etichette ricorrenti tramite Template Render.
- Risposte PDF per postazioni di stampa, strumenti seller o workflow warehouse.
Cosa controlla il tuo sistema
- Integrazione account Amazon, chiamate SP-API, dati del piano di spedizione, valori FNSKU e regole marketplace.
- Payload corretti dei codici a barre, dimensioni etichetta, dati prodotto e accettazione in scansione.
- UX seller, workflow di preparazione, storage e autorizzazione alla ristampa.
Checklist di produzione
- Confermate marketplace attivo e requisiti di fulfillment prima del rendering.
- Validate payload dei codici a barre e qualità fisica di stampa sul supporto etichetta di produzione.
- Tenete integrazione Amazon e gestione delle credenziali fuori da gPdf.
- Conservate i dati sorgente dell'etichetta per rendere deterministiche le ristampe.
- Spostate i layout approvati su Template Render per le integrazioni con postazioni di stampa.
Limiti della promessa
- gPdf non è un'app Amazon ufficiale né un connettore SP-API.
- gPdf renderizza PDF; compliance Amazon e regole del workflow seller restano vostre.
- Non considerate il rendering PDF come certificazione dell'etichetta Amazon.
Le etichette FBA sono PDF guidati dai dati
I workflow di preparazione Amazon FBA richiedono spesso etichette per prodotto, collo o spedizione. Il problema di rendering è chiaro: il vostro sistema fornisce identificativi e regole dell’etichetta, e gPdf renderizza il PDF.
Mantenete l’integrazione marketplace separata dal rendering. Recuperate o calcolate gli identificativi corretti nel sistema seller o warehouse, poi chiamate gPdf con il payload finale dell’etichetta.
FAQ
- gPdf è un'app Amazon FBA ufficiale?
- No. Un backend seller, prep o warehouse può chiamare gPdf, ma gPdf non dichiara un'app Amazon ufficiale né un'integrazione SP-API.
- gPdf può renderizzare etichette FNSKU?
- gPdf può renderizzare etichette PDF con elementi barcode. Il vostro sistema possiede valore FNSKU, regole dell'etichetta e workflow Amazon.
- Le etichette FBA dovrebbero usare template?
- Usate JSON Render mentre testate le coordinate. Usate Template Render dopo l'approvazione del design dell'etichetta e del contratto dei campi.
- gPdf certifica le etichette per Amazon?
- No. Qualità di stampa, accettazione in scansione e compliance marketplace restano vostra responsabilità.