对 AWS 合作伙伴中心 API 参考进行了重组。有关支持的 API 操作的更多信息，请参阅 AWS 合作伙伴中心 API 参考。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用福利应用程序

福利应用程序模拟合作伙伴对特定福利的请求。它收集了根据福利特定条件评估和处理申请所需的所有信息。从草案的创建到最终批准或拒绝，福利申请的生命周期贯穿多个州。

创建福利应用程序

合作伙伴通过使用 CreateBenefitApplication API 操作创建福利申请来启动福利申请流程。申请在创建时进入PENDING_SUBMISSION状态，允许合作伙伴在提交审核之前准备完整的信息。

创建福利申请时，合作伙伴必须提供：

合作伙伴可以选择提供：

CreateBenefitApplicationAPI 执行软验证，仅检查基本字段类型和模式。提交过程中会进行全面的业务逻辑验证，允许合作伙伴保存不完整的申请，稍后返回以完成申请。

最佳实践：合作伙伴应使用中的权益申请架构GetBenefit来准确了解在创建应用程序之前需要哪些信息。这降低了因数据缺失或无效而导致提交失败的可能性。

更新福利申请

合作伙伴可以使用 UpdateBenefitApplication API 操作修改福利申请草案。这使合作伙伴可以在提交之前完善信息、添加文档或更正错误。

更新福利申请时，合作伙伴必须提供：

即使只有特定字段发生变化，合作伙伴也必须提交完整的福利申请对象。最佳做法是首先使用检索最新的应用程序详细信息GetBenefitApplication，修改必填字段，然后将完整的更新负载提交到UpdateBenefitApplication。

Optimi stic Locking：修订版字段确保仅当应用程序自上次检索以来未发生更改时才应用更新。如果修订版本与当前数据库值不匹配，则更新会因冲突错误而被拒绝。这可以防止合作伙伴意外覆盖其他流程或系统所做的更改。

只能在应用程序处于PENDING_SUBMISSION状态时执行更新。提交后，应用程序将进入审核流程，无法再通过此 API 进行更新。

将资源与福利申请相关联

合作伙伴可以使用 AssociateBenefitApplicationResource API 操作将福利申请链接到相关资源。这在福利与使用福利的业务环境之间建立了宝贵的联系。

支持的资源类型包括：

资源关联只能在提交之前发生。一旦提交福利申请（状态更改为IN_REVIEW），就不允许有其他社团。合作伙伴可以将最多 10 个资源与每个福利申请相关联。

要取消资源的关联，合作伙伴使用 DisassociateBenefitApplicationResource API 操作。与关联一样，解除关联只能在PENDING_SUBMISSION状态中发生。

提交福利申请

福利申请完成并准备好进行 AWS 审核后，合作伙伴使用 SubmitBenefitApplication API 操作提交。提交会触发从PENDING_SUBMISSION到的状态过渡，IN_REVIEW并启动特定福利的批准工作流程。

提交后，API 将执行全面的验证，包括：

如果验证失败，API 会返回 ValidationException 包含详细的错误代码和消息，指明哪些字段需要更正。合作伙伴必须使用解决这些问题，UpdateBenefitApplication然后才能再次尝试提交。

文件处理要求：如果任何附加文件仍处于PENDING状态，则无法提交福利申请。合作伙伴必须等待文件处理完成（状态更改为SUCCEEDED）后才能提交。如果文件处理失败（状态FAILED），合作伙伴应上传更正后的版本。

成功提交后：

合作伙伴可以通过检索申请和监控 “阶段” 字段来跟踪提交进度，该字段表示当前的批准阶段（例如，“业务审批”、“技术审批”、“财务审批”）。

管理已提交的应用程序

提交后，合作伙伴管理福利申请的选择有限，但是API为常见场景提供了具体的操作。

召回福利申请

如果合作伙伴在提交后发现错误或需要进行更改，他们可以使用 RecallBenefitApplication API 操作调用应用程序。召回会将应用程序恢复到PENDING_SUBMISSION状态，允许更新和重新提交。

撤回申请时，合作伙伴应提供：

原因字段可以提高可追溯性，并有助于 AWS 了解导致召回的常见问题，为福利申请流程的未来改进提供信息。

召回后，合作伙伴可以使用UpdateBenefitApplication进行必要的更改，然后在准备就绪SubmitBenefitApplication后重新提交。

修改福利申请

对于提交后的细微更正，合作伙伴可以使用 AmendBenefitApplication API 操作更新特定字段，而无需调用整个应用程序。当 AWS 审评者在审评过程中要求澄清或更正时，这尤其有用。

修正案使用 JSON Patch-style 方法，合作伙伴指定：

合作伙伴可以在单个 API 调用中提交最多 10 个修正案。每项修正案都必须包含更新的修订版号，以实现乐观锁定。

修正案应用于细微更正。对于实质性更改，合作伙伴应使用RecallBenefitApplication将申请恢复为草稿状态以进行全面更新。

取消福利申请

如果合作伙伴不再需要福利或希望撤回申请，则可以使用 CancelBenefitApplication API 操作取消该申请。取消会将申请转换为CANCELED状态，永久结束申请流程。

取消申请时，合作伙伴应提供：

一旦取消，应用程序将无法重新激活。如果合作伙伴后来决定需要福利，则必须创建新的福利申请。

取消的常见原因包括：

查看福利申请详情

合作伙伴可以使用 GetBenefitApplication API 操作检索有关福利申请的完整信息。这提供了应用程序的全面视图，包括：

应用程序元数据：

状态信息：

应用程序内容：

审计信息：

当应用程序处于状态时，ACTION_REQUIRED状态原因代码特别有价值。这些守则为合作伙伴需要解决哪些问题才能继续进行申请提供了具体、可操作的指导。

列出福利申请

合作伙伴可以使用 ListBenefitApplications API 操作查看其所有福利申请。这将返回具有强大过滤功能的应用程序摘要的分页列表。

合作伙伴可以按以下条件筛选应用程序：

清单回复包括基本摘要信息，例如：

合作伙伴可以使用排序参数配置结果排序，并可选择按创建日期、状态、计划或福利标识符升序或降序排序。

仪表板构建：该 ListBenefitApplications API 旨在支持合作伙伴仪表板的创建。通过对应用程序进行筛选和排序，合作伙伴可以生成视图，例如：