feat(client-partnercentral-selling): Added support for filtering opportunities by target close date in the ListOpportunities API. You can now filter results to return opportunities with a target close date before or after a specified date, enabling more precise opportunity searches based on expected closure timelines.

Author: awstools

clients/client-partnercentral-selling/src/commands/ListOpportunitiesCommand.ts

@@ -46,7 +46,7 @@ export interface ListOpportunitiesCommandOutput extends ListOpportunitiesRespons
  *   NextToken: "STRING_VALUE",
  *   Sort: { // OpportunitySort
  *     SortOrder: "ASCENDING" || "DESCENDING", // required
- *     SortBy: "LastModifiedDate" || "Identifier" || "CustomerCompanyName" || "CreatedDate", // required
+ *     SortBy: "LastModifiedDate" || "Identifier" || "CustomerCompanyName" || "CreatedDate" || "TargetCloseDate", // required
  *   },
  *   LastModifiedDate: { // LastModifiedDate
  *     AfterLastModifiedDate: new Date("TIMESTAMP"),
@@ -68,6 +68,10 @@ export interface ListOpportunitiesCommandOutput extends ListOpportunitiesRespons
  *     AfterCreatedDate: new Date("TIMESTAMP"),
  *     BeforeCreatedDate: new Date("TIMESTAMP"),
  *   },
+ *   TargetCloseDate: { // TargetCloseDateFilter
+ *     AfterTargetCloseDate: "STRING_VALUE",
+ *     BeforeTargetCloseDate: "STRING_VALUE",
+ *   },
  * };
  * const command = new ListOpportunitiesCommand(input);
  * const response = await client.send(command);

clients/client-partnercentral-selling/src/models/enums.ts

@@ -1175,6 +1175,7 @@ export const OpportunitySortName = {
   CUSTOMER_COMPANY_NAME: "CustomerCompanyName",
   IDENTIFIER: "Identifier",
   LAST_MODIFIEDDATE: "LastModifiedDate",
+  TARGET_CLOSE_DATE: "TargetCloseDate",
 } as const;
 /**
  * @public

clients/client-partnercentral-selling/src/models/models_0.ts

@@ -2349,7 +2349,7 @@ export interface CreateEngagementInvitationRequest {
   EngagementIdentifier: string | undefined;
 
   /**
-   * <p> The <code>Invitation</code> object all information necessary to initiate an engagement invitation to a partner. It contains a personalized message from the sender, the invitation's receiver, and a payload. The <code>Payload</code> can be the <code>OpportunityInvitation</code>, which includes detailed structures for sender contacts, partner responsibilities, customer information, and project details. </p>
+   * <p> The <code>Invitation</code> object all information necessary to initiate an engagement invitation to a partner. It contains a personalized message from the sender, the invitation's receiver, and a payload. The <code>Payload</code> can be the <code>OpportunityInvitation</code>, which includes detailed structures for sender contacts, partner responsibilities, customer information, and project details, or <code>LeadInvitation</code>, which includes structures for customer information and interaction details. </p>
    * @public
    */
   Invitation: Invitation | undefined;
@@ -3460,6 +3460,24 @@ export interface OpportunitySort {
   SortBy: OpportunitySortName | undefined;
 }
 
+/**
+ * <p>Filters opportunities based on their target close date.</p>
+ * @public
+ */
+export interface TargetCloseDateFilter {
+  /**
+   * <p>Filters opportunities with a target close date after this date. Use the <code>YYYY-MM-DD</code> format.</p>
+   * @public
+   */
+  AfterTargetCloseDate?: string | undefined;
+
+  /**
+   * <p>Filters opportunities with a target close date before this date. Use the <code>YYYY-MM-DD</code> format.</p>
+   * @public
+   */
+  BeforeTargetCloseDate?: string | undefined;
+}
+
 /**
  * @public
  */
@@ -3523,6 +3541,12 @@ export interface ListOpportunitiesRequest {
    * @public
    */
   CreatedDate?: CreatedDateFilter | undefined;
+
+  /**
+   * <p>Filters opportunities based on their target close date. This filter helps retrieve opportunities with an expected close date before or after a specified date.</p>
+   * @public
+   */
+  TargetCloseDate?: TargetCloseDateFilter | undefined;
 }
 
 /**

clients/client-partnercentral-selling/src/schemas/schemas_0.ts

@@ -41,6 +41,7 @@ const _AR = "AccountReceiver";
 const _AS = "AccountSummary";
 const _ASd = "AddressSummary";
 const _ASw = "AwsSubmission";
+const _ATCD = "AfterTargetCloseDate";
 const _ATM = "AwsTeamMember";
 const _AWS = "AWS";
 const _Ac = "Account";
@@ -52,6 +53,7 @@ const _BCD = "BeforeCreatedDate";
 const _BLMD = "BeforeLastModifiedDate";
 const _BP = "BusinessProblem";
 const _BT = "BusinessTitle";
+const _BTCD = "BeforeTargetCloseDate";
 const _C = "Catalog";
 const _CA = "CreatedAt";
 const _CAu = "CustomerAction";
@@ -396,6 +398,7 @@ const _TABC = "TotalAmountByCategory";
 const _TAa = "TaskArn";
 const _TC = "TargetCompany";
 const _TCD = "TargetCloseDate";
+const _TCDF = "TargetCloseDateFilter";
 const _TCDa = "TargetCompletionDate";
 const _TE = "ThrottlingException";
 const _TI = "TaskIdentifier";
@@ -992,8 +995,8 @@ export var ListEngagementsResponse$: StaticStructureSchema = [3, n0, _LERi,
 ];
 export var ListOpportunitiesRequest$: StaticStructureSchema = [3, n0, _LOR,
   0,
-  [_C, _MR, _NT, _Sor, _LMD, _I, _LCSi, _LCRS, _CCN, _CD],
-  [0, 1, 0, () => OpportunitySort$, () => LastModifiedDate$, 64 | 0, 64 | 0, 64 | 0, 64 | 0, () => CreatedDateFilter$], 1
+  [_C, _MR, _NT, _Sor, _LMD, _I, _LCSi, _LCRS, _CCN, _CD, _TCD],
+  [0, 1, 0, () => OpportunitySort$, () => LastModifiedDate$, 64 | 0, 64 | 0, 64 | 0, 64 | 0, () => CreatedDateFilter$, () => TargetCloseDateFilter$], 1
 ];
 export var ListOpportunitiesResponse$: StaticStructureSchema = [3, n0, _LORi,
   0,
@@ -1240,6 +1243,11 @@ export var TagResourceResponse$: StaticStructureSchema = [3, n0, _TRRa,
   [],
   []
 ];
+export var TargetCloseDateFilter$: StaticStructureSchema = [3, n0, _TCDF,
+  0,
+  [_ATCD, _BTCD],
+  [0, 0]
+];
 export var UntagResourceRequest$: StaticStructureSchema = [3, n0, _URR,
   0,
   [_RA, _TK],

clients/client-partnercentral-selling/test/index-objects.spec.mjs

@@ -289,6 +289,7 @@ import {
   TagResourceCommand,
   TagResourceRequest$,
   TagResourceResponse$,
+  TargetCloseDateFilter$,
   TaskStatus,
   ThrottlingException,
   ThrottlingException$,
@@ -547,6 +548,7 @@ assert(typeof SubmitOpportunityRequest$ === "object");
 assert(typeof Tag$ === "object");
 assert(typeof TagResourceRequest$ === "object");
 assert(typeof TagResourceResponse$ === "object");
+assert(typeof TargetCloseDateFilter$ === "object");
 assert(typeof UntagResourceRequest$ === "object");
 assert(typeof UntagResourceResponse$ === "object");
 assert(typeof UpdateEngagementContextPayload$ === "object");

clients/client-partnercentral-selling/test/index-types.ts

@@ -320,6 +320,7 @@ export type {
   Tag,
   TagResourceRequest,
   TagResourceResponse,
+  TargetCloseDateFilter,
   UntagResourceRequest,
   UntagResourceResponse,
   UpdateEngagementContextPayload,