@fiado/type-kit 3.430.0 → 3.432.0

package/src/loanCredit/dtos/WriteOffConfirmations.ts

@@ -0,0 +1,17 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsOptional } from 'class-validator';
+
+/** Las dos casillas de la baja contable; el lambda exige las dos en true. */
+export class WriteOffConfirmations {
+    /** Se agotaron los recursos de recuperación. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    recoveryResourcesExhausted?: boolean;
+
+    /** El crédito cumple los días de mora requeridos. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    overdueDaysMet?: boolean;
+}

package/src/loanCredit/dtos/requests/BackofficeAcceptRestructureRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, Matches } from 'class-validator';
+
+/** Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/accept` (loan-credit-business). */
+export class BackofficeAcceptRestructureRequest {
+    /** OTP de 4 dígitos con propósito RESTRUCTURE. */
+    @Expose()
+    @IsString()
+    @Matches(/^\d{4}$/)
+    otpCode!: string;
+}

package/src/loanCredit/dtos/requests/BackofficeApplyAdvanceRequest.ts

@@ -0,0 +1,18 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsOptional, IsString, Matches, Min } from 'class-validator';
+
+/** Body de `POST /backoffice/credits/:creditId/advances` (loan-credit-business). */
+export class BackofficeApplyAdvanceRequest {
+    /** Cuántas cuotas siguientes se adelantan. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    installmentCount!: number;
+
+    /** OTP con propósito ADVANCE que firma la autorización; sin él, un adelanto mayor al pago del periodo responde 422. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(/^\d{4}$/)
+    otpCode?: string;
+}

package/src/loanCredit/dtos/requests/BackofficeApplyPrepaymentRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Min } from 'class-validator';
+
+/** Body de `POST /backoffice/credits/:creditId/prepayments` (loan-credit-business). */
+export class BackofficeApplyPrepaymentRequest {
+    @Expose()
+    @IsInt()
+    @Min(1)
+    amountCents!: number;
+}

package/src/loanCredit/dtos/requests/BackofficeApproveRestructureRequest.ts

@@ -0,0 +1,19 @@
+import { Expose, Type } from 'class-transformer';
+import { IsOptional, IsString, MinLength, ValidateNested } from 'class-validator';
+import { RestructureTerms } from '../RestructureTerms';
+
+/** Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/approve` (loan-credit-business). */
+export class BackofficeApproveRestructureRequest {
+    /** Motivo del admin. Va a la auditoría y no se loguea. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    reason!: string;
+
+    /** Términos ajustados; ausente se aprueba como se propuso. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => RestructureTerms)
+    terms?: RestructureTerms;
+}

package/src/loanCredit/dtos/requests/BackofficeCollectWrittenOffCreditRequest.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { WrittenOffRecoveryTypeEnum } from '../../enums/WrittenOffRecoveryTypeEnum';
+
+/** Body de `POST /backoffice/credits/:creditId/recovery-collection` (loan-credit-business). */
+export class BackofficeCollectWrittenOffCreditRequest {
+    @Expose()
+    @IsEnum(WrittenOffRecoveryTypeEnum)
+    recoveryType!: WrittenOffRecoveryTypeEnum;
+}

package/src/loanCredit/dtos/requests/BackofficeListPaymentsInReviewRequest.ts

@@ -0,0 +1,19 @@
+import { Expose, Type } from 'class-transformer';
+import { IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/** Query de `GET /backoffice/payments/review` (loan-credit-business). */
+export class BackofficeListPaymentsInReviewRequest {
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    /** Cursor opaco de la página anterior. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

package/src/loanCredit/dtos/requests/BackofficeListWriteOffCandidatesRequest.ts

@@ -0,0 +1,19 @@
+import { Expose, Type } from 'class-transformer';
+import { IsInt, IsOptional, IsString, Max, Min } from 'class-validator';
+
+/** Query de `GET /backoffice/credits/write-off-candidates` (loan-credit-business). */
+export class BackofficeListWriteOffCandidatesRequest {
+    @Expose()
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(100)
+    limit?: number;
+
+    /** Cursor opaco de la página anterior. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    nextToken?: string;
+}

package/src/loanCredit/dtos/requests/BackofficeProposeRestructureRequest.ts

@@ -0,0 +1,18 @@
+import { Expose, Type } from 'class-transformer';
+import { IsDefined, IsString, MinLength, ValidateNested } from 'class-validator';
+import { RestructureTerms } from '../RestructureTerms';
+
+/** Body de `POST /backoffice/credits/:creditId/restructures` (loan-credit-business). */
+export class BackofficeProposeRestructureRequest {
+    /** Justificación del cobrador. Va a la auditoría y no se loguea. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    justification!: string;
+
+    @Expose()
+    @IsDefined()
+    @ValidateNested()
+    @Type(() => RestructureTerms)
+    terms!: RestructureTerms;
+}

package/src/loanCredit/dtos/requests/BackofficeRejectRestructureRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsString, MinLength } from 'class-validator';
+
+/** Body de `POST /backoffice/credits/:creditId/restructures/:restructureId/reject` (loan-credit-business). */
+export class BackofficeRejectRestructureRequest {
+    /** Motivo del rechazo. Va a la auditoría y no se loguea. */
+    @Expose()
+    @IsString()
+    @MinLength(1)
+    reason!: string;
+}

package/src/loanCredit/dtos/requests/BackofficeResolvePaymentReviewRequest.ts

@@ -0,0 +1,30 @@
+import { Expose } from 'class-transformer';
+import { IsBoolean, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { PaymentReviewActionEnum } from '../../enums/PaymentReviewActionEnum';
+import { RefundDestinationEnum } from '../../enums/RefundDestinationEnum';
+
+/** Body de `POST /backoffice/credits/:creditId/payments/:paymentId/review-resolution` (loan-credit-business). */
+export class BackofficeResolvePaymentReviewRequest {
+    @Expose()
+    @IsEnum(PaymentReviewActionEnum)
+    action!: PaymentReviewActionEnum;
+
+    /** Obligatorio con REFUND. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(RefundDestinationEnum)
+    refundDestination?: RefundDestinationEnum;
+
+    // pii_sensitive: no se persiste; en logs sale enmascarada.
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @Matches(/^\d{18}$/)
+    clabe?: string;
+
+    /** Obligatorio con REFUND a PCF_CLABE: el cliente confirmó su CLABE PCF. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    customerConfirmedPcfClabe?: boolean;
+}

package/src/loanCredit/dtos/requests/BackofficeSettleCreditRequest.ts

@@ -0,0 +1,11 @@
+import { Expose } from 'class-transformer';
+import { IsInt, Min } from 'class-validator';
+
+/** Body de `POST /backoffice/credits/:creditId/settlement` (loan-credit-business). */
+export class BackofficeSettleCreditRequest {
+    /** Monto a liquidar; menor al calculado responde 422 SETTLEMENT_AMOUNT_MISMATCH. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    amountCents!: number;
+}

package/src/loanCredit/dtos/requests/BackofficeWriteOffCreditRequest.ts

@@ -0,0 +1,19 @@
+import { Expose, Type } from 'class-transformer';
+import { IsOptional, IsString, MinLength, ValidateNested } from 'class-validator';
+import { WriteOffConfirmations } from '../WriteOffConfirmations';
+
+/** Body de `POST /backoffice/credits/:creditId/write-off`. Los faltantes los responde el lambda con su code. */
+export class BackofficeWriteOffCreditRequest {
+    /** Motivo de la baja. Va a la auditoría del crédito y no se loguea. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MinLength(1)
+    reason?: string;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => WriteOffConfirmations)
+    confirmations?: WriteOffConfirmations;
+}

package/src/loanCredit/dtos/responses/LoanAdHocChargeRequested.ts

@@ -0,0 +1,10 @@
+import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
+
+/** Response 202 de recovery-collection, prepayments y advances. El 202 no mueve el libro; lo mueve el apply-result. */
+export interface LoanAdHocChargeRequested {
+    creditId: string;
+    chargeKind: LoanAdHocChargeKindEnum;
+    /** `<creditId>#<chargeKind>#<n>`. */
+    chargeId: string;
+    amountCents: number;
+}

package/src/loanCredit/dtos/responses/LoanOtpDispatch.ts

@@ -0,0 +1,5 @@
+/** Response de los envíos de OTP de reestructura y de adelanto. */
+export interface LoanOtpDispatch {
+    creditId: string;
+    otpSent: boolean;
+}

package/src/loanCredit/dtos/responses/LoanPaymentReviewItem.ts

@@ -0,0 +1,13 @@
+import { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
+import { PaymentReviewReasonEnum } from '../../enums/PaymentReviewReasonEnum';
+
+/** Un pago con revisión pendiente. */
+export interface LoanPaymentReviewItem {
+    paymentId: string;
+    creditId: string;
+    chargeKind: LoanChargeKindEnum;
+    /** Lo que quedó en revisión de ese pago. */
+    reviewAmountCents: number;
+    reviewReasons: PaymentReviewReasonEnum[];
+    reviewPendingAt: string;
+}

package/src/loanCredit/dtos/responses/LoanPaymentReviewListResponse.ts

@@ -0,0 +1,8 @@
+import { LoanPaymentReviewItem } from './LoanPaymentReviewItem';
+
+/** Response de `GET /backoffice/payments/review`. */
+export interface LoanPaymentReviewListResponse {
+    items: LoanPaymentReviewItem[];
+    /** Cursor de la página siguiente; su ausencia marca el fin de la lista. */
+    nextToken?: string;
+}

package/src/loanCredit/dtos/responses/LoanPaymentReviewResolution.ts

@@ -0,0 +1,12 @@
+import { PaymentReviewResolutionEnum } from '../../enums/PaymentReviewResolutionEnum';
+
+/** Response de `POST /backoffice/credits/:creditId/payments/:paymentId/review-resolution`. */
+export interface LoanPaymentReviewResolution {
+    paymentId: string;
+    creditId: string;
+    reviewResolution: PaymentReviewResolutionEnum;
+    /** `<creditId>#<paymentId>#<intento>`, sin CLABE. Sólo con REFUND. */
+    refundKey?: string;
+    resolvedBy: string;
+    resolvedAt: string;
+}

package/src/loanCredit/dtos/responses/LoanPrepaymentQuote.ts

@@ -0,0 +1,10 @@
+/** Response de `GET /backoffice/credits/:creditId/prepayment-quote`. */
+export interface LoanPrepaymentQuote {
+    creditId: string;
+    /** Saldo insoluto que se le informa al cliente. */
+    outstandingCapitalCents: number;
+    /** Pago del periodo: el mínimo del abono. */
+    periodPaymentCents: number;
+    /** Monto de liquidación anticipada: el techo del abono. */
+    settlementAmountCents: number;
+}

package/src/loanCredit/dtos/responses/LoanRestructure.ts

@@ -0,0 +1,23 @@
+import { LoanRestructureStatusEnum } from '../../enums/LoanRestructureStatusEnum';
+import { RestructureTerms } from '../RestructureTerms';
+
+/** Response de propose, approve, reject y accept de una reestructura. */
+export interface LoanRestructure {
+    restructureId: string;
+    creditId: string;
+    restructureStatus: LoanRestructureStatusEnum;
+    justification?: string;
+    proposedTerms: RestructureTerms;
+    proposedBy: string;
+    proposedAt: string;
+    originalOutstandingCapitalCents: number;
+    originalRemainingInstallments: number;
+    /** Términos que aprobó el admin; ausente mientras siga PROPOSED. */
+    finalTerms?: RestructureTerms;
+    resolvedBy?: string;
+    resolvedAt?: string;
+    resolutionReason?: string;
+    acceptedAt?: string;
+    /** Versión del plan que nació con la reestructura; ausente antes de aceptarla. */
+    planVersion?: number;
+}

package/src/loanCredit/dtos/responses/LoanRestructureListResponse.ts

@@ -0,0 +1,8 @@
+import { LoanRestructure } from './LoanRestructure';
+
+/** Response de `GET /backoffice/credits/:creditId/restructures`. */
+export interface LoanRestructureListResponse {
+    items: LoanRestructure[];
+    /** Cupo usado: cuenta sólo reestructuras aceptadas. */
+    usedRestructures: number;
+}

package/src/loanCredit/dtos/responses/LoanRestructurePreview.ts

@@ -0,0 +1,16 @@
+import { RestructureTerms } from '../RestructureTerms';
+import { LoanRestructurePreviewInstallment } from './LoanRestructurePreviewInstallment';
+
+/** Response de `GET /backoffice/credits/:creditId/restructures/:restructureId/preview`. */
+export interface LoanRestructurePreview {
+    restructureId: string;
+    creditId: string;
+    terms: RestructureTerms;
+    /** Capital insoluto que se amortiza. */
+    outstandingCapitalCents: number;
+    /** Interés vencido no pagado, repartido sin interés en las cuotas nuevas. */
+    consolidatedOverdueInterestCents: number;
+    /** IVA vencido no pagado, repartido sin interés en las cuotas nuevas. */
+    consolidatedOverdueIvaCents: number;
+    installments: LoanRestructurePreviewInstallment[];
+}

package/src/loanCredit/dtos/responses/LoanRestructurePreviewInstallment.ts

@@ -0,0 +1,11 @@
+/** Una cuota del plan nuevo de la reestructura. */
+export interface LoanRestructurePreviewInstallment {
+    /** Sigue la numeración después de la última cuota del plan vigente. */
+    installmentNumber: number;
+    dueDate: string;
+    capitalCents: number;
+    /** Interés de la cuota, incluida la parte consolidada del interés vencido. */
+    interestCents: number;
+    ivaCents: number;
+    totalCents: number;
+}

package/src/loanCredit/dtos/responses/LoanSettlementQuote.ts

@@ -0,0 +1,16 @@
+/** Response de `GET /backoffice/credits/:creditId/settlement-quote`. Cada componente va redondeado al centavo y el total es su suma. */
+export interface LoanSettlementQuote {
+    creditId: string;
+    /** Total (capital + interés + IVA) de las cuotas vencidas completas. */
+    overdueInstallmentsCents: number;
+    /** Capital insoluto de las cuotas que todavía no vencen. */
+    outstandingCapitalCents: number;
+    /** Interés del periodo en curso × días transcurridos ÷ días del periodo. */
+    currentPeriodInterestCents: number;
+    /** IVA 16% del interés prorrateado. */
+    currentPeriodInterestIvaCents: number;
+    elapsedDays: number;
+    periodDays: number;
+    settlementAmountCents: number;
+    quotedAt: string;
+}

package/src/loanCredit/dtos/responses/LoanSettlementRequested.ts

@@ -0,0 +1,12 @@
+import { LoanSettlementStatusEnum } from '../../enums/LoanSettlementStatusEnum';
+
+/** Response 202 de `POST /backoffice/credits/:creditId/settlement`. */
+export interface LoanSettlementRequested {
+    creditId: string;
+    settlementStatus: LoanSettlementStatusEnum;
+    /** `<creditId>#SETTLEMENT#<n>`: el cargo ad hoc pedido al motor. */
+    chargeId: string;
+    settlementAmountCents: number;
+    /** Neto que se cobra: el monto menos los pagos ya asentados en el libro. */
+    chargeAmountCents: number;
+}

package/src/loanCredit/dtos/responses/LoanWriteOffCandidateItem.ts

@@ -0,0 +1,14 @@
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+
+/** Un crédito candidato a baja contable. */
+export interface LoanWriteOffCandidateItem {
+    creditId: string;
+    borrowerId: string;
+    status: LoanCreditStatusEnum;
+    overdueDays: number;
+    overdueInstallments: number;
+    overdueAmountCents: number;
+    outstandingBalanceCents: number;
+    /** Instante en que el crón lo marcó candidato. */
+    writeOffCandidateAt: string;
+}

package/src/loanCredit/dtos/responses/LoanWriteOffCandidateListResponse.ts

@@ -0,0 +1,8 @@
+import { LoanWriteOffCandidateItem } from './LoanWriteOffCandidateItem';
+
+/** Response de `GET /backoffice/credits/write-off-candidates`. */
+export interface LoanWriteOffCandidateListResponse {
+    items: LoanWriteOffCandidateItem[];
+    /** Cursor de la página siguiente; su ausencia marca el fin de la lista. */
+    nextToken?: string;
+}

package/src/loanCredit/dtos/responses/LoanWriteOffResult.ts

@@ -0,0 +1,13 @@
+import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+
+/** Response de `POST /backoffice/credits/:creditId/write-off`. */
+export interface LoanWriteOffResult {
+    creditId: string;
+    previousStatus: LoanCreditStatusEnum;
+    status: LoanCreditStatusEnum;
+    overdueDays: number;
+    writtenOffAmountCents: number;
+    writtenOffAt: string;
+    /** Quién aprobó la baja. */
+    writtenOffBy: string;
+}

package/src/loanCredit/enums/ContractTypeEnum.ts

@@ -1,12 +1,14 @@
 /**
- * Tipo de documento del contrato de crédito (M2 §4.3 / C4 — 3 documentos):
- * `CREDIT` = contrato de crédito celular (RECA 16145-439-038506/04-01076-0525) ·
- * `PROMISSORY_NOTE` = pagaré (garantiza el crédito; mismo monto/tasa/plazo) ·
- * `SIC_AUTHORIZATION` = autorización de consulta/reporte a Círculo de Crédito (Art. 28 LRSIC).
+ * Tipo de documento del crédito: los tres de la originación y los que emite su ciclo de vida.
  * @enum {string}
  */
 export enum ContractTypeEnum {
     CREDIT = 'CREDIT',
     PROMISSORY_NOTE = 'PROMISSORY_NOTE',
     SIC_AUTHORIZATION = 'SIC_AUTHORIZATION',
+    RESTRUCTURE_ADDENDUM = 'RESTRUCTURE_ADDENDUM',
+    ADVANCE_AUTHORIZATION = 'ADVANCE_AUTHORIZATION',
+    SETTLEMENT_CERTIFICATE = 'SETTLEMENT_CERTIFICATE',
+    PAYMENT_RECEIPT = 'PAYMENT_RECEIPT',
+    ACCOUNT_STATEMENT = 'ACCOUNT_STATEMENT',
 }

package/src/loanCredit/enums/LoanAdHocChargeKindEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Tipo de cobro fuera del calendario. Hay un solo cargo pendiente por tipo.
+ * @enum {string}
+ */
+export enum LoanAdHocChargeKindEnum {
+    SETTLEMENT = 'SETTLEMENT',
+    RECOVERY = 'RECOVERY',
+    PREPAYMENT = 'PREPAYMENT',
+    ADVANCE = 'ADVANCE',
+}

package/src/loanCredit/enums/LoanChargeKindEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Tipo de cargo que originó el pago.
+ * @enum {string}
+ */
+export enum LoanChargeKindEnum {
+    INSTALLMENT = 'INSTALLMENT',
+    SETTLEMENT = 'SETTLEMENT',
+    RECOVERY = 'RECOVERY',
+    PREPAYMENT = 'PREPAYMENT',
+    ADVANCE = 'ADVANCE',
+}

package/src/loanCredit/enums/LoanRestructureStatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado de la reestructura. `PENDING_REGISTRATION`: el plan nuevo está escrito y falta confirmar el alta de sus cargos.
+ * @enum {string}
+ */
+export enum LoanRestructureStatusEnum {
+    PROPOSED = 'PROPOSED',
+    APPROVED = 'APPROVED',
+    REJECTED = 'REJECTED',
+    PENDING_REGISTRATION = 'PENDING_REGISTRATION',
+    EXECUTED = 'EXECUTED',
+}

package/src/loanCredit/enums/LoanSettlementStatusEnum.ts

@@ -0,0 +1,7 @@
+/**
+ * Estado de la liquidación anticipada del crédito.
+ * @enum {string}
+ */
+export enum LoanSettlementStatusEnum {
+    PENDING = 'PENDING',
+}

package/src/loanCredit/enums/PaymentReviewActionEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Salida que el admin le da al dinero en revisión.
+ * @enum {string}
+ */
+export enum PaymentReviewActionEnum {
+    APPLY = 'APPLY',
+    REFUND = 'REFUND',
+    RECONCILE = 'RECONCILE',
+}

package/src/loanCredit/enums/PaymentReviewReasonEnum.ts

@@ -0,0 +1,16 @@
+/**
+ * Por qué el pago quedó en revisión.
+ * @enum {string}
+ */
+export enum PaymentReviewReasonEnum {
+    /** Sobrante del pago. */
+    OVERPAYMENT = 'OVERPAYMENT',
+    /** La cuota ya estaba cerrada. */
+    INSTALLMENT_CLOSED = 'INSTALLMENT_CLOSED',
+    /** El crédito ya no se cobra. */
+    CREDIT_NOT_COLLECTIBLE = 'CREDIT_NOT_COLLECTIBLE',
+    /** Cuota con abonos previos sin desglose. */
+    LEGACY_INSTALLMENT_WITH_PAYMENT = 'LEGACY_INSTALLMENT_WITH_PAYMENT',
+    /** Lo retenido sin capturar. */
+    UNCAPTURED_HOLD = 'UNCAPTURED_HOLD',
+}

package/src/loanCredit/enums/PaymentReviewResolutionEnum.ts

@@ -0,0 +1,13 @@
+/**
+ * Desenlace de la resolución de un pago en revisión.
+ * @enum {string}
+ */
+export enum PaymentReviewResolutionEnum {
+    APPLIED = 'APPLIED',
+    REFUNDED = 'REFUNDED',
+    /** Timeout o pendiente del proveedor: no se abre otro intento hasta confirmar si el dinero salió. */
+    REFUND_PENDING = 'REFUND_PENDING',
+    /** El proveedor rechazó la devolución: el pago vuelve a la bandeja con un intento más. */
+    REFUND_REJECTED = 'REFUND_REJECTED',
+    RECONCILED = 'RECONCILED',
+}

package/src/loanCredit/enums/RefundDestinationEnum.ts

@@ -0,0 +1,8 @@
+/**
+ * `CUSTOMER_ACCOUNT` es la cuenta que informa el cliente; `PCF_CLABE` es su CLABE PCF, sólo si él la confirma.
+ * @enum {string}
+ */
+export enum RefundDestinationEnum {
+    CUSTOMER_ACCOUNT = 'CUSTOMER_ACCOUNT',
+    PCF_CLABE = 'PCF_CLABE',
+}

package/src/loanCredit/enums/WrittenOffRecoveryTypeEnum.ts

@@ -0,0 +1,8 @@
+/**
+ * `OVERDUE` cobra lo vencido; `SETTLEMENT` cobra el monto de liquidación con interés devengado y cierra el crédito.
+ * @enum {string}
+ */
+export enum WrittenOffRecoveryTypeEnum {
+    OVERDUE = 'OVERDUE',
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/loanCredit/index.ts

@@ -108,3 +108,43 @@ export * from './dtos/MessagingCandidateItem';
 export * from './dtos/requests/ListMessagingCandidatesRequest';
 export * from './dtos/responses/ListMessagingCandidatesResponse';
 
+
+// Ciclo de vida del crédito — endpoints backoffice de liquidación, baja, reestructura, abono y bandeja
+export * from './enums/LoanSettlementStatusEnum';
+export * from './enums/LoanAdHocChargeKindEnum';
+export * from './enums/WrittenOffRecoveryTypeEnum';
+export * from './enums/LoanRestructureStatusEnum';
+export * from './enums/LoanChargeKindEnum';
+export * from './enums/PaymentReviewReasonEnum';
+export * from './enums/PaymentReviewActionEnum';
+export * from './enums/RefundDestinationEnum';
+export * from './enums/PaymentReviewResolutionEnum';
+export * from './dtos/RestructureTerms';
+export * from './dtos/WriteOffConfirmations';
+export * from './dtos/requests/BackofficeSettleCreditRequest';
+export * from './dtos/requests/BackofficeListWriteOffCandidatesRequest';
+export * from './dtos/requests/BackofficeWriteOffCreditRequest';
+export * from './dtos/requests/BackofficeCollectWrittenOffCreditRequest';
+export * from './dtos/requests/BackofficeProposeRestructureRequest';
+export * from './dtos/requests/BackofficeApproveRestructureRequest';
+export * from './dtos/requests/BackofficeRejectRestructureRequest';
+export * from './dtos/requests/BackofficeAcceptRestructureRequest';
+export * from './dtos/requests/BackofficeApplyPrepaymentRequest';
+export * from './dtos/requests/BackofficeApplyAdvanceRequest';
+export * from './dtos/requests/BackofficeListPaymentsInReviewRequest';
+export * from './dtos/requests/BackofficeResolvePaymentReviewRequest';
+export * from './dtos/responses/LoanSettlementQuote';
+export * from './dtos/responses/LoanSettlementRequested';
+export * from './dtos/responses/LoanAdHocChargeRequested';
+export * from './dtos/responses/LoanWriteOffCandidateItem';
+export * from './dtos/responses/LoanWriteOffCandidateListResponse';
+export * from './dtos/responses/LoanWriteOffResult';
+export * from './dtos/responses/LoanRestructure';
+export * from './dtos/responses/LoanRestructureListResponse';
+export * from './dtos/responses/LoanRestructurePreviewInstallment';
+export * from './dtos/responses/LoanRestructurePreview';
+export * from './dtos/responses/LoanOtpDispatch';
+export * from './dtos/responses/LoanPrepaymentQuote';
+export * from './dtos/responses/LoanPaymentReviewItem';
+export * from './dtos/responses/LoanPaymentReviewListResponse';
+export * from './dtos/responses/LoanPaymentReviewResolution';

package/src/loanOfferings/dtos/requests/ComputeAmortizationScheduleRequest.ts

@@ -0,0 +1,31 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNumber, Max, Min } from 'class-validator';
+
+/** Body de `POST /private/amortization/schedule` (loan-offerings-business). Tabla francesa semanal sin fechas. */
+export class ComputeAmortizationScheduleRequest {
+    /** Saldo a amortizar en centavos. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    financedAmountCents!: number;
+
+    /** TNA en decimal (`2.30` = 230%). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    tnaAnnual!: number;
+
+    /** Número de cuotas semanales. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    @Max(104)
+    termWeeks!: number;
+
+    /** IVA sobre interés en decimal (`0.16`). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    ivaOnInterest!: number;
+}