

# Associating, disassociating and assigning opportunities
<a name="associating-disassociating-assigning-opportunities"></a>

 Opportunities can be associated or disassociated with Partner Solutions, AWS Products, AWS Marketplace Offers, and AWS Marketplace Offer Sets throughout the opportunity lifecycle. 

## Associating opportunities with other entities
<a name="associating-opportunities-with-other-entities"></a>

 The associated entities are retrieved from the `GetOpportunity` method within the `RelatedEntityIdentifiers` object. The `RelatedEntityIdentifiers` can be updated using `AssociateOpportunity`. Note that this field cannot be updated using the `UpdateOpportunity` or `CreateOpportunity` method. 

## Solutions
<a name="solutions"></a>

 Before an engagement with AWS is started using the `StartEngagementFromOpportunityTask` action, it is mandatory to associate at least one and up to ten Partner Solutions. An AWS Referral may or may not contain a Partner Solution. 

 To view your existing solutions, use the `ListSolutions` action. 

 Partners can create, update, and manage their solutions in the `Build` section on [AWS Partner Central](https://aws.amazon.com/partners/). 

## AWS products
<a name="aws-products"></a>

 Up to 20 AWS Products can be associated with an opportunity. To view a list of available AWS Products, use the list of [AWS Products hosted on GitHub](https://github.com/aws-samples/partner-crm-integration-samples/blob/main/resources/aws_products.json). Association with AWS Products is exclusively done using the `AssociateOpportunity` action. To replace or remove a Product, use the `DisassociateOpportunity` action. 

## AWS Marketplace offers and offer sets
<a name="aws-marketplace-offers-and-offer-sets"></a>

### AWS Marketplace offers
<a name="aws-marketplace-offers"></a>

 Opportunities can be tied to an AWS Marketplace Private Offer. To view available offers, use the ListEntities from the AWS Marketplace Catalog API. Currently, you can only associate offers from the AWS Marketplace Seller account linked to AWS Partner Central. 

 For associating a private offer ARN is required. Sample:

```
arn:aws:aws-marketplace:us-east-1:123123123123:AWSMarketplace/Offer/offer-dtn3example1tg
```

### AWS Marketplace offer sets
<a name="w2aab9b7b9c23c11b5"></a>

 Opportunities can also be associated with AWS Marketplace Offer Sets. Offer sets enable the grouping of multiple related marketplace offers together for comprehensive solution packaging. To view available offer sets, use the ListEntities from the AWS Marketplace Catalog API. 

 For associating an offer set, an ARN is required. Sample:

```
arn:aws:aws-marketplace:us-east-1:123123123123:AWSMarketplace/OfferSet/offerset-dtn3example1tg
```

 **Important:** An opportunity can be associated with either **one Offer** OR **one Offer Set**, but not both. Only one of these entity types can be associated with an opportunity at a time. 

## Disassociating opportunities from other entities
<a name="disassociating-opportunities-from-other-entities"></a>

 Use the `DisassociateOpportunity` action to unlink the Opportunity from Solutions, AWS Products, AWS Marketplace Offers and AWS Marketplace Offer Sets. Depending on the state of the Opportunity, different validation rules apply for unlinking the related objects. 

## Assigning opportunities
<a name="assigning-opportunities"></a>

 Use `AssignOpportunity` to change the opportunity's owner. You can set any of your Partner Central users to be the opportunity owner. 