@emilgroup/insurance-sdk-node 1.104.1-beta.4 → 1.104.1-beta.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -50,7 +50,7 @@ export declare const PoliciesApiAxiosParamCreator: (configuration?: Configuratio
50
50
  */
51
51
  activatePolicy: (policyCode: string, activatePolicyRequestDto: ActivatePolicyRequestDto, authorization?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
52
52
  /**
53
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
53
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
54
54
  * @summary Create the draft-policy
55
55
  * @param {string} policyCode Unique identifier for the object.
56
56
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -78,11 +78,11 @@ export declare const PoliciesApiAxiosParamCreator: (configuration?: Configuratio
78
78
  */
79
79
  deleteDraftPolicy: (policyCode: string, authorization?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
80
80
  /**
81
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
81
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
82
82
  * @summary Retrieve the draft-policy
83
83
  * @param {string} policyCode Unique identifier for the object.
84
84
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
85
- * @param {string} [expand] Fields to expand response by.
85
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
86
86
  * @param {*} [options] Override http request option.
87
87
  * @throws {RequiredError}
88
88
  */
@@ -109,16 +109,16 @@ export declare const PoliciesApiAxiosParamCreator: (configuration?: Configuratio
109
109
  */
110
110
  getPolicyDataByDate: (code: string, authorization?: string, timesliceDate?: string, expand?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
111
111
  /**
112
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
112
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
113
113
  * @summary List policies
114
114
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
115
115
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
116
116
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
117
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
118
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
117
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
118
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
119
119
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
120
120
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
121
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
121
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
122
122
  * @param {*} [options] Override http request option.
123
123
  * @throws {RequiredError}
124
124
  */
@@ -155,7 +155,7 @@ export declare const PoliciesApiAxiosParamCreator: (configuration?: Configuratio
155
155
  */
156
156
  listPolicyVersions: (policyCode: string, authorization?: string, pageSize?: number, pageToken?: string, filter?: string, search?: string, order?: string, expand?: string, filters?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
157
157
  /**
158
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
158
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
159
159
  * @summary Update the draft-policy
160
160
  * @param {string} policyCode Unique identifier for the object.
161
161
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -241,7 +241,7 @@ export declare const PoliciesApiFp: (configuration?: Configuration) => {
241
241
  */
242
242
  activatePolicy(policyCode: string, activatePolicyRequestDto: ActivatePolicyRequestDto, authorization?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ActivatePolicyResponseClass>>;
243
243
  /**
244
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
244
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
245
245
  * @summary Create the draft-policy
246
246
  * @param {string} policyCode Unique identifier for the object.
247
247
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -269,11 +269,11 @@ export declare const PoliciesApiFp: (configuration?: Configuration) => {
269
269
  */
270
270
  deleteDraftPolicy(policyCode: string, authorization?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<DeleteResponseClass>>;
271
271
  /**
272
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
272
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
273
273
  * @summary Retrieve the draft-policy
274
274
  * @param {string} policyCode Unique identifier for the object.
275
275
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
276
- * @param {string} [expand] Fields to expand response by.
276
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
277
277
  * @param {*} [options] Override http request option.
278
278
  * @throws {RequiredError}
279
279
  */
@@ -300,16 +300,16 @@ export declare const PoliciesApiFp: (configuration?: Configuration) => {
300
300
  */
301
301
  getPolicyDataByDate(code: string, authorization?: string, timesliceDate?: string, expand?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<GetPolicyResponseClass>>;
302
302
  /**
303
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
303
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
304
304
  * @summary List policies
305
305
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
306
306
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
307
307
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
308
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
309
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
308
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
309
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
310
310
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
311
311
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
312
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
312
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
313
313
  * @param {*} [options] Override http request option.
314
314
  * @throws {RequiredError}
315
315
  */
@@ -346,7 +346,7 @@ export declare const PoliciesApiFp: (configuration?: Configuration) => {
346
346
  */
347
347
  listPolicyVersions(policyCode: string, authorization?: string, pageSize?: number, pageToken?: string, filter?: string, search?: string, order?: string, expand?: string, filters?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ListPolicyVersionResponseClass>>;
348
348
  /**
349
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
349
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
350
350
  * @summary Update the draft-policy
351
351
  * @param {string} policyCode Unique identifier for the object.
352
352
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -432,7 +432,7 @@ export declare const PoliciesApiFactory: (configuration?: Configuration, basePat
432
432
  */
433
433
  activatePolicy(policyCode: string, activatePolicyRequestDto: ActivatePolicyRequestDto, authorization?: string, options?: any): AxiosPromise<ActivatePolicyResponseClass>;
434
434
  /**
435
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
435
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
436
436
  * @summary Create the draft-policy
437
437
  * @param {string} policyCode Unique identifier for the object.
438
438
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -460,11 +460,11 @@ export declare const PoliciesApiFactory: (configuration?: Configuration, basePat
460
460
  */
461
461
  deleteDraftPolicy(policyCode: string, authorization?: string, options?: any): AxiosPromise<DeleteResponseClass>;
462
462
  /**
463
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
463
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
464
464
  * @summary Retrieve the draft-policy
465
465
  * @param {string} policyCode Unique identifier for the object.
466
466
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
467
- * @param {string} [expand] Fields to expand response by.
467
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
468
468
  * @param {*} [options] Override http request option.
469
469
  * @throws {RequiredError}
470
470
  */
@@ -491,16 +491,16 @@ export declare const PoliciesApiFactory: (configuration?: Configuration, basePat
491
491
  */
492
492
  getPolicyDataByDate(code: string, authorization?: string, timesliceDate?: string, expand?: string, options?: any): AxiosPromise<GetPolicyResponseClass>;
493
493
  /**
494
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
494
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
495
495
  * @summary List policies
496
496
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
497
497
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
498
498
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
499
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
500
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
499
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
500
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
501
501
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
502
502
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
503
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
503
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
504
504
  * @param {*} [options] Override http request option.
505
505
  * @throws {RequiredError}
506
506
  */
@@ -537,7 +537,7 @@ export declare const PoliciesApiFactory: (configuration?: Configuration, basePat
537
537
  */
538
538
  listPolicyVersions(policyCode: string, authorization?: string, pageSize?: number, pageToken?: string, filter?: string, search?: string, order?: string, expand?: string, filters?: string, options?: any): AxiosPromise<ListPolicyVersionResponseClass>;
539
539
  /**
540
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
540
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
541
541
  * @summary Update the draft-policy
542
542
  * @param {string} policyCode Unique identifier for the object.
543
543
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -714,7 +714,7 @@ export interface PoliciesApiGetDraftPolicyRequest {
714
714
  */
715
715
  readonly authorization?: string;
716
716
  /**
717
- * Fields to expand response by.
717
+ * Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
718
718
  * @type {string}
719
719
  * @memberof PoliciesApiGetDraftPolicy
720
720
  */
@@ -801,13 +801,13 @@ export interface PoliciesApiListPoliciesRequest {
801
801
  */
802
802
  readonly pageToken?: string;
803
803
  /**
804
- * Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
804
+ * Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
805
805
  * @type {string}
806
806
  * @memberof PoliciesApiListPolicies
807
807
  */
808
808
  readonly filter?: string;
809
809
  /**
810
- * To search the list by any field, pass search&#x3D;xxx to fetch the result.
810
+ * To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
811
811
  * @type {string}
812
812
  * @memberof PoliciesApiListPolicies
813
813
  */
@@ -825,7 +825,7 @@ export interface PoliciesApiListPoliciesRequest {
825
825
  */
826
826
  readonly expand?: string;
827
827
  /**
828
- * Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
828
+ * Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
829
829
  * @type {string}
830
830
  * @memberof PoliciesApiListPolicies
831
831
  */
@@ -1139,7 +1139,7 @@ export declare class PoliciesApi extends BaseAPI {
1139
1139
  */
1140
1140
  activatePolicy(requestParameters: PoliciesApiActivatePolicyRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<ActivatePolicyResponseClass, any, {}>>;
1141
1141
  /**
1142
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
1142
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
1143
1143
  * @summary Create the draft-policy
1144
1144
  * @param {PoliciesApiCreateDraftPolicyRequest} requestParameters Request parameters.
1145
1145
  * @param {*} [options] Override http request option.
@@ -1166,7 +1166,7 @@ export declare class PoliciesApi extends BaseAPI {
1166
1166
  */
1167
1167
  deleteDraftPolicy(requestParameters: PoliciesApiDeleteDraftPolicyRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<DeleteResponseClass, any, {}>>;
1168
1168
  /**
1169
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
1169
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
1170
1170
  * @summary Retrieve the draft-policy
1171
1171
  * @param {PoliciesApiGetDraftPolicyRequest} requestParameters Request parameters.
1172
1172
  * @param {*} [options] Override http request option.
@@ -1193,7 +1193,7 @@ export declare class PoliciesApi extends BaseAPI {
1193
1193
  */
1194
1194
  getPolicyDataByDate(requestParameters: PoliciesApiGetPolicyDataByDateRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<GetPolicyResponseClass, any, {}>>;
1195
1195
  /**
1196
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
1196
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
1197
1197
  * @summary List policies
1198
1198
  * @param {PoliciesApiListPoliciesRequest} requestParameters Request parameters.
1199
1199
  * @param {*} [options] Override http request option.
@@ -1220,7 +1220,7 @@ export declare class PoliciesApi extends BaseAPI {
1220
1220
  */
1221
1221
  listPolicyVersions(requestParameters: PoliciesApiListPolicyVersionsRequest, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<ListPolicyVersionResponseClass, any, {}>>;
1222
1222
  /**
1223
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
1223
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
1224
1224
  * @summary Update the draft-policy
1225
1225
  * @param {PoliciesApiPatchDraftPolicyRequest} requestParameters Request parameters.
1226
1226
  * @param {*} [options] Override http request option.
@@ -150,7 +150,7 @@ var PoliciesApiAxiosParamCreator = function (configuration) {
150
150
  });
151
151
  },
152
152
  /**
153
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
153
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
154
154
  * @summary Create the draft-policy
155
155
  * @param {string} policyCode Unique identifier for the object.
156
156
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -300,11 +300,11 @@ var PoliciesApiAxiosParamCreator = function (configuration) {
300
300
  });
301
301
  },
302
302
  /**
303
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
303
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
304
304
  * @summary Retrieve the draft-policy
305
305
  * @param {string} policyCode Unique identifier for the object.
306
306
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
307
- * @param {string} [expand] Fields to expand response by.
307
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
308
308
  * @param {*} [options] Override http request option.
309
309
  * @throws {RequiredError}
310
310
  */
@@ -460,16 +460,16 @@ var PoliciesApiAxiosParamCreator = function (configuration) {
460
460
  });
461
461
  },
462
462
  /**
463
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
463
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
464
464
  * @summary List policies
465
465
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
466
466
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
467
467
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
468
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
469
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
468
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
469
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
470
470
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
471
471
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
472
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
472
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
473
473
  * @param {*} [options] Override http request option.
474
474
  * @throws {RequiredError}
475
475
  */
@@ -680,7 +680,7 @@ var PoliciesApiAxiosParamCreator = function (configuration) {
680
680
  });
681
681
  },
682
682
  /**
683
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
683
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
684
684
  * @summary Update the draft-policy
685
685
  * @param {string} policyCode Unique identifier for the object.
686
686
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -1083,7 +1083,7 @@ var PoliciesApiFp = function (configuration) {
1083
1083
  });
1084
1084
  },
1085
1085
  /**
1086
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
1086
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
1087
1087
  * @summary Create the draft-policy
1088
1088
  * @param {string} policyCode Unique identifier for the object.
1089
1089
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -1147,11 +1147,11 @@ var PoliciesApiFp = function (configuration) {
1147
1147
  });
1148
1148
  },
1149
1149
  /**
1150
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
1150
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
1151
1151
  * @summary Retrieve the draft-policy
1152
1152
  * @param {string} policyCode Unique identifier for the object.
1153
1153
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
1154
- * @param {string} [expand] Fields to expand response by.
1154
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
1155
1155
  * @param {*} [options] Override http request option.
1156
1156
  * @throws {RequiredError}
1157
1157
  */
@@ -1214,16 +1214,16 @@ var PoliciesApiFp = function (configuration) {
1214
1214
  });
1215
1215
  },
1216
1216
  /**
1217
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
1217
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
1218
1218
  * @summary List policies
1219
1219
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
1220
1220
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
1221
1221
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
1222
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
1223
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
1222
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
1223
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
1224
1224
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
1225
1225
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
1226
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
1226
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
1227
1227
  * @param {*} [options] Override http request option.
1228
1228
  * @throws {RequiredError}
1229
1229
  */
@@ -1296,7 +1296,7 @@ var PoliciesApiFp = function (configuration) {
1296
1296
  });
1297
1297
  },
1298
1298
  /**
1299
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
1299
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
1300
1300
  * @summary Update the draft-policy
1301
1301
  * @param {string} policyCode Unique identifier for the object.
1302
1302
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -1472,7 +1472,7 @@ var PoliciesApiFactory = function (configuration, basePath, axios) {
1472
1472
  return localVarFp.activatePolicy(policyCode, activatePolicyRequestDto, authorization, options).then(function (request) { return request(axios, basePath); });
1473
1473
  },
1474
1474
  /**
1475
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
1475
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
1476
1476
  * @summary Create the draft-policy
1477
1477
  * @param {string} policyCode Unique identifier for the object.
1478
1478
  * @param {CreateDraftPolicyRequestDto} createDraftPolicyRequestDto
@@ -1506,11 +1506,11 @@ var PoliciesApiFactory = function (configuration, basePath, axios) {
1506
1506
  return localVarFp.deleteDraftPolicy(policyCode, authorization, options).then(function (request) { return request(axios, basePath); });
1507
1507
  },
1508
1508
  /**
1509
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
1509
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
1510
1510
  * @summary Retrieve the draft-policy
1511
1511
  * @param {string} policyCode Unique identifier for the object.
1512
1512
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
1513
- * @param {string} [expand] Fields to expand response by.
1513
+ * @param {string} [expand] Fields to expand in the draft response. Pass the unprefixed relation name; for example, \&quot;premiumItems\&quot; expands the draft premium items relation.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: version, timelines, premiums, premiumItems, premiumFormulas&lt;/i&gt;
1514
1514
  * @param {*} [options] Override http request option.
1515
1515
  * @throws {RequiredError}
1516
1516
  */
@@ -1543,16 +1543,16 @@ var PoliciesApiFactory = function (configuration, basePath, axios) {
1543
1543
  return localVarFp.getPolicyDataByDate(code, authorization, timesliceDate, expand, options).then(function (request) { return request(axios, basePath); });
1544
1544
  },
1545
1545
  /**
1546
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
1546
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
1547
1547
  * @summary List policies
1548
1548
  * @param {string} [authorization] Bearer Token: provided by the login endpoint under the name accessToken.
1549
1549
  * @param {number} [pageSize] A limit on the number of objects to be returned. Limit ranges between 1 and 50. Default: 10.
1550
1550
  * @param {string} [pageToken] A cursor for use in pagination. pageToken is an ID that defines your place in the list. For instance, if you make a list request and receive 100 objects and pageToken&#x3D;1, your subsequent call can include pageToken&#x3D;2 in order to fetch the next page of the list.
1551
- * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
1552
- * @param {string} [search] To search the list by any field, pass search&#x3D;xxx to fetch the result.
1551
+ * @param {string} [filter] Filter the response by one or multiple fields. In general, fetching filtered responses will conserve bandwidth and reduce response time.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
1552
+ * @param {string} [search] To search the list, pass search&#x3D;xxx. Free text is matched against the policy\&#39;s searchable fields — policy code, policy number, internal policy number, holder, status, product name/slug/ids, account and lead codes, policy start date, and insured-object values (policyObjects.data). Matching is case-, accent- and umlaut-insensitive (mueller finds Müller); typos are corrected for holder and product name; results are ranked by relevance first, then by the requested order. Among the insured-object values, free text reaches the ones a person would search by — names, e-mail addresses, postal addresses, plates, model, serial and other identifier fields. Dates, amounts, booleans, bare numbers, document links and values over 64 characters are deliberately not free-text searchable, so that searching for a name does not compete with every policy that happens to contain a 0. They remain reachable field-scoped. To search a single field, pass search&#x3D;path:value e.g. search&#x3D;holder:Müller, search&#x3D;policyNumber:11002200, search&#x3D;policyObjects.data.postalCode:10115. Field-scoped search reaches every stored value, including the ones free text skips. The value matches exactly or as a prefix, without typo correction or ranking. Paths are dot-separated and case-sensitive; array fields need no index.
1553
1553
  * @param {string} [order] Order allows you to specify the desired order of entities retrieved from the server by ascending (ASC) or descending (DESC) order.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, policyNumber, createdAt, updatedAt, policyStartDate, productVersionId, productId&lt;/i&gt;
1554
1554
  * @param {string} [expand] Expand to fetch additional information about the list items. Expanding resources can reduce the number of API calls required to accomplish a task. Use with discretion as some expanded fields can drastically increase payload size.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: versions, product, timelines, premiums, premiumItems, premiumFormulas, currentVersion, currentTimelines, currentPremiums, currentPremiumItems, currentPremiumFormulas, partnerLinks&lt;i&gt;
1555
- * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode&lt;/i&gt;
1555
+ * @param {string} [filters] Filters the response by one or multiple fields. Advanced filter functionality allows you to perform more complex filtering operations.&lt;br/&gt; &lt;br/&gt; &lt;i&gt;Allowed values: id, code, leadCode, policyNumber, holder, policyStartDate, productSlug, productVersionId, productId, accountCode, productName, status, statuses, createdAt, policyData, partnerCode, partnerLinks.partnerCode&lt;/i&gt;
1556
1556
  * @param {*} [options] Override http request option.
1557
1557
  * @throws {RequiredError}
1558
1558
  */
@@ -1595,7 +1595,7 @@ var PoliciesApiFactory = function (configuration, basePath, axios) {
1595
1595
  return localVarFp.listPolicyVersions(policyCode, authorization, pageSize, pageToken, filter, search, order, expand, filters, options).then(function (request) { return request(axios, basePath); });
1596
1596
  },
1597
1597
  /**
1598
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
1598
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
1599
1599
  * @summary Update the draft-policy
1600
1600
  * @param {string} policyCode Unique identifier for the object.
1601
1601
  * @param {PatchDraftPolicyRequestDto} patchDraftPolicyRequestDto
@@ -1705,7 +1705,7 @@ var PoliciesApi = /** @class */ (function (_super) {
1705
1705
  return (0, exports.PoliciesApiFp)(this.configuration).activatePolicy(requestParameters.policyCode, requestParameters.activatePolicyRequestDto, requestParameters.authorization, options).then(function (request) { return request(_this.axios, _this.basePath); });
1706
1706
  };
1707
1707
  /**
1708
- * This will create a draft policy in the database. **Required Permissions** \"policy-management.policies.create\"
1708
+ * Creates a draft version of the policy update, without affecting the current version. This adds a new version to the existing policy — it does not create a new policy. The draft is returned with `isDraft: true` and `isCurrent: false`; the current version is unchanged until the draft is approved via `PATCH .../draft` with `revisionStatus: APPROVED`. **Required Permissions** \"policy-management.policies.create\"
1709
1709
  * @summary Create the draft-policy
1710
1710
  * @param {PoliciesApiCreateDraftPolicyRequest} requestParameters Request parameters.
1711
1711
  * @param {*} [options] Override http request option.
@@ -1741,7 +1741,7 @@ var PoliciesApi = /** @class */ (function (_super) {
1741
1741
  return (0, exports.PoliciesApiFp)(this.configuration).deleteDraftPolicy(requestParameters.policyCode, requestParameters.authorization, options).then(function (request) { return request(_this.axios, _this.basePath); });
1742
1742
  };
1743
1743
  /**
1744
- * Retrieves the details of the draft-policy that was previously created. Supply the unique draft-policy code that was returned when you created it and Emil Api will return the corresponding draft-policy information. **Required Permissions** \"policy-management.policies.view\"
1744
+ * Retrieves the draft version of the policy, if one exists. The returned version has `isDraft: true` and `isCurrent: false` it is never the current/live version. Returns a 404 if no draft exists (e.g. after it has been approved or rejected). **Required Permissions** \"policy-management.policies.view\"
1745
1745
  * @summary Retrieve the draft-policy
1746
1746
  * @param {PoliciesApiGetDraftPolicyRequest} requestParameters Request parameters.
1747
1747
  * @param {*} [options] Override http request option.
@@ -1777,7 +1777,7 @@ var PoliciesApi = /** @class */ (function (_super) {
1777
1777
  return (0, exports.PoliciesApiFp)(this.configuration).getPolicyDataByDate(requestParameters.code, requestParameters.authorization, requestParameters.timesliceDate, requestParameters.expand, options).then(function (request) { return request(_this.axios, _this.basePath); });
1778
1778
  };
1779
1779
  /**
1780
- * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation. **Required Permissions** \"policy-management.policies.view\"
1780
+ * Returns a list of policies you have previously created. The policies are returned in sorted order, with the oldest one appearing first. For more information about pagination, read the Pagination documentation.<br/> <br/> <b>Notes on filtering:</b><br/> - The `partnerCode` filter matches any policy that has ever had a link to that partner — past, current, or future-dated — not only currently-assigned ones. There is currently no separate filter to match only the currently-active link.<br/> - An unrecognized filter field name is silently ignored: the request returns 200 with the unfiltered (or partially filtered, if combined with valid fields) result set rather than an error. **Required Permissions** \"policy-management.policies.view\"
1781
1781
  * @summary List policies
1782
1782
  * @param {PoliciesApiListPoliciesRequest} requestParameters Request parameters.
1783
1783
  * @param {*} [options] Override http request option.
@@ -1815,7 +1815,7 @@ var PoliciesApi = /** @class */ (function (_super) {
1815
1815
  return (0, exports.PoliciesApiFp)(this.configuration).listPolicyVersions(requestParameters.policyCode, requestParameters.authorization, requestParameters.pageSize, requestParameters.pageToken, requestParameters.filter, requestParameters.search, requestParameters.order, requestParameters.expand, requestParameters.filters, options).then(function (request) { return request(_this.axios, _this.basePath); });
1816
1816
  };
1817
1817
  /**
1818
- * Updates the specified draft-policy by setting the values of the parameters passed. Any parameters not provided will be left unchanged. **Required Permissions** \"policy-management.policies.update\"
1818
+ * Updates the draft version, or changes its lifecycle state via `revisionStatus` (see that field\'s description for what each value does — most notably, `APPROVED` promotes the draft to the current policy version and `REJECTED` deletes it). **Required Permissions** \"policy-management.policies.update\"
1819
1819
  * @summary Update the draft-policy
1820
1820
  * @param {PoliciesApiPatchDraftPolicyRequest} requestParameters Request parameters.
1821
1821
  * @param {*} [options] Override http request option.
@@ -24,7 +24,7 @@ export interface CreateDraftPolicyRequestDto {
24
24
  */
25
25
  'policyObjects': Array<PolicyObjectDto>;
26
26
  /**
27
- * Date from which the policy should be updated. This will create a new timeline starting from this date.
27
+ * Date from which the policy should be updated. This will create a new timeline starting from this date. Required — unlike on the PATCH draft endpoint, `from` cannot be omitted when creating a draft.
28
28
  * @type {string}
29
29
  * @memberof CreateDraftPolicyRequestDto
30
30
  */
@@ -22,7 +22,7 @@ export interface GetDraftPolicyRequestDto {
22
22
  */
23
23
  'policyCode': string;
24
24
  /**
25
- * Fields to expand response by.
25
+ * Fields to expand in the draft response. Pass the unprefixed relation name; for example, \"premiumItems\" expands the draft premium items relation.<br/> <br/> <i>Allowed values: version, timelines, premiums, premiumItems, premiumFormulas</i>
26
26
  * @type {string}
27
27
  * @memberof GetDraftPolicyRequestDto
28
28
  */
@@ -24,7 +24,7 @@ export interface PatchDraftPolicyRequestDto {
24
24
  */
25
25
  'policyObjects': Array<PolicyObjectDto>;
26
26
  /**
27
- * Date from which the policy should be updated. This will create a new timeline starting from this date.
27
+ * Date from which the policy should be updated. This will create a new timeline starting from this date. Optional on PATCH — omit it to leave the current version unaffected.
28
28
  * @type {string}
29
29
  * @memberof PatchDraftPolicyRequestDto
30
30
  */
@@ -36,7 +36,7 @@ export interface PatchDraftPolicyRequestDto {
36
36
  */
37
37
  'to'?: string;
38
38
  /**
39
- * Policy revision status.
39
+ * Policy revision status. Terminal values change the draft lifecycle:<br/> <br/> - <b>APPROVED</b>: promotes the draft to the current policy version (`isCurrent: true`, `isDraft: false`), replacing the current version.<br/> - <b>REJECTED</b>: deletes the draft version; subsequent `GET .../draft` requests return 404.<br/> - <b>CREATED</b>, <b>IN_REVIEW</b>, or <b>REVIEWED</b>: updates the draft in place with the supplied payload and leaves it as a draft (`isCurrent: false`, `isDraft: true`).
40
40
  * @type {string}
41
41
  * @memberof PatchDraftPolicyRequestDto
42
42
  */
@@ -28,7 +28,7 @@ export interface PolicyObjectDto {
28
28
  */
29
29
  'insuredObjectName'?: string;
30
30
  /**
31
- * Insured object data.
31
+ * Insured object data. For the \"Coverage\" insured object, pass the tariff variant as `tariffVariant`, for example `{ \"tariffVariant\": \"...\" }`.
32
32
  * @type {object}
33
33
  * @memberof PolicyObjectDto
34
34
  */
@@ -47,7 +47,7 @@ export interface PolicyPremiumItemClass {
47
47
  */
48
48
  'premiumFormula': PremiumFormulaClass;
49
49
  /**
50
- * Is premium override?
50
+ * Whether this premium item is priced from an override rather than the formula. Read-only — it cannot be set directly. It is computed per formula (matched by `name` + `unit`) from whether the request included a matching entry in `premiumOverride.premiumOverrides`.
51
51
  * @type {boolean}
52
52
  * @memberof PolicyPremiumItemClass
53
53
  */
@@ -33,6 +33,12 @@ export interface ProductVersionClass {
33
33
  * @memberof ProductVersionClass
34
34
  */
35
35
  'code': string;
36
+ /**
37
+ * A slug is a human-readable, unique identifier, used to identify a resource instead of a less human-readable identifier like an id. It is derived from the product slug and the version number, e.g. `car-insurance_v2`.
38
+ * @type {string}
39
+ * @memberof ProductVersionClass
40
+ */
41
+ 'slug': string;
36
42
  /**
37
43
  * Product version description.
38
44
  * @type {string}