API per etichette di reso nella logistica inversa ecommerce
Genera PDF di etichette di reso e istruzioni di reso da dati ecommerce o supporto, con pagine in formato etichetta, codici a barre e ristampe da template.
/api/v1/pdf/render Renderizzare PDF di etichette di reso o fogli di istruzioni da dati RMA, cliente, articolo, destinazione e codice a barre, così un portale resi può fornire al cliente un documento deterministico.
Quando usare questa API
- Il vostro sistema ha già creato l'RMA e l'autorizzazione al reso.
- Un vettore o sistema resi ha già fornito il contenuto dell'etichetta o i dati di tracciamento.
- Vi serve un'etichetta PDF o un foglio di istruzioni che possa essere scaricato, inviato via email o ristampato.
- Volete riusare lo stesso layout di etichetta di reso tramite Template Render.
Cosa non sostituisce
- Vi serve che gPdf approvi il reso, acquisti affrancatura o crei una spedizione presso il vettore.
- Vi serve orchestrazione diretta delle API dei vettori.
- Vi serve output in comandi stampante, come ZPL.
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 di reso con codice a barre RMA.
{
"pages": [
{
"size": "label_4_6_in",
"elements": [
{
"type": "text",
"x": 5,
"y": 8,
"content": "RETURN TO",
"style": { "font_size": 9, "font_family": "NotoSans-Regular" }
},
{
"type": "text",
"x": 5,
"y": 18,
"content": "Acme Returns\n500 Dock Door 4\nColumbus OH 43215",
"style": { "font_size": 11, "font_family": "NotoSans-Regular" }
},
{
"type": "barcode",
"format": "code128",
"content": "RMA-2026-77881",
"x": 5,
"y": 70,
"width": 88,
"height": 20,
"barcode_text": { "enabled": true, "position": "bottom" }
}
]
}
]
}
Cosa gestisce gPdf
- Rendering PDF per etichette di reso in formato etichetta e pagine di istruzioni.
- Codice a barre, testo, indirizzo, RMA e blocchi servizio.
- Associazione al template per layout approvati di etichetta di reso o istruzioni.
- Output deterministico per nuovi download del cliente e ristampe del supporto.
Cosa controlla il tuo sistema
- Idoneità del reso, stato RMA, account del vettore, affrancatura, numero di tracciamento e messaggi al cliente.
- Contenuti corretti dei codici a barre, indirizzo di destinazione, riferimenti articolo e regole della finestra di reso.
- Consegna email, download dal portale e audit trail del supporto.
Checklist di produzione
- Validate il contenuto del reso con il vettore o il provider resi prima del rendering.
- Stampate e scansionate le etichette sullo stesso supporto che useranno clienti o negozi.
- Includete un X-Request-Id e salvate la traccia RMA-PDF nei log del supporto.
- Rendete idempotenti i download ripetuti dal punto di vista del cliente.
- Separate il rendering dell'etichetta dalla logica di approvazione del rimborso.
Limiti della promessa
- gPdf renderizza PDF di etichette di reso; non autorizza resi né acquista affrancatura.
- Accettazione del vettore e correttezza del contenuto dei codici a barre restano vostra responsabilità.
- L'API pubblica restituisce PDF, non ZPL o comandi diretti per stampanti.
La logistica inversa richiede confini di responsabilità chiari
Le etichette di reso uniscono esperienza cliente e regole del vettore. gPdf possiede il rendering PDF. Il vostro sistema resi possiede idoneità, stato RMA, tracciamento, contenuti richiesti dal vettore e comunicazione al cliente.
Mantenete visibile questo confine nell’integrazione. Generate prima la decisione di reso, poi renderizzate il documento dai dati definitivi.
FAQ
- gPdf crea la spedizione di reso?
- No. Il vostro vettore o piattaforma resi crea la spedizione e il contenuto da renderizzare. gPdf trasforma quei dati in un PDF.
- Le etichette di reso possono essere generate da template?
- Sì. Usate Template Render dopo l'approvazione del layout dell'etichetta di reso o delle istruzioni.
- Il PDF può includere istruzioni di reso?
- Sì. La stessa richiesta di rendering può creare una pagina etichetta, una pagina di istruzioni o entrambe, a seconda del vostro layout.
- gPdf sostituisce la certificazione del vettore?
- No. Accettazione del vettore, test scanner e regole sul contenuto restano vostra responsabilità.