@fiado/type-kit 3.424.0 → 3.426.0

package/bin/collection/dtos/DeregisterChargeResponse.d.ts

@@ -1,8 +1,19 @@
+import { CollectionState } from '../enums/CollectionState';
 import { DeregisterChargeStatus } from '../enums/DeregisterChargeStatus';
 /**
  * Resultado de dar de baja un cargo en el motor de cobro. Un cargo inexistente no viaja en este
  * DTO: el motor responde 404.
+ *
+ * `finalState` y `amountCollected` describen en qué terminó el cobro, y sólo tienen sentido cuando
+ * `status` es `ALREADY_TERMINAL`: ese status por sí solo no distingue el cargo que se cobró del que
+ * ya estaba cancelado, y sin esa distinción quien da de baja no puede reconciliar un cobro cuyo
+ * resultado se perdió en la cola muerta. Son opcionales para no romper al consumidor que ya lee
+ * este DTO.
  */
 export declare class DeregisterChargeResponse {
     status: DeregisterChargeStatus;
+    /** Estado terminal del cobro: `COLLECTED` o `CANCELLED`. */
+    finalState?: CollectionState;
+    /** Lo que el motor alcanzó a cobrar, en PESOS con decimales. */
+    amountCollected?: number;
 }

package/bin/collection/dtos/DeregisterChargeResponse.js

@@ -11,10 +11,17 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeregisterChargeResponse = void 0;
 const class_validator_1 = require("class-validator");
+const CollectionState_1 = require("../enums/CollectionState");
 const DeregisterChargeStatus_1 = require("../enums/DeregisterChargeStatus");
 /**
  * Resultado de dar de baja un cargo en el motor de cobro. Un cargo inexistente no viaja en este
  * DTO: el motor responde 404.
+ *
+ * `finalState` y `amountCollected` describen en qué terminó el cobro, y sólo tienen sentido cuando
+ * `status` es `ALREADY_TERMINAL`: ese status por sí solo no distingue el cargo que se cobró del que
+ * ya estaba cancelado, y sin esa distinción quien da de baja no puede reconciliar un cobro cuyo
+ * resultado se perdió en la cola muerta. Son opcionales para no romper al consumidor que ya lee
+ * este DTO.
  */
 class DeregisterChargeResponse {
 }
@@ -23,3 +30,13 @@ __decorate([
     (0, class_validator_1.IsEnum)(DeregisterChargeStatus_1.DeregisterChargeStatus),
     __metadata("design:type", String)
 ], DeregisterChargeResponse.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectionState_1.CollectionState),
+    __metadata("design:type", String)
+], DeregisterChargeResponse.prototype, "finalState", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], DeregisterChargeResponse.prototype, "amountCollected", void 0);

package/bin/collection/dtos/PendingChargeDto.d.ts

@@ -3,9 +3,9 @@ import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
- * `amount` es lo que queda por cobrar AHORA, con las reglas del dominio ya aplicadas —mora corrida,
- * pagos recibidos por otra vía—. El motor no lo recalcula ni lo valida contra nada: cobra lo que aquí
- * se declare.
+ * `amount` es lo que queda por cobrar AHORA, en PESOS con decimales —no en centavos—, con las reglas
+ * del dominio ya aplicadas —mora corrida, pagos recibidos por otra vía—. El motor no lo recalcula ni
+ * lo valida contra nada: cobra lo que aquí se declare, en la escala en que aquí se declare.
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.

package/bin/collection/dtos/PendingChargeDto.js

@@ -17,9 +17,9 @@ const CollectionPricingDto_1 = require("./CollectionPricingDto");
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
- * `amount` es lo que queda por cobrar AHORA, con las reglas del dominio ya aplicadas —mora corrida,
- * pagos recibidos por otra vía—. El motor no lo recalcula ni lo valida contra nada: cobra lo que aquí
- * se declare.
+ * `amount` es lo que queda por cobrar AHORA, en PESOS con decimales —no en centavos—, con las reglas
+ * del dominio ya aplicadas —mora corrida, pagos recibidos por otra vía—. El motor no lo recalcula ni
+ * lo valida contra nada: cobra lo que aquí se declare, en la escala en que aquí se declare.
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.

package/bin/remittance/dtos/RemittanceCountryConfig.d.ts

@@ -19,15 +19,18 @@ export declare class RemittanceCountryConfigItem {
     sortOrder: number;
     enabled: boolean;
     configured: boolean;
+    /** Mínimo de envío en USD (piso de UniTeller: 25). Los tramos de precio arrancan aquí. */
+    minAmountUSD: number;
 }
 /** Response de GET /backoffice/config/countries (config chica, sin paginación). */
 export declare class RemittanceCountryConfigListResponse {
     items: RemittanceCountryConfigItem[];
 }
-/** Body de PUT /backoffice/config/countries/{countryISO}. Ambos opcionales (merge con lo existente). */
+/** Body de PUT /backoffice/config/countries/{countryISO}. Todos opcionales (merge con lo existente). */
 export declare class RemittanceCountryUpdateRequest {
     enabled?: boolean;
     name?: string;
+    minAmountUSD?: number;
 }
 /** Un país + su orden final. */
 export declare class RemittanceCountryOrderItem {

package/bin/remittance/dtos/RemittanceCountryConfig.js

@@ -30,7 +30,7 @@ exports.RemittanceCountryConfigItem = RemittanceCountryConfigItem;
 class RemittanceCountryConfigListResponse {
 }
 exports.RemittanceCountryConfigListResponse = RemittanceCountryConfigListResponse;
-/** Body de PUT /backoffice/config/countries/{countryISO}. Ambos opcionales (merge con lo existente). */
+/** Body de PUT /backoffice/config/countries/{countryISO}. Todos opcionales (merge con lo existente). */
 class RemittanceCountryUpdateRequest {
 }
 exports.RemittanceCountryUpdateRequest = RemittanceCountryUpdateRequest;
@@ -45,6 +45,12 @@ __decorate([
     (0, class_validator_1.Length)(1, 60),
     __metadata("design:type", String)
 ], RemittanceCountryUpdateRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], RemittanceCountryUpdateRequest.prototype, "minAmountUSD", void 0);
 /** Un país + su orden final. */
 class RemittanceCountryOrderItem {
 }

package/bin/remittance/dtos/RemittancePricing.d.ts

@@ -9,12 +9,14 @@ import { RemittanceCorridor } from "../enums/RemittanceCorridor";
  * Promociones. retail = wholesale × (1 − markupBps/10000), SIN clampear
  * (el tope ≤ base de UNIR es transitorio).
  */
-/** Tramo de service fee. Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
+/** Tramo de service fee (+ markup opcional). Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
 export declare class PricingTier {
     amountMin: number;
     /** Display ("$1–$49"); null/ausente = sin tope (último tramo). El matching NO lo usa. */
     amountMax?: number | null;
     serviceFee: number;
+    /** Override del markup de la combinación para este tramo (bps CON SIGNO). Ausente = hereda. */
+    markupBps?: number;
     /** ISO date (YYYY-MM-DD) "FEE DESDE" — informativo. */
     effectiveFrom: string;
 }
@@ -74,6 +76,8 @@ export declare class SimulatePricingRequest {
 export declare class SimulatePricingResponse {
     /** ExternalQuickQuotes (vivo). */
     wholesale: number;
+    /** Markup aplicado: el del tramo matcheado o, si no tiene override, el de la combinación. */
+    markupBps: number;
     /** round4(wholesale × (1 − markupBps/10000)) — SIN clampear (markup negativo ⇒ retail > wholesale). */
     retail: number;
     /** Del tramo matcheado (mayor amountMin ≤ amountUSD). */

package/bin/remittance/dtos/RemittancePricing.js

@@ -23,7 +23,7 @@ const RemittanceCorridor_1 = require("../enums/RemittanceCorridor");
  * Promociones. retail = wholesale × (1 − markupBps/10000), SIN clampear
  * (el tope ≤ base de UNIR es transitorio).
  */
-/** Tramo de service fee. Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
+/** Tramo de service fee (+ markup opcional). Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
 class PricingTier {
 }
 exports.PricingTier = PricingTier;
@@ -43,6 +43,13 @@ __decorate([
     (0, class_validator_1.Max)(100),
     __metadata("design:type", Number)
 ], PricingTier.prototype, "serviceFee", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(-500),
+    (0, class_validator_1.Max)(500),
+    __metadata("design:type", Number)
+], PricingTier.prototype, "markupBps", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.Length)(10, 10),

package/bin/remittance/dtos/internal/RemittancePricingResolve.d.ts

@@ -29,5 +29,7 @@ export declare class PricingResolveResponse {
     appliedRuleIds: string[];
     /** true si no había combinación (se usó Estándar del corridor o markup 0 + fee 0). */
     fallback: boolean;
+    /** Mínimo de envío del país destino (RemittanceCountryConfig_GT). El connector rechaza montos menores. */
+    minAmountUSD: number;
     blocked?: PricingResolveBlocked;
 }

package/bin/remittance/dtos/internal/RemittancePricingSchedule.d.ts

@@ -15,6 +15,8 @@ export declare class PricingScheduleTier {
     /** Display; null/ausente = último tramo (sin tope). El matching usa amountMin. */
     amountMax?: number | null;
     serviceFee: number;
+    /** Markup efectivo del tramo (bps CON SIGNO, tras promo). Ausente = aplica el markupBps de la respuesta. */
+    markupBps?: number;
 }
 /** Promoción AUTOMATIC vigente aplicada al schedule (ausente = no hay). */
 export declare class PricingScheduleAppliedPromo {

package/bin/remittance/dtos/internal/RemittancePricingSchedule.js

@@ -49,6 +49,11 @@ __decorate([
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)
 ], PricingScheduleTier.prototype, "serviceFee", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    __metadata("design:type", Number)
+], PricingScheduleTier.prototype, "markupBps", void 0);
 /** Promoción AUTOMATIC vigente aplicada al schedule (ausente = no hay). */
 class PricingScheduleAppliedPromo {
 }

package/package.json

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

package/src/collection/dtos/DeregisterChargeResponse.ts

@@ -1,10 +1,21 @@
-import { IsEnum } from 'class-validator';
+import { IsEnum, IsNumber, IsOptional } from 'class-validator';
+import { CollectionState } from '../enums/CollectionState';
 import { DeregisterChargeStatus } from '../enums/DeregisterChargeStatus';
 
 /**
  * Resultado de dar de baja un cargo en el motor de cobro. Un cargo inexistente no viaja en este
  * DTO: el motor responde 404.
+ *
+ * `finalState` y `amountCollected` describen en qué terminó el cobro, y sólo tienen sentido cuando
+ * `status` es `ALREADY_TERMINAL`: ese status por sí solo no distingue el cargo que se cobró del que
+ * ya estaba cancelado, y sin esa distinción quien da de baja no puede reconciliar un cobro cuyo
+ * resultado se perdió en la cola muerta. Son opcionales para no romper al consumidor que ya lee
+ * este DTO.
  */
 export class DeregisterChargeResponse {
   @IsEnum(DeregisterChargeStatus) status!: DeregisterChargeStatus;
+  /** Estado terminal del cobro: `COLLECTED` o `CANCELLED`. */
+  @IsOptional() @IsEnum(CollectionState) finalState?: CollectionState;
+  /** Lo que el motor alcanzó a cobrar, en PESOS con decimales. */
+  @IsOptional() @IsNumber() amountCollected?: number;
 }

package/src/collection/dtos/PendingChargeDto.ts

@@ -6,9 +6,9 @@ import { CollectionPricingDto } from './CollectionPricingDto';
 /**
  * Un cargo vivo, según el dominio que lleva la deuda.
  *
- * `amount` es lo que queda por cobrar AHORA, con las reglas del dominio ya aplicadas —mora corrida,
- * pagos recibidos por otra vía—. El motor no lo recalcula ni lo valida contra nada: cobra lo que aquí
- * se declare.
+ * `amount` es lo que queda por cobrar AHORA, en PESOS con decimales —no en centavos—, con las reglas
+ * del dominio ya aplicadas —mora corrida, pagos recibidos por otra vía—. El motor no lo recalcula ni
+ * lo valida contra nada: cobra lo que aquí se declare, en la escala en que aquí se declare.
  *
  * El desglose (capital, interés, impuesto) es opcional y no participa del cobro: viaja para que el
  * asiento y los reportes puedan reconstruirlo.
@@ -25,7 +25,7 @@ export class PendingChargeDto {
   @IsString() domain!: string;            // une-credit | surekeep-retail
   @IsString() parentDebtId!: string;      // credit_id / CREDIT#id
   @IsInt() installmentNumber!: number;    // coupon_number / installment_number
-  @IsNumber() amount!: number;               // centavos
+  @IsNumber() amount!: number;            // PESOS con decimales (1026.66), NO centavos
   @IsEnum(CurrencyId) currency!: CurrencyId;
   @IsString() dueDate!: string;           // ISO date
   @IsString() status!: string;            // estado del cargo en el dominio (normalizado por el motor)

package/src/remittance/dtos/RemittanceCountryConfig.ts

@@ -1,4 +1,4 @@
-import { IsArray, IsBoolean, IsInt, IsOptional, IsString, Length, Min, ValidateNested } from "class-validator";
+import { IsArray, IsBoolean, IsInt, IsNumber, IsOptional, IsString, Length, Min, ValidateNested } from "class-validator";
 import { Type } from "class-transformer";
 
 /**
@@ -24,6 +24,8 @@ export class RemittanceCountryConfigItem {
     sortOrder!: number;
     enabled!: boolean;
     configured!: boolean;
+    /** Mínimo de envío en USD (piso de UniTeller: 25). Los tramos de precio arrancan aquí. */
+    minAmountUSD!: number;
 }
 
 /** Response de GET /backoffice/config/countries (config chica, sin paginación). */
@@ -31,7 +33,7 @@ export class RemittanceCountryConfigListResponse {
     items!: RemittanceCountryConfigItem[];
 }
 
-/** Body de PUT /backoffice/config/countries/{countryISO}. Ambos opcionales (merge con lo existente). */
+/** Body de PUT /backoffice/config/countries/{countryISO}. Todos opcionales (merge con lo existente). */
 export class RemittanceCountryUpdateRequest {
     @IsOptional()
     @IsBoolean()
@@ -41,6 +43,11 @@ export class RemittanceCountryUpdateRequest {
     @IsString()
     @Length(1, 60)
     name?: string;
+
+    @IsOptional()
+    @IsNumber()
+    @Min(1)
+    minAmountUSD?: number;
 }
 
 /** Un país + su orden final. */

package/src/remittance/dtos/RemittancePricing.ts

@@ -27,7 +27,7 @@ import { RemittanceCorridor } from "../enums/RemittanceCorridor";
  * (el tope ≤ base de UNIR es transitorio).
  */
 
-/** Tramo de service fee. Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
+/** Tramo de service fee (+ markup opcional). Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
 export class PricingTier {
     @IsNumber()
     @Min(1)
@@ -43,6 +43,13 @@ export class PricingTier {
     @Max(100)
     serviceFee!: number;
 
+    /** Override del markup de la combinación para este tramo (bps CON SIGNO). Ausente = hereda. */
+    @IsOptional()
+    @IsInt()
+    @Min(-500)
+    @Max(500)
+    markupBps?: number;
+
     /** ISO date (YYYY-MM-DD) "FEE DESDE" — informativo. */
     @IsString()
     @Length(10, 10)
@@ -164,6 +171,8 @@ export class SimulatePricingRequest {
 export class SimulatePricingResponse {
     /** ExternalQuickQuotes (vivo). */
     wholesale!: number;
+    /** Markup aplicado: el del tramo matcheado o, si no tiene override, el de la combinación. */
+    markupBps!: number;
     /** round4(wholesale × (1 − markupBps/10000)) — SIN clampear (markup negativo ⇒ retail > wholesale). */
     retail!: number;
     /** Del tramo matcheado (mayor amountMin ≤ amountUSD). */

package/src/remittance/dtos/internal/RemittancePricingResolve.ts

@@ -43,5 +43,7 @@ export class PricingResolveResponse {
     appliedRuleIds!: string[];
     /** true si no había combinación (se usó Estándar del corridor o markup 0 + fee 0). */
     fallback!: boolean;
+    /** Mínimo de envío del país destino (RemittanceCountryConfig_GT). El connector rechaza montos menores. */
+    minAmountUSD!: number;
     blocked?: PricingResolveBlocked;
 }

package/src/remittance/dtos/internal/RemittancePricingSchedule.ts

@@ -40,6 +40,11 @@ export class PricingScheduleTier {
     @IsNumber()
     @Min(0)
     serviceFee!: number;
+
+    /** Markup efectivo del tramo (bps CON SIGNO, tras promo). Ausente = aplica el markupBps de la respuesta. */
+    @IsOptional()
+    @IsInt()
+    markupBps?: number;
 }
 
 /** Promoción AUTOMATIC vigente aplicada al schedule (ausente = no hay). */