FedEx 集成服务提供商
先决条件
您必须拥有 FedEx 用户 ID，才能登录 FedEx Developer Portal 并创建组织。
加入您公司的组织，与团队展开协作。若您的公司尚无组织，您可创建一个。
加入现有组织
1. 申请邀请
请联系您公司组织的管理员向您发送邀请。您需在 24 小时内接受该邀请。若邀请已过期，请联系管理员重新发送。
2. 接受邀请
使用您现有的用户 ID 和密码登录。若您的用户 ID 已关联至其他组织，请创建一个新 ID。
创建新组织
当您创建一个组织后，您将成为该组织的管理员。作为管理员，您可以邀请用户加入组织、分配项目与用户角色，并管理账单账户。
如需进一步了解用户角色，请参阅组织管理指南。
1. 在导航栏中选择创建或加入组织。
2. 输入以下详细信息：
- 在我任职的公司选项中，选择销售或提供基于 FedEx 技术的软件解决方案，并希望注册为经过认证的 FedEx 集成服务提供商
- 输入您公司的名称、公司网站，以及一个团队成员能够识别的组织名称（例如公司名称、部门、分支机构或区域名称）。
- 输入包含您公司域名的官方电子邮件、公司注册地所在国家或地区，以及您销售或分发软件解决方案的国家和地区。
3. 选择下一步。
您之后可在菜单中的管理组织下更新或补充详细信息。
添加账单账户
1. 选择账单账户选项卡。若您尚无 FedEx 账单账户，可选择开设账单账户 以开立新账户 或联系 FedEx 支持人员。
注意：请使用您自己的账号；不可使用客户的 FedEx 账号。
2. 选择添加账单账户。
3. 输入您的 FedEx 账号、账户别名，以及您在开立账户时使用的美国账单邮寄地址。
注意：账单邮寄地址必须与您开立账户时使用的地址完全一致。该账户将成为您所在组织的默认账单账户。
4. 选择一种身份验证方式。
- 电话验证方式仅面向位于美国和加拿大的集成商开放。
5. 输入您收到的验证码，并选择提交。
6. 阅读并接受 FedEx 集成商协议。
管理员如何邀请用户
1. 进入管理组织页面，选择用户选项卡。
2. 选择+ 添加用户。
3. 输入以下详细信息：
- 国家或地区
- 首选语言
4. 选择用户角色（查看者、贡献者或管理员）。
5. （可选）将用户分配至项目。
- 您随时可以从项目的“概览”页面为用户分配项目。
6. 输入用户的电子邮件地址，并点击邀请。
- 您可一次性邀请最多 20 位用户，电子邮件地址之间请用逗号分隔。邀请有效期为 24 小时。
创建项目
1. 从菜单中选择我的项目，然后选择 + 创建项目。
2. 输入项目名称。
- 推荐的名称格式为 Projectname_applicationname。完成后，选择下一步。
3. 选择您项目中需要包含的 API 及 Advanced Integrated Visibility 产品。
- Advanced Integrated Visibility 产品仅适用于美国 FedEx 集成供应商。
- 如果您选择任何付费产品，系统会要求您为该项目分配一个账单账户并接受必要条款。
分配账单账户
注意：仅当您选择付费产品时，需执行此操作。
1. 通过已添加至组织的账户列表，分配一个账单账户。账单账户必须位于美国境内。
2. 接受 FedEx Developer Portal 许可协议与订购单，并选择创建。
在项目中配置 Advanced Integrated Visibility
1. 在您的应用程序或平台中创建一个用于接收回调的目标 URL。此 URL 必须：
- 使用 HTTPS
- 请勿使用 RFC1918 IP 地址段、fedex.com 及其子域名，以及 localhost 或 127.0.0.1 等 IP 地址
2. 生成用于身份验证的安全令牌。此令牌必须：
- 包含 26–100 个字符，且至少包含一个大写字母、一个小写字母和一个数字
3. 从菜单中选择我的项目，然后选择 Advanced Integrated Visibility 选项卡。
4. 选择创建 Advanced Integrated Visibility 项目。
5. 选择用户类型：
- FedEx 寄件人：使用 FedEx 进行托运，并需将 FedEx API 集成至其自有应用程序中
- FedEx 电商兼容供应商：即经 FedEx 认证的电商兼容供应商
- FedEx 集成服务提供商：销售或提供基于 FedEx 技术的软件解决方案，并已通过 FedEx 认证的集成服务提供商
6. 选择订阅类型。您可通过账号或追踪号码订阅事件通知。
7. 确认账单账户，并选择您所需的功能，例如递送证明、预计送达时间、查询事件或基于事件进行筛选。
8. 输入项目详细信息。
- 输入唯一且易于识别的项目名称。
- 输入您创建的目标 URL 和安全令牌。
- 输入用于接收 Advanced Integrated Visibility 更新及服务中断通知的电子邮件地址和首选语言。
9. 接受 FedEx Developer Portal 许可协议与订购单，并选择创建。
注意：根据您选择的订阅类型，可能还需完成其他步骤。详情请参阅我们的 Webhook 文档。
请按照以下步骤验证您的 API 集成，并确认您的应用程序能够发送和接收测试数据。
1. 从菜单中选择我的项目，然后选择项目名称。
2. 在 API 密钥选项卡上的测试密钥下，找到您的测试凭据。
3. 登录后，点击文档页面顶部的下载 JSON 架构按钮，即可下载 JSON API 集合文件。查阅您集成所使用的端点的示例请求。
4. 申请 OAuth 访问令牌，用于每次 API 事务的身份验证。该令牌有效期为 1 小时，您可将应用程序配置为在令牌过期前自动刷新。详情请参阅 API Authorization 文档。
5. 从菜单中选择 API 目录，选择您需要使用的 API，然后选择文档。
6. 从菜单中，选择端点。
7. 使用您的测试凭证和 FedEx 测试 URL 发送示例请求，然后确认返回的响应与文档示例一致。详情请参阅沙盒虚拟化指南。
8. 运行 Advanced Integrated Visibility 测试，生成样本数据，并确认您的应用程序能正确处理查询信息。
注意：测试不会对您的回调 URL 进行身份验证。详情请参阅 Advanced Integrated Visibility 文档。
验证步骤因地区而异
下列步骤仅适用于美国和加拿大境内的客户。如果您的住址不位于上述两个国家境内，请访问 API 验证 页面并寻求支持。
要将您的 API 迁移至生产环境，这些 API 必须通过验证。验证级别因 API 而异。开始前，请查阅 API 验证要求 。
1. 从菜单中选择我的项目，然后选择项目名称。
2. 在 API 密钥选项卡上的测试密钥下，找到您的测试凭据。
3. 明确您计划部署解决方案的国家或地区对应的测试用例。详情请参阅集成商测试用例基线。
4. 在运行测试用例前，请使用之前提供的测试账号完成注册事务。
5. 完成所有必需的测试用例。
6. 填写 产品信息工作表 (PIW)，提供您的联系方式以及所选的 FedEx 服务。
7. 填写集成商验证封面表。
提交可交付项
将所有必要材料发送至 validationmtp@fedex.com。
1. 准备以下可交付项：
- 填写完整的 PIW (PDF)
- 填写完整的验证封面表 (PDF)
- 含多因素身份验证的最终客户注册事务 (JSON)
- 所有适用测试用例的扫描托运标签（PDF 或 PNG）
- 三种标签格式的寄件交易（PDF、PNG 和 ZPL (JSON)）（适用于相关的托运 API 和费率 API）
- 屏幕截图 (PDF) 显示：
- 面向客户的解决方案，用于展示 FedEx 服务及特殊处理选项
- 免责声明
- 最终用户许可协议 (EULA)
- 终端客户注册流程
2. 将所有文件压缩为一个 .zip 文件，以避免电子邮件服务商的发送限制。
3. 将 .zip 文件通过电子邮件发送至验证团队。
避免延误的最佳实践
遵循以下指南以缩短审核时间：
- 标签的打印与扫描分辨率不得低于 600 DPI。请勿提交由 API 直接生成的文件。
- 若使用热敏打印机，请申请与您的打印机匹配的图像格式，例如 Zebra 打印机请使用 ZPLII 格式。
- 使用 FedEx International Express® 服务时，请一并提供辅助（第二）空运提单 (AWB)。
- 对于一票多件货件 (MPS)，请为每一件包裹单独提供一份标签。
标签评估
验证团队将对您提交的资料进行审核。
- 若未通过审核，请根据反馈意见进行修改并重新提交相关材料。
- 若通过审核，您将收到一封确认电子邮件。获得批准后，您的生产环境凭证将被授权用于托运标签相关事务。
1. 从菜单中选择我的项目，然后选择项目名称。
2. 在 API 部分，复制您的生产环境 API 密钥和密钥并妥善保管。
注意：密钥仅显示一次，请将其保存在安全位置。若不慎遗失，之后可重新生成新密钥。
