gPdf
Nền tảng thương mại điện tử

API nhãn Amazon FBA cho backend seller và kho

Kết xuất PDF nhãn sản phẩm, carton và shipment kiểu Amazon FBA từ dữ liệu seller hoặc warehouse với mã vạch vector và đầu ra template.

API CHÍNH JSON Render
ENDPOINT /api/v1/pdf/render
HỆ THỐNG seller tool / warehouse backend / FBA prep service / ecommerce operations system
Thử trong Playground Đọc tài liệu
Việc cần giải quyết

Kết xuất PDF nhãn sản phẩm, carton hoặc shipment cho quy trình chuẩn bị Amazon FBA sau khi hệ thống seller, prep hoặc warehouse của bạn đã xác định đúng identifiers, mã vạch payloads và quy tắc nhã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 Amazon FBA.

{
  "pages": [
    {
      "width": 70,
      "height": 35,
      "elements": [
        {
          "type": "text",
          "x": 4,
          "y": 4,
          "content": "FNSKU X00ABC1234",
          "style": { "font_size": 8, "font_family": "NotoSans-Regular" }
        },
        {
          "type": "barcode",
          "format": "code128",
          "content": "X00ABC1234",
          "x": 4,
          "y": 12,
          "width": 60,
          "height": 12,
          "barcode_text": { "enabled": true, "position": "bottom" }
        },
        {
          "type": "text",
          "x": 4,
          "y": 29,
          "content": "SKU: ACME-FILTER-01",
          "style": { "font_size": 6, "font_family": "NotoSans-Regular" }
        }
      ]
    }
  ]
}

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.

Nhãn FBA là nhãn PDF dựa trên dữ liệu

API nhãn Amazon FBA phù hợp khi hệ thống của bạn đã quyết định dữ liệu cần in và chỉ cần tạo PDF ổn định. gPdf nhận dữ liệu có cấu trúc, bố cục hoặc template, rồi kết xuất thành PDF có thể in và reprint.

Các quyết định nghiệp vụ như hãng vận chuyển, mã tracking, routing, dữ liệu sản phẩm, tồn kho, quy tắc marketplace hoặc kiểm thử acceptance vẫn nằm ngoài gPdf. Điều này giữ đường kết xuất rõ ràng: gPdf tạo tài liệu; hệ thống vận hành của bạn quyết định tài liệu đó có đúng để dùng hay không.

FAQ

Đây có phải API nhãn Amazon FBA độc lập không?
Có. Trang này ánh xạ quy trình nhãn Amazon FBA 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 cho Shopify 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 Tạo PDF cho logistics và thương mại điện tử /blog/logistics-ecommerce-pdf-generation-fit/