@fiado/type-kit 3.407.0 → 3.408.0

package/bin/loanCredit/constants/creditPaymentHook.d.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export declare const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/bin/loanCredit/constants/creditPaymentHook.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = void 0;
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+exports.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

package/bin/loanCredit/dtos/requests/CreditPaymentAppliedRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export declare class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditPaymentAppliedRequest.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPaymentAppliedRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+class CreditPaymentAppliedRequest {
+}
+exports.CreditPaymentAppliedRequest = CreditPaymentAppliedRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditPaymentAppliedRequest.prototype, "paymentReference", void 0);

package/bin/loanCredit/dtos/requests/CreditSettledRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export declare class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    actor?: string;
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    paymentReference?: string;
+}

package/bin/loanCredit/dtos/requests/CreditSettledRequest.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettledRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const creditPaymentHook_1 = require("../../constants/creditPaymentHook");
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+class CreditSettledRequest {
+}
+exports.CreditSettledRequest = CreditSettledRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(creditPaymentHook_1.CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreditSettledRequest.prototype, "paymentReference", void 0);

package/bin/loanCredit/dtos/responses/CreditPaymentAppliedResponse.d.ts

@@ -0,0 +1,8 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

package/bin/loanCredit/dtos/responses/CreditPaymentAppliedResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/dtos/responses/CreditSettledResponse.d.ts

@@ -0,0 +1,8 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/bin/loanCredit/dtos/responses/CreditSettledResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export declare enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = "CREDIT_NOT_UNLOCKABLE",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = "NOT_LOCKED",
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = "LOCKED_FOR_OTHER_REASON",
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = "THRESHOLD_NOT_MET",
+    UNLOCKED = "UNLOCKED",
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = "UNLOCK_PENDING",
+    UNLOCK_FAILED = "UNLOCK_FAILED"
+}

package/bin/loanCredit/enums/CreditPaymentUnlockDecisionEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditPaymentUnlockDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+var CreditPaymentUnlockDecisionEnum;
+(function (CreditPaymentUnlockDecisionEnum) {
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CreditPaymentUnlockDecisionEnum["CREDIT_NOT_UNLOCKABLE"] = "CREDIT_NOT_UNLOCKABLE";
+    CreditPaymentUnlockDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    CreditPaymentUnlockDecisionEnum["NOT_LOCKED"] = "NOT_LOCKED";
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    CreditPaymentUnlockDecisionEnum["LOCKED_FOR_OTHER_REASON"] = "LOCKED_FOR_OTHER_REASON";
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    CreditPaymentUnlockDecisionEnum["THRESHOLD_NOT_MET"] = "THRESHOLD_NOT_MET";
+    CreditPaymentUnlockDecisionEnum["UNLOCKED"] = "UNLOCKED";
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    CreditPaymentUnlockDecisionEnum["UNLOCK_PENDING"] = "UNLOCK_PENDING";
+    CreditPaymentUnlockDecisionEnum["UNLOCK_FAILED"] = "UNLOCK_FAILED";
+})(CreditPaymentUnlockDecisionEnum || (exports.CreditPaymentUnlockDecisionEnum = CreditPaymentUnlockDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export declare enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = "ALREADY_SETTLED",
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = "CREDIT_NOT_SETTLEABLE",
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = "NO_INSTALLMENTS",
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = "INCOMPLETE_PLAN",
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = "BALANCE_OUTSTANDING",
+    SETTLED = "SETTLED",
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = "SETTLE_CONFLICT",
+    SETTLE_FAILED = "SETTLE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementDecisionEnum.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementDecisionEnum = void 0;
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+var CreditSettlementDecisionEnum;
+(function (CreditSettlementDecisionEnum) {
+    CreditSettlementDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    CreditSettlementDecisionEnum["ALREADY_SETTLED"] = "ALREADY_SETTLED";
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CreditSettlementDecisionEnum["CREDIT_NOT_SETTLEABLE"] = "CREDIT_NOT_SETTLEABLE";
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    CreditSettlementDecisionEnum["NO_INSTALLMENTS"] = "NO_INSTALLMENTS";
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    CreditSettlementDecisionEnum["INCOMPLETE_PLAN"] = "INCOMPLETE_PLAN";
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    CreditSettlementDecisionEnum["BALANCE_OUTSTANDING"] = "BALANCE_OUTSTANDING";
+    CreditSettlementDecisionEnum["SETTLED"] = "SETTLED";
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    CreditSettlementDecisionEnum["SETTLE_CONFLICT"] = "SETTLE_CONFLICT";
+    CreditSettlementDecisionEnum["SETTLE_FAILED"] = "SETTLE_FAILED";
+})(CreditSettlementDecisionEnum || (exports.CreditSettlementDecisionEnum = CreditSettlementDecisionEnum = {}));

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export declare enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = "CREDIT_NOT_FOUND",
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = "CREDIT_NOT_SETTLED",
+    NOT_ENROLLED = "NOT_ENROLLED",
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = "ALREADY_RELEASED",
+    RELEASED = "RELEASED",
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = "RELEASE_PENDING",
+    RELEASE_FAILED = "RELEASE_FAILED"
+}

package/bin/loanCredit/enums/CreditSettlementReleaseDecisionEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CreditSettlementReleaseDecisionEnum = void 0;
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+var CreditSettlementReleaseDecisionEnum;
+(function (CreditSettlementReleaseDecisionEnum) {
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_FOUND"] = "CREDIT_NOT_FOUND";
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CreditSettlementReleaseDecisionEnum["CREDIT_NOT_SETTLED"] = "CREDIT_NOT_SETTLED";
+    CreditSettlementReleaseDecisionEnum["NOT_ENROLLED"] = "NOT_ENROLLED";
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    CreditSettlementReleaseDecisionEnum["ALREADY_RELEASED"] = "ALREADY_RELEASED";
+    CreditSettlementReleaseDecisionEnum["RELEASED"] = "RELEASED";
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    CreditSettlementReleaseDecisionEnum["RELEASE_PENDING"] = "RELEASE_PENDING";
+    CreditSettlementReleaseDecisionEnum["RELEASE_FAILED"] = "RELEASE_FAILED";
+})(CreditSettlementReleaseDecisionEnum || (exports.CreditSettlementReleaseDecisionEnum = CreditSettlementReleaseDecisionEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -17,6 +17,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 export * from './dtos/responses/LoanBorrowerResponse';
 export * from './dtos/responses/LoanCreditResponse';

package/bin/loanCredit/index.js

@@ -39,6 +39,14 @@ __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);
 __exportStar(require("./dtos/requests/ActivationCheckRequest"), exports);
+__exportStar(require("./dtos/requests/CreditPaymentAppliedRequest"), exports);
+__exportStar(require("./dtos/requests/CreditSettledRequest"), exports);
+__exportStar(require("./dtos/responses/CreditPaymentAppliedResponse"), exports);
+__exportStar(require("./dtos/responses/CreditSettledResponse"), exports);
+__exportStar(require("./enums/CreditPaymentUnlockDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementDecisionEnum"), exports);
+__exportStar(require("./enums/CreditSettlementReleaseDecisionEnum"), exports);
+__exportStar(require("./constants/creditPaymentHook"), exports);
 __exportStar(require("./dtos/requests/ChangeLoanCreditStatusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/LoanBorrowerResponse"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.407.0",
+  "version": "3.408.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/loanCredit/constants/creditPaymentHook.ts

@@ -0,0 +1,2 @@
+/** Largo máximo del actor y de la referencia de pago de los dos hooks de cobranza del crédito. */
+export const CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH = 120;

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

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/payment-applied` (loan-credit-business). Es OPCIONAL:
+ * sin él el pago se atribuye al sistema. `paymentReference` es sólo trazabilidad — no decide nada.
+ */
+export class CreditPaymentAppliedRequest {
+    /** Quién aplicó el pago; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago en el sistema que lo aplicó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

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

@@ -0,0 +1,25 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH } from '../../constants/creditPaymentHook';
+
+/**
+ * Body de `POST /private/credits/:creditId/settled` (loan-credit-business). También opcional.
+ * La ruta VERIFICA que el crédito no deba nada: no le cree al caller.
+ */
+export class CreditSettledRequest {
+    /** Quién declaró la liquidación; queda en la bitácora del expediente. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    actor?: string;
+
+    /** Referencia del pago que liquidó. Sólo trazabilidad. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(CREDIT_PAYMENT_HOOK_TEXT_MAX_LENGTH)
+    paymentReference?: string;
+}

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

@@ -0,0 +1,9 @@
+import { CreditPaymentUnlockDecisionEnum } from '../../enums/CreditPaymentUnlockDecisionEnum';
+
+/** Resultado de aplicar un pago: el crédito sale de mora y el equipo se suelta si corresponde. */
+export interface CreditPaymentAppliedResponse {
+    creditId: string;
+    /** El crédito salió de mora. Pasa aunque no haya equipo, esté sin candado, o sea SCHEDULED. */
+    creditReactivated: boolean;
+    unlockDecision: CreditPaymentUnlockDecisionEnum;
+}

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

@@ -0,0 +1,9 @@
+import { CreditSettlementDecisionEnum } from '../../enums/CreditSettlementDecisionEnum';
+import { CreditSettlementReleaseDecisionEnum } from '../../enums/CreditSettlementReleaseDecisionEnum';
+
+/** Resultado de liquidar el crédito; `releaseDecision` es null si el equipo no salió al proveedor. */
+export interface CreditSettledResponse {
+    creditId: string;
+    settlementDecision: CreditSettlementDecisionEnum;
+    releaseDecision: CreditSettlementReleaseDecisionEnum | null;
+}

package/src/loanCredit/enums/CreditPaymentUnlockDecisionEnum.ts

@@ -0,0 +1,20 @@
+/**
+ * Qué pasó con el equipo cuando se aplicó un pago al crédito.
+ * @enum {string}
+ */
+export enum CreditPaymentUnlockDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está en un estado al que el pago le suelte el equipo. */
+    CREDIT_NOT_UNLOCKABLE = 'CREDIT_NOT_UNLOCKABLE',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El equipo no estaba bloqueado: no hay nada que soltar. */
+    NOT_LOCKED = 'NOT_LOCKED',
+    /** El candado no es el de la mora (fraude, manual, o sin motivo): un pago no lo suelta. */
+    LOCKED_FOR_OTHER_REASON = 'LOCKED_FOR_OTHER_REASON',
+    /** El pago no alcanzó el umbral escalonado: sigue bloqueado y no se reprograma nada. */
+    THRESHOLD_NOT_MET = 'THRESHOLD_NOT_MET',
+    UNLOCKED = 'UNLOCKED',
+    /** El proveedor aceptó la orden y todavía no la dio por hecha. */
+    UNLOCK_PENDING = 'UNLOCK_PENDING',
+    UNLOCK_FAILED = 'UNLOCK_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementDecisionEnum.ts

@@ -0,0 +1,21 @@
+/**
+ * Qué pasó al intentar dejar el crédito liquidado. La ruta VERIFICA el saldo, no cree al caller.
+ * @enum {string}
+ */
+export enum CreditSettlementDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** Ya estaba liquidado: la ruta es idempotente y la liberación corre igual. */
+    ALREADY_SETTLED = 'ALREADY_SETTLED',
+    /** El estado del crédito no admite liquidación (sólo ACTIVE e IN_ARREARS la admiten). */
+    CREDIT_NOT_SETTLEABLE = 'CREDIT_NOT_SETTLEABLE',
+    /** Sin plan de cuotas no hay evidencia de que deba cero; fail-closed. */
+    NO_INSTALLMENTS = 'NO_INSTALLMENTS',
+    /** Al plan le falta alguna cuota del plazo: la deuda que no se persistió no se puede saldar. */
+    INCOMPLETE_PLAN = 'INCOMPLETE_PLAN',
+    /** Alguna cuota sigue debiendo: liquidar acá liberaría un equipo con deuda viva. */
+    BALANCE_OUTSTANDING = 'BALANCE_OUTSTANDING',
+    SETTLED = 'SETTLED',
+    /** Otro movió el estado entre la lectura y la escritura; el caller relee y reintenta. */
+    SETTLE_CONFLICT = 'SETTLE_CONFLICT',
+    SETTLE_FAILED = 'SETTLE_FAILED',
+}

package/src/loanCredit/enums/CreditSettlementReleaseDecisionEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Qué pasó con el equipo al liquidarse el crédito. El verbo es Release, terminal: el equipo SALE
+ * del enrolamiento, no se queda desbloqueado.
+ * @enum {string}
+ */
+export enum CreditSettlementReleaseDecisionEnum {
+    CREDIT_NOT_FOUND = 'CREDIT_NOT_FOUND',
+    /** El crédito no está liquidado: liberar el equipo sería irreversible y prematuro. */
+    CREDIT_NOT_SETTLED = 'CREDIT_NOT_SETTLED',
+    NOT_ENROLLED = 'NOT_ENROLLED',
+    /** El expediente ya salió del MDM; la liberación es idempotente y no vuelve a salir. */
+    ALREADY_RELEASED = 'ALREADY_RELEASED',
+    RELEASED = 'RELEASED',
+    /** El proveedor aceptó la liberación y todavía no la dio por hecha. */
+    RELEASE_PENDING = 'RELEASE_PENDING',
+    RELEASE_FAILED = 'RELEASE_FAILED',
+}

package/src/loanCredit/index.ts

@@ -23,6 +23,14 @@ export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';
 export * from './dtos/requests/SignLoanCreditRequest';
 export * from './dtos/requests/ActivationCheckRequest';
+export * from './dtos/requests/CreditPaymentAppliedRequest';
+export * from './dtos/requests/CreditSettledRequest';
+export * from './dtos/responses/CreditPaymentAppliedResponse';
+export * from './dtos/responses/CreditSettledResponse';
+export * from './enums/CreditPaymentUnlockDecisionEnum';
+export * from './enums/CreditSettlementDecisionEnum';
+export * from './enums/CreditSettlementReleaseDecisionEnum';
+export * from './constants/creditPaymentHook';
 export * from './dtos/requests/ChangeLoanCreditStatusRequest';
 
 // Response DTOs