Tạo dự án

1. Chuyển đến Dự án của tôi từ menu và chọn + Tạo dự án. 

2. Nhập Tên dự án. 

• Định dạng tên được đề xuất: Projectname_applicationname. Sau khi hoàn tất, hãy chọn Tiếp theo. 

3. Chọn API và các sản phẩm Advanced Integrated Visibility để đưa vào dự án của bạn. 

• Các sản phẩm Advanced Integrated Visibility chỉ dành cho Nhà cung cấp đơn vị tích hợp của FedEx tại Hoa Kỳ.  
• Nếu chọn bất kỳ sản phẩm trả phí nào, bạn sẽ phải chỉ định tài khoản thanh toán cho dự án và chấp nhận các điều khoản bắt buộc. 

Chỉ định tài khoản thanh toán

    Lưu ý: Bạn bắt buộc phải chỉ định tài khoản thanh toán chỉ khi chọn sản phẩm trả phí. 

1. Chỉ định tài khoản thanh toán trong danh sách các tài khoản đã được thêm vào tổ chức. Địa chỉ thanh toán của tài khoản phải ở Hoa Kỳ.  

2. Chấp nhận Thỏa thuận cấp phép FedEx Developer Portal cũng như Biểu mẫu đặt hàng và chọn Tạo.

Cấu hình Advanced Integrated Visibility trong dự án 

1. Tạo URL đích trong ứng dụng hoặc nền tảng để nhận yêu cầu gọi lại. URL phải: 

• Sử dụng HTTPS 
• Không được sử dụng không gian IP RFC1918, fedex.com và miền phụ tương ứng, cũng như các địa chỉ IP như localhost hoặc 127.0.0.1 

2. Tạo mã thông báo bảo mật để xác thực. Mã thông báo phải: 

• Bao gồm 26 – 100 ký tự, ít nhất một chữ cái viết hoa, ít nhất một chữ cái viết thường và ít nhất một số 

3. Từ menu, hãy chọn Dự án của tôi, rồi chọn tab Advanced Integrated Visibility. 

4. Chọn Tạo dự án Advanced Integrated Visibility. 

5. Chọn loại người dùng: 

• Đơn vị vận chuyển FedEx: Vận chuyển với FedEx và cần tích hợp API FedEx vào ứng dụng của riêng họ 
• Nhà cung cấp FedEx Compatible: Là nhà cung cấp FedEx Compatible được chứng nhận 
• Nhà cung cấp đơn vị tích hợp của FedEx: Bán hoặc cung cấp giải pháp phần mềm sử dụng công nghệ FedEx và là Nhà cung cấp đơn vị tích hợp của FedEx đã được xác thực 

6. Chọn loại gói đăng ký. Bạn có thể đăng ký nhận thông tin từ các sự kiện theo số tài khoản hoặc số theo dõi. 

7. Xác nhận tài khoản thanh toán và chọn các tính năng bạn cần, chẳng hạn như bằng chứng giao hàng, ngày giao hàng ước tính, sự kiện theo dõi hoặc tính năng lọc theo sự kiện. 

8. Nhập chi tiết dự án. 

• Nhập tên dự án duy nhất và dễ nhận biết. 
• Nhập URL đích và mã thông báo bảo mật bạn đã tạo. 
• Nhập địa chỉ email và ngôn ngữ ưu tiên để nhận thông báo về các bản cập nhật và sự cố của Advanced Integrated Visibility. 

9. Chấp nhận Thỏa thuận cấp phép FedEx Developer Portal cũng như Biểu mẫu đặt hàng và chọn Tạo. 

    Lưu ý: Tùy thuộc vào loại gói đăng ký bạn đã chọn, có thể bạn cần thực hiện thêm các bước khác. Để biết chi tiết, hãy xem tài liệu về Webhook.

Để chuyển API sang giai đoạn sản xuất, bạn phải xác thực API. Cấp độ xác thực sẽ khác nhau tùy theo API. Hãy xem lại các yêu cầu xác thực API trước khi bắt đầu.  

1. Từ menu, hãy chọn Dự án của tôi, rồi chọn Tên dự án. 

2. Trên tab Mã API, trong phần Mã kiểm thử, hãy tìm thông tin đăng nhập kiểm thử.  

3. Xác định trường hợp kiểm thử cho các khu vực hoặc lãnh thổ mà bạn dự định triển khai giải pháp của mình. Để biết chi tiết, hãy xem cơ sở cho trường hợp kiểm thử đơn vị tích hợp. 

4. Hoàn thành các giao dịch đăng ký bằng cách sử dụng số tài khoản kiểm thử được cung cấp trước khi chạy các trường hợp kiểm thử. 

5. Hoàn thành tất cả các trường hợp kiểm thử bắt buộc.  

6. Điền thông tin liên hệ và lựa chọn dịch vụ FedEx của bạn vào Phiếu thông tin sản phẩm (PIW). 

7. Hoàn thành Tờ bìa xác thực đơn vị tích hợp. 

Gửi tài liệu 

Gửi tất cả tài liệu cần thiết đến validationmtp@fedex.com. 

1. Chuẩn bị các tài liệu sau đây: 

• PIW đã điền đầy đủ (PDF) 
• Tờ bìa xác thực đã điền đầy đủ (PDF) 
• Giao dịch đăng ký của khách hàng cuối sử dụng phương thức xác thực đa yếu tố (JSON) 
• Nhãn vận chuyển đã quét cho tất cả các trường hợp kiểm thử áp dụng (PDF hoặc PNG) 
• Giao dịch vận chuyển cho ba định dạng nhãn (PDF, PNG và ZPL (JSON)) dành cho API Shipping và API Rating tương ứng 
• Ảnh chụp màn hình (PDF) hiển thị: 
  • Giải pháp phục vụ khách hàng hiển thị các dịch vụ và tùy chọn xử lý đặc biệt của FedEx 
  • Tuyên bố miễn trừ trách nhiệm 
  • Thỏa thuận cấp phép người dùng cuối (EULA) 
  • Quy trình đăng ký của khách hàng cuối 

2. Nén tất cả các tệp vào một tệp .zip duy nhất để tránh các hạn chế của nhà cung cấp dịch vụ email. 

3. Gửi tệp .zip qua email đến đội ngũ xác thực. 

Các phương thức tốt nhất để tránh chậm trễ 

Làm theo các hướng dẫn sau đây để giảm thời gian đánh giá: 

• In và quét nhãn ở độ phân giải tối thiểu 600 DPI. Không gửi các tệp được tạo trực tiếp từ API. 
• Đối với máy in nhiệt, hãy yêu cầu loại hình ảnh phù hợp với máy in của bạn, ví dụ: ZPLII cho máy in Zebra. 
• Đối với dịch vụ FedEx International Express®, hãy đính kèm vận đơn hàng không (AWB) phụ (thứ cấp). 
• Đính kèm nhãn cho mỗi gói hàng trong lô hàng nhiều kiện (MPS). 

Đánh giá nhãn

Đội ngũ Xác thực sẽ xem xét tài liệu bạn gửi. 

• Nếu tài liệu bị từ chối, hãy gửi phản hồi và gửi lại tài liệu. 
• Nếu tài liệu được phê duyệt, bạn sẽ nhận được email xác nhận. Sau khi được phê duyệt, thông tin đăng nhập sản xuất của bạn sẽ được ủy quyền cho các giao dịch tạo nhãn vận chuyển.

1. Từ menu, hãy chọn Dự án của tôi, rồi chọn Tên dự án. 

2. Trong phần API, hãy sao chép và lưu trữ an toàn mã API sản xuất và mã khóa bí mật của bạn. 

    Lưu ý: Hãy lưu mã khóa bí mật của bạn ở một nơi an toàn vì mã khóa này chỉ xuất hiện một lần. Nếu để mất, bạn có thể tạo lại mã khóa mới.