Open Ship API

API này hỗ trợ bạn tạo Lô hàng mở và cho phép thêm dần các gói hàng vào lô hàng trong một khoảng thời gian, thay vì nhập tất cả thông tin lô hàng và gói hàng cùng một lúc. Lô hàng sẽ duy trì trạng thái mở trong khoảng thời gian năm ngày và cho phép thêm cũng như sửa đổi gói hàng trong thời gian đó. Sau khi xác nhận lô hàng, bạn có thể tạo các loại giấy tờ vận chuyển như nhãn, AWB hoặc báo cáo. Khi kết thúc ngày thứ năm, lô hàng phải được xác nhận hoặc sẽ bị loại bỏ.

Lưu ý: Lô hàng mở sẽ bị loại bỏ nếu bạn không xác nhận lô hàng vào cuối ngày thứ năm kể từ ngày tạo lô hàng.

API Vận chuyển mở được sử dụng khi bạn muốn thêm nhiều gói hàng vào một lô hàng trong một khoảng thời gian và bạn không chắc chắn về số lượng gói hàng định thêm hay thời điểm hoàn tất lô hàng. API này mang đến phương thức linh hoạt để bạn chuẩn bị lô hàng bất cứ lúc nào trong ngày, cho đến khi sẵn sàng gửi.

Các lô hàng Vận chuyển mở thường là lô hàng nhiều kiện, nhưng cũng có thể là lô hàng có một gói hàng, được gọi là lô hàng một kiện.

Để gửi lô hàng nhiều kiện (MPS) đến một người nhận, hãy sử dụng API Vận chuyển mở và thêm từng gói hàng vào lô hàng hoặc thêm nhiều gói hàng nếu các gói hàng này được gửi đến cùng một người nhận.

Sau đây là các dịch vụ liên kết với Lô hàng mở:

• FedEx Express^® nội địa Hoa Kỳ và nội địa Canada
• FedEx Ground^® nội địa Hoa Kỳ và nội địa Canada
• FedEx Home Delivery^®
• FedEx International Priority^®
• FedEx International Priority^® Express (IPE)
• FedEx International Economy^®
• FedEx Priority Overnight^TM
• FedEx® Regional Economy
• FedEx® Regional Economy Freight
• FedEx International Connect Plus®
• FedEx® First
• FedEx Priority Express
• FedEx Priority
• FedEx Priority Express Freight
• FedEx Priority Freight
• FedEx Economy (Chỉ Vương quốc Anh)

Sau đây là các tính năng liên kết với API Vận chuyển mở:

Quản lý lô hàng mở

Tính năng này cho phép người gửi tạo, sửa đổi, xóa Lô hàng mở và truy xuất Lô hàng mở đã tạo để xem lại hoặc xác minh. Người gửi có thể xác nhận lô hàng đã hoàn tất để chuyển dữ liệu lô hàng đến FedEx và tạo giấy tờ phù hợp cho lô hàng. Tính năng này cũng xác định và báo cáo các lỗi (nếu có) trong giao dịch và cung cấp trạng thái thích hợp.

Các thông tin quan trọng trong tính năng này là accountNumber, Dữ liệu lô hàng, groupPackageCount, chỉ mục để biểu thị gói hàng chính trong lô hàng. Kết quả của tính năng này sẽ đảm bảo tải dữ liệu lô hàng lên các hệ thống FedEx và tạo các số theo dõi, nhãn cũng như báo cáo phù hợp cho lô hàng.

Quản lý gói hàng trong lô hàng mở

Tính năng này cho phép bạn thêm, sửa đổi và xóa gói hàng trong Lô hàng mở đã tạo. Bạn cũng có thể truy xuất gói hàng hiện có trong một Lô hàng mở hiện tại.

Nhận kết quả về lô hàng mở (Không đồng bộ)

Tính năng này cho phép truy xuất không đồng bộ kết quả về lô hàng đã xác nhận. Khi bạn xác nhận Lô hàng mở có từ 40 gói hàng trở lên, API sẽ xử lý lô hàng này theo cách không đồng bộ.

Khi lô hàng được xử lý không đồng bộ, phản hồi cho yêu cầu này chỉ xác nhận rằng yêu cầu được xếp hàng đợi thành công, dù lô hàng có được xử lý thành công hay không. Phản hồi cũng trả về jobId để truy xuất kết quả sau. Tính năng này sử dụng jobId để truy xuất Kết quả lô hàng mở (TẠO, SỬA ĐỔI & XÁC NHẬN) có thể là nhãn, báo cáo về lô hàng. Tính năng này cũng xác định và báo cáo các lỗi (nếu có) trong lô hàng và cung cấp trạng thái thích hợp.

Lưu ý: Nếu có lỗi trong phản hồi về lô hàng xử lý không đồng bộ, hãy sửa các lỗi đó và gửi yêu cầu lô hàng mới.

Phần này sẽ mô tả chi tiết quy trình của API Vận chuyển mở. Quy trình Vận chuyển mở được quản lý theo hai cách hay dựa trên hai phương án xử lý:

Quy trình cho 40 gói hàng trở xuống

1. Sử dụng điểm cuối Tạo lô hàng mở để tạo một Lô hàng mở với tất cả thông tin bắt buộc về vận chuyển, bao bì, accountNumber và chỉ mục.
2. Sử dụng điểm cuối Thêm gói hàng vào lô hàng mở để thêm một hoặc nhiều (không quá 40) gói hàng vào Lô hàng mở đã tạo. Các thông tin đầu vào quan trọng là chỉ mục và accountNumber của Lô hàng mở được thêm gói hàng.
3. Sử dụng điểm cuối Xác nhận lô hàng mở để xác nhận sau cùng rằng tất cả gói hàng đã được thêm và lô hàng đã hoàn tất. Thông tin đầu vào quan trọng là chỉ mục và accountNumber của lô hàng mở được xác nhận.

Điểm cuối Xác nhận lô hàng mở này là điểm cuối cuối cùng trong quy trình, giúp xác thực thông tin lô hàng và gói hàng cũng như tạo thành công nhãn và tất cả báo cáo khác cho lô hàng. Điểm cuối này cũng cung cấp chi tiết lỗi được trả về trong quá trình xác thực. Bạn có thể sửa các lỗi này bằng điểm cuối Sửa đổi lô hàng mở hoặc Sửa đổi gói hàng của lô hàng mở và xác nhận lại lô hàng để yêu cầu thành công.

Quy trình cho trên 40 gói hàng

1. Sử dụng điểm cuối Tạo lô hàng mở để tạo một Lô hàng mở với tất cả thông tin bắt buộc về vận chuyển, bao bì, accountNumber và chỉ mục.
2. Sử dụng điểm cuối Thêm gói hàng vào lô hàng mở để thêm một hoặc nhiều (không quá 40) gói hàng vào Lô hàng mở đã tạo. Các thông tin quan trọng là chỉ mục và accountNumber của Lô hàng mở được thêm gói hàng.
3. Sử dụng điểm cuối Xác nhận lô hàng mở để xác nhận tất cả gói hàng đã được thêm và lô hàng đã hoàn tất. Thông tin đầu vào quan trọng là chỉ mục và accountNumber của lô hàng mở được xác nhận. Trong trường hợp này, vì có trên 40 gói hàng, API sẽ xử lý lô hàng theo cách không đồng bộ và trả về jobId mà bạn có thể sử dụng sau để truy xuất kết quả lô hàng. Nếu phản hồi có lỗi, bạn có thể sửa các lỗi này bằng điểm cuối Sửa đổi lô hàng mở hoặc Sửa đổi gói hàng của lô hàng mở và xác nhận lô hàng bằng điểm cuối Xác nhận lô hàng mở.
4. Sử dụng điểm cuối Nhận kết quả lô hàng mở để truy xuất kết quả về Tạo, Sửa đổi & Xác nhận lô hàng mở như nhãn và giấy tờ vận chuyển. Các thông tin đầu vào quan trọng là jobId và accountNumber của lô hàng đã xác nhận.

Điểm cuối Nhận kết quả lô hàng mở là điểm cuối cuối cùng trong quy trình, giúp truy xuất kết quả về Lô hàng mở đã xác nhận, như nhãn và tất cả báo cáo khác về Lô hàng mở đã xác nhận. Nếu phản hồi trả về chi tiết lỗi, bạn có thể sửa các lỗi này bằng điểm cuối Sửa đổi lô hàng mở hoặc Sửa đổi gói hàng của lô hàng mở, rồi xác nhận lô hàng bằng điểm cuối Xác nhận lô hàng mở, cuối cùng là sử dụng điểm cuối Nhận kết quả lô hàng mở để truy xuất kết quả về Lô hàng mở đã xác nhận để yêu cầu thành công.

Sau đây là các chức năng gắn với API Vận chuyển mở:

Tạo lô hàng mở

Sử dụng điểm cuối này để tạo Lô hàng mở với thông tin lô hàng bắt buộc và xác định ít nhất một gói hàng trong lô hàng.

Sau đây là các thông tin đầu vào bắt buộc để tạo Lô hàng mở:

• openShipmentAction – Đây là hành động Tạo lô hàng và trong trường hợp này, hãy sử dụng giá trị là CREATE_PACKAGE.
• accountNumber – Đây là số tài khoản FedEx.
• requestedShipment – Thông tin chi tiết về Lô hàng mở.
• chỉ mục – Giá trị độc nhất của Lô hàng mở, giá trị này hữu ích trong việc sửa đổi lô hàng hoặc gói hàng. Thông tin này là không bắt buộc, nếu không được cung cấp, bạn có thể sử dụng số theo dõi chính để xác định riêng một lô hàng.

Phản hồi thành công của yêu cầu này sẽ xử lý lô hàng và tạo số theo dõi, chính là Số theo dõi chính của gói hàng đầu tiên. Lưu ý rằng phản hồi sẽ không tạo nhãn.

Thêm gói hàng vào lô hàng mở

Sử dụng điểm cuối này để thêm một hay nhiều gói hàng vào yêu cầu Lô hàng mở hiện tại trước khi xác nhận lô hàng. Vào bất kỳ lúc nào trong ngày, bạn có thể gửi riêng một yêu cầu Thêm gói hàng để thêm từng gói hàng nhằm chuẩn bị lô hàng. Bạn cũng có thể gửi nhiều kiện trong một yêu cầu Thêm gói hàng.

Lưu ý: Tổng số lượng gói hàng của lô hàng không được vượt quá giới hạn gói hàng của Lô hàng mở.

Sau đây là các thông tin đầu vào bắt buộc để Thêm gói hàng vào Lô hàng mở:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• requestedPackageLineItem – Thông tin chi tiết về (các) gói hàng được thêm.
• accountNumber – Đây là số tài khoản FedEx.

Phản hồi thành công của yêu cầu này sẽ tạo số theo dõi cho gói hàng mới thêm.

Sửa đổi gói hàng của lô hàng mở

Sử dụng điểm cuối này để sửa đổi chi tiết của một hoặc nhiều gói hàng trong một Lô hàng mở hiện tại trước khi xác nhận lô hàng. Trong số này bao gồm cả gói hàng chính, là gói hàng đầu tiên được thêm vào Lô hàng mở.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.
• trackingId – Một hoặc nhiều ID theo dõi (các) gói hàng vận chuyển mở của gói hàng được sửa đổi.
• requestedPackageLineItem – Thông tin chi tiết về (các) gói hàng được sửa đổi.

Yêu cầu thành công sẽ cập nhật các gói hàng dự định gửi và trả về chi tiết lô hàng đã cập nhật.

Xóa gói hàng trong lô hàng mở

Sử dụng điểm cuối này để xóa một hoặc nhiều gói hàng khỏi Lô hàng mở đã tạo trước khi xác nhận lô hàng.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.
• trackingId – Một hoặc nhiều ID theo dõi (các) gói hàng vận chuyển mở nhận được yêu cầu xóa.

Yêu cầu thành công sẽ xóa các gói hàng dự định gửi và trả về trạng thái cho phần tử deletedPackagesFromOpenshipment là true ở kết quả đầu ra.

Lưu ý: Nếu bạn xóa gói hàng chính khỏi lô hàng, gói hàng tiếp theo trong chuỗi sẽ trở thành gói hàng chính và số theo dõi chính sẽ được chỉ định lại cho gói hàng này. Chuỗi số sẽ giảm đúng bằng số gói hàng đã xóa.

Truy xuất gói hàng của lô hàng mở

Sử dụng điểm cuối này để truy xuất một hoặc nhiều gói hàng từ Lô hàng mở đã tạo để xem lại hoặc xác thực.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.
• trackingId – Một hoặc nhiều ID theo dõi (các) gói hàng vận chuyển mở được truy xuất chi tiết.

Yêu cầu thành công sẽ truy xuất các gói hàng dự định gửi.

Sửa đổi lô hàng mở

Sử dụng điểm cuối này để sửa đổi một yêu cầu Lô hàng mở để các thông tin vận chuyển bắt buộc đều đúng trước khi xác nhận lô hàng.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.
• requestedShipment – Chi tiết lô hàng của Lô hàng mở được sửa đổi.

Yêu cầu thành công sẽ cập nhật thông tin chi tiết về lô hàng cho Lô hàng mở đã tạo và trả về số theo dõi của (các) gói hàng được sửa đổi cũng như chi tiết lô hàng giao dịch được cập nhật làm kết quả đầu ra.

Truy xuất lô hàng mở

Sử dụng điểm cuối này để truy xuất Lô hàng mở đã tạo để xem lại hoặc xác thực.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.

Yêu cầu thành công sẽ truy xuất chi tiết về Lô hàng mở dự định gửi.

Xóa lô hàng mở

Sử dụng điểm cuối này để xóa yêu cầu Lô hàng mở trước khi xác nhận lô hàng.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.

Yêu cầu thành công sẽ xóa Lô hàng mở cũng như tất cả gói hàng liên kết và trả về trạng thái trong phần tử deletedOpenshipment là true ở kết quả đầu ra.

Xác nhận lô hàng mở

Sử dụng điểm cuối này để xác thực và tải dữ liệu lô hàng Vận chuyển mở lên Các hệ thống FedEx sau khi tất cả gói hàng được thêm vào yêu cầu Lô hàng.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• chỉ mục – Đây là giá trị độc nhất được chỉ định cho Lô hàng mở đã tạo. Nếu không có thông tin này, hãy cung cấp số theo dõi chính.
• accountNumber – Đây là số tài khoản FedEx.
• labelResponseOptions – Xác định phản hồi sẽ trả về bytecode được mã hóa hay URL cho nhãn.
  Lưu ý: Phần tử labelResponseOptions chỉ có trong Yêu cầu xác nhận lô hàng mở và sau khi có xác nhận lô hàng thì nhãn sẽ được tạo.

Phản hồi xác nhận thành công cho 40 gói hàng trở xuống sẽ tải dữ liệu lô hàng lên các hệ thống FedEx và tạo nhãn Gói hàng cũng như tất cả báo cáo khác về lô hàng.

Phản hồi xác nhận thành công cho trên 40 gói hàng xác nhận rằng yêu cầu được xếp hàng đợi thành công và trả về jobId để truy xuất kết quả sau.

Lưu ý: Bạn nên thêm tối thiểu một gói hàng vào Lô hàng mở để có thể xác nhận lô hàng.

Nhận kết quả về lô hàng mở

Sử dụng điểm cuối này để nhận dữ liệu về lô hàng Vận chuyển mở được xác nhận. Bạn chỉ nên sử dụng điểm cuối này khi lô hàng có trên 40 gói hàng và phản hồi xác nhận Lô hàng mở trả về jobId.

Sau đây là các thông tin đầu vào cần thiết liên kết với yêu cầu này:

• resultMethodType – Xác định giá trị là CREATE.
• accountNumber – Đây là số tài khoản FedEx.
• jobId – Đây là jobId nhận được trong quá trình xác nhận Lô hàng mở.

Phản hồi thành công của yêu cầu này sẽ trả về kết quả cho Lô hàng mở được xác nhận, như nhãn Gói hàng và tất cả báo cáo khác về lô hàng của Lô hàng mở được xác nhận. Nếu phản hồi trả về chi tiết lỗi, bạn có thể sửa các lỗi này bằng điểm cuối Sửa đổi lô hàng mở hoặc Sửa đổi gói hàng của lô hàng mở, rồi xác nhận lô hàng bằng điểm cuối Xác nhận lô hàng mở, cuối cùng là sử dụng điểm cuối Nhận kết quả lô hàng mở để truy xuất kết quả Lô hàng mở đã xác nhận để yêu cầu thành công.

Lô hàng mở nhiều kiện (MPS) chứa từ hai gói hàng trở lên được vận chuyển đến cùng địa chỉ người nhận. Gói hàng đầu tiên trong yêu cầu lô hàng được coi là gói hàng chính.

Để tạo lô hàng nhiều kiện:

• Thêm các thông tin ở cấp độ lô hàng như chi tiết về serviceType, packagingType, totalWeight, totalPackageCount và requestedPackageLineItems vào gói hàng chính.
  Lưu ý: sequenceNumber của gói hàng chính phải bằng 1.
• Thêm tất cả gói hàng vào lô hàng.
• Xác nhận lô hàng.

Sau khi bạn xác nhận lô hàng, sử dụng một trong các phương án xử lý ở bên dưới:

Xử lý lô hàng đồng bộ

Xử lý đồng bộ là một trong những phương pháp xử lý tối ưu, được sử dụng nội bộ khi một lô hàng có từ 40 gói hàng trở xuống (tổng số lượng gói hàng/grouppackagecount<=40) với hàng hóa giới hạn trong lô hàng.

Khi xác nhận, yêu cầu lô hàng có từ 40 lô hàng trở xuống sẽ được xử lý đồng bộ và các nhãn, chứng từ/báo cáo của lô hàng sẽ được tạo ngay lập tức. Quá trình này tối ưu cho người gửi, nếu có hạn chế về thời gian và nếu các nhãn phải được in ngay sau khi xác nhận lô hàng.

Lưu ý: Giới hạn tối đa 40 gói hàng là chỉ báo và không phải là giới hạn cố định. Giới hạn cũng phụ thuộc vào việc kết hợp các gói hàng và hàng hóa trong lô hàng. Để biết thêm chi tiết, hãy liên hệ với nhóm hỗ trợ FedEx.

Ví dụ: Yêu cầu Lô hàng mở của bạn gồm 10 gói hàng. Khi bạn xác nhận lô hàng sau khi thêm tất cả 10 gói hàng, lô hàng sẽ được xử lý đồng bộ. Trong phản hồi sẽ xuất hiện 10 nhãn đã tạo; URL cho nhãn hoặc nhãn được mã hóa theo yêu cầu cũng sẽ được cung cấp.

Quy trình chi tiết sau đây minh họa quá trình xử lý đồng bộ cho Lô hàng mở:

1. Sử dụng điểm cuối Tạo lô hàng mở.
2. Thêm 1-40 gói hàng bằng điểm cuối Thêm gói hàng vào lô hàng mở
3. Sử dụng điểm cuối Xác nhận lô hàng mở để xác nhận Lô hàng mở.
4. Yêu cầu thành công sẽ tạo nhãn và phản hồi đầu ra sẽ có nhãn URL hoặc nhãn được mã hóa theo yêu cầu.
5. Nếu lô hàng có lỗi, thông tin chi tiết về lỗi sẽ được cung cấp trong phần phản hồi.
6. Sau khi sửa tất cả các lỗi, hãy sử dụng điểm cuối Xác nhận lô hàng mở để phản hồi thành công.

Lưu ý: 

• Trong phương pháp này, nếu cần thêm nhiều gói hơn vào lô hàng hiện có, bạn chỉ có thể thêm tối đa tổng số 40 gói hàng. 

Xử lý lô hàng không đồng bộ

API xử lý nội bộ lô hàng theo cách không đồng bộ khi tổng số lượng gói hàng vượt quá 40 (nghĩa là totalPackageCount > 40). Đây là một phương thức rất tiện lợi, khi số lượng gói hàng lớn và bạn muốn gửi các lô hàng với số gói hàng lớn như vậy theo định kỳ. Việc gửi lô hàng với quá nhiều gói hàng cùng một lúc đòi hỏi hoạt động phức tạp và sử dụng nhiều tài nguyên tốn kém của FedEx. Với phương án xử lý này, FedEx đảm bảo nội bộ rằng các lô hàng với số gói hàng lớn được xử lý dễ dàng và bạn cũng có thể nhận dữ liệu về nhãn theo định kỳ.

Khi lô hàng được xử lý không đồng bộ, phản hồi cho yêu cầu này chỉ xác nhận rằng yêu cầu được xếp hàng đợi thành công, dù lô hàng có được xử lý thành công hay không, và trả về jobId để truy xuất kết quả sau.

Lưu ý: Quá trình này cần thời gian để lô hàng được xử lý thành công, sau đó bạn mới có thể truy xuất kết quả.

Để truy xuất kết quả lô hàng xử lý không đồng bộ, hãy sử dụng điểm cuối Nhận kết quả lô hàng mở và cung cấp chi tiết về jobId cũng như accountNumber trong yêu cầu. Phản hồi cho yêu cầu này sẽ trả về dữ liệu kết quả lô hàng kèm theo chi tiết nhãn hoặc chi tiết về lỗi của lô hàng.

Ví dụ: Lô hàng của bạn gồm 45 gói hàng, sau khi xác nhận sẽ được xử lý không đồng bộ. Phản hồi sẽ trả về jobId. Sau đó, bạn có thể sử dụng điểm cuối Nhận kết quả lô hàng mở để truy xuất kết quả về lô hàng và dữ liệu cho nhãn.

Quy trình chi tiết sau đây minh họa quá trình xử lý lô hàng không đồng bộ:

1. Sử dụng điểm cuối Tạo lô hàng mở.
2. Thêm từ 40 gói hàng trở lên bằng điểm cuối Thêm gói hàng vào lô hàng mở.
3. Sử dụng điểm cuối Xác nhận lô hàng mở để xác nhận lô hàng.
4. Việc gửi thành công sẽ cung cấp jobId.
5. Sử dụng jobId và accountNumber để truy xuất kết quả đầu ra bằng điểm cuối Nhận kết quả lô hàng mở.
6. Kết quả đầu ra thành công sẽ cung cấp dữ liệu kết quả lô hàng kèm theo chi tiết về nhãn.
7. Nếu kết quả có lỗi, thông tin chi tiết về lỗi sẽ được cung cấp trong phần phản hồi.

Lưu ý:

• Trong phương pháp này, tổng số gói hàng tối đa được phép là 300 gói hàng hoặc lên tới 999 hàng hóa trong một yêu cầu. 
• Trong phương pháp này, sau khi gửi yêu cầu, bạn không thể thêm mới, sửa đổi hoặc xóa các gói hàng trong yêu cầu ban đầu. Nếu phản hồi trả về có lỗi, hãy sửa các lỗi này bằng điểm cuối Sửa đổi gói hàng của lô hàng mở, rồi xác nhận lô hàng bằng điểm cuối Xác nhận lô hàng mở, sau đó nhận kết quả đầu ra thành công bằng điểm cuối Nhận kết quả lô hàng mở..

API FedEx hỗ trợ nhiều loại nhãn. API FedEx hỗ trợ ba loại tùy chọn nhãn, bao gồm giấy in nhiệt, giấy thường và nhãn có thể tùy chỉnh. Bạn có thể sử dụng các điểm cuối của API Vận chuyển mở để tạo nhiều loại nhãn.

FedEx cung cấp 2 định dạng nhãn để hỗ trợ dịch vụ vận chuyển:

• Nhãn nhiệt
• Nhãn laze

Nhãn nhiệt

API FedEx cho phép bạn in nhãn vận chuyển cho tất cả các loại vận chuyển, chẳng hạn như FedEx Express^®, FedEx Ground^® và FedEx International Ground^®, bằng nhiều loại máy in nhãn nhiệt.

API FedEx hỗ trợ nhãn nhiệt với các kích thước sau:

• 4'' x 6'' – không có nhãn chứng từ có thể điều chỉnh
• 4'' x 6,75'' – có hoặc không có nhãn chứng từ
• 4'' x 8'' – chừa khoảng trống để bạn tùy ý đưa thêm tệp đồ họa hoặc tệp văn bản vào
• 4 x 8,5 inch (10,16 x 21,59 cm) – có nhãn chứng từ có thể điều chỉnh (đi kèm riêng cho nhãn nhận dạng lốp xe)
• 4'' x 9'' – chừa khoảng trống cho đồ họa hoặc văn bản cũng như nhãn chứng từ
• 4 x 10,5 inch (10,16 x 26,67 cm) – có nhãn chứng từ có thể điều chỉnh (đi kèm riêng cho nhãn nhận dạng lốp xe)
  

Các loại giấy in nhãn 4 X 8,5 inch (10,16 x 21,59 cm) và 4 X 10,5 inch (10,16 x 26,67 cm) đi kèm nhãn chứng từ bổ sung có cùng mã vạch. Một mã vạch được in trên nhãn chính còn mã vạch kia được in trên nhãn chứng từ. Loại giấy in nhãn này rất hữu dụng cho gói hàng lốp xe vì có thể đặt nhãn trên mặt gai lốp xe và nhãn chứng từ bổ sung có bản sao mã vạch và hướng dẫn vận hành trên mép lốp xe. Việc sử dụng các loại giấy in nhãn này sẽ làm giảm số lần phải dán lại nhãn cho lốp xe, đồng thời, việc quét kích thước được tăng cường giúp tối ưu hoá khả năng khôi phục. Để biết thêm thông tin về giấy in nhãn, hãy tham khảo phần Các loại giấy in nhãn.

Lưu ý: Nhãn chứng từ là một nhãn dính bóc được, chứa thông tin vận chuyển bổ sung bạn có thể chọn để hiện trên giấy in nhãn, trong khi in nhãn vận chuyển bằng máy in nhiệt.

Các phần tử trên nhãn nhiệt

Nhãn vận chuyển nhiệt bao gồm ba phần tử cơ bản:

• Nội dung con người có thể đọc được: phần này của nhãn chứa thông tin vận chuyển.
• Mã vạch con người có thể đọc được của Ground sẽ được mã hóa theo mặc định.
• Mã vạch hai chiều (2D): mã vạch hai chiều gồm các chữ cái và chữ số, lưu trữ dữ liệu cho cả lô hàng FedEx Express và FedEx Ground sử dụng tiêu chuẩn MH10.8.3 của Viện Tiêu chuẩn quốc gia Hoa Kỳ (ANSI). Mã vạch 2D được tạo bằng cách sử dụng ký hiệu Portable Data File (PDF) 417.
• Mã vạch riêng của FedEx:
  • ASTRA (Hỗ trợ định tuyến theo dõi sắp xếp nâng cao) cho lô hàng FedEx Express cho đến khi mã vạch FDX 1D được đưa vào sử dụng hoàn toàn; mã vạch "96" cho FedEx Ground và FedEx Home Delivery. FedEx Ground cũng cho phép sử dụng mã vạch SSCC-18 "00".
  • Mã vạch FedEx 1D (FDX1D) cho lô hàng FedEx Express được tạo bằng ANSI/AIM BC4-1995 (Đặc điểm kỹ thuật ký hiệu thống nhất CODE-128C).

Thông tin chính để tạo nhãn nhiệt

Sau đây là thông tin chính cần thiết để tạo nhãn nhiệt:

• LabelFormatType: Bắt buộc để nhận hình ảnh nhãn chính xác trong API Phản hồi vận chuyển mở:
  • COMMON2D: Loại định dạng nhãn để nhận nhãn.
  • LABEL_DATA_ONLY: Giá trị được sử dụng để nhận dữ liệu mã vạch nếu bạn tạo nhãn tùy chỉnh.

Giá trị hợp lệ:

• ImageType: Bắt buộc để định dạng nhãn nhiệt cho máy in bạn sử dụng; cung cấp loại luồng dữ liệu hoặc bitmap được trả về.

  • EPL2 - Eltron (Loại giấy in nhãn)
  • ZPLII - Zebra (Loại giấy in nhãn)

Giá trị hợp lệ:

Lưu ý: Tất cả các nhãn bắt buộc của lô hàng được tạo và trả về trong một vùng đệm duy nhất.

Các máy in nhiệt được hỗ trợ

Bạn nên sử dụng các máy in nhiệt sau với API FedEx:

• Unimark
• Eltron
  • Orion (EPL2)
  • Eclipse (EPL2)
• Zebra
  • LP2443 (EPL2)
  • LP2844 (EPL2)
  • Gk420 (ZPL)
  • LP2348 Plus (EPL2/ZPL)
  • Z4M Plus (ZPL or EPL)
  • ZP500/ZP505 (EPL2/ZPL)
  • Z4M/Z4M+ (EPL2/ZPL)
  • ZM400 (EPL2/ZPL)
  • ZT410 (EPL2/ZPL)
  • Các máy in khác thuộc dòng ZT4xx (EPL2/ZPL)

Lưu ý: Tất cả các máy in này đều tương thích với chế độ trang Ngôn ngữ lập trình ASCII Eltron (EPL2). Các máy in nhiệt được hỗ trợ cả ở dạng ghi trực tiếp vào máy in được kết nối với cổng nối tiếp của hệ thống và như khi là máy in được cài đặt sẵn trong Windows để kết nối qua cổng LPT, nối tiếp hoặc USB. Các phiên bản phần mềm hệ thống của máy in do FedEx cung cấp có thể khác nhau tùy theo khu vực.

Số lượng nhãn nhiệt được in cho mỗi dịch vụ

Bảng sau đây cho biết số lượng mỗi loại nhãn cần thiết cho từng dịch vụ đặc biệt. Tất cả các nhãn cần thiết được tạo bằng lệnh gọi đến Máy chủ nhãn chung FedEx (CLS) và CLS trả về một vùng đệm duy nhất, ngoại trừ nhãn trả hàng cho dịch vụ thu tiền khi giao hàng.

Số lượng nhãn nhiệt được in cho mỗi dịch vụ ở Hoa Kỳ

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
FedEx Express Hoa Kỳ	1 nhãn vận chuyển
FedEx Ground Hoa Kỳ/FedEx Home Delivery	1 nhãn vận chuyển

Số lượng nhãn nhiệt được in cho mỗi dịch vụ quốc tế xuất khẩu từ Hoa Kỳ

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
FedEx Express quốc tế xuất khẩu từ Hoa Kỳ	1 nhãn vận chuyển 2 nhãn người nhận
FedEx Express quốc tế xuất khẩu từ Hoa Kỳ có tùy chọn tự chọn nhà môi giới	1 nhãn vận chuyển 2 nhãn người nhận
FedEx Ground quốc tế xuất khẩu từ Hoa Kỳ	1 nhãn vận chuyển
FedEx Ground quốc tế xuất khẩu từ Hoa Kỳ C.O.D.	1 nhãn vận chuyển 2 nhãn trả hàng C.O.D.

Số lượng nhãn nhiệt được in cho mỗi dịch vụ nội địa Canada

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
FedEx Express nội địa Canada	Lô hàng không phải DG (Hàng hóa nguy hiểm)/Đá khô: 1 nhãn vận chuyển
FedEx Ground nội địa Canada	1 nhãn vận chuyển
FedEx Ground nội địa Canada C.O.D.	1 nhãn vận chuyển 2 nhãn trả hàng C.O.D.

Số lượng nhãn nhiệt được in cho mỗi dịch vụ quốc tế xuất khẩu từ Canada

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
FedEx Express quốc tế xuất khẩu từ Canada	Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Express quốc tế xuất khẩu từ Canada có tự chọn nhà môi giới	Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Ground quốc tế xuất khẩu từ Canada (CA)	1 nhãn vận chuyển

Số lượng nhãn nhiệt được in cho mỗi lô hàng đến Philippines và Thái Lan

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
Lô hàng đến Philippines	2 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản 3 bản sao hóa đơn thương mại
Lô hàng hàng hóa đến Thái Lan	3 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản
Lô hàng tài liệu đến Thái Lan	2 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản

Nhãn chứng từ

Nếu bạn in nhãn vận chuyển bằng máy in nhiệt, bạn có thể chọn giấy in nhãn bao gồm nhãn chứng từ, một nhãn dính bóc được chứa thông tin vận chuyển bổ sung. Bạn có thể cấu hình thông tin vận chuyển này từ dữ liệu vận chuyển của mình hoặc chọn in dữ liệu có thể cấu hình cụ thể cho nhu cầu vận chuyển của bạn.

Nhãn laze

API FedEx hỗ trợ in nhãn bằng máy in laze. Các nhãn này thường được in trên giấy khổ A4 hoặc Letter của Hoa Kỳ và được gấp đôi để đựng vừa trong túi đựng nhãn FedEx tiêu chuẩn. Nhãn in bằng máy in laze được tạo ở định dạng PDF và không cần thay đổi kích thước. Để biết thêm thông tin về giấy in nhãn, hãy tham khảo phần Các loại giấy in nhãn.

Điều kiện

Các yêu cầu sau áp dụng cho nhãn PDF:

• Yêu cầu Adobe Reader 6.0 trở lên để xử lý nhãn.
• Cấu hình trình điều khiển máy in phải được cài đặt để không thể thay đổi kích thước trên máy in.
• Không cần sử dụng trình bọc HTML để hiển thị nhãn PDF bằng giấy thường trong trình duyệt.
• Acrobat khuyến nghị dùng các trình duyệt sau để xem tài liệu PDF:
  • Microsoft Internet Explorer 10 trở lên
  • Firefox 1.0 trở lên
  • Mozilla 1.7 trở lên

Tùy chọn nhãn PDF giúp bạn không cần chỉ định thông số về hướng hình ảnh (chiều rộng và chiều cao) hay độ phân giải màn hình để hiển thị nhãn chính xác trong trình duyệt.

Các phần tử trên nhãn laze

Nhãn vận chuyển laze bao gồm ba phần tử cơ bản:

• Nội dung con người có thể đọc được – Phần này của nhãn chứa thông tin vận chuyển.
• Mã vạch con người có thể đọc được của Ground sẽ được mã hóa theo mặc định.
• Mã vạch hai chiều (2D) – Mã vạch hai chiều gồm các chữ cái và chữ số, lưu trữ dữ liệu cho cả lô hàng FedEx Express và FedEx Ground sử dụng tiêu chuẩn MH10.8.3 của Viện Tiêu chuẩn quốc gia Hoa Kỳ (ANSI). Mã vạch 2D được tạo bằng cách sử dụng định dạng Tệp dữ liệu di động (PDF) 417.
• Mã vạch riêng của FedEx:
  • ASTRA (Hỗ trợ định tuyến theo dõi sắp xếp nâng cao) cho lô hàng FedEx Express cho đến khi mã vạch FDX 1D được đưa vào sử dụng hoàn toàn; mã vạch "96" cho lô hàng FedEx Ground và FedEx Home Delivery. FedEx Ground cũng cho phép sử dụng mã vạch SSCC-18 "00" trong trường hợp áp dụng.
  • Mã vạch FedEx 1D (FDX1D) cho lô hàng FedEx Express được tạo bằng ANSI/AIM BC4-1995 (Đặc điểm kỹ thuật ký hiệu thống nhất CODE-128C).

Thông tin chính để tạo nhãn laze

Các phần tử API FedEx sau đây là bắt buộc để tạo nhãn laze:

• LabelSpecification/LabelFormatType: Bắt buộc để nhận hình ảnh nhãn chính xác trong API Phản hồi vận chuyển mở: Các giá trị hợp lệ là:
  • COMMON2D – loại định dạng nhãn để nhận nhãn.
  • LABEL_DATA_ONLY – giá trị này được sử dụng để nhận dữ liệu mã vạch nếu bạn tạo nhãn tùy chỉnh.

• LabelSpecification/ImageType: Bắt buộc để chỉ định định dạng nhãn. Loại luồng dữ liệu hoặc bitmap được trả về:

  Các giá trị hợp lệ là:

  • PDF – giấy thường
  • PNG – giấy thường

• LabelSpecification/LabelStockType: Bắt buộc đối với tất cả các loại nhãn. Chỉ định xem giấy in nhãn có nhãn chứng từ ở đầu hay cuối nhãn hay không có nhãn chứng từ. Khi sử dụng ImageType là PDF hoặc PNG, các giá trị sau hiển thị nhãn định dạng laze:
  • PAPER_4X6
  • PAPER_4X8
  • PAPER_4X9
  • PAPER_4X675
    Các giá trị này hiển thị nhãn vận chuyển có định dạng giấy thường:
  • PAPER_7X47
  • PAPER_85X11_BOTTOM_HALF_LABEL
  • PAPER_85X11_TOP_HALF_LABEL
  • PAPER_LETTER

Lưu ý: Nếu bạn yêu cầu nhãn giấy thường, dữ liệu trả về là hình ảnh nhãn được mã hóa Base64, ảnh này phải được giải mã Base64 trước khi hiển thị tệp nhãn.

Các loại máy in laze được hỗ trợ

Hầu hết các máy in laze đều có thể in loại nhãn này; tuy nhiên, nhãn in trên máy in phun mực sẽ không được chấp nhận.
Lưu ý: Nếu bạn sử dụng máy in laze màu, định nghĩa màu nên được đặt thành màu đen, ngay cả khi máy in chỉ được lắp hộp mực đen.

Số lượng nhãn laze cần thiết cho mỗi dịch vụ

Bảng sau đây cho biết số lượng mỗi loại nhãn cần thiết cho từng dịch vụ đặc biệt. Tất cả các nhãn cần thiết được tạo bằng lệnh gọi đến Máy chủ nhãn chung FedEx (CLS) và CLS trả về một vùng đệm duy nhất, ngoại trừ nhãn trả hàng cho dịch vụ thu tiền khi giao hàng.

Số lượng nhãn laze được in cho mỗi dịch vụ ở Hoa Kỳ

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Ground/FedEx Home Delivery Hoa Kỳ	1 nhãn vận chuyển

Số lượng nhãn laze được in cho mỗi dịch vụ quốc tế xuất khẩu từ Hoa Kỳ

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Express quốc tế xuất khẩu từ Hoa Kỳ	1 nhãn vận chuyển trong phần trả lời; tối thiểu phải in 3 nhãn – 1 nhãn trên bao bì và 2 nhãn trong túi đựng chứng từ.
FedEx Express quốc tế xuất khẩu từ Hoa Kỳ có tự chọn nhà môi giới	1 nhãn vận chuyển trong phần trả lời; tối thiểu phải in 3 nhãn – 1 nhãn trên bao bì và 2 nhãn trong túi đựng chứng từ.
FedEx Ground quốc tế xuất khẩu từ Hoa Kỳ	1 nhãn vận chuyển
FedEx Ground quốc tế xuất khẩu từ Hoa Kỳ C.O.D.	1 nhãn vận chuyển 2 nhãn trả hàng C.O.D.

Số lượng nhãn laze được in cho mỗi dịch vụ nội địa Mexico

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Express nội địa Mexico	FedEx Express nội địa Mexico Lô hàng không phải DG (Hàng hóa nguy hiểm)/Đá khô: 1 nhãn vận chuyển

Số lượng nhãn laze được in cho mỗi dịch vụ nội địa Canada

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Express nội địa Canada	FedEx Express nội địa Canada Lô hàng không phải DG (Hàng hóa nguy hiểm)/Đá khô: 1 nhãn vận chuyển
FedEx Ground nội địa Canada	1 nhãn vận chuyển
FedEx Ground nội địa Canada C.O.D.	1 nhãn vận chuyển 2 nhãn trả hàng C.O.D.

Số lượng nhãn laze được in cho mỗi dịch vụ quốc tế xuất khẩu từ Canada

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Express quốc tế xuất khẩu từ Canada	FedEx Express quốc tế xuất khẩu từ Canada Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Express quốc tế xuất khẩu từ Canada có tự chọn nhà môi giới	FedEx Express quốc tế xuất khẩu từ Canada có tự chọn nhà môi giới Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Ground quốc tế xuất khẩu từ Canada (CA)	1 nhãn vận chuyển

Số lượng nhãn laze được in cho mỗi dịch vụ quốc tế xuất khẩu từ Canada

Loại dịch vụ	Nhãn laze - Định dạng PDF
FedEx Express quốc tế xuất khẩu từ Canada	FedEx Express quốc tế xuất khẩu từ Canada Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Express quốc tế xuất khẩu từ Canada có tự chọn nhà môi giới	FedEx Express quốc tế xuất khẩu từ Canada có tự chọn nhà môi giới Lô hàng không phải DG/Đá khô: 1 nhãn vận chuyển 2 nhãn người nhận
FedEx Ground quốc tế xuất khẩu từ Canada (CA)	1 nhãn vận chuyển

Số lượng nhãn laze được in cho mỗi lô hàng đến Philippines và Thái Lan

Loại dịch vụ	Nhãn nhiệt (FedEx CLS sẽ trả về số lượng nhãn thích hợp trong phản hồi)
Lô hàng đến Philippines	2 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản 3 bản sao hóa đơn thương mại
Lô hàng hàng hóa đến Thái Lan	3 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản
Lô hàng tài liệu đến Thái Lan	2 nhãn vận chuyển có in số tài khoản 1 nhãn người nhận không in số tài khoản

Nhãn tùy chỉnh

FedEx cho phép tùy chỉnh nhãn do FedEx tạo. Bạn có thể thêm văn bản liên quan đến doanh nghiệp của mình và chọn loại mã vạch (ký hiệu) được sử dụng trên chứng từ và nhãn FedEx trong phần tùy chỉnh của nhãn nhiệt.

Để hỗ trợ ứng dụng vận chuyển của bạn, API Vận chuyển mở của FedEx cung cấp hai phương án tùy chỉnh nhãn vận chuyển:

• Đặt phần đồ họa PNG PAPER 7 x 4,75 inch lên giấy in nhãn của bạn. Ví dụ: bạn có thể tạo danh sách đóng gói trên biểu mẫu 8 1/2 x 11 inch. Trong biểu mẫu này, bạn cũng có thể đặt phần đồ họa PNG PAPER 7 x 4,75 inch lên thay vì tự tạo nhãn riêng.
• Thêm tệp đồ họa hoặc văn bản vào nhãn nhiệt 4'' x 8'' hoặc 4'' x 9''. Kích thước nhãn này chừa ra khoảng trống 2 inch cho phần đồ họa hoặc văn bản của bạn.

Lưu ý: Không thể thay đổi nội dung con người có thể đọc và mã vạch trong phần chung của nhãn.

Nhãn xác thực tùy chỉnh

Bạn có thể tạo nhãn tùy chỉnh không liên quan đến thông tin vận chuyển ở cả cấp gói hàng và cấp lô hàng bằng cách chỉ định thông tin tùy chỉnh cần thiết, cách định dạng thông tin đó và vị trí đặt thông tin đó trên nhãn tùy chỉnh. Nhãn tùy chỉnh này được giới hạn ở định dạng nhãn nhiệt.

Tùy chỉnh nhãn nhiệt

API FedEx cung cấp hai định dạng nhãn nhiệt mà bạn có thể tùy chỉnh bằng tệp đồ họa hoặc tệp văn bản để không cần phải tạo nhãn tùy chỉnh. Các nhãn này hỗ trợ tất cả các dịch vụ vận chuyển của FedEx. Các định dạng bao gồm:

• Nhãn nhiệt 4'' x 8'' không có nhãn chứng từ
• Nhãn nhiệt 4'' x 9'' có nhãn chứng từ

Các loại nhãn này chừa ra 2 inch để bạn tùy chỉnh. Tính năng này chỉ áp dụng cho nhãn nhiệt được in trên máy in nhiệt cài đặt độ phân giải 203 DPI hoặc 300 DPI.

Quy tắc về nhãn tùy chỉnh

Các quy tắc để sử dụng các định dạng nhãn này là:

• Chỉ có thể tùy chỉnh nhãn gửi hàng. Ví dụ: nếu bạn in nhãn gửi hàng Express 4'' x 8'' có logo công ty bạn, nhãn phụ về người nhận sẽ không hiển thị logo đó.
• Nội dung đồ họa hoặc văn bản có thể tùy chỉnh không được cao quá 2 inch và rộng quá 4 1/2 inch.
• FedEx không hỗ trợ việc sửa chữa. Bản in đồ họa và/hoặc văn bản sẽ ở nguyên dạng khi được gửi trong dịch vụ vận chuyển.
• Nếu tất cả dữ liệu cần thiết để in đồ họa và/hoặc văn bản không được cung cấp (ví dụ: tọa độ X và Y), nhãn vận chuyển hợp lệ sẽ được trả lại mà không có dữ liệu tùy chỉnh. Bạn phải hủy lô hàng được thể hiện bằng nhãn này nếu bạn cố gắng tạo lại nhãn khác bằng hình ảnh và/hoặc văn bản.
• Đối với độ phân giải máy in ở mức 203 DPI (8 chấm/mm), về vị trí trên tọa độ X và Y, dữ liệu tọa độ điểm chèn là giao điểm của các cạnh trên và trái của nhãn nhiệt 4 inch x 6,75 inch kèm nhãn chứng từ ở cuối. Đối với nhãn nhiệt 4 inch x 6,75 inch kèm nhãn chứng từ ở đầu, tăng giá trị tọa độ Y của điểm chèn thêm 164 chấm. Đối với nhãn 4 inch x 6 inch không có nhãn chứng từ, tăng giá trị tọa độ Y của điểm chèn thêm 8 chấm. Các thuộc tính phần tử nhãn nhiệt dựa trên độ phân giải máy in 203 DPI (8 chấm/mm).
• Đối với độ phân giải máy in ở mức 300 DPI (12 chấm/mm), về vị trí trên tọa độ X và Y, dữ liệu tọa độ điểm chèn là giao điểm của các cạnh trên và trái của nhãn nhiệt 4 inch x 6,75 inch kèm nhãn chứng từ ở cuối. Đối với nhãn nhiệt 4 inch x 6,75 inch kèm nhãn chứng từ ở đầu, tăng giá trị tọa độ Y của điểm chèn thêm 246 chấm. Đối với nhãn 4 inch x 6 inch không có nhãn chứng từ, tăng giá trị tọa độ Y của điểm chèn thêm 12 chấm. Các thuộc tính phần tử nhãn nhiệt dựa trên độ phân giải máy in 300 DPI (12 chấm/mm).
  Lưu ý:
  • Đối với mã vạch FXD1D, kích thước X (chiều rộng của thanh hẹp nhất trong ký hiệu) là 15 mil (3 chấm) cho máy in 203 DPI và 13,3 mil (4 chấm) cho máy in 300 DPI.
  • Đối với mã vạch 2D PDF-417, chiều X là 10 mil (2 chấm) cho máy in 203 DPI. Để có được chiều X tương đương gần nhất cho máy in 300 DPI, phải sử dụng mức 9,99 mil (3 chấm).
  • Đối với khối Người gửi/Khác ở đầu nhãn và khối Số tham chiếu của người gửi bên dưới thông tin người nhận (sử dụng phông chữ rất nhỏ), nhà phát triển nhãn cần kiểm tra hướng dẫn lập trình ZPL để tham chiếu chéo các đặc điểm của bộ phông chữ nhằm chọn bộ phông chữ có hiệu suất tương đương cho nhiều độ phân giải đầu in khác.
• Điểm chèn ký tự là góc trên cùng bên trái của ký tự đầu tiên trong chuỗi, tại đường kẻ trên.
• Hạn chế của máy in yêu cầu gốc vị trí ở góc phần tư trên cùng bên trái của mặt trước. Do đó, dữ liệu có thể bắt đầu trong phần tùy chỉnh được của nhãn và ghi vào phần FedEx của nhãn (dữ liệu nhãn nhiệt thực tế). Nếu điều này xảy ra, logo hoặc văn bản của bạn sẽ bị thông tin nhãn FedEx ghi đè lên. Bạn phải chỉnh vị trí để sử dụng nhãn vận chuyển.
• Quá trình thêm thông tin nhãn chứng từ vào nhãn 4'' x 9'' phải được cấu hình bằng cùng một quy trình bạn sử dụng cho nhãn nhiệt kèm nhãn chứng từ 4'' x 6'' tiêu chuẩn.

Lưu ý: Chỉ nên thêm hình ảnh màu 1 bit vì nhãn sẽ được in đen trắng.

Các phần tử trong mục nhập về đồ họa nhãn tùy chỉnh

API cung cấp hình ảnh PNG (Portable Network Graphic) cho nhãn FedEx Express và FedEx Ground. Phần đồ họa trên nhãn PNG là bản sao của nhãn giấy thường hoặc nhiệt được API hỗ trợ. Tùy chọn nhãn này cho phép bạn đặt phần đồ họa cho nhãn PNG trên giấy in nhãn của mình để không cần phải tạo nhãn tùy chỉnh.

Các yêu cầu sau đây sẽ áp dụng khi bạn dùng phần đồ họa PNG 4'' x 6'' nhúng trong chứng từ gửi hàng:

• Giấy in nhãn
• Máy in
• Thay đổi kích thước

Giấy in nhãn

Nhãn PNG 4'' x 6'' chỉ nên sử dụng với giấy in nhãn kiểu bóc dán. Nhóm chứng nhận nhãn FedEx Ground và FedEx Express sẽ từ chối các nhãn PNG 4'' x 6'' không nằm trên giấy in nhãn kiểu bóc dán, bao gồm bất kỳ nhãn nào được in trên giấy thường.

Máy in

Bạn nên sử dụng máy in laze để in nhãn. Không nên sử dụng máy in phun mực vì loại máy in này tạo mã vạch quét được không ổn định. Không thể in nhãn PNG 4'' x 6'' bằng máy in màu trừ phi định nghĩa màu được đặt thành màu đen, ngay cả khi máy in chỉ lắp hộp mực đen. Cài đặt này là cần thiết để đạt được định nghĩa mã vạch chính xác để quét tại trung tâm FedEx.

Thay đổi kích thước

Hình ảnh được trả về trong giao dịch vận chuyển của bạn là 200 điểm trên inch (DPI) và có kích thước 4" (R) x 6" (C) hoặc 800 x 1200 pixel. Nhãn này có hướng dọc và được thiết kế để in trong vùng nhãn 4" x 6". Khi in, nhãn phải có kích thước 4" x 6".

Để tạo nhãn và mã vạch ở giá trị DPI yêu cầu, bạn phải thay đổi kích thước hình ảnh trước khi in. Cách bạn thay đổi kích thước hình ảnh phụ thuộc vào ứng dụng bạn dùng để xem và in nhãn. Để thay đổi kích thước hình ảnh PNG cho nhãn 4" x 6" theo inch: sử dụng chính xác chiều rộng 4'' và chiều dài 6".

Danh sách kiểm tra khi xem lại nhãn

Tất cả mã vạch

Bắt buộc để xác thực:

• Vùng trống: Phải luôn đảm bảo có khoảng trắng ít nhất 0,1 inch cả trên và dưới mã vạch.
• Vùng trống: Phải luôn đảm bảo có khoảng trắng ít nhất 0,2 inch cả bên trái và bên phải mã vạch.
• Kiểm tra để đảm bảo tất cả các mã vạch đáp ứng yêu cầu chiều cao tối thiểu.

Chất lượng in

Các sự cố thường gặp khiến nhãn bị từ chối:

• Vạch bị tách rời
• In bị mờ/khoảng trắng vô hiệu
• Khoảng trắng vô hiệu lặp lại (sự cố con lăn)
• Nhòe (truyền nhiệt)
• Bong tróc (laze) cho thấy sự cố khi kết hợp mực
• Phần in bị nhăn (truyền nhiệt)
• Độ tương phản in đối với nhãn nhiệt trực tiếp phải đạt ít nhất 90%

Các chi tiết con người có thể đọc được trên nhãn Ground

Đối với phần con người có thể đọc được trên nhãn FedEx Ground, những yếu tố sau đây phải có để xác thực:

• Dữ liệu khớp với mã vạch
• Logo FedEx Ground: Logo có thể tải xuống từ trang web riêng của FedEx tại fedex.com.
• Logo FedEx Home Delivery: nhãn phải có chữ “H” lớn đặt trong ô, cách địa chỉ gửi hàng đến khoảng 1". Chữ “H” phải có kích thước tối thiểu 0,25" x 0,70".
• Mô tả dịch vụ
• Thông tin người gửi
• Thông tin về người nhận
• Mã bưu chính và lộ trình
• Ngày gửi hàng
• Trọng lượng thực tế
• Thông tin về thiết bị tự động hóa của khách hàng (dụng cụ đo, ứng dụng/hệ thống, phiên bản)
• Kích thước
• Thông tin tham chiếu khác
• Số theo dõi và ID biểu mẫu (Số theo dõi phải có 14 chữ số)
• ID địa điểm bốc dỡ tại sân bay
• Mã bưu chính

Các chi tiết con người có thể đọc được trên nhãn Express

Các phần tử sau phải được in trên nhãn để vượt qua thủ tục chứng nhận:

• Logo FedEx Express: Logo có thể tải xuống từ trang web riêng của FedEx tại fedex.com.
• Mô tả dịch vụ
• Loại gói hàng, nếu là gói hàng quốc tế
• Ngày giao hàng trong tuần (ví dụ: MON cho thứ Hai)
• Giao hàng vào khoảng ngày
• Số trên dụng cụ đo
• Ngày gửi hàng
• Định dạng số lượng kiện, nội dung phần chữ trên nhãn chính, nội dung phần chữ của nhãn CRN trên tất cả MPS
• ID địa điểm bốc dỡ tại sân bay
• Mã bưu chính và lộ trình
• Tiền tố và hậu tố lộ trình theo thông tin Hỗ trợ sắp xếp và định tuyến toàn cầu
• Mã xử lý
• Cam kết khu vực dịch vụ
• Số điện thoại của người nhận và người gửi
• Trọng lượng
• Kích thước, nếu có
• Trường tham chiếu nếu là lô hàng chất có cồn
• Số theo dõi và ID biểu mẫu (Số theo dõi phải có 14 chữ số)
• Trong nhãn ASTRA, số theo dõi 12 chữ số nằm ở vị trí từ 17 đến 28 của mã vạch 32 ký tự. Trong mã vạch FDX 1D mới, số theo dõi nằm ở vị trí từ 21 đến 34. Số theo dõi của FedEx Express sẽ tiếp tục là 12 chữ số. Số 0 sẽ chiếm hai vị trí đầu tiên.

Các quy tắc sau áp dụng cho API Vận chuyển mở:

• Bạn cũng có thể tạo và xác nhận Lô hàng mở có một gói hàng.
• Lô hàng mở sẽ bị loại bỏ nếu bạn không xác nhận lô hàng vào cuối ngày thứ năm kể từ ngày tạo lô hàng.
• Sau khi xác nhận lô hàng, bạn không thể thêm gói hàng vào Lô hàng mở.