@fiado/type-kit 3.381.0 → 3.382.0

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

@@ -1,5 +1,6 @@
 import { MechanismType } from '../enums/MechanismType';
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 export declare class AuthorizeCollectionMovementRequest {
     executionId: string;
     directoryId: string;
@@ -10,4 +11,11 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    /**
+     * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
+     * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el
+     * dinero se mueve igual pero sin ese registro — es el comportamiento anterior, y se conserva para
+     * no romper a quien todavía no manda tarifa.
+     */
+    pricing?: CollectionPricingDto;
 }

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -11,8 +11,10 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthorizeCollectionMovementRequest = void 0;
 const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
 const MechanismType_1 = require("../enums/MechanismType");
 const CurrencyId_1 = require("../../currency/enums/CurrencyId");
+const CollectionPricingDto_1 = require("./CollectionPricingDto");
 class AuthorizeCollectionMovementRequest {
 }
 exports.AuthorizeCollectionMovementRequest = AuthorizeCollectionMovementRequest;
@@ -55,3 +57,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "holdTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
+    __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
+], AuthorizeCollectionMovementRequest.prototype, "pricing", void 0);

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

@@ -0,0 +1,28 @@
+import { ProductTaxFeeTypeEnum } from '../../productCatalog';
+import { CollectionFeeMode } from '../enums/CollectionFeeMode';
+/**
+ * Tarifa de un cobro, tal como la manda quien lo pide.
+ *
+ * La regla viaja aquí y no sale del catálogo de productos porque quien conoce las condiciones
+ * comerciales de una cartera es el dominio dueño de la deuda, no el procesador: la misma mecánica de
+ * cobro se tarifa distinto según el producto, el tenant o el convenio.
+ *
+ * Viaja la REGLA, no el importe ya calculado. Así la aritmética y el redondeo son los mismos que los
+ * del resto de las transacciones, en vez de que cada dominio reimplemente los suyos y los números
+ * dejen de cuadrar entre sí.
+ */
+export declare class CollectionPricingDto {
+    /**
+     * Fila de `ProductCatalog_GT` con la que se clasifica la transacción resultante — de ahí salen su
+     * tipo y subtipo. La tarifa NO sale de ahí: sale de los campos de abajo.
+     */
+    productCatalogId: string;
+    /** Comisión: porcentaje sobre el monto, o importe fijo, según `feeType`. */
+    fee: number;
+    feeType: ProductTaxFeeTypeEnum;
+    /** Impuesto: porcentaje SOBRE LA COMISIÓN, o importe fijo, según `taxType`. */
+    tax: number;
+    taxType: ProductTaxFeeTypeEnum;
+    /** Quién absorbe la comisión: el cliente por encima de su deuda, o el destino al recibir menos. */
+    feeMode: CollectionFeeMode;
+}

package/bin/collection/dtos/CollectionPricingDto.js

@@ -0,0 +1,55 @@
+"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.CollectionPricingDto = void 0;
+const class_validator_1 = require("class-validator");
+const productCatalog_1 = require("../../productCatalog");
+const CollectionFeeMode_1 = require("../enums/CollectionFeeMode");
+/**
+ * Tarifa de un cobro, tal como la manda quien lo pide.
+ *
+ * La regla viaja aquí y no sale del catálogo de productos porque quien conoce las condiciones
+ * comerciales de una cartera es el dominio dueño de la deuda, no el procesador: la misma mecánica de
+ * cobro se tarifa distinto según el producto, el tenant o el convenio.
+ *
+ * Viaja la REGLA, no el importe ya calculado. Así la aritmética y el redondeo son los mismos que los
+ * del resto de las transacciones, en vez de que cada dominio reimplemente los suyos y los números
+ * dejen de cuadrar entre sí.
+ */
+class CollectionPricingDto {
+}
+exports.CollectionPricingDto = CollectionPricingDto;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CollectionPricingDto.prototype, "productCatalogId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CollectionPricingDto.prototype, "fee", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(productCatalog_1.ProductTaxFeeTypeEnum),
+    __metadata("design:type", String)
+], CollectionPricingDto.prototype, "feeType", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CollectionPricingDto.prototype, "tax", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(productCatalog_1.ProductTaxFeeTypeEnum),
+    __metadata("design:type", String)
+], CollectionPricingDto.prototype, "taxType", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(CollectionFeeMode_1.CollectionFeeMode),
+    __metadata("design:type", String)
+], CollectionPricingDto.prototype, "feeMode", void 0);

package/bin/collection/enums/CollectionFeeMode.d.ts

@@ -0,0 +1,6 @@
+export declare enum CollectionFeeMode {
+    /** El cliente paga la deuda MÁS la comisión: se le debita `monto + fee + IVA`. */
+    ON_TOP = "ON_TOP",
+    /** El cliente paga sólo la deuda: se le debita el monto, y la comisión se retiene de lo que se remite. */
+    RETAINED = "RETAINED"
+}

package/bin/collection/enums/CollectionFeeMode.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionFeeMode = void 0;
+var CollectionFeeMode;
+(function (CollectionFeeMode) {
+    /** El cliente paga la deuda MÁS la comisión: se le debita `monto + fee + IVA`. */
+    CollectionFeeMode["ON_TOP"] = "ON_TOP";
+    /** El cliente paga sólo la deuda: se le debita el monto, y la comisión se retiene de lo que se remite. */
+    CollectionFeeMode["RETAINED"] = "RETAINED";
+})(CollectionFeeMode || (exports.CollectionFeeMode = CollectionFeeMode = {}));

package/bin/collection/index.d.ts

@@ -4,6 +4,7 @@ export * from './enums/SagaStep';
 export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
 export * from './enums/RegisterCollectibleStatus';
+export * from './enums/CollectionFeeMode';
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';
 export * from './dtos/CollectResponse';
@@ -18,6 +19,7 @@ export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
 export * from './dtos/RegisterCollectibleResponse';
+export * from './dtos/CollectionPricingDto';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';
 export * from './dtos/CollectionIntentSummaryDto';

package/bin/collection/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./enums/SagaStep"), exports);
 __exportStar(require("./enums/CollectionResultStatus"), exports);
 __exportStar(require("./enums/DeregisterChargeStatus"), exports);
 __exportStar(require("./enums/RegisterCollectibleStatus"), exports);
+__exportStar(require("./enums/CollectionFeeMode"), exports);
 // DTOs
 __exportStar(require("./dtos/PendingChargeDto"), exports);
 __exportStar(require("./dtos/CollectRequest"), exports);
@@ -36,6 +37,7 @@ __exportStar(require("./dtos/UpsertProductConfigRequest"), exports);
 __exportStar(require("./dtos/ApplyCollectionResultRequest"), exports);
 __exportStar(require("./dtos/DeregisterChargeResponse"), exports);
 __exportStar(require("./dtos/RegisterCollectibleResponse"), exports);
+__exportStar(require("./dtos/CollectionPricingDto"), exports);
 __exportStar(require("./dtos/ResolvePendingChargesRequest"), exports);
 __exportStar(require("./dtos/MoneyInEvent"), exports);
 // DTOs — backoffice de monitoreo

package/package.json

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

package/src/collection/dtos/AuthorizeCollectionMovementRequest.ts

@@ -1,6 +1,8 @@
-import { IsString, IsInt, IsEnum, IsOptional } from 'class-validator';
+import { IsString, IsInt, IsEnum, IsOptional, ValidateNested } from 'class-validator';
+import { Type } from 'class-transformer';
 import { MechanismType } from '../enums/MechanismType';
 import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { CollectionPricingDto } from './CollectionPricingDto';
 
 export class AuthorizeCollectionMovementRequest {
   @IsString() executionId!: string;    // idempotencia (@IdempotencyController)
@@ -12,4 +14,12 @@ export class AuthorizeCollectionMovementRequest {
   @IsOptional() @IsString() intentId?: string;
   @IsOptional() @IsString() chargeId?: string;
   @IsOptional() @IsString() holdTxId?: string;
+
+  /**
+   * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
+   * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el
+   * dinero se mueve igual pero sin ese registro — es el comportamiento anterior, y se conserva para
+   * no romper a quien todavía no manda tarifa.
+   */
+  @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
 }

package/src/collection/dtos/CollectionPricingDto.ts

@@ -0,0 +1,35 @@
+import { IsEnum, IsNumber, IsString, Min } from 'class-validator';
+import { ProductTaxFeeTypeEnum } from '../../productCatalog';
+import { CollectionFeeMode } from '../enums/CollectionFeeMode';
+
+/**
+ * Tarifa de un cobro, tal como la manda quien lo pide.
+ *
+ * La regla viaja aquí y no sale del catálogo de productos porque quien conoce las condiciones
+ * comerciales de una cartera es el dominio dueño de la deuda, no el procesador: la misma mecánica de
+ * cobro se tarifa distinto según el producto, el tenant o el convenio.
+ *
+ * Viaja la REGLA, no el importe ya calculado. Así la aritmética y el redondeo son los mismos que los
+ * del resto de las transacciones, en vez de que cada dominio reimplemente los suyos y los números
+ * dejen de cuadrar entre sí.
+ */
+export class CollectionPricingDto {
+  /**
+   * Fila de `ProductCatalog_GT` con la que se clasifica la transacción resultante — de ahí salen su
+   * tipo y subtipo. La tarifa NO sale de ahí: sale de los campos de abajo.
+   */
+  @IsString() productCatalogId!: string;
+
+  /** Comisión: porcentaje sobre el monto, o importe fijo, según `feeType`. */
+  @IsNumber() @Min(0) fee!: number;
+
+  @IsEnum(ProductTaxFeeTypeEnum) feeType!: ProductTaxFeeTypeEnum;
+
+  /** Impuesto: porcentaje SOBRE LA COMISIÓN, o importe fijo, según `taxType`. */
+  @IsNumber() @Min(0) tax!: number;
+
+  @IsEnum(ProductTaxFeeTypeEnum) taxType!: ProductTaxFeeTypeEnum;
+
+  /** Quién absorbe la comisión: el cliente por encima de su deuda, o el destino al recibir menos. */
+  @IsEnum(CollectionFeeMode) feeMode!: CollectionFeeMode;
+}

package/src/collection/enums/CollectionFeeMode.ts

@@ -0,0 +1,6 @@
+export enum CollectionFeeMode {
+  /** El cliente paga la deuda MÁS la comisión: se le debita `monto + fee + IVA`. */
+  ON_TOP = 'ON_TOP',
+  /** El cliente paga sólo la deuda: se le debita el monto, y la comisión se retiene de lo que se remite. */
+  RETAINED = 'RETAINED',
+}

package/src/collection/index.ts

@@ -5,6 +5,7 @@ export * from './enums/SagaStep';
 export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
 export * from './enums/RegisterCollectibleStatus';
+export * from './enums/CollectionFeeMode';
 
 // DTOs
 export * from './dtos/PendingChargeDto';
@@ -21,6 +22,7 @@ export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
 export * from './dtos/RegisterCollectibleResponse';
+export * from './dtos/CollectionPricingDto';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';