Đây có phải API PDF logistics độc lập không?

Có. Trang này ánh xạ quy trình PDF logistics 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 kiểm tra với máy in, máy quét, kho, hãng vận chuyển hoặc 3PL downstream trước production.

Logistics và nhãn

API PDF logistics cho nhãn, phiếu và tài liệu kho

Tạo PDF logistics có cấu trúc như nhãn, packing slips, waybills, manifests và tài liệu kho từ dữ liệu WMS, OMS và 3PL.

API CHÍNH JSON Render

ENDPOINT /api/v1/pdf/render

HỆ THỐNG WMS / OMS / backend 3PL / backend fulfillment

Thử trong Playground Đọc tài liệu

Việc cần giải quyết

Kết xuất tài liệu logistics vận hành từ dữ liệu WMS, OMS, 3PL và fulfillment có cấu trúc, trong khi hãng vận chuyển transactions, shipment routing, warehouse state và business rules vẫn nằm trong hệ thống gọi.

Khi nào dùng API này

Bạn cần nhãn, packing slips, waybills, manifests hoặc tài liệu kho từ dữ liệu vận hành.
Bạn muốn nhiều loại tài liệu cùng dùng một hợp đồng JSON hoặc template.
Bạn cần mã vạch vector, text blocks, bảng và bố cục xác định.
Bạn có thể tự quản lý hãng vận chuyển transaction, routing và trạng thái kho.

Những gì không thay thế

Bạn cần gPdf mua vận chuyển, chọn hãng vận chuyển hoặc tạo shipment.
Bạn cần WMS, OMS, TMS hoặc 3PL platform đầy đủ.
Bạn cần chứng nhận hãng vận chuyển, customs hoặc marketplace từ gPdf.

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 - PDF logistics.

{
  "template_id": "packing_list",
  "data": [
    {
      "order_number": "SO-8421",
      "warehouse": "LAX-01",
      "ship_to": "Example Retailer, 88 Harbor Rd, Long Beach, CA",
      "items": [
        { "sku": "CASE-001", "description": "Widget case", "quantity": 4 },
        { "sku": "CASE-002", "description": "Replacement kit", "quantity": 1 }
      ]
    }
  ]
}

gPdf xử lý gì

Kết xuất PDF logistics từ JSON Render hoặc Template Render.
Nhãn, packing slips, manifests, bảng, mã vạch vector và metadata.
Template cho bố cục kho hoặc fulfillment dùng lặp lại.
Output xác định cho reprint, audit và support.

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

Carrier accounts, shipment creation, routing và trạng thái kho.
Dữ liệu recipient, item, carton, pallet, payload mã vạch và business rules.
Máy in setup, scan testing, downstream acceptance và retention policy.

Checklist đưa vào production

In thử trên máy in và vật liệu thực tế.
Test quét mã vạch, địa chỉ dài, nhiều dòng hàng và reprint.
Quyết định từng tài liệu dùng JSON Render hay template.
Log request ID cùng shipment/order/warehouse IDs.
Giữ hãng vận chuyển-specific logic ngoài request kết xuất.

Ranh giới tuyên bố

gPdf kết xuất tài liệu logistics PDF; gPdf không phải hãng vận chuyển, WMS, OMS hoặc TMS.
Acceptance với hãng vận chuyển, kho hoặc marketplace thuộc hệ thống của bạn.
API tạo PDF, không tạo shipment hoặc mua postage.

Tài liệu logistics là một nhóm quy trình

Tài liệu logistics thường là một cụm gồm nhãn, packing slips, manifests, waybills và tài liệu kho. gPdf giúp cùng một dữ liệu có cấu trúc tạo ra PDF xác định cho từng bề mặt đó.

Các hệ thống vận hành như WMS, OMS, 3PL hoặc fulfillment backend vẫn là nguồn sự thật cho shipment, routing, tồn kho, hãng vận chuyển account và business rules. gPdf chỉ kết xuất đầu ra PDF mà các hệ thống đó mô tả.

Cách sử dụng API

Dùng JSON Render khi bố cục được sinh bằng mã hoặc còn thay đổi. Dùng Template Render khi bố cục label, slip hoặc document đã được duyệt và nhiều hệ thống chỉ nên gửi dữ liệu nghiệp vụ.

Giữ hệ thống vận hành làm nguồn sự thật

Không đưa logic hãng vận chuyển, trạng thái kho hoặc quyết định vận hành vào renderer. Hãy log request ID, đầu ra và dữ liệu nguồn để có thể reprint hoặc audit mà không làm mờ ranh giới giữa tạo PDF và hệ thống vận hành.

FAQ

Đây có phải API PDF logistics độc lập không?: Có. Trang này ánh xạ quy trình PDF logistics 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 kiểm tra với máy in, máy quét, kho, hãng vận chuyển hoặc 3PL downstream trước production.