gPdf
Logistics và nhãn

API nhãn vận chuyển cho nhãn PDF 4x6

Tạo PDF nhãn vận chuyển 4x6 sẵn sàng để in từ order JSON, với mã vạch vector, kích thước trang label và reprint kho xác định.

API CHÍNH JSON Render
ENDPOINT /api/v1/pdf/render
HỆ THỐNG WMS / OMS / backend 3PL / backend vận chuyển
Thử trong Playground Đọc tài liệu
Việc cần giải quyết

Kết xuất PDF cỡ label từ dữ liệu đơn hàng, người nhận, dịch vụ và tracking để kho hoặc backend thương mại điện tử có thể in cùng một nhãn 4x6 đáng tin cậy trong fulfillment và reprint xác định khi cần.

Khi nào dùng API này

  • Hệ thống của bạn đã có dữ liệu cần in, payload mã vạch và nội dung hiển thị.
  • Bạn cần đầu ra PDF cho quy trình in kho, fulfillment hoặc vận hành.
  • Bạn muốn mã vạch vector thay vì ảnh raster dán vào PDF.
  • Bạn cần cùng payload kết xuất ra cùng tài liệu để reprint và audit.

Những gì không thay thế

  • Bạn cần mua vận chuyển, tính cước hoặc tạo nhãn hãng vận chuyển qua tài khoản hãng vận chuyển.
  • Bạn cần endpoint thay thế ZPL/EPL. gPdf trả về PDF, không phải máy in command language.
  • Bạn cần gPdf chứng nhận hãng vận chuyển hoặc quy trình vận hành. Kiểm thử scan và acceptance vẫn thuộc về bạn.

Endpoint cần gọi

CHÍNH

/api/v1/pdf/render

JSON Render là đường mặc định cho quy trình này.

PHỤ 1

/api/v1/template-render

Dùng khi quy trình cần API liên quan, hợp đồng mẫu hoặc truy vấn năng lực.

Request tối thiểu

POST /api/v1/pdf/render - nhãn vận chuyển 4x6.

{
  "pages": [
    {
      "size": "label_4_6_in",
      "elements": [
        {
          "type": "text",
          "x": 4,
          "y": 6,
          "content": "SHIP TO",
          "style": { "font_size": 8, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "text",
          "x": 4,
          "y": 13,
          "content": "Acme Warehouse\n1200 Logistics Pkwy\nMemphis TN 38116",
          "style": { "font_size": 11, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "1Z999AA10123456784",
          "x": 4,
          "y": 62,
          "width": 92,
          "height": 22,
          "barcode_text": { "enabled": true, "position": "bottom" }
        }
      ]
    }
  ]
}

gPdf xử lý gì

  • Trang PDF cỡ label hoặc tài liệu vận hành theo request.
  • Kết xuất mã vạch vector cho nội dung hãng vận chuyển, kho hoặc vận hành.
  • Văn bản, block địa chỉ, service marks, đường kẻ, khung và binding template tùy chọn.
  • Đầu ra PDF xác định cho reprint trong kho.

Hệ thống của bạn quản lý gì

  • Tài khoản hãng vận chuyển hoặc marketplace, lựa chọn dịch vụ và tạo mã tracking nếu có.
  • Payload mã vạch đúng, text đọc được, địa chỉ, routing data và dữ liệu vận hành.
  • Thiết lập máy in, vật liệu nhãn, kiểm thử scan và kiểm tra acceptance.

Checklist đưa vào production

  1. In thử trên đúng model máy in và vật liệu nhãn.
  2. Kiểm tra tỷ lệ scan mã vạch ở DPI và khoảng cách máy quét mục tiêu.
  3. Lưu dữ liệu nguồn hoặc PDF trả về theo reprint policy.
  4. Dùng Template Render khi bố cục đã duyệt và được nhiều hệ thống dùng lại.
  5. Giữ logic hãng vận chuyển hoặc đặc thù marketplace ngoài request kết xuất.

Ranh giới tuyên bố

  • gPdf kết xuất PDF tài liệu; gPdf không mua vận chuyển hoặc gọi trực tiếp hãng vận chuyển.
  • gPdf không phải cơ quan chứng nhận hãng vận chuyển, marketplace hoặc GS1.
  • API tạo đầu ra PDF, không phải ZPL, EPL hoặc command stream của máy in nhiệt.

Mô hình API nhãn vận chuyển

API nhãn vận chuyển nhận dữ liệu đơn hàng, người nhận, dịch vụ, tracking và payload mã vạch rồi kết xuất thành nhãn PDF có thể in. gPdf tạo đầu ra PDF xác định; hệ thống của bạn vẫn tạo mã tracking, chọn dịch vụ và sở hữu quy trình của hãng vận chuyển.

JSON Render và Template Render

Dùng JSON Render khi bố cục nhãn được sinh bằng mã hoặc còn thay đổi. Dùng Template Render khi bố cục 4x6 đã được duyệt và nhiều hệ thống chỉ nên gửi dữ liệu shipment theo template_id.

Kiểm thử in rất quan trọng

Nhãn vận chuyển phải được in thử trên máy in thật, vật liệu nhãn thật và máy quét thật. Hãy kiểm tra tỷ lệ quét mã vạch, DPI, quiet zone, địa chỉ dài và acceptance của hãng vận chuyển trước production.

FAQ

Đây có phải API nhãn vận chuyển độc lập không?
Có. Trang này ánh xạ quy trình nhãn vận chuyển vào endpoint công khai POST /api/v1/pdf/render. Hệ thống của bạn vẫn sở hữu dữ liệu nghiệp vụ, còn gPdf chỉ tạo PDF từ request hợp lệ.
Khi nào nên dùng Template Render?
Dùng Template Render khi bố cục đã được duyệt và bạn muốn gọi bằng template_id cùng data thay vì gửi toàn bộ tọa độ ở mỗi request.
API có trả PDF trực tiếp không?
Có. Khi kết xuất thành công, API trả về application/pdf. Khi lỗi, API dùng JSON error envelope chung với mã API-XXX và req_id.
Cần kiểm tra gì trước production?
Hãy in thử bằng máy in thật, kiểm tra scan mã vạch và xác nhận với hãng vận chuyển, marketplace hoặc quy trình kho liên quan.
Giải pháp API PDF packing slip Template Render Giải pháp API nhãn hoàn trả JSON Render Giải pháp API PDF logistics JSON Render Giải pháp API nhãn kho JSON Render Giải pháp API mã vạch GS1 JSON Render Tham chiếu Tham chiếu Render API /docs/api-reference/ Tham chiếu Tham chiếu Template API /docs/template-api/ Tham chiếu PDF nhãn vận chuyển ở quy mô nhà vận chuyển /use-cases/shipping-labels/ Tham chiếu Thư viện mẫu /templates/ Tham chiếu TCO nhãn vận chuyển năm 2026 /blog/itext-vs-gpdf-for-shipping-labels-tco-2026/ Tham chiếu Mã vạch vector và raster trong PDF /blog/vector-vs-raster-barcodes-in-pdf/