@emilgroup/commission-sdk-node 2.9.1-beta.1 → 2.9.1-beta.11

package/models/clawback-config-class.ts

@@ -0,0 +1,42 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface ClawbackConfigClass
+ */
+export interface ClawbackConfigClass {
+    /**
+     * Allow manual commission clawback creation.
+     * @type {boolean}
+     * @memberof ClawbackConfigClass
+     */
+    'manual': boolean;
+    /**
+     * Allow automatic commission clawback creation for policy termination and withdrawal.
+     * @type {boolean}
+     * @memberof ClawbackConfigClass
+     */
+    'policyCancellation': boolean;
+    /**
+     * Allow automatic commission clawback creation for intermediary switches.
+     * @type {boolean}
+     * @memberof ClawbackConfigClass
+     */
+    'intermediarySwitched': boolean;
+}
+

package/models/clawback-config-dto.ts

@@ -0,0 +1,42 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface ClawbackConfigDto
+ */
+export interface ClawbackConfigDto {
+    /**
+     * Allow manual commission clawback creation.
+     * @type {boolean}
+     * @memberof ClawbackConfigDto
+     */
+    'manual': boolean;
+    /**
+     * Allow automatic commission clawback creation for policy termination and withdrawal.
+     * @type {boolean}
+     * @memberof ClawbackConfigDto
+     */
+    'policyCancellation': boolean;
+    /**
+     * Allow automatic commission clawback creation for intermediary switches.
+     * @type {boolean}
+     * @memberof ClawbackConfigDto
+     */
+    'intermediarySwitched': boolean;
+}
+

package/models/commission-agreement-version-class.ts

@@ -13,6 +13,7 @@
  */
 
 
+import { ClawbackConfigClass } from './clawback-config-class';
 import { CommissionAgreementClass } from './commission-agreement-class';
 import { CommissionAgreementProductClass } from './commission-agreement-product-class';
 
@@ -64,6 +65,12 @@ export interface CommissionAgreementVersionClass {
      * @memberof CommissionAgreementVersionClass
      */
     'settlementCreationDate'?: string;
+    /**
+     * Version-scoped clawback creation configuration.
+     * @type {ClawbackConfigClass}
+     * @memberof CommissionAgreementVersionClass
+     */
+    'clawbackConfig': ClawbackConfigClass;
     /**
      * Description explaining what changed in this version or version notes
      * @type {string}

package/models/commission-candidate-class.ts

@@ -68,6 +68,18 @@ export interface CommissionCandidateClass {
      * @memberof CommissionCandidateClass
      */
     'policyRenewalDate'?: string;
+    /**
+     * Exclusive end of the period the commission will be created for
+     * @type {string}
+     * @memberof CommissionCandidateClass
+     */
+    'commissionPeriodTo'?: string;
+    /**
+     * Expected invoice entry count in the commission period, used as the pro rata denominator
+     * @type {number}
+     * @memberof CommissionCandidateClass
+     */
+    'expectedInvoiceEntryCount'?: number;
     /**
      * Time at which the object was created.
      * @type {string}

package/models/commission-class.ts

@@ -112,6 +112,42 @@ export interface CommissionClass {
      * @memberof CommissionClass
      */
     'settlementCode'?: string;
+    /**
+     * The source invoice code for invoice-driven commissions
+     * @type {string}
+     * @memberof CommissionClass
+     */
+    'invoiceCode'?: string;
+    /**
+     * Start of the period the commission was originally created for
+     * @type {string}
+     * @memberof CommissionClass
+     */
+    'commissionPeriodFrom'?: string;
+    /**
+     * Exclusive end of the period the commission was originally created for
+     * @type {string}
+     * @memberof CommissionClass
+     */
+    'commissionPeriodTo'?: string;
+    /**
+     * Expected invoice entry count in the commission period, used as the pro rata denominator
+     * @type {number}
+     * @memberof CommissionClass
+     */
+    'expectedInvoiceEntryCount'?: number;
+    /**
+     * For clawback commissions, the original commission being clawed back
+     * @type {string}
+     * @memberof CommissionClass
+     */
+    'originalCommissionCode'?: string;
+    /**
+     * The trigger type that created this clawback commission
+     * @type {string}
+     * @memberof CommissionClass
+     */
+    'clawbackTriggerType'?: CommissionClassClawbackTriggerTypeEnum;
     /**
      * Time at which the object was created.
      * @type {string}
@@ -144,3 +180,13 @@ export interface CommissionClass {
     'items': Array<CommissionItemClass>;
 }
 
+export const CommissionClassClawbackTriggerTypeEnum = {
+    Manual: 'manual',
+    PolicyTermination: 'policy_termination',
+    PolicyWithdrawal: 'policy_withdrawal',
+    IntermediarySwitched: 'intermediary_switched'
+} as const;
+
+export type CommissionClassClawbackTriggerTypeEnum = typeof CommissionClassClawbackTriggerTypeEnum[keyof typeof CommissionClassClawbackTriggerTypeEnum];
+
+

package/models/commission-config-dto.ts

@@ -22,7 +22,7 @@ import { CommissionConditionsDto } from './commission-conditions-dto';
  */
 export interface CommissionConfigDto {
     /**
-     * Type of commission (e.g., sales, maintenance, other)
+     * Type of commission (e.g., sales, maintenance, other, clawback)
      * @type {string}
      * @memberof CommissionConfigDto
      */
@@ -50,7 +50,8 @@ export interface CommissionConfigDto {
 export const CommissionConfigDtoTypeEnum = {
     Sales: 'sales',
     Maintenance: 'maintenance',
-    Other: 'other'
+    Other: 'other',
+    Clawback: 'clawback'
 } as const;
 
 export type CommissionConfigDtoTypeEnum = typeof CommissionConfigDtoTypeEnum[keyof typeof CommissionConfigDtoTypeEnum];

package/models/commission-estimate-class.ts

@@ -39,7 +39,7 @@ export interface CommissionEstimateClass {
      */
     'amount': number;
     /**
-     * Type of commission. Valid values: sales, maintenance, other
+     * Type of commission. Valid values: sales, maintenance, other, clawback
      * @type {string}
      * @memberof CommissionEstimateClass
      */
@@ -55,7 +55,8 @@ export interface CommissionEstimateClass {
 export const CommissionEstimateClassTypeEnum = {
     Sales: 'sales',
     Maintenance: 'maintenance',
-    Other: 'other'
+    Other: 'other',
+    Clawback: 'clawback'
 } as const;
 
 export type CommissionEstimateClassTypeEnum = typeof CommissionEstimateClassTypeEnum[keyof typeof CommissionEstimateClassTypeEnum];

package/models/create-commission-agreement-request-dto.ts

@@ -13,6 +13,7 @@
  */
 
 
+import { ClawbackConfigDto } from './clawback-config-dto';
 import { CommissionAgreementMetadataDto } from './commission-agreement-metadata-dto';
 
 /**
@@ -75,6 +76,12 @@ export interface CreateCommissionAgreementRequestDto {
      * @memberof CreateCommissionAgreementRequestDto
      */
     'settlementCreationDate'?: string;
+    /**
+     * Initial version clawback creation configuration. Missing config defaults to all triggers disabled.
+     * @type {ClawbackConfigDto}
+     * @memberof CreateCommissionAgreementRequestDto
+     */
+    'clawbackConfig'?: ClawbackConfigDto;
 }
 
 export const CreateCommissionAgreementRequestDtoBillingFrequencyEnum = {

package/models/create-commission-agreement-version-request-dto.ts

@@ -13,6 +13,7 @@
  */
 
 
+import { ClawbackConfigDto } from './clawback-config-dto';
 
 /**
  * 
@@ -50,5 +51,11 @@ export interface CreateCommissionAgreementVersionRequestDto {
      * @memberof CreateCommissionAgreementVersionRequestDto
      */
     'versionDescription'?: string;
+    /**
+     * Version-scoped clawback creation configuration. Missing config defaults to all triggers disabled.
+     * @type {ClawbackConfigDto}
+     * @memberof CreateCommissionAgreementVersionRequestDto
+     */
+    'clawbackConfig'?: ClawbackConfigDto;
 }
 

package/models/create-commission-candidate-request-dto.ts

@@ -39,7 +39,7 @@ export interface CreateCommissionCandidateRequestDto {
      */
     'candidateType': CreateCommissionCandidateRequestDtoCandidateTypeEnum;
     /**
-     * The type of commission. Valid values: sales, maintenance, other
+     * The type of commission. Valid values: sales, maintenance, other, clawback
      * @type {string}
      * @memberof CreateCommissionCandidateRequestDto
      */
@@ -51,11 +51,23 @@ export interface CreateCommissionCandidateRequestDto {
      */
     'commissionCode'?: string;
     /**
-     * The date of the next policy renewal for this commission candidate
+     * The date of the next policy renewal for this commission candidate. Required when renewal clawback metadata is provided.
      * @type {string}
      * @memberof CreateCommissionCandidateRequestDto
      */
     'policyRenewalDate'?: string;
+    /**
+     * Exclusive end of the commission period. If provided, policyRenewalDate and expectedInvoiceEntryCount must also be provided.
+     * @type {string}
+     * @memberof CreateCommissionCandidateRequestDto
+     */
+    'commissionPeriodTo'?: string;
+    /**
+     * Expected invoice entry count in the commission period. If provided, policyRenewalDate and commissionPeriodTo must also be provided.
+     * @type {number}
+     * @memberof CreateCommissionCandidateRequestDto
+     */
+    'expectedInvoiceEntryCount'?: number;
 }
 
 export const CreateCommissionCandidateRequestDtoCandidateTypeEnum = {
@@ -67,7 +79,8 @@ export type CreateCommissionCandidateRequestDtoCandidateTypeEnum = typeof Create
 export const CreateCommissionCandidateRequestDtoCommissionTypeEnum = {
     Sales: 'sales',
     Maintenance: 'maintenance',
-    Other: 'other'
+    Other: 'other',
+    Clawback: 'clawback'
 } as const;
 
 export type CreateCommissionCandidateRequestDtoCommissionTypeEnum = typeof CreateCommissionCandidateRequestDtoCommissionTypeEnum[keyof typeof CreateCommissionCandidateRequestDtoCommissionTypeEnum];

package/models/create-commission-clawback-request-dto.ts

@@ -0,0 +1,30 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface CreateCommissionClawbackRequestDto
+ */
+export interface CreateCommissionClawbackRequestDto {
+    /**
+     * Optional business effective date for the clawback calculation. If omitted, server processing time is used.
+     * @type {string}
+     * @memberof CreateCommissionClawbackRequestDto
+     */
+    'effectiveDate'?: string;
+}
+

package/models/create-commission-clawback-response-class.ts

@@ -0,0 +1,52 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import { CommissionClass } from './commission-class';
+
+/**
+ * 
+ * @export
+ * @interface CreateCommissionClawbackResponseClass
+ */
+export interface CreateCommissionClawbackResponseClass {
+    /**
+     * Whether a new clawback commission was created.
+     * @type {boolean}
+     * @memberof CreateCommissionClawbackResponseClass
+     */
+    'created': boolean;
+    /**
+     * Reason why no clawback commission was created. Possible reasons: the original commission was not paid out, the calculated clawback amount was zero or positive, or the commission was already fully clawed back.
+     * @type {string}
+     * @memberof CreateCommissionClawbackResponseClass
+     */
+    'notCreatedReason'?: CreateCommissionClawbackResponseClassNotCreatedReasonEnum;
+    /**
+     * Created clawback commission. Set only when created is true.
+     * @type {CommissionClass}
+     * @memberof CreateCommissionClawbackResponseClass
+     */
+    'commission'?: CommissionClass;
+}
+
+export const CreateCommissionClawbackResponseClassNotCreatedReasonEnum = {
+    CommissionNotPaidOut: 'commission_not_paid_out',
+    ClawbackAmountNotNegative: 'clawback_amount_not_negative',
+    CommissionAlreadyFullyClawedBack: 'commission_already_fully_clawed_back'
+} as const;
+
+export type CreateCommissionClawbackResponseClassNotCreatedReasonEnum = typeof CreateCommissionClawbackResponseClassNotCreatedReasonEnum[keyof typeof CreateCommissionClawbackResponseClassNotCreatedReasonEnum];
+
+

package/models/create-commission-item-request-dto.ts

@@ -39,7 +39,7 @@ export interface CreateCommissionItemRequestDto {
      */
     'amount': number;
     /**
-     * The type of commission item. Valid values: sales, maintenance, other
+     * The type of commission item. Valid values: sales, maintenance, other, clawback
      * @type {string}
      * @memberof CreateCommissionItemRequestDto
      */
@@ -49,7 +49,8 @@ export interface CreateCommissionItemRequestDto {
 export const CreateCommissionItemRequestDtoTypeEnum = {
     Sales: 'sales',
     Maintenance: 'maintenance',
-    Other: 'other'
+    Other: 'other',
+    Clawback: 'clawback'
 } as const;
 
 export type CreateCommissionItemRequestDtoTypeEnum = typeof CreateCommissionItemRequestDtoTypeEnum[keyof typeof CreateCommissionItemRequestDtoTypeEnum];

package/models/create-commission-request-dto.ts

@@ -51,5 +51,11 @@ export interface CreateCommissionRequestDto {
      * @memberof CreateCommissionRequestDto
      */
     'items': Array<CreateCommissionItemRequestDto>;
+    /**
+     * Commission candidate code linked to this commission.
+     * @type {string}
+     * @memberof CreateCommissionRequestDto
+     */
+    'commissionCandidateCode'?: string;
 }
 

package/models/evaluated-commission-class.ts

@@ -21,7 +21,7 @@
  */
 export interface EvaluatedCommissionClass {
     /**
-     * Type of commission (e.g., sales, maintenance, other)
+     * Type of commission (e.g., sales, maintenance, other, clawback)
      * @type {string}
      * @memberof EvaluatedCommissionClass
      */
@@ -55,7 +55,8 @@ export interface EvaluatedCommissionClass {
 export const EvaluatedCommissionClassTypeEnum = {
     Sales: 'sales',
     Maintenance: 'maintenance',
-    Other: 'other'
+    Other: 'other',
+    Clawback: 'clawback'
 } as const;
 
 export type EvaluatedCommissionClassTypeEnum = typeof EvaluatedCommissionClassTypeEnum[keyof typeof EvaluatedCommissionClassTypeEnum];

package/models/index.ts

@@ -1,3 +1,5 @@
+export * from './clawback-config-class';
+export * from './clawback-config-dto';
 export * from './commission-agreement-class';
 export * from './commission-agreement-metadata-dto';
 export * from './commission-agreement-metadata-partner-dto';
@@ -24,6 +26,8 @@ export * from './create-commission-agreement-version-request-dto';
 export * from './create-commission-agreement-version-response-class';
 export * from './create-commission-candidate-request-dto';
 export * from './create-commission-candidate-response-class';
+export * from './create-commission-clawback-request-dto';
+export * from './create-commission-clawback-response-class';
 export * from './create-commission-item-request-dto';
 export * from './create-commission-recipient-for-products-request-dto';
 export * from './create-commission-recipient-for-products-response-class';
@@ -57,12 +61,16 @@ export * from './list-commission-candidates-response-class';
 export * from './list-commission-recipients-response-class';
 export * from './list-commission-settlements-response-class';
 export * from './list-commissions-response-class';
+export * from './list-scheduled-commission-clawback-triggers-response-class';
 export * from './patch-commission-agreement-status-request-dto';
 export * from './patch-commission-agreement-status-response-class';
 export * from './publish-commission-settlements-request-dto';
 export * from './publish-commission-settlements-response-class';
+export * from './scheduled-commission-clawback-trigger-class';
 export * from './trigger-commission-settlement-creation-request-dto';
 export * from './trigger-commission-settlement-creation-response-class';
+export * from './trigger-due-commission-clawbacks-request-dto';
+export * from './trigger-due-commission-clawbacks-response-class';
 export * from './update-commission-agreement-product-request-dto';
 export * from './update-commission-agreement-product-response-class';
 export * from './update-commission-agreement-request-dto';

package/models/list-scheduled-commission-clawback-triggers-response-class.ts

@@ -0,0 +1,49 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+import { ScheduledCommissionClawbackTriggerClass } from './scheduled-commission-clawback-trigger-class';
+
+/**
+ * 
+ * @export
+ * @interface ListScheduledCommissionClawbackTriggersResponseClass
+ */
+export interface ListScheduledCommissionClawbackTriggersResponseClass {
+    /**
+     * The list of scheduled commission clawback triggerss.
+     * @type {Array<ScheduledCommissionClawbackTriggerClass>}
+     * @memberof ListScheduledCommissionClawbackTriggersResponseClass
+     */
+    'items': Array<ScheduledCommissionClawbackTriggerClass>;
+    /**
+     * Next page token.
+     * @type {string}
+     * @memberof ListScheduledCommissionClawbackTriggersResponseClass
+     */
+    'nextPageToken': string;
+    /**
+     * Items per page.
+     * @type {number}
+     * @memberof ListScheduledCommissionClawbackTriggersResponseClass
+     */
+    'itemsPerPage': number;
+    /**
+     * Total amount of items.
+     * @type {number}
+     * @memberof ListScheduledCommissionClawbackTriggersResponseClass
+     */
+    'totalItems': number;
+}
+

package/models/scheduled-commission-clawback-trigger-class.ts

@@ -0,0 +1,119 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface ScheduledCommissionClawbackTriggerClass
+ */
+export interface ScheduledCommissionClawbackTriggerClass {
+    /**
+     * The unique database identifier of the scheduled trigger
+     * @type {number}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'id': number;
+    /**
+     * Unique identifier for the object.
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'code': string;
+    /**
+     * The policy this scheduled clawback trigger belongs to
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'policyCode': string;
+    /**
+     * The automatic clawback trigger type
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'triggerType': ScheduledCommissionClawbackTriggerClassTriggerTypeEnum;
+    /**
+     * The effective date when the scheduled clawback trigger becomes due
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'effectiveDate': string;
+    /**
+     * The current scheduled trigger status
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'status': ScheduledCommissionClawbackTriggerClassStatusEnum;
+    /**
+     * The time when the due job queued this trigger for processing
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'queuedAt'?: string;
+    /**
+     * Failure reason when processing this scheduled trigger failed
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'errorMessage'?: string;
+    /**
+     * The time when this scheduled trigger was canceled
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'canceledAt'?: string;
+    /**
+     * Time at which the object was created.
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'createdAt': string;
+    /**
+     * Time at which the object was updated.
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'updatedAt': string;
+    /**
+     * Identifier of the user who created the record.
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'createdBy': string;
+    /**
+     * Identifier of the user who last updated the record.
+     * @type {string}
+     * @memberof ScheduledCommissionClawbackTriggerClass
+     */
+    'updatedBy': string;
+}
+
+export const ScheduledCommissionClawbackTriggerClassTriggerTypeEnum = {
+    PolicyTermination: 'policy_termination',
+    PolicyWithdrawal: 'policy_withdrawal',
+    IntermediarySwitched: 'intermediary_switched'
+} as const;
+
+export type ScheduledCommissionClawbackTriggerClassTriggerTypeEnum = typeof ScheduledCommissionClawbackTriggerClassTriggerTypeEnum[keyof typeof ScheduledCommissionClawbackTriggerClassTriggerTypeEnum];
+export const ScheduledCommissionClawbackTriggerClassStatusEnum = {
+    Scheduled: 'scheduled',
+    Queued: 'queued',
+    Canceled: 'canceled',
+    Failed: 'failed'
+} as const;
+
+export type ScheduledCommissionClawbackTriggerClassStatusEnum = typeof ScheduledCommissionClawbackTriggerClassStatusEnum[keyof typeof ScheduledCommissionClawbackTriggerClassStatusEnum];
+
+

package/models/trigger-due-commission-clawbacks-request-dto.ts

@@ -0,0 +1,36 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * EMIL CommissionService
+ * The EMIL CommissionService API description
+ *
+ * The version of the OpenAPI document: 1.0
+ * Contact: kontakt@emil.de
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+
+
+/**
+ * 
+ * @export
+ * @interface TriggerDueCommissionClawbacksRequestDto
+ */
+export interface TriggerDueCommissionClawbacksRequestDto {
+    /**
+     * Processing cutoff for due scheduled clawback triggers. If omitted, server processing time is used.
+     * @type {string}
+     * @memberof TriggerDueCommissionClawbacksRequestDto
+     */
+    'processingDate'?: string;
+    /**
+     * When true, due triggers are counted but not enqueued or marked queued.
+     * @type {boolean}
+     * @memberof TriggerDueCommissionClawbacksRequestDto
+     */
+    'dryRun'?: boolean;
+}
+