Bắt đầu

FedEx Developer Portal cung cấp một bộ Giao diện lập trình ứng dụng (API) để tích hợp FedEx vào các ứng dụng của bạn. Những hướng dẫn này sẽ chỉ cho bạn cách thiết lập tổ chức, tạo dự án, kiểm thử phần tích hợp, đưa dự án vào sản xuất, cũng như chứng thực API trong một số trường hợp.

Các loại người dùng:

FedEx cung cấp dịch vụ tích hợp cho ba loại người dùng: Đơn vị vận chuyển FedEx, nhà cung cấp các giải pháp phần mềm đã xác minh gọi là Nhà cung cấp FedEx Compatible và Nhà cung cấp đơn vị tích hợp của FedEx đã được xác thực.

Người gửi FedEx:

Công ty sử dụng dịch vụ vận chuyển của FedEx và cần tích hợp API FedEx vào ứng dụng của riêng họ.

Nhà cung cấp dịch vụ hoặc giải pháp:

Công ty cần tích hợp với API FedEx để xây dựng giải pháp, ứng dụng hoặc plugin có thể bán và/hoặc phân phối cho một tổ chức bên ngoài sử dụng dịch vụ vận chuyển của FedEx.

Nhà cung cấp FedEx Compatible: Công ty đã được xác minh có thỏa thuận hợp đồng thông qua chương trình FedEx Compatible.
Nhà cung cấp đơn vị tích hợp của FedEx: Công ty đã được xác thực có thỏa thuận hợp đồng thông qua Chương trình đơn vị tích hợp của FedEx.

Ở bên dưới, hãy chọn cách mô tả đúng nhất về doanh nghiệp của bạn. Bất kể loại người dùng, FedEx đều cung cấp hướng dẫn để giúp bạn bắt đầu.

Chọn để bắt đầu.

Which of the following best describes your business?

Select user

EXPAND ALL

1 Tạo hoặc tham gia tổ chức

Nếu công ty của bạn chưa có tổ chức, hãy tạo một tổ chức. Ngoài ra, bạn có thể tham gia một tổ chức hiện có.

Tạo tổ chức mới

Trên thanh điều hướng, nhấp vào Tạo hoặc tham gia tổ chức.

Lưu ý: Là người tạo, bạn tự động được giữ vai trò quản trị viên của tổ chức.

Quản trị viên có thể:

Mời người dùng tham gia

Chỉ định vai trò cho người dùng (ví dụ: người đóng góp, người xem) và dự án

Quản lý tài khoản vận chuyển

Để tìm hiểu thêm về những vai trò này, hãy xem Hướng dẫn quản trị tổ chức của chúng tôi.

Đối với loại hình Công ty, chọn “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”.

Cung cấp tên công ty của bạn, URL của trang web và tên dành riêng cho tổ chức. Tên tổ chức có thể trùng với tên công ty của bạn hoặc đại diện cho một nhóm cụ thể (phòng ban, bộ phận, khu vực, địa điểm). Thông tin này là cần thiết để xác thực yêu cầu của bạn.

Lưu ý: Chọn tên tổ chức mà tất cả người dùng khác có thể nhận ra (ví dụ: tên công ty, phòng ban, khu vực, địa điểm).

Nêu rõ vị trí công ty và nơi giải pháp phần mềm sẽ được bán hoặc phân phối.

Thêm Tài khoản thanh toán và xác thực tài khoản

Lưu ý: Là nhà cung cấp dịch vụ vận chuyển và kho vận trong Chương trình đơn vị tích hợp của FedEx, bạn phải sử dụng số tài khoản của riêng mình. Bạn không thể sử dụng tài khoản FedEx của khách hàng.

Nhập số tài khoản FedEx của bạn. Nếu bạn chưa có tài khoản FedEx, hãy mở tài khoản tại fedex.com hoặc liên hệ với đại diện bộ phận Hỗ trợ của FedEx.

Nhập biệt danh cho tài khoản và địa chỉ thanh toán liên kết với tài khoản đó. Chọn Tiếp theo.

Lưu ý: Địa chỉ thanh toán phải trùng khớp với thông tin trên hồ sơ của chúng tôi cho tài khoản này. Đây sẽ là tài khoản thanh toán mặc định cho tổ chức của bạn.

Để hoàn tất việc tạo tổ chức, bạn phải xác thực tài khoản. Hãy chọn một tùy chọn xác thực (Tùy chọn Điện thoại chỉ áp dụng cho Đơn vị tích hợp tại Hoa Kỳ và Canada, Email, Tin nhắn văn bản) rồi chọn Tiếp theo.

Hãy nhập mã xác thực bạn nhận được và chọn Gửi.

Chấp thuận các điều khoản

Đọc Thỏa thuận đơn vị tích hợp chung và Cẩm nang về chương trình. Chọn các ô để xác nhận bạn chấp nhận các điều khoản, sau đó chọn Chấp nhận.

Màn hình xác nhận sẽ xuất hiện. Nhấp vào Quản lý tổ chức để chỉnh sửa thông tin chi tiết, nếu cần.

Mời người dùng

Lưu ý: Chỉ Quản trị viên mới có thể mời người dùng.

Chọn Quản lý tổ chức từ menu điều hướng bên trái.

Vào tab Người dùng, rồi chọn Thêm người dùng.

Điền vào biểu mẫu và chỉ định vai trò phù hợp cho người dùng mới: Người xem, Người đóng góp hoặc Quản trị viên.

Để biết thêm thông tin về vai trò của người dùng, hãy xem Hướng dẫn quản trị tổ chức.

Chỉ định người dùng cho dự án (nếu có) trong menu thả xuống với tiêu đề Dự án.

Nhập địa chỉ email của từng người dùng, sau đó chọn Mời.

Tham gia tổ chức hiện có

Yêu cầu lời mời: Nhờ quản trị viên của tổ chức gửi lời mời cho bạn. Bạn có 24 giờ để chấp nhận, sau đó lời mời sẽ hết hạn. Bạn có thể nhờ quản trị viên gửi lại lời mời, nếu cần.

Chấp nhận lời mời: Đăng nhập bằng mã người dùng và mật khẩu hiện tại của bạn. Trong trường hợp mã người dùng đã liên kết với một tổ chức khác, bạn phải tạo mã người dùng mới.

Tạo tổ chức

Tham gia tổ chức hiện có

Bước 1: Yêu cầu quản trị viên của tổ chức gửi cho bạn lời mời.

Nếu công ty của bạn đã tạo tổ chức, hãy yêu cầu quản trị viên của tổ chức mời bạn tham gia. Bạn sẽ có 24 giờ để chấp nhận lời mời. Nếu bỏ lỡ khoảng thời gian đó, bạn có thể yêu cầu họ gửi lại lời mời bất cứ lúc nào.

Bước 2: Chấp nhận lời mời.

Để chấp nhận lời mời, bạn sẽ cần đăng nhập bằng ID người dùng và mật khẩu hiện tại của bạn. Trong trường hợp ID người dùng hiện tại đã được liên kết với tổ chức, bạn sẽ cần tạo ID người dùng mới.

2 Tạo dự án

Tạo dự án API

Truy cập trang Dự án của tôi và mở tab API. Nhấp vào nút Tạo dự án API.

Bước 1: Chọn các API bạn muốn đưa vào dự án

Xem xét hạn mức API, giới hạn tốc độ và chi tiết chứng thực API.

Bước 2: Đặt cấu hình chi tiết dự án

Đặt tên dễ nhận biết cho dự án, chỉ có ở tổ chức của bạn.
Chọn quốc gia bất kỳ mà bạn muốn vận chuyển nội địa, để chúng tôi chỉ định tài khoản vận chuyển thử nghiệm cho bạn. Để thử nghiệm vận chuyển nội địa gói hàng tại một quốc gia châu Âu, bạn phải có tài khoản thử nghiệm riêng cho từng quốc gia. Bạn luôn có thể thêm/xóa quốc gia vào lúc khác.
Để nhận thông báo về các bản cập nhật API mới nhất và mọi thông tin liên quan đến việc ngừng hoạt động, hãy thiết lập các tùy chọn thông báo.

Bước 3: Đọc và chấp nhận các điều khoản, bao gồm cả Thỏa thuận cấp phép của FedEx Developer Portal

Sau khi chấp nhận các điều khoản và nhấp vào nút Tạo, bạn sẽ nhìn thấy màn hình xác nhận. Khi đó, bạn có thể xem thông tin xác thực kiểm thử trong dự án mới.

Tạo dự án webhook

Điều kiện

Xem xét giá: người đăng ký cần thanh toán phí hằng tháng dựa trên số lượng số theo dõi. Tham khảo Hướng dẫn về giá để tìm hiểu thêm về giá.
Thiết lập tài khoản: Webhook Advanced Integrated Visibility yêu cầu tài khoản thanh toán ở Hoa Kỳ và ít nhất một tài khoản gửi hàng, hai loại tài khoản này loại trừ lẫn nhau. Chỉ quản trị viên mới có thể thêm tài khoản thanh toán và tài khoản vận chuyển trên trang Quản lý tổ chức.

Tạo một URL (call back) hợp lệ trong nền tảng hoặc ứng dụng đích

URL đích sẽ được sử dụng để nhận mã xác thực và tin nhắn cũng như thông báo phần tải webhook từ FedEx. URL phải sử dụng HTTPS để đảm bảo tính bảo mật. URL của bạn sẽ bị chặn nếu bao gồm:

Không gian IP RFC1918
fedex.com hoặc miền phụ tương ứng
Địa chỉ IP trong URL này (kể cả localhost, 127.0.0.1)

Tạo mã thông báo bảo mật

Mã thông báo bảo mật này có thể được sử dụng làm khóa bí mật để xác thực và xác nhận thông tin được truyền giữa tổ chức của bạn và FedEx. Mã thông báo bảo mật phải bao gồm:

Độ dài tối thiểu 26 ký tự và tối đa 100 ký tự
1 ký tự viết hoa
1 ký tự viết thường
1 ký tự số

Ví dụ: Y1F6OiVUQW2JPSElmRE9U0IY5

Sau khi xác định URL và mã thông báo bảo mật, bạn đã sẵn sàng tạo dự án webhook. Truy cập trang Dự án của tôi và mở tab Webhook. Nhấp vào nút Tạo dự án webhook.

Chọn loại gói đăng ký

Người gửi FedEx có thể đăng ký nhận thông báo về các sự kiện theo số tài khoản hoặc số theo dõi.

Bước 1: Xác nhận tài khoản thanh toán và chọn tính năng

Xem xét và xác nhận tài khoản thanh toán mặc định được hiển thị hoặc chọn một tài khoản khác từ tổ chức của bạn.
Đặt cấu hình dự án bằng cách chọn các tính năng như tùy chọn bằng chứng giao hàng, tùy chọn giao hàng ước tính, sự kiện theo dõi và lọc theo sự kiện.

Bước 2: Nhập chi tiết dự án

Đặt tên dễ nhận biết cho dự án, chỉ có ở tổ chức của bạn.
Nhập chi tiết mã thông báo bảo mật và URL đích mà bạn đã tạo trong quá trình xác thực trước khi thiết lập (xem các bước ở trên).
Để nhận thông báo về các bản cập nhật webhook mới nhất và mọi thông tin liên quan đến việc ngừng hoạt động, hãy nhập địa chỉ email và ngôn ngữ ưu tiên.

Bước 3: Đọc và chấp nhận các điều khoản

Sau khi chấp nhận các điều khoản – bao gồm cả Thỏa thuận cấp phép của FedEx Developer Portal và Biểu mẫu đặt hàng – và nhấp vào nút Tạo, bạn sẽ nhìn thấy màn hình xác nhận.

Tùy gọi đăng ký đã chọ, có thể bạn cần thực hiện thêm các bước khác. Truy cập tài liệu để tìm hiểu thêm.

Truy cập Dự án của tôi

3 Kiểm thử phần tích hợp

Trên trang Tổng quan về dự án API, hãy lấy thông tin xác thực kiểm thử – khóa API, khóa bí mật và tài khoản vận chuyển – từ tab Khóa kiểm thử.

Bước 1: Yêu cầu mã thông báo truy cập OAuth

Mã thông báo truy cập OAuth phải được sử dụng cho mỗi giao dịch API. Mã thông báo này chỉ có hiệu lực trong một giờ, nên bạn sẽ cần lập trình cho ứng dụng làm mới mã thông báo trước khi phiên hết hạn. Tham khảo tài liệu về Ủy quyền cho API để biết thêm chi tiết.

Bước 2: Xem xét tài liệu về API

Nhấp vào tài liệu về từng API để đọc bối cảnh kinh doanh và hiểu cách sử dụng API. Đăng nhập để tải bộ sưu tập API JSON xuống thông qua nút ở đầu trang tài liệu. Bạn cũng có thể xem các ví dụ về yêu cầu điểm cuối phù hợp với nhu cầu tích hợp của bạn.

Bước 3: Sử dụng sandbox để kiểm thử các giao dịch mẫu

Nhấp vào điểm cuối mong muốn trong menu điều hướng bên trái để chuyển đến sandbox cụ thể đó. Xác định những yêu cầu mẫu phù hợp với trường hợp sử dụng của bạn, sau đó sử dụng thông tin xác thực kiểm thử và URL kiểm thử của FedEx để thực hiện các lệnh gọi đến điểm cuối như được mô tả trong yêu cầu mẫu. Xác minh rằng phản hồi lệnh gọi API mà bạn nhận được khớp với phản hồi hiển thị trong tài liệu. Tìm hiểu thêm về trải nghiệm kiểm thử trong Hướng dẫn sử dụng sandbox được mô phỏng.

Kiểm thử với webhook

Bước kiểm thử có thể giúp bạn biết rõ hơn liệu URL bạn tạo có hợp lệ hay không. Bước này cho phép FedEx xác định và xây dựng kết nối với URL của bạn để gửi dữ liệu. Việc kiểm thử còn có thể cung cấp dữ liệu kiểm thử mẫu, giúp bạn kiểm tra và xác nhận xem bạn có thể xử lý dữ liệu theo dõi được cung cấp trong ứng dụng của mình hay không. Tuy nhiên, việc kiểm thử không xác thực URL. Truy cập tài liệu về webhook để tìm hiểu cách kiểm thử URL webhook.

4 Đưa vào sản xuất

Truy cập trang Tổng quan về dự án và mở tab Khóa sản xuất. Các dự án gói đăng ký Advanced Integrated Visibility dựa trên số tài khoản không cần đưa vào sản xuất.

Bước 1: Đặt cấu hình dự án

Đổi tên khóa khi cần.
Xem lại số tài khoản bạn đã chọn ở bước 1 trong quy trình tạo dự án. Thông tin này được sử dụng để đưa dự án của bạn vào sản xuất. Sau khi dự án của bạn đi vào bước sản xuất, bạn có thể thêm nhiều tài khoản hơn nếu cần.

Bước 2: Nhận khóa dự án

Khóa API sản xuất và khóa bí mật sản xuất sẽ hiển thị để bạn lưu trữ ở nơi an toàn. Để đảm bảo an toàn cho khóa bí mật sản xuất của bạn, chúng tôi chỉ hiển thị khóa một lần. Nếu để mất, bạn có thể tạo khóa mới.

Sau khi nhận khóa dự án và nhấp vào Tiếp, bạn sẽ thấy chi tiết dự án ở tab Khóa sản xuất.

Để thêm các tài khoản vận chuyển khác vào dự án của bạn, hãy nhấp vào Chỉnh sửa ở đầu bảng tài khoản vận chuyển.

5 Chứng thực API của bạn

Các bước chứng thực khác nhau tùy theo khu vực

Các bước sau đây chỉ áp dụng cho khách hàng ở Hoa Kỳ và Canada. Nếu bạn sống ở ngoài hai quốc gia này, hãy truy cập trang Chứng thực API để tìm thông tin hỗ trợ.

Một số API yêu cầu chứng thực nhãn vận chuyển để sử dụng trong môi trường sản xuất của chúng tôi. Tìm hiểu xem API của bạn có yêu cầu chứng thực hay không.

Bước 1: Phát triển và thử nghiệm API FedEx với ứng dụng hỗ trợ web của bạn

Một khi đã hoàn tất việc phát triển ứng dụng hỗ trợ web, đã đến lúc hoàn tất thử nghiệm bằng thông tin thử nghiệm ((các) tài khoản gửi hàng, Mã API và Mã khóa bí mật thử nghiệm). Mã API và Mã khóa bí mật thử nghiệm của bạn sẽ được hiển thị trên trang Tổng quan về dự án và có thể xem bất cứ lúc nào.

Bước 2: Đưa dự án của bạn vào sản xuất

Sau khi đã thử nghiệm với API FedEx, bạn cần bắt đầu quy trình chứng thực bằng việc đưa dự án của mình vào sản xuất trên FedEx Developer Portal. Một khi đã hoàn tất thành công, bạn sẽ thấy Khóa API và Khóa bí mật cho bước sản xuất của mình. Bạn sẽ chỉ nhìn thấy Khóa bí mật sản xuất một lần nhưng sau đó, bạn có thể tạo lại khóa này.

Bước 3: Điền vào Tờ bìa nhãn

Điền đầy đủ thông tin liên hệ thích hợp và các dịch vụ mà bạn dự định triển khai vào Tờ bìa nhãn. Điền cả số tài khoản và khóa sản xuất.

Bước 4: Tạo nhãn kiểm thử và gửi đến Nhóm phân tích mã vạch

Tạo nhãn kiểm thử trong môi trường kiểm thử FedEx liên kết với ứng dụng rồi gửi nhãn kiểm thử cho (các) đội ngũ đánh giá nhãn FedEx để được phê duyệt. Nhóm phân tích mã vạch cần ba ngày làm việc để hoàn thành đánh giá nhãn.

Tuân thủ các phương thức tối ưu sau đây để tránh chậm trễ trong quá trình xử lý:

Nhãn phải được in và quét với độ phân giải tối thiểu là 600 DPI. KHÔNG GỬI CÁC TỆP DO API TẠO RA.
Đối với máy in nhiệt, phải yêu cầu loại hình ảnh của nhãn phù hợp với mẫu máy in. Ví dụ: ZPLII cho máy in Zebra.
Dùng địa chỉ của người gửi/người nhận khi tạo mẫu nhãn để đánh giá. Chỉ tạo mẫu nhãn cho các dịch vụ cụ thể đang đăng ký.
Nhãn Thu tiền mặt khi giao hàng (C.O.D.) của FedEx® phải đi kèm nhãn trả hàng C.O.D. tương ứng.
Các lô hàng FedEx International Express® phải đính kèm nhãn Vận đơn hàng không (AWB) phụ/thứ cấp.
Lô hàng nhiều kiện (MPS) phải đính kèm một nhãn cho mỗi gói hàng trong lô.
Gửi bản PDF và Tờ bìa nhãn đến địa chỉ email label@fedex.com.
Nhãn thực có thể gửi đến địa chỉ sau:

FedEx Services

WTC-Business Solutions Testing

10 FedEx Parkway

2nd Floor Horizontal

Collierville, TN 38017

Nếu nhãn được quét không có những khiếm khuyết nhìn thấy được (ví dụ như các đường chạy ngang mã vạch, đốm mực hoặc hư hại thực tế) thì nhãn có thể qua bước kiểm tra và được phê duyệt. 

Nếu bạn gửi nhãn thực, hãy chú ý đến chất lượng in và những phần bị to/nhỏ của nhãn do vô tình (tức là thay đổi kích thước). Đây là hai lý do chính khiến nhãn không vượt qua được quy trình đánh giá nhãn.

Bước 5: Xem xét việc đánh giá nhãn

Nhóm phân tích mã vạch sẽ đánh giá nhãn thử nghiệm được nộp và phê duyệt hoặc từ chối nhãn. Nhóm phân tích mã vạch sẽ liên hệ với bạn về việc phê duyệt hay từ chối nhãn đã nộp. Nếu được phê duyệt, nhãn sẽ chuyển sang bước tiếp theo. Nếu nhãn bị từ chối, hãy sửa lại nhãn theo hướng dẫn và nộp lại để phê duyệt.

Bước 6: Kích hoạt ứng dụng

Ngay khi Nhóm phân tích mã vạch phê duyệt nhãn thử nghiệm để sang trạng thái sản xuất, họ sẽ ủy quyền thông tin xác thực sản phẩm của bạn để gửi giao dịch nhãn vận chuyển đã xác định và thông báo cho bạn qua email khi chứng thực thành công. Quy trình phê duyệt được thực hiện cho từng dự án.

Bước 7: Thay thế URL và thông tin

Thay thế URL và thông tin thử nghiệm bằng URL và thông tin sản phẩm. Thử nghiệm lại việc triển khai trong môi trường sản xuất bằng dữ liệu mẫu.

EXPAND ALL

1 Liên hệ với FedEx để tạo tổ chức

Điều kiện

Công ty của bạn phải đang là nhà cung cấp FedEx Compatible. Nếu công ty bạn không tham gia chương trình Compatible, hãy thay đổi lựa chọn ở trên thành "Nhà cung cấp ngoài Compatible".

Bước 1: Nhận lời mời tham gia tổ chức

FedEx sẽ tạo tổ chức và mời một thành viên nhóm tham gia tổ chức. Người dùng này sẽ được chỉ định làm quản trị viên cho tổ chức của bạn.

Bước 2: Chấp nhận lời mời

Bước 3: Mời người dùng

Quản trị viên có thể mời người dùng vào tổ chức và chỉ định vai trò, phân công dự án cho người dùng. Mở tab Người dùng. Nhấp vào nút Thêm người dùng.

Chọn vai trò người dùng: Người xem, Người đóng góp hoặc Quản trị viên. Tìm hiểu thêm về các vai trò trong Hướng dẫn quản trị tổ chức của chúng tôi.
Nếu bạn hiện đang có dự án, hãy phân công một dự án cho người dùng. Bạn cũng có thể phân công dự án cho người dùng trong bất kỳ trang Tổng quan về dự án nào.
Nhập địa chỉ email của những người dùng bạn muốn tham gia vào tổ chức trong vai trò đã chọn.

Mời người dùng

2 Chọn sản phẩm của FedEx để tạo dự án

Truy cập Danh mục API để xác định các API hoặc webhook phù hợp cho giải pháp của bạn. Tư vấn viên công nghệ cho khách hàng (CTC) của FedEx và người quản lý Kênh Compatible có thể hỗ trợ bạn chọn API phù hợp cho giải pháp theo nhu cầu kinh doanh.

Bước 1: Điền vào PIW

Quay lại Cộng đồng nhà cung cấp Compatible (CPC) để điền vào Phiếu thông tin sản phẩm (PIW).

Bước 2: Xem xét dự án do FedEx tạo

Sau khi PIW được phê duyệt, FedEx sẽ tạo (các) dự án của bạn. Mỗi phiên bản của từng giải pháp sẽ có một dự án riêng biệt trên FedEx Developer Portal.

Bước 3: Tham dự buổi minh họa API với nhóm của bạn

Đội ngũ FedEx Compatible cùng với CTC của FedEx và đội ngũ Xác minh sẽ tổ chức buổi minh họa kỹ thuật về API với nhóm của bạn. Đội ngũ FedEx sẽ thảo luận về việc Xác minh chương trình Compatible, các tính năng và chức năng API mới cũng như trả lời các câu hỏi.

Truy cập Dự án của tôi

3 Kiểm thử phần tích hợp và hoàn tất việc xác minh

Trên trang Tổng quan về dự án API, hãy lấy thông tin xác thực kiểm thử – khóa API và khóa bí mật – từ tab Khóa kiểm thử.

Bước 1: Tạo khóa khách hàng

Sử dụng Credential Registration API để tạo khóa khách hàng. Đây là API riêng tư chỉ có trong phần API ở cuối trang Tổng quan về dự án API.

Bước 2: Yêu cầu mã thông báo truy cập OAuth

Bước 3: Xem xét tài liệu về API

Bước 4: Sử dụng sandbox để kiểm thử các giao dịch mẫu

Bước 5: Xác minh từng giải pháp

Sau khi kiểm thử đầy đủ các giải pháp của bạn, hãy gửi các trường hợp kiểm thử cho đội ngũ Xác minh để xác minh từng giải pháp. FedEx sẽ xem xét đầy đủ mọi nội dung được gửi và cập nhật thông tin cho bạn sau khi quá trình xác minh được phê duyệt.

Kiểm thử với webhook

Nếu tổ chức của bạn có quyền truy cập vào webhook, bước kiểm thử có thể giúp bạn biết rõ hơn liệu URL bạn tạo có hợp lệ hay không. Bước này cho phép FedEx xác định và xây dựng kết nối với URL của bạn để gửi dữ liệu. Việc kiểm thử còn có thể cung cấp dữ liệu kiểm thử mẫu, giúp bạn kiểm tra và xác nhận xem bạn có thể xử lý dữ liệu theo dõi được cung cấp trong ứng dụng của mình hay không. Tuy nhiên, việc kiểm thử không xác thực URL. Truy cập tài liệu về webhook để tìm hiểu cách kiểm thử URL webhook.

4 Tạo khóa bí mật cho khâu sản xuất

Sau đó, FedEx sẽ đưa (các) dự án vào sản xuất. Truy cập trang Tổng quan về dự án API và mở tab Khóa sản xuất. Nhấp vào liên kết Tạo khóa bí mật dưới cột Khóa bí mật.

Giờ đây, bạn có thể thử nghiệm lại việc triển khai trong môi trường sản xuất bằng dữ liệu mẫu.

EXPAND ALL

1 Tạo hoặc tham gia tổ chức

Tham gia vào tổ chức hiện tại của công ty hoặc tạo tổ chức nếu chưa có tổ chức nào dành cho công ty bạn.

Tạo tổ chức mới

Trên thanh điều hướng, nhấp vào Tạo hoặc tham gia tổ chức.

Lưu ý: Là người tạo, bạn tự động được giữ vai trò quản trị viên của tổ chức.

Quản trị viên có thể:

Mời người dùng tham gia

Chỉ định vai trò cho người dùng (ví dụ: người đóng góp, người xem) và dự án

Quản lý tài khoản vận chuyển

Để tìm hiểu thêm về những vai trò này, hãy xem Hướng dẫn quản trị tổ chức của chúng tôi.

Đối với loại hình Công ty, chọn “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”.

Cung cấp tên công ty của bạn, URL của trang web và tên dành riêng cho tổ chức. Tên tổ chức có thể trùng với tên công ty của bạn hoặc đại diện cho một nhóm cụ thể (phòng ban, bộ phận, khu vực, địa điểm). Thông tin này là cần thiết để xác thực yêu cầu của bạn.

Lưu ý: Chọn tên tổ chức mà tất cả người dùng khác có thể nhận ra (ví dụ: tên công ty, phòng ban, khu vực, địa điểm).

Nêu rõ vị trí công ty và nơi giải pháp phần mềm sẽ được bán hoặc phân phối.

Thêm Tài khoản thanh toán và xác thực tài khoản

Lưu ý: Là nhà cung cấp dịch vụ vận chuyển và kho vận trong Chương trình đơn vị tích hợp của FedEx, bạn phải sử dụng số tài khoản của riêng mình. Bạn không thể sử dụng tài khoản FedEx của khách hàng.

Nhập số tài khoản FedEx của bạn. Nếu bạn chưa có tài khoản FedEx, hãy mở tài khoản tại fedex.com hoặc liên hệ với đại diện bộ phận Hỗ trợ của FedEx.

Nhập biệt danh cho tài khoản và địa chỉ thanh toán liên kết với tài khoản đó. Chọn Tiếp theo.

Lưu ý: Địa chỉ thanh toán phải trùng khớp với thông tin trên hồ sơ của chúng tôi cho tài khoản này. Đây sẽ là tài khoản thanh toán mặc định cho tổ chức của bạn.

Để hoàn tất việc tạo tổ chức, bạn phải xác thực tài khoản. Hãy chọn một tùy chọn xác thực (Tùy chọn Điện thoại chỉ áp dụng cho Đơn vị tích hợp tại Hoa Kỳ và Canada, Email, Tin nhắn văn bản) rồi chọn Tiếp theo.

Hãy nhập mã xác thực bạn nhận được và chọn Gửi.

Chấp thuận các điều khoản

Đọc Thỏa thuận đơn vị tích hợp của FedEx và Cẩm nang về chương trình. Chọn các ô để xác nhận bạn chấp nhận các điều khoản, sau đó chọn Chấp nhận.

Màn hình xác nhận sẽ xuất hiện. Nhấp vào Quản lý tổ chức để chỉnh sửa thông tin chi tiết, nếu cần.

Mời người dùng

Lưu ý: Chỉ Quản trị viên mới có thể mời người dùng.

Chọn Quản lý tổ chức từ menu điều hướng bên trái.

Vào tab Người dùng, rồi chọn Thêm người dùng.

Điền vào biểu mẫu và chỉ định vai trò phù hợp cho người dùng mới: Người xem, Người đóng góp hoặc Quản trị viên.

Để biết thêm thông tin về vai trò của người dùng, hãy xem Hướng dẫn quản trị tổ chức.

Chỉ định người dùng cho dự án (nếu có) trong menu thả xuống với tiêu đề Dự án.

Nhập địa chỉ email của từng người dùng, sau đó chọn Mời.

Tạo tổ chức

Tham gia tổ chức hiện có

Yêu cầu lời mời: Nhờ quản trị viên của tổ chức gửi lời mời cho bạn. Bạn có 24 giờ để chấp nhận, sau đó lời mời sẽ hết hạn. Bạn có thể nhờ quản trị viên gửi lại lời mời, nếu cần.

Chấp nhận lời mời: Đăng nhập bằng mã người dùng và mật khẩu hiện tại của bạn. Trong trường hợp mã người dùng đã liên kết với một tổ chức khác, bạn phải tạo mã người dùng mới.

2 Tạo dự án

Tạo dự án API

Vào trang Dự án của tôi rồi chọn Tạo dự án.

Điền vào trường Tên dự án. Định dạng tên được đề xuất là “TênDựÁn_TênỨngDụng”. Sau khi hoàn tất, chọn Tiếp theo.

Chọn API và các sản phẩm Advanced Integrated Visibility cho dự án của bạn.

Lưu ý: 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ỳ.

Lưu ý: 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 và chấp nhận các điều khoản

Chỉ định một 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. Bước này chỉ cần thiết nếu bạn đã chọn một sản phẩm trả phí ở bước trước.

Chấp nhận các điều khoản và điều kiện liên quan đến sản phẩm.

Xác nhận chi tiết

Xem xét các sản phẩm đã chọn. Xác minh tài khoản thanh toán được cung cấp.

Xem xét và chấp nhận Thỏa thuận cấp phép của FedEx Developer Portal.

Nhấp vào Tạo để tạo dự án và xem thông tin xác thực kiểm thử.

Đặt cấu hình Advanced Integrated Visibility trong một dự án

Điều kiện

Điều kiện

Xem xét giá: người đăng ký cần thanh toán phí hằng tháng dựa trên số lượng số theo dõi. Tham khảo Biểu mẫu đặt hàng để tìm hiểu thêm về giá.
Thiết lập tài khoản: Advanced Integrated Visibility yêu cầu tài khoản thanh toán ở Hoa Kỳ và ít nhất một tài khoản vận chuyển hai loại tài khoản này loại trừ lẫn nhau. Chỉ quản trị viên mới có thể thêm tài khoản thanh toán và tài khoản vận chuyển trên trang Quản lý tổ chức.

Tạo URL gọi lại hợp lệ trong nền tảng hoặc ứng dụng đích – URL nền tảng/ứng dụng của bạn:

Phải sử dụng HTTPS để đảm bảo tính bảo mật.

Không thể bao gồm không gian IP RFC1918, miền phụ fedex.com hoặc địa chỉ IP trực tiếp (ví dụ: 127.0.0.1).

Tạo mã thông báo bảo mật

Phải dài từ 26 – 100 ký tự và bao gồm:
- 1 chữ cái viết hoa
- 1 chữ cái viết thường
- 1 số
Ví dụ: Y1F6OiVUQW2JPSElmRE9U0IY5

Đặt cấu hình Advanced Integrated Visibility

Chọn Advanced Integrated Visibility. Chọn các tính năng như bằng chứng giao hàng, giao hàng ước tính, sự kiện theo dõi và lọc theo sự kiện

Nhập URL đích và mã thông báo bảo mật.

Cung cấp email để nhận thông tin mới nhất và thông báo gián đoạn liên quan đến Advanced Integrated Visibility.

Xác nhận chi tiết

Xem xét và chấp nhận Thỏa thuận cấp phép của FedEx Developer Portal cũng như Biểu mẫu đặt hàng.

Hãy chọn Tạo để hoàn tất thiết lập.

Lưu ý: Có thể có thêm các bước khác cần áp dụng, tùy theo loại đăng ký của bạn. Tham khảo tài liệu để biết thông tin chi tiết.

Truy cập Dự án của tôi

3 Kiểm thử phần tích hợp

Truy xuất thông tin xác thực kiểm thử và bắt đầu kiểm thử

Xem xét tài liệu về API
- Đọc tài liệu về API để hiểu các API khác nhau mà chúng tôi cung cấp, cùng với bối cảnh kinh doanh và quy trình tích hợp.
- Tải Lược đồ JSON xuống từ trang tài liệu về API tương ứng.
- Xem kỹ các yêu cầu ví dụ cho điểm cuối mong muốn.
Lấy thông tin xác thực kiểm thử

Trên trang Tổng quan về dự án, hãy vào tab Mã API. Danh sách Mã API và Mã khóa bí mật có ở phần mang tiêu đề Mã kiểm thử.
Xem xét tài liệu về API
- Mã thông báo OAuth là bắt buộc đối với tất cả các giao dịch API. Mã này hết hạn trong vòng một giờ.
- Ứng dụng phải làm mới mã thông báo trước khi mã hết hạn.
- Tham khảo tài liệu về API Authorization để biết thông tin chi tiết.
Kiểm thử các giao dịch API trong sandbox
- Vào API tương ứng trong Danh mục API, rồi chọn Tài liệu.
- Chọn điểm cuối API mong muốn trong menu bên trái.
- Sử dụng các yêu cầu mẫu phù hợp với trường hợp sử dụng của bạn.
- Thực hiện các lệnh gọi API bằng thông tin xác thực kiểm thử và URL kiểm thử FedEx.
- Xác minh phản hồi dựa trên tài liệu.
- Tham khảo Hướng dẫn mô phỏng sandbox để biết thêm chi tiết.

Kiểm thử Advanced Integrated Visibility

Việc kiểm thử Advanced Integrated Visibility sẽ xác thực định dạng URL cũng như giúp thiết lập kết nối giữa FedEx và ứng dụng của bạn.

Việc kiểm thử cung cấp dữ liệu kiểm thử mẫu để xử lý thông tin theo dõi.

Lưu ý: Việc kiểm thử không xác thực URL.

Truy cập tài liệu về Advanced Integrated Visibility để tìm hiểu thêm.

4 Chứng thực API của bạn

Xác thực là quy trình bắt buộc để chuyển các API sang môi trường sản xuất. Cấp độ xác thực sẽ khác nhau tùy theo API.

Phát triển và kiểm thử API FedEx

Sử dụng thông tin xác thực kiểm thử của bạn (mã API và mã khóa bí mật) có ở trang Tổng quan về dự án.
Xác định các trường hợp kiểm thử đối với các khu vực/vùng lãnh thổ mà bạn dự định triển khai giải pháp của mình (tham khảo Cơ sở cho trường hợp kiểm thử đơn vị tích hợp).
Trước khi chạy các trường hợp kiểm thử, hãy hoàn tất giao dịch đăng ký bằng số tài khoản kiểm thử được cung cấp.
Thực hiện tất cả các trường hợp kiểm thử cần thiết.

Truy cập trang Tổng quan về dự án.

Chọn Yêu cầu mã sản xuất. FedEx sẽ tiếp nhận yêu cầu mã sản xuất và thông báo cho bạn khi mã được chấp thuận.

Hoàn tất PIW và Tờ bìa xác thực

Điền vào Bảng tính thông tin sản phẩm (PIW) và Tờ bìa xác thực đơn vị tích hợp, cung cấp thông tin liên hệ và dịch vụ FedEx bạn dự định sử dụng.

Gửi tài liệu

Thu thập và nén các tài liệu sau đây vào một tệp .zip để tránh các hạn chế của nhà cung cấp dịch vụ email. Gửi đến validationmtp@fedex.com.

Các tài liệu cần thiết

PIW đã điền đầy đủ (PDF).
Tờ bìa xác thực đã điền đầy đủ (PDF).

Ảnh chụp màn hình (PDF):

Giải pháp phục vụ khách hàng cho thấy các dịch vụ FedEx/tùy chọn xử lý đặc biệt

Tuyên bố miễn trừ trách nhiệm

Thỏa thuận cấp phép người dùng cuối

Quy trình đăng ký của khách hàng cuối

Giao dịch đăng ký của khách hàng cuối dể 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/PNG)
Giao dịch vận chuyển cho ba định dạng nhãn: PDF, PNG và ZPL (JSON) (dành cho các API Shipping và Rating tương ứng)

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

Nhãn phải được in và quét với độ phân giải tối thiểu là 600 DPI.
Nhãn máy in nhiệt phải phù hợp với mẫu máy in (ví dụ: ZPLII cho máy in Zebra).
Các lô hàng FedEx International Express® yêu cầu nhãn Vận đơn hàng không (AWB) thứ cấp.
Lô hàng nhiều kiện (MPS) phải đính kèm một nhãn cho mỗi gói hàng.

Đánh giá nhãn

Đội ngũ Xác thực sẽ phê duyệt hoặc từ chối tài liệu bạn gửi.

Nếu bị từ chối, hãy sửa theo phản hồi và gửi lại nhãn

Nếu được phê duyệt, bạn sẽ nhận được email xác nhận đã xác thực thành công. Sau khi bạn nhận được email, thông tin đăng nhập môi trường sản xuất của bạn sẽ được ủy quyền cho các giao dịch nhãn vận chuyển.

Làm theo hướng dẫn sau xác thực

Xem xét và thực hiện bất kỳ yêu cầu sau khi xác thực nào cần thiết.

5 Đưa vào sản xuất

Khi nhận thông báo rằng Mã sản xuất của bạn đã được chấp thuận, hãy lấy Mã sản xuất từ tab Tổng quan về dự án.

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.
Mã khóa bí mật chỉ hiển thị một lần. Nếu làm mất, bạn phải tạo lại mã khóa mới.