Logistik dan label

Return label API untuk reverse logistics ecommerce

Generate PDF return label dan instruksi return dari data ecommerce atau support dengan halaman berukuran label, barcode, dan reprint template.

API UTAMA JSON Render
ENDPOINT /api/v1/pdf/render
SISTEM backend ecommerce / portal return / OMS / backend 3PL
Pekerjaan yang diselesaikan

Merender PDF return label atau lembar instruksi return dari data RMA, pelanggan, item, tujuan, dan barcode agar portal return dapat memberikan dokumen deterministik kepada pelanggan.

Kapan memakai API ini

  • Sistem Anda sudah membuat RMA dan otorisasi return.
  • Carrier atau sistem return sudah menyediakan payload label atau data tracking.
  • Anda membutuhkan label PDF atau lembar instruksi yang dapat diunduh, dikirim email, atau dicetak ulang.
  • Anda ingin layout return label yang sama dipakai ulang melalui Template Render.

Apa yang tidak digantikan

  • Anda membutuhkan gPdf untuk menyetujui return, membeli ongkir, atau membuat shipment carrier.
  • Anda membutuhkan orkestrasi API carrier langsung.
  • Anda membutuhkan output perintah printer seperti ZPL.

Endpoint yang dipanggil

UTAMA

/api/v1/pdf/render

JSON Render adalah jalur default untuk workflow ini.

SEKUNDER 1

/api/v1/template-render

Gunakan saat workflow butuh jalur API terkait, kontrak template, atau capability lookup.

Request minimal

POST /api/v1/pdf/render - return label dengan barcode 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" }
        }
      ]
    }
  ]
}

Yang ditangani gPdf

  • Render PDF untuk return label berukuran label dan halaman instruksi.
  • Blok barcode, teks, alamat, RMA, dan layanan.
  • Binding template untuk return label atau layout instruksi yang disetujui.
  • Output deterministik untuk download ulang pelanggan dan reprint support.

Yang dikelola sistem Anda

  • Kelayakan return, status RMA, akun carrier, ongkir, tracking number, dan pesan pelanggan.
  • Payload barcode yang benar, alamat tujuan, referensi item, dan aturan jendela return.
  • Delivery email, download portal, dan audit trail support.

Checklist produksi

  1. Validasi payload return dengan carrier atau penyedia return sebelum render.
  2. Cetak dan scan label pada stock yang sama dengan yang akan dipakai pelanggan atau toko.
  3. Sertakan X-Request-Id dan simpan trace RMA-ke-PDF di log support Anda.
  4. Buat download berulang idempotent dari sudut pandang pelanggan.
  5. Pisahkan render label dari logika approval refund.

Batas klaim

  • gPdf merender PDF return label; gPdf tidak mengotorisasi return atau membeli ongkir.
  • Penerimaan carrier dan kebenaran payload barcode tetap menjadi tanggung jawab Anda.
  • API publik mengembalikan PDF, bukan ZPL atau perintah printer langsung.

Reverse logistics membutuhkan kepemilikan yang jelas

Return label menggabungkan pengalaman pelanggan dan aturan carrier. gPdf memiliki render PDF. Sistem return Anda memiliki eligibility, status RMA, tracking, payload carrier, dan komunikasi pelanggan.

Jaga batas itu tetap terlihat dalam integrasi. Buat keputusan return terlebih dahulu, lalu render dokumen dari data yang sudah final.

FAQ

Apakah gPdf membuat shipment return?
Tidak. Carrier atau platform return Anda membuat shipment dan payload. gPdf merender data tersebut menjadi PDF.
Bisakah return label digenerate dari template?
Ya. Gunakan Template Render setelah return label atau layout instruksi disetujui.
Bisakah PDF memuat instruksi return?
Ya. Request render yang sama dapat membuat halaman label, halaman instruksi, atau keduanya, tergantung layout Anda.
Apakah gPdf menggantikan sertifikasi carrier?
Tidak. Penerimaan carrier, scan test, dan aturan payload tetap menjadi tanggung jawab Anda.