@fiado/type-kit 3.573.0 → 3.574.0

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

@@ -395,6 +395,26 @@ export interface MyCommissionsTotals {
     unitsCount: number;
     netCents: number;
 }
+/**
+ * Lo que un cierre todavía abierto va a mover en el saldo del vendedor, calculado al momento con la
+ * misma cuenta del cierre: cada venta con el «Cuándo se paga» de su plan, menos lo ya acreditado al
+ * momento, más los ajustes del corte.
+ */
+export interface MyCommissionsUpcomingCut {
+    periodId: string;
+    periodStart: string;
+    periodEnd: string;
+    /** Día del cierre en México (`yyyy-mm-dd`): el lunes siguiente al domingo del corte. */
+    cutDate: string;
+    /** Lo que el cierre deja por depositar; negativo si descuenta. */
+    payableCents: number;
+    /** De `payableCents`, lo que viene de ajustes del corte. */
+    adjustmentsCents: number;
+    /** Lo que el cierre retiene hasta el día 1. */
+    retainedCents: number;
+    /** Día en que se libera lo retenido (`yyyy-mm-dd`); `null` si no retiene. */
+    releaseDate: string | null;
+}
 /**
  * `GET /commissions/me?weeks=` — las comisiones del vendedor que llama. El vendedor sale del token;
  * no se puede pedir el de otro.
@@ -412,6 +432,11 @@ export interface GetMyCommissionsResponse {
     };
     /** El corte en curso; `null` si todavía no tiene ventas, renta ni ajustes. */
     week: CommissionSellerBreakdown | null;
+    /**
+     * Los cierres pendientes con algo que mover: el del corte anterior si todavía no cierra y el del
+     * corte en curso, del más próximo al más lejano. Ausente en motores anteriores.
+     */
+    upcomingCuts?: MyCommissionsUpcomingCut[];
     /** Cortes cuya semana empieza en el mes de hoy: cerrados, el anterior aún sin cerrar y el en curso. */
     month: MyCommissionsTotals;
     /** Cortes cuya semana empieza en el año de hoy: cerrados, el anterior aún sin cerrar y el en curso. */

package/package.json

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

package/src/retailCommission/dtos/CommissionApi.ts

@@ -476,6 +476,27 @@ export interface MyCommissionsTotals {
     netCents: number;
 }
 
+/**
+ * Lo que un cierre todavía abierto va a mover en el saldo del vendedor, calculado al momento con la
+ * misma cuenta del cierre: cada venta con el «Cuándo se paga» de su plan, menos lo ya acreditado al
+ * momento, más los ajustes del corte.
+ */
+export interface MyCommissionsUpcomingCut {
+    periodId: string;
+    periodStart: string;
+    periodEnd: string;
+    /** Día del cierre en México (`yyyy-mm-dd`): el lunes siguiente al domingo del corte. */
+    cutDate: string;
+    /** Lo que el cierre deja por depositar; negativo si descuenta. */
+    payableCents: number;
+    /** De `payableCents`, lo que viene de ajustes del corte. */
+    adjustmentsCents: number;
+    /** Lo que el cierre retiene hasta el día 1. */
+    retainedCents: number;
+    /** Día en que se libera lo retenido (`yyyy-mm-dd`); `null` si no retiene. */
+    releaseDate: string | null;
+}
+
 /**
  * `GET /commissions/me?weeks=` — las comisiones del vendedor que llama. El vendedor sale del token;
  * no se puede pedir el de otro.
@@ -485,6 +506,11 @@ export interface GetMyCommissionsResponse {
     period: { periodId: string; periodStart: string; periodEnd: string };
     /** El corte en curso; `null` si todavía no tiene ventas, renta ni ajustes. */
     week: CommissionSellerBreakdown | null;
+    /**
+     * Los cierres pendientes con algo que mover: el del corte anterior si todavía no cierra y el del
+     * corte en curso, del más próximo al más lejano. Ausente en motores anteriores.
+     */
+    upcomingCuts?: MyCommissionsUpcomingCut[];
     /** Cortes cuya semana empieza en el mes de hoy: cerrados, el anterior aún sin cerrar y el en curso. */
     month: MyCommissionsTotals;
     /** Cortes cuya semana empieza en el año de hoy: cerrados, el anterior aún sin cerrar y el en curso. */