Người gửi FedEx
Điều kiện
Bạn phải có ID người dùng FedEx để đăng nhập vào FedEx Developer Portal và tạo tổ chức.
Tham gia tổ chức của công ty để cộng tác với nhóm của bạn. Nếu công ty của bạn chưa có tổ chức, bạn có thể tạo tổ chức.
Tham gia tổ chức hiện có
1. 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 lời mời. Nếu lời mời hết hạn, hãy nhờ quản trị viên gửi lại.
2. 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. Nếu mã người dùng của bạn liên kết với một tổ chức khác, hãy tạo mã mới.
Tạo tổ chức mới
Khi tạo một tổ chức, bạn sẽ trở thành quản trị viên. Với tư cách là quản trị viên, bạn có thể mời người dùng tham gia tổ chức, phân công dự án và vai trò người dùng, cũng như quản lý tài khoản vận chuyển.
Để tìm hiểu thêm về vai trò người dùng, hãy xem Hướng dẫn quản trị tổ chức.
1. Đăng nhập vào FedEx Developer Portal.
2. Từ menu, hãy chọn Dự án của tôi, sau đó chọn Tạo tổ chức.
3. Nhập các chi tiết sau đây:
- Đối với Tôi làm việc cho một công ty, hãy chọn 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 mình
- Nhập tên công ty, trang web của công ty và tên tổ chức để nhóm của bạn dễ nhận ra, chẳng hạn như tên công ty, phòng ban, bộ phận hoặc khu vực.
4. Chọn Tạo.
Bạn có thể cập nhật hoặc thêm chi tiết sau, trong phần Quản lý tổ chức trên menu.
Thêm tài khoản vận chuyển
1. Chọn Thêm tài khoản vận chuyển trong ô Thêm tài khoản. Nếu bạn chưa có tài khoản FedEx, hãy chọn Tạo tài khoản để mở tài khoản mới hoặc liên hệ bộ phận Hỗ trợ của FedEx.
2. Chọn + Thêm tài khoản.
3. Nhập số tài khoản FedEx của bạn, biệt danh của tài khoản và địa chỉ thanh toán mà bạn đã sử dụng trong quá trình thiết lập tài khoản.
4. Chấp nhận Thỏa thuận cấp phép người dùng cuối hoặc chuyển tiếp thỏa thuận này cho người đại diện được ủy quyền trong công ty của bạn.
Thêm tài khoản thanh toán
1. Chọn tab Tài khoản thanh toán . Nếu bạn chưa có tài khoản thanh toán FedEx, hãy chọn Mở tài khoản thanh toán để mở tài khoản mới hoặc liên hệ bộ phận Hỗ trợ của FedEx.
2. Chọn Thêm tài khoản thanh toán. Địa chỉ thanh toán của tài khoản phải ở Hoa Kỳ.
3. Nhập số tài khoản FedEx của bạn, biệt danh của tài khoản và địa chỉ thanh toán tại Hoa Kỳ mà bạn đã sử dụng trong quá trình thiết lập tài khoản.
4. Đọc và chấp nhận Thỏa thuận cấp phép người dùng cuối.
Mời người dùng với tư cách quản trị viên
1. Từ menu, hãy chọn Quản lý tổ chức, sau đó chọn tab Người dùng.
2. Chọn + Thêm người dùng.
3. Chọn quốc gia hoặc vùng lãnh thổ và ngôn ngữ ưu tiên, sau đó chọn vai trò người dùng: người xem, người đóng góp hoặc quản trị viên.
4. (Không bắt buộc) Phân công người dùng tham gia vào một dự án. Bạn có thể phân công người dùng bất cứ lúc nào tại trang Tổng quan của dự án.
5. Nhập địa chỉ email của người dùng và nhấp vào Mời. Bạn có thể mời tối đa 20 người dùng cùng lúc, mỗi email được phân tách bằng dấu phẩy. Lời mời sẽ hết hạn sau 24 giờ.
Tạo dự án API
1. Từ menu, hãy chọn Dự án của tôi, sau đó chọn tab API và chọn + Tạo dự án API.
2. Xác nhận nhu cầu về API của bạn.
3. Chọn API bạn muốn đưa vào dự án.
4. Tạo tên dự án và chọn các quốc gia bạn dự định vận chuyển lô hàng đến để nhận tài khoản vận chuyển kiểm thử. Đối với các lô hàng nội địa châu Âu, bạn cần có tài khoản kiểm thử riêng cho mỗi quốc gia. Bạn có thể thêm hoặc xóa các quốc gia vào lúc khác.
5. Chọn Cài đặt trong phần Thông báo để thiết lập tùy chọn thông báo.
6. Đọc và chấp nhận các điều khoản và điều kiện.
Tạo dự án Advanced Integrated Visibility
Đ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 Quy trình theo dõi lô hàng yêu cầu sử dụng tài khoản thanh toán ở Hoa Kỳ và ít nhất một tài khoản vận chuyển. Đây là hai loại tài khoản riêng biệt. 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.
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 chữ số
3. Từ menu, hãy chọn Dự án của tôi, sau đó 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 mình
- 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 muố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 lọc theo sự kiện.
8. Nhập chi tiết dự án.
- Nhập tên dự án dễ nhận biết và không trùng lặp.
- 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ý đã 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.
Hãy làm theo các bước sau đây để xác minh phần tích hợp API và xác nhận rằng ứng dụng của bạn có thể gửi và nhận dữ liệu kiểm thử.
Lấy thông tin xác thực kiểm thử
1. Từ menu, hãy chọn Dự án của tôi, sau đó chọn Tên dự án.
2. Trên tab Mã API, trong phần Mã kiểm thử, bạn sẽ tìm thấy thông tin xác thực kiểm thử.
3. Đăng nhập và nhấp vào nút Tải lược đồ JSON xuống ở đầu trang tài liệu để tải bộ sưu tập API JSON xuống. Xem kỹ yêu cầu ví dụ cho các điểm cuối mà phần tích hợp của bạn sử dụng.
4. Yêu cầu mã thông báo truy cập OAuth để sử dụng cho mỗi giao dịch API.
Lưu ý: Mã thông báo này có hiệu lực trong một giờ và bạn có thể cấu hình ứng dụng để làm mới mã thông báo trước khi mã hết hạn. Để biết chi tiết, hãy xem tài liệu về API Authorization.
5. Từ menu, hãy chọn Danh mục API, chọn API bạn muốn sử dụng và chọn Tài liệu.
6. Từ menu, hãy chọn điểm cuối.
7. Gửi các yêu cầu mẫu bằng cách sử dụng thông tin xác thực kiểm thử của bạn và URL kiểm thử của FedEx, rồi kiểm tra xem phản hồi có khớp với các ví dụ trong tài liệu không. Để biết chi tiết, hãy xem Hướng dẫn mô phỏng sandbox.
8. Chạy kiểm thử với Advanced Integrated Visibility để tạo dữ liệu mẫu và kiểm tra xem ứng dụng của bạn xử lý thông tin theo dõi có chính xác hay không.
Lưu ý: Việc kiểm thử không xác thực URL gọi lại. Để biết chi tiết, hãy xem tài liệu về Advanced Integrated Visibility.
Đưa dự án vào giai đoạn sản xuất
Thiết lập cấu hình sản xuất trước khi vào giai đoạn sản xuất. Bạn có thể đổi tên mã, thêm các tài khoản khác sau khi dự án đi vào giai đoạn sản xuất và xem lại số tài khoản đã chọn trong quá trình tạo dự án. Số tài khoản này sẽ đưa dự án của bạn vào giai đoạn sản xuất.
Lưu ý: Các dự án Advanced Integrated Visibility dựa trên số tài khoản không yêu cầu kích hoạt trong môi trường sản xuất.
1. Từ menu, hãy chọn Dự án của tôi, sau đó chọn Tên dự án.
2. Chọn tab Mã sản xuất.
3. Lấy thông tin xác thực sản xuất và lưu trữ cách an toàn.
- Sao chép mã API sản xuất và mã khóa bí mật vào nơi an toàn.
- Khi bạn yêu cầu mã sản xuất, hãy lưu mã ở một nơi an toàn vì mã này chỉ xuất hiện một lần. Nếu để mất, bạn có thể tạo lại mã mới sau.
4. Chọn Tiếp để xem chi tiết dự án trên tab Mã sản xuất.
Để thêm các tài khoản vận chuyển khác, hãy chọn Chỉnh sửa ở đầu bảng tài khoản vận chuyể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 không sống ở hai quốc gia này, hãy truy cập trang Xác thực API để tìm thông tin hỗ trợ.
Xác thực API của bạn
Một số API FedEx yêu cầu xác thực nhãn vận chuyển trước khi có thể sử dụng trong giai đoạn sản xuất. Hãy xem kỹ 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, sau đó chọn Tên dự án.
2. Trên tab Mã API, trong phần Mã kiểm thử, bạn sẽ tìm thấy thông tin xác thực kiểm thử.
3. Sau khi quá trình kiểm thử hoàn tất, hãy đưa dự án của bạn vào giai đoạn sản xuất trong FedEx Developer Portal để bắt đầu xác thực.
- Khi bạn yêu cầu mã sản xuất, hãy lưu mã ở một nơi an toàn vì mã này chỉ xuất hiện một lần. Nếu để mất, bạn có thể tạo lại mã mới sau.
4. Cung cấp thông tin cần thiết trên Tờ bìa nhãn, bao gồm thông tin liên hệ, các dịch vụ bạn dự định triển khai, số tài khoản và mã API sản xuất.
5. Tạo nhãn kiểm thử trong môi trường kiểm thử FedEx, rồi gửi để Nhóm phân tích mã vạch của FedEx xem xét. Quá trình đánh giá nhãn sẽ diễn ra trong 3 ngày làm việc.
Các phương thức tốt nhất để tránh chậm trễ:
- 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, loại hình ảnh phải phù hợp với máy in của bạn, ví dụ: ZPLII cho máy in Zebra.
- Sử dụng địa chỉ đơn vị vận chuyển và người nhận hợp lệ cho các nhãn mẫu. Chỉ tạo nhãn cho các dịch vụ mà bạn dự định sử dụng.
- Đối với dịch vụ Thu tiền khi giao hàng (C.O.D.) của FedEx, hãy đính kèm nhãn trả lại C.O.D.
- Đố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).
- Đối với lô hàng nhiều kiện (MPS), hãy gửi một nhãn cho mỗi gói hàng.
Gửi tài liệu của bạn bằng một trong các tùy chọn sau đây:
- Gửi bản PDF và Tờ bìa nhãn đến địa chỉ email label@fedex.com.
- Gửi nhãn thực qua đường bưu điện đến:
FedEx Services
WTC-Business Solutions Testing
10 FedEx Parkway
2nd Floor Horizontal
Collierville, TN 38017
Lưu ý: Đối với nhãn thực, hãy đảm bảo không có sai sót nào nhìn thấy được, chẳng hạn như vết mực hoặc hư hại. Không phóng to hoặc thu nhỏ nhãn khi in.
6. Nhóm phân tích mã vạch của FedEx sẽ xem xét nhãn bạn gửi và phê duyệt hoặc từ chối nhãn. Nếu nhãn bị từ chối, hãy khắc phục theo ý kiến phản hồi và gửi lại nhãn.
7. Sau khi phê duyệt, Nhóm phân tích mã vạch của FedEx sẽ gửi email cho bạn sau khi cho phép sử dụng thông tin xác thực sản xuất của bạn cho các giao dịch tạo nhãn vận chuyển.
Lưu ý: Quy trình phê duyệt áp dụng cho từng dự án. Mỗi dự án mới đều cần được phê duyệt.
8. Thay thế URL và thông tin xác thực kiểm thử bằng URL và thông tin xác thực của giai đoạn sản xuất.
9. Tiến hành kiểm thử giai đoạn sản xuất lần cuối bằng dữ liệu mẫu để xác nhận mọi hoạt động diễn ra như mong đợi.
