Piattaforme ecommerce

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 PRINCIPALE JSON Render
ENDPOINT /api/v1/pdf/render
SISTEMI strumento seller / backend warehouse / servizio di preparazione FBA / sistema operativo ecommerce
Lavoro da svolgere

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

PRIMARIO

/api/v1/pdf/render

JSON Render è il percorso predefinito per questo flusso.

SECONDARIO 1

/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

  1. Confermate marketplace attivo e requisiti di fulfillment prima del rendering.
  2. Validate payload dei codici a barre e qualità fisica di stampa sul supporto etichetta di produzione.
  3. Tenete integrazione Amazon e gestione delle credenziali fuori da gPdf.
  4. Conservate i dati sorgente dell'etichetta per rendere deterministiche le ristampe.
  5. 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à.