@fiado/type-kit 3.550.0 → 3.552.0

package/bin/retailCommission/dtos/CommissionApi.d.ts

@@ -4,8 +4,11 @@ import type { CommissionAddOn, CommissionCategory, CommissionPlanSnapshot, Commi
 import type { CommissionAccrual, CommissionAppliedBonus, CommissionSaleInput, CommissionSaleLine } from './CommissionAccrual';
 import type { CommissionAdjustment, CommissionAppliedMultiplier, CommissionAppliedThreshold, CommissionPayout, CommissionPayoutSeller, CommissionSellerBreakdown } from './CommissionPayout';
 import type { CommissionPolicies, CommissionRule, CommissionRuleCondition, CommissionRuleLevers, CommissionRuleScope, CommissionRuleSetSnapshot } from './CommissionRule';
+import type { CommissionChainStatement, CommissionLedgerMovement, CommissionPayment, CommissionSellerBalance } from './CommissionLedger';
 import type { CommissionWindowEnum } from '../enums/CommissionWindowEnum';
+import type { CommissionBillingPeriodEnum } from '../enums/CommissionBillingPeriodEnum';
 import type { CommissionCountByEnum } from '../enums/CommissionCountByEnum';
+import type { CommissionPayTimingEnum } from '../enums/CommissionPayTimingEnum';
 import type { CommissionAggregateByEnum } from '../enums/CommissionAggregateByEnum';
 import type { CommissionSeriesByEnum } from '../enums/CommissionSeriesByEnum';
 import type { CommissionAccrualStatusEnum } from '../enums/CommissionAccrualStatusEnum';
@@ -197,6 +200,8 @@ export interface CommissionRuleInput {
     replacesOthers: boolean;
     /** Si la regla cuenta piezas o ventas. Ausente = `PIECE`. */
     countBy?: CommissionCountByEnum;
+    /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
+    payTiming?: CommissionPayTimingEnum;
 }
 /** `POST /backoffice/commissions/rules` — la regla nace en borrador. */
 export type CreateRuleRequest = CommissionRuleInput;
@@ -231,7 +236,7 @@ export interface RuleHistoryResponse {
 export interface GetPoliciesResponse {
     policies: CommissionPolicies;
 }
-/** `PUT /backoffice/commissions/policies` — las dos políticas se guardan juntas. */
+/** `PUT /backoffice/commissions/policies` — las políticas se guardan juntas. */
 export interface UpdatePoliciesRequest {
     clawback: {
         cancelacionDias: number;
@@ -242,6 +247,11 @@ export interface UpdatePoliciesRequest {
         multiplicadorMaxBps: number;
         ventanaDefault: CommissionWindowEnum;
     };
+    /** Opcional para que un editor que todavía no la manda siga funcionando. */
+    payouts?: {
+        walletDeposits: boolean;
+        chainBillingPeriod: CommissionBillingPeriodEnum;
+    };
 }
 export interface UpdatePoliciesResponse {
     policies: CommissionPolicies;
@@ -375,6 +385,8 @@ export interface CommissionRuleView {
     effectiveTo: string | null;
     /** Si la regla cuenta piezas o ventas. Ausente = `PIECE`. */
     countBy?: CommissionCountByEnum;
+    /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
+    payTiming?: CommissionPayTimingEnum;
 }
 /** Lo pagado en varios cortes. */
 export interface MyCommissionsTotals {
@@ -411,3 +423,70 @@ export interface GetMyCommissionsResponse {
     /** Tope del multiplicador de la política; `null` sin política. */
     multiplierCapBps: number | null;
 }
+/** `GET /backoffice/commissions/payments/attention` — el reporte "Por pagar" de la cadena. */
+export interface GetPaymentAttentionResponse {
+    /** Saldos con exigible sin depositar, con su motivo. */
+    pending: CommissionSellerBalance[];
+    /** Depósitos sin confirmar: "Requiere revisión". */
+    unverified: CommissionPayment[];
+    /** Saldos con exigible negativo. */
+    debts: CommissionSellerBalance[];
+}
+/** `POST /backoffice/commissions/payments/sellers/{sellerId}/paid-outside` */
+export interface MarkPaidOutsideRequest {
+    amountCents: number;
+    /** Obligatorio: dinero que sale sin depósito tiene que poder auditarse. */
+    reason: string;
+}
+/** `POST /backoffice/commissions/payments/{paymentId}/resolve` — revisión de un depósito sin confirmar. */
+export interface ResolvePaymentRequest {
+    /** `true` = sí se depositó; `false` = no, y el monto vuelve al exigible. */
+    accredited: boolean;
+    /** El folio, cuando sí se depositó. */
+    transactionId?: string;
+    note: string;
+}
+/** `GET /backoffice/commissions/sellers/{sellerId}/ledger` — saldo e historial de un vendedor. */
+export interface GetSellerLedgerResponse {
+    balance: CommissionSellerBalance;
+    movements: CommissionLedgerMovement[];
+    payments: CommissionPayment[];
+}
+/** `GET /backoffice/commissions/statements` */
+export interface ListStatementsResponse {
+    statements: CommissionChainStatement[];
+}
+/** `GET /backoffice/commissions/statements/{statementId}` — el estado de cuenta y sus depósitos. */
+export interface GetStatementResponse {
+    statement: CommissionChainStatement;
+    payments: CommissionPayment[];
+}
+/** `GET /commissions/me/payments` — los pagos del vendedor que llama. */
+export interface GetMyPaymentsResponse {
+    /** `null` mientras no tiene nada en el libro. */
+    balance: CommissionSellerBalance | null;
+    payments: CommissionPayment[];
+}
+/** `POST /backoffice/commissions/payments/sellers/{sellerId}/retry` (202) — el pago quedó en la cola. */
+export interface RetrySellerPaymentView {
+    sellerId: string;
+    /** Id del disparo `RETRY` con que se encoló. */
+    triggerId: string;
+}
+/** `POST /backoffice/commissions/payments/sellers/{sellerId}/paid-outside` (201) — el saldo nuevo y el movimiento escrito. */
+export interface MarkPaidOutsideView {
+    balance: CommissionSellerBalance;
+    movement: CommissionLedgerMovement;
+}
+/** `POST /backoffice/commissions/payments/{paymentId}/resolve` — el depósito ya resuelto. */
+export interface ResolvePaymentView {
+    payment: CommissionPayment;
+}
+/**
+ * `POST /private/retailers/{retailerId}/sellers/{sellerId}/payments/trigger?tenantId=` (202) — retail-org
+ * avisa que el vendedor vinculó su wallet. El cuerpo va vacío (`{}`).
+ */
+export interface PrivateTriggerSellerPaymentResponse {
+    /** `false` si la cola no lo recibió: el saldo sigue pendiente y entra en el siguiente pago. */
+    enqueued: boolean;
+}

package/bin/retailCommission/dtos/CommissionLedger.d.ts

@@ -0,0 +1,96 @@
+import type { CommissionBillingPeriodEnum } from '../enums/CommissionBillingPeriodEnum';
+import type { CommissionLedgerMovementKindEnum } from '../enums/CommissionLedgerMovementKindEnum';
+import type { CommissionPayTimingEnum } from '../enums/CommissionPayTimingEnum';
+import type { CommissionPaymentAttentionEnum } from '../enums/CommissionPaymentAttentionEnum';
+import type { CommissionPaymentStatusEnum } from '../enums/CommissionPaymentStatusEnum';
+/**
+ * Saldo de un vendedor en una cadena. Es parte del libro de pagos: cada peso que se le acredita, se
+ * le descuenta o se le deposita en su wallet. Montos en centavos; fechas en ISO.
+ */
+export interface CommissionSellerBalance {
+    retailerId: string;
+    sellerId: string;
+    /** Ganado que todavía no toca pagar (reglas al cierre del mes). */
+    retainedCents: number;
+    /** Lo que se puede depositar ya. Negativo = el vendedor debe. */
+    payableCents: number;
+    /** Apartado para un depósito en curso o sin confirmar. */
+    inTransitCents: number;
+    /** Acumulado de todo lo ganado. */
+    earnedCents: number;
+    /** Acumulado de todo lo descontado. */
+    deductedCents: number;
+    /** Acumulado de lo depositado y confirmado. */
+    accreditedCents: number;
+    /** Acumulado de lo pagado por fuera. */
+    paidOutsideCents: number;
+    /** `null` si no necesita atención. */
+    attention: CommissionPaymentAttentionEnum | null;
+    /** Código del último rechazo, p. ej. `USER_NOT_ACTIVE`. */
+    attentionCode: string | null;
+    /** Desde cuándo tiene esa atención. */
+    attentionSince: string | null;
+    updatedAt: string;
+}
+/** Lo que una regla aporta a un movimiento. */
+export interface CommissionLedgerMovementRule {
+    ruleId: string;
+    payTiming: CommissionPayTimingEnum;
+    cents: number;
+}
+/** Un movimiento del libro. Nunca cambia. */
+export interface CommissionLedgerMovement {
+    /** Determinista por origen: una reentrega no duplica el movimiento. */
+    movementKey: string;
+    kind: CommissionLedgerMovementKindEnum;
+    periodId: string;
+    retainedDeltaCents: number;
+    payableDeltaCents: number;
+    byRule: CommissionLedgerMovementRule[];
+    saleId: string | null;
+    adjustmentId: string | null;
+    /** `YYYY-MM` de la liberación mensual. */
+    releaseMonth: string | null;
+    /** Obligatorio en lo pagado por fuera. */
+    reason: string | null;
+    createdAt: string;
+    createdBy: string;
+}
+/** Un depósito a la wallet del vendedor. Solo cambia su estado. */
+export interface CommissionPayment {
+    /** También es la llave de idempotencia del depósito. */
+    paymentId: string;
+    retailerId: string;
+    sellerId: string;
+    amountCents: number;
+    status: CommissionPaymentStatusEnum;
+    /** La wallet a la que se depositó. */
+    directoryId: string;
+    /** Folio del depósito; `null` mientras no se confirma. */
+    transactionId: string | null;
+    errorCode: string | null;
+    /** Lo que ve el vendedor en su wallet; máximo 120 caracteres. */
+    concept: string;
+    requestedAt: string;
+    resolvedAt: string | null;
+    resolvedBy: string | null;
+    /** Nota de quien lo revisó a mano. */
+    note: string | null;
+}
+/**
+ * Estado de cuenta para cobrarle a la cadena: los depósitos confirmados del periodo. Lo pagado por
+ * fuera no entra. Se genera una vez y no cambia.
+ */
+export interface CommissionChainStatement {
+    statementId: string;
+    retailerId: string;
+    period: CommissionBillingPeriodEnum;
+    /** `YYYY-MM-DD`, inclusive. */
+    startDate: string;
+    /** `YYYY-MM-DD`, inclusive. */
+    endDate: string;
+    accreditedCents: number;
+    paymentsCount: number;
+    sellersCount: number;
+    generatedAt: string;
+}

package/bin/retailCommission/dtos/CommissionLedger.js

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

package/bin/retailCommission/dtos/CommissionRule.d.ts

@@ -1,9 +1,11 @@
 import type { ProductCategoryEnum } from '../../retailCatalog/enums/ProductCategoryEnum';
 import type { ProductTierEnum } from '../../retailCatalog/enums/ProductTierEnum';
+import type { CommissionBillingPeriodEnum } from '../enums/CommissionBillingPeriodEnum';
 import type { CommissionBonusModeEnum } from '../enums/CommissionBonusModeEnum';
 import type { CommissionCountByEnum } from '../enums/CommissionCountByEnum';
 import type { CommissionMetricEnum } from '../enums/CommissionMetricEnum';
 import type { CommissionOperatorEnum } from '../enums/CommissionOperatorEnum';
+import type { CommissionPayTimingEnum } from '../enums/CommissionPayTimingEnum';
 import type { CommissionRuleStatusEnum } from '../enums/CommissionRuleStatusEnum';
 import type { CommissionWindowEnum } from '../enums/CommissionWindowEnum';
 /**
@@ -75,6 +77,8 @@ export interface CommissionRule {
     replacesOthers: boolean;
     /** Si la regla cuenta piezas o ventas. Ausente = `PIECE`. */
     countBy?: CommissionCountByEnum;
+    /** Cuándo se paga lo que gana. Ausente = `ON_CUT`. */
+    payTiming?: CommissionPayTimingEnum;
     /** Sube en cada guardado. */
     version: number;
     /** La versión que está en el plan vigente. `null` si nunca se publicó. */
@@ -102,10 +106,19 @@ export interface CommissionPolicyCommissions {
     editedBy: string;
     editedAt: string;
 }
-/** Políticas de la cadena. Cada una es `null` mientras la cadena no la guarda. */
+/** Política de pagos a la wallet de los vendedores. */
+export interface CommissionPayoutPolicy {
+    /** Depositar las comisiones a la wallet. Apagado, todo se calcula y queda pendiente. */
+    walletDeposits: boolean;
+    /** Cada cuánto se le cobra a la cadena. */
+    chainBillingPeriod: CommissionBillingPeriodEnum;
+}
+/** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */
 export interface CommissionPolicies {
     clawback: CommissionPolicyClawback | null;
     commissions: CommissionPolicyCommissions | null;
+    /** Ausente = depósitos encendidos y cobro semanal. */
+    payouts?: CommissionPayoutPolicy;
 }
 /**
  * El plan vigente: las reglas publicadas y las políticas, congeladas en un snapshot inmutable.

package/bin/retailCommission/enums/CommissionBillingPeriodEnum.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Cada cuánto se le cobra a la cadena lo que Fiado depositó a sus vendedores.
+ *
+ * WEEKLY - Semanal. Es el valor cuando la cadena no guardó la política.
+ * MONTHLY - Mensual.
+ */
+export declare enum CommissionBillingPeriodEnum {
+    WEEKLY = "WEEKLY",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailCommission/enums/CommissionBillingPeriodEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionBillingPeriodEnum = void 0;
+/**
+ * Cada cuánto se le cobra a la cadena lo que Fiado depositó a sus vendedores.
+ *
+ * WEEKLY - Semanal. Es el valor cuando la cadena no guardó la política.
+ * MONTHLY - Mensual.
+ */
+var CommissionBillingPeriodEnum;
+(function (CommissionBillingPeriodEnum) {
+    CommissionBillingPeriodEnum["WEEKLY"] = "WEEKLY";
+    CommissionBillingPeriodEnum["MONTHLY"] = "MONTHLY";
+})(CommissionBillingPeriodEnum || (exports.CommissionBillingPeriodEnum = CommissionBillingPeriodEnum = {}));

package/bin/retailCommission/enums/CommissionLedgerMovementKindEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tipo de movimiento del libro de pagos. Un movimiento nunca cambia.
+ *
+ * EARN - Ganado: suma al exigible o al retenido.
+ * DEDUCT - Descontado del exigible.
+ * RELEASE - Liberación mensual: pasa de retenido a exigible.
+ * PAID_OUTSIDE - Pagado por fuera de la wallet: sale del exigible sin depósito.
+ */
+export declare enum CommissionLedgerMovementKindEnum {
+    EARN = "EARN",
+    DEDUCT = "DEDUCT",
+    RELEASE = "RELEASE",
+    PAID_OUTSIDE = "PAID_OUTSIDE"
+}

package/bin/retailCommission/enums/CommissionLedgerMovementKindEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionLedgerMovementKindEnum = void 0;
+/**
+ * Tipo de movimiento del libro de pagos. Un movimiento nunca cambia.
+ *
+ * EARN - Ganado: suma al exigible o al retenido.
+ * DEDUCT - Descontado del exigible.
+ * RELEASE - Liberación mensual: pasa de retenido a exigible.
+ * PAID_OUTSIDE - Pagado por fuera de la wallet: sale del exigible sin depósito.
+ */
+var CommissionLedgerMovementKindEnum;
+(function (CommissionLedgerMovementKindEnum) {
+    CommissionLedgerMovementKindEnum["EARN"] = "EARN";
+    CommissionLedgerMovementKindEnum["DEDUCT"] = "DEDUCT";
+    CommissionLedgerMovementKindEnum["RELEASE"] = "RELEASE";
+    CommissionLedgerMovementKindEnum["PAID_OUTSIDE"] = "PAID_OUTSIDE";
+})(CommissionLedgerMovementKindEnum || (exports.CommissionLedgerMovementKindEnum = CommissionLedgerMovementKindEnum = {}));

package/bin/retailCommission/enums/CommissionPayTimingEnum.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cuándo se paga lo que gana una regla.
+ *
+ * ON_SALE - Al momento: se vuelve exigible al registrar la venta. Solo para reglas que únicamente
+ *   pagan bono por venta.
+ * ON_CUT - Al cierre de la semana. Es el valor cuando la regla no lo trae.
+ * MONTHLY - Al cierre del mes: se retiene hasta el día 1 del mes siguiente al lunes del corte.
+ */
+export declare enum CommissionPayTimingEnum {
+    ON_SALE = "ON_SALE",
+    ON_CUT = "ON_CUT",
+    MONTHLY = "MONTHLY"
+}

package/bin/retailCommission/enums/CommissionPayTimingEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayTimingEnum = void 0;
+/**
+ * Cuándo se paga lo que gana una regla.
+ *
+ * ON_SALE - Al momento: se vuelve exigible al registrar la venta. Solo para reglas que únicamente
+ *   pagan bono por venta.
+ * ON_CUT - Al cierre de la semana. Es el valor cuando la regla no lo trae.
+ * MONTHLY - Al cierre del mes: se retiene hasta el día 1 del mes siguiente al lunes del corte.
+ */
+var CommissionPayTimingEnum;
+(function (CommissionPayTimingEnum) {
+    CommissionPayTimingEnum["ON_SALE"] = "ON_SALE";
+    CommissionPayTimingEnum["ON_CUT"] = "ON_CUT";
+    CommissionPayTimingEnum["MONTHLY"] = "MONTHLY";
+})(CommissionPayTimingEnum || (exports.CommissionPayTimingEnum = CommissionPayTimingEnum = {}));

package/bin/retailCommission/enums/CommissionPayTriggerEnum.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Qué pidió pagarle a un vendedor.
+ *
+ * SALE - Una venta con reglas al momento.
+ * CUT - El cierre del corte.
+ * RELEASE - La liberación mensual.
+ * ADJUSTMENT - Un ajuste manual.
+ * WALLET_LINKED - Se vinculó su wallet.
+ * RETRY - "Reintentar ahora" desde "Por pagar".
+ */
+export declare enum CommissionPayTriggerEnum {
+    SALE = "SALE",
+    CUT = "CUT",
+    RELEASE = "RELEASE",
+    ADJUSTMENT = "ADJUSTMENT",
+    WALLET_LINKED = "WALLET_LINKED",
+    RETRY = "RETRY"
+}

package/bin/retailCommission/enums/CommissionPayTriggerEnum.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPayTriggerEnum = void 0;
+/**
+ * Qué pidió pagarle a un vendedor.
+ *
+ * SALE - Una venta con reglas al momento.
+ * CUT - El cierre del corte.
+ * RELEASE - La liberación mensual.
+ * ADJUSTMENT - Un ajuste manual.
+ * WALLET_LINKED - Se vinculó su wallet.
+ * RETRY - "Reintentar ahora" desde "Por pagar".
+ */
+var CommissionPayTriggerEnum;
+(function (CommissionPayTriggerEnum) {
+    CommissionPayTriggerEnum["SALE"] = "SALE";
+    CommissionPayTriggerEnum["CUT"] = "CUT";
+    CommissionPayTriggerEnum["RELEASE"] = "RELEASE";
+    CommissionPayTriggerEnum["ADJUSTMENT"] = "ADJUSTMENT";
+    CommissionPayTriggerEnum["WALLET_LINKED"] = "WALLET_LINKED";
+    CommissionPayTriggerEnum["RETRY"] = "RETRY";
+})(CommissionPayTriggerEnum || (exports.CommissionPayTriggerEnum = CommissionPayTriggerEnum = {}));

package/bin/retailCommission/enums/CommissionPaymentAttentionEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Por qué el saldo de un vendedor aparece en "Por pagar".
+ *
+ * NO_WALLET - No tiene wallet vinculada.
+ * REJECTED - Su último depósito se rechazó (cuenta bloqueada, tope de nivel...); el código va aparte.
+ * PAUSED - La cadena apagó los depósitos a la wallet.
+ * DEBT - Su exigible es negativo: debe.
+ */
+export declare enum CommissionPaymentAttentionEnum {
+    NO_WALLET = "NO_WALLET",
+    REJECTED = "REJECTED",
+    PAUSED = "PAUSED",
+    DEBT = "DEBT"
+}

package/bin/retailCommission/enums/CommissionPaymentAttentionEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPaymentAttentionEnum = void 0;
+/**
+ * Por qué el saldo de un vendedor aparece en "Por pagar".
+ *
+ * NO_WALLET - No tiene wallet vinculada.
+ * REJECTED - Su último depósito se rechazó (cuenta bloqueada, tope de nivel...); el código va aparte.
+ * PAUSED - La cadena apagó los depósitos a la wallet.
+ * DEBT - Su exigible es negativo: debe.
+ */
+var CommissionPaymentAttentionEnum;
+(function (CommissionPaymentAttentionEnum) {
+    CommissionPaymentAttentionEnum["NO_WALLET"] = "NO_WALLET";
+    CommissionPaymentAttentionEnum["REJECTED"] = "REJECTED";
+    CommissionPaymentAttentionEnum["PAUSED"] = "PAUSED";
+    CommissionPaymentAttentionEnum["DEBT"] = "DEBT";
+})(CommissionPaymentAttentionEnum || (exports.CommissionPaymentAttentionEnum = CommissionPaymentAttentionEnum = {}));

package/bin/retailCommission/enums/CommissionPaymentStatusEnum.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Estado de un depósito de comisiones a la wallet del vendedor.
+ *
+ * PENDING - El monto se apartó y el depósito está en curso.
+ * ACCREDITED - Depositado, con folio.
+ * FAILED - Rechazado sin mover dinero: el monto vuelve al exigible.
+ * UNVERIFIED - Resultado ambiguo: el monto sigue apartado y no se reintenta solo; alguien lo revisa.
+ */
+export declare enum CommissionPaymentStatusEnum {
+    PENDING = "PENDING",
+    ACCREDITED = "ACCREDITED",
+    FAILED = "FAILED",
+    UNVERIFIED = "UNVERIFIED"
+}

package/bin/retailCommission/enums/CommissionPaymentStatusEnum.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommissionPaymentStatusEnum = void 0;
+/**
+ * Estado de un depósito de comisiones a la wallet del vendedor.
+ *
+ * PENDING - El monto se apartó y el depósito está en curso.
+ * ACCREDITED - Depositado, con folio.
+ * FAILED - Rechazado sin mover dinero: el monto vuelve al exigible.
+ * UNVERIFIED - Resultado ambiguo: el monto sigue apartado y no se reintenta solo; alguien lo revisa.
+ */
+var CommissionPaymentStatusEnum;
+(function (CommissionPaymentStatusEnum) {
+    CommissionPaymentStatusEnum["PENDING"] = "PENDING";
+    CommissionPaymentStatusEnum["ACCREDITED"] = "ACCREDITED";
+    CommissionPaymentStatusEnum["FAILED"] = "FAILED";
+    CommissionPaymentStatusEnum["UNVERIFIED"] = "UNVERIFIED";
+})(CommissionPaymentStatusEnum || (exports.CommissionPaymentStatusEnum = CommissionPaymentStatusEnum = {}));

package/bin/retailCommission/index.d.ts

@@ -20,11 +20,18 @@ export * from './enums/CommissionCountByEnum';
 export * from './enums/CommissionAggregateByEnum';
 export * from './enums/CommissionSeriesByEnum';
 export * from './enums/CommissionSimulationSkipEnum';
+export * from './enums/CommissionPayTimingEnum';
+export * from './enums/CommissionBillingPeriodEnum';
+export * from './enums/CommissionPaymentStatusEnum';
+export * from './enums/CommissionPaymentAttentionEnum';
+export * from './enums/CommissionLedgerMovementKindEnum';
+export * from './enums/CommissionPayTriggerEnum';
 export * from './dtos/CommissionPlan';
 export * from './dtos/CommissionRule';
 export * from './dtos/CommissionCouponAccrual';
 export * from './dtos/CommissionCalcTrace';
 export * from './dtos/CommissionAccrual';
 export * from './dtos/CommissionPayout';
+export * from './dtos/CommissionLedger';
 export * from './dtos/CommissionApi';
 export * from './dtos/PrivateLatestClosedPayout';

package/bin/retailCommission/index.js

@@ -37,6 +37,12 @@ __exportStar(require("./enums/CommissionCountByEnum"), exports);
 __exportStar(require("./enums/CommissionAggregateByEnum"), exports);
 __exportStar(require("./enums/CommissionSeriesByEnum"), exports);
 __exportStar(require("./enums/CommissionSimulationSkipEnum"), exports);
+__exportStar(require("./enums/CommissionPayTimingEnum"), exports);
+__exportStar(require("./enums/CommissionBillingPeriodEnum"), exports);
+__exportStar(require("./enums/CommissionPaymentStatusEnum"), exports);
+__exportStar(require("./enums/CommissionPaymentAttentionEnum"), exports);
+__exportStar(require("./enums/CommissionLedgerMovementKindEnum"), exports);
+__exportStar(require("./enums/CommissionPayTriggerEnum"), exports);
 // Entidades del dominio
 __exportStar(require("./dtos/CommissionPlan"), exports);
 __exportStar(require("./dtos/CommissionRule"), exports);
@@ -44,6 +50,7 @@ __exportStar(require("./dtos/CommissionCouponAccrual"), exports);
 __exportStar(require("./dtos/CommissionCalcTrace"), exports);
 __exportStar(require("./dtos/CommissionAccrual"), exports);
 __exportStar(require("./dtos/CommissionPayout"), exports);
+__exportStar(require("./dtos/CommissionLedger"), exports);
 // Contratos HTTP — uno por endpoint
 __exportStar(require("./dtos/CommissionApi"), exports);
 __exportStar(require("./dtos/PrivateLatestClosedPayout"), exports);

package/bin/retailOrg/dtos/RetailUser.d.ts

@@ -1,6 +1,7 @@
 import { CollectorSeniorityEnum } from '../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../enums/RetailUserStatusEnum';
+import { RetailUserWalletLinkMethodEnum } from '../enums/RetailUserWalletLinkMethodEnum';
 /**
  * RetailUser — usuario retail (empleado de tienda) de un retailer (SureKeep Fase 1 — pista Retail).
  * `cognitoSub` enlaza con la identidad en Cognito (validada vía platform-rbac por api-invoker).
@@ -28,6 +29,18 @@ export declare class RetailUser {
     /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
     coverageStoreIds?: string[];
     status: RetailUserStatusEnum;
+    /** Directorio de Fiado del dueño de la wallet PCF; `null` o ausente si no tiene wallet. */
+    fiadoDirectoryId?: string | null;
+    /** Cuenta PCF de la wallet. */
+    pcfAccountId?: string | null;
+    /** Cómo se encontró la wallet: por CLABE o por teléfono. */
+    walletLinkMethod?: RetailUserWalletLinkMethodEnum | null;
+    /** Últimos 4 dígitos de la CLABE; la CLABE completa no se guarda. */
+    walletClabeLast4?: string | null;
+    /** Cuándo se vinculó (ISO). */
+    walletLinkedAt?: string | null;
+    /** Quién la vinculó: el actorId del usuario del back office. */
+    walletLinkedBy?: string | null;
     createdAt: string;
     updatedAt: string;
     createdBy: string;

package/bin/retailOrg/dtos/RetailUser.js

@@ -16,6 +16,7 @@ const regex_1 = require("../../helpers/constans/regex");
 const CollectorSeniorityEnum_1 = require("../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../enums/EmploymentTypeEnum");
 const RetailUserStatusEnum_1 = require("../enums/RetailUserStatusEnum");
+const RetailUserWalletLinkMethodEnum_1 = require("../enums/RetailUserWalletLinkMethodEnum");
 /**
  * RetailUser — usuario retail (empleado de tienda) de un retailer (SureKeep Fase 1 — pista Retail).
  * `cognitoSub` enlaza con la identidad en Cognito (validada vía platform-rbac por api-invoker).
@@ -89,6 +90,44 @@ __decorate([
     (0, class_validator_1.IsEnum)(RetailUserStatusEnum_1.RetailUserStatusEnum),
     __metadata("design:type", String)
 ], RetailUser.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "fiadoDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "pcfAccountId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RetailUserWalletLinkMethodEnum_1.RetailUserWalletLinkMethodEnum),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkMethod", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^\d{4}$/, { message: 'walletClabeLast4 debe tener 4 dígitos' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletClabeLast4", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(regex_1.regexIso8601, { message: 'walletLinkedAt debe ser una fecha ISO 8601' }),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkedAt", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "walletLinkedBy", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailOrg/dtos/requests/LinkRetailUserWalletRequest.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Body de `PUT /retailers/{retailerId}/users/{retailUserId}/wallet`: vincula la wallet PCF del
+ * vendedor por CLABE o por teléfono, exactamente uno. El servidor vuelve a resolver la cuenta.
+ */
+export declare class LinkRetailUserWalletRequest {
+    /** CLABE PCF, 18 dígitos. Solo se guardan los últimos 4; no va a logs completa. */
+    clabe?: string | null;
+    /** Teléfono de México: 10 dígitos, con o sin `+52`; retail-org lo normaliza a E.164. No va a logs completo. */
+    phone?: string | null;
+}

package/bin/retailOrg/dtos/requests/LinkRetailUserWalletRequest.js

@@ -0,0 +1,37 @@
+"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.LinkRetailUserWalletRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const IsSingleWalletKeyConstraint_1 = require("../../validators/IsSingleWalletKeyConstraint");
+/**
+ * Body de `PUT /retailers/{retailerId}/users/{retailUserId}/wallet`: vincula la wallet PCF del
+ * vendedor por CLABE o por teléfono, exactamente uno. El servidor vuelve a resolver la cuenta.
+ */
+class LinkRetailUserWalletRequest {
+}
+exports.LinkRetailUserWalletRequest = LinkRetailUserWalletRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateIf)((o) => o.clabe != null || o.phone == null),
+    (0, class_validator_1.Validate)(IsSingleWalletKeyConstraint_1.IsSingleWalletKeyConstraint),
+    (0, class_validator_1.IsString)({ message: 'clabe debe ser texto' }),
+    (0, class_validator_1.Matches)(/^\d{18}$/, { message: 'clabe debe tener 18 dígitos' }),
+    __metadata("design:type", String)
+], LinkRetailUserWalletRequest.prototype, "clabe", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)({ message: 'phone debe ser texto' }),
+    (0, class_validator_1.Matches)(/^(\+52)?\d{10}$/, { message: 'phone debe tener 10 dígitos, con o sin +52' }),
+    __metadata("design:type", String)
+], LinkRetailUserWalletRequest.prototype, "phone", void 0);