API voor retouretiketten voor e-commerce-retourlogistiek
Genereer PDF's voor retouretiketten en retourinstructies vanuit e-commerce- of supportdata, met etiketpagina's, barcodes en template-reprints.
/api/v1/pdf/render Render PDF's voor retouretiketten of retourinstructies vanuit RMA-, klant-, item-, bestemmings- en barcodedata, zodat een retourportal een deterministisch document aan de klant kan leveren.
Wanneer deze API past
- Uw systeem de RMA en retourautorisatie al heeft aangemaakt.
- Een vervoerder of retoursysteem de etiketpayload of trackingdata al heeft geleverd.
- U een PDF-etiket of instructieblad nodig hebt dat kan worden gedownload, gemaild of opnieuw geprint.
- U dezelfde retouretiketlayout wilt hergebruiken via Template Render.
Wat dit niet vervangt
- U wilt dat gPdf de retour goedkeurt, porto koopt of een vervoerderzending aanmaakt.
- U directe orkestratie van vervoerder-API's nodig hebt.
- U printercommand-output zoals ZPL nodig hebt.
Welk endpoint aanroepen
/api/v1/pdf/render
JSON Render is het standaardpad voor deze workflow.
/api/v1/template-render
Gebruik dit wanneer de workflow een verwant API-pad, templatecontract of capability lookup nodig heeft.
Minimale request
POST /api/v1/pdf/render - retouretiket met RMA-barcode.
{
"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" }
}
]
}
]
}
Wat gPdf afhandelt
- PDF-rendering voor retouretiketten op etiketformaat en instructiepagina's.
- Barcode-, tekst-, adres-, RMA- en serviceblokken.
- Template-binding voor goedgekeurde retouretiket- of instructielayouts.
- Deterministische output voor herhaalde klantdownloads en supportreprints.
Wat uw systeem beheert
- Retourgeschiktheid, RMA-status, vervoerdersaccount, porto, trackingnummer en klantcommunicatie.
- Correcte barcodepayloads, bestemmingsadres, itemverwijzingen en regels voor de retourtermijn.
- E-maillevering, portaaldownload en support-audittrail.
Productiechecklist
- Valideer de retourpayload bij de vervoerder of retourprovider voordat u rendert.
- Print en scan etiketten op hetzelfde materiaal dat klanten of winkels gebruiken.
- Neem een X-Request-Id op en bewaar het RMA-naar-PDF-spoor in uw supportlogs.
- Maak herhaalde downloads idempotent vanuit het perspectief van de klant.
- Scheid etiketrendering van logica voor terugbetalingsgoedkeuring.
Grenzen van de claim
- gPdf rendert PDF's voor retouretiketten; het autoriseert geen retouren en koopt geen porto.
- Vervoerdersacceptatie en correctheid van barcodepayloads blijven uw verantwoordelijkheid.
- De publieke API retourneert PDF, geen ZPL of directe printercommando's.
Reverse logistics vraagt om duidelijke eigenaarschap
Retouretiketten combineren klantervaring en vervoerdersregels. gPdf beheert PDF-rendering. Uw retoursysteem beheert geschiktheid, RMA-status, tracking, vervoerderpayloads en klantcommunicatie.
Houd die grens zichtbaar in de integratie. Neem eerst de retourbeslissing en render daarna het document vanuit de definitieve data.
FAQ
- Maakt gPdf de retourzending aan?
- Nee. Uw vervoerder- of retourplatform maakt de zending en payload aan. gPdf rendert die data naar een PDF.
- Kunnen retouretiketten vanuit templates worden gegenereerd?
- Ja. Gebruik Template Render zodra de retouretiket- of instructielayout is goedgekeurd.
- Kan de PDF retourinstructies bevatten?
- Ja. Dezelfde renderrequest kan een etiketpagina, een instructiepagina of beide maken, afhankelijk van uw layout.
- Vervangt gPdf vervoerderscertificering?
- Nee. Vervoerdersacceptatie, scannertests en payloadregels blijven uw verantwoordelijkheid.