@fiado/type-kit 3.495.0 → 3.496.0

package/bin/retailIntegration/enums/RetailUserEventTypeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailUserEventTypeEnum = void 0;
+/** `eventType` válidos en `POST /webhooks/users`. */
+var RetailUserEventTypeEnum;
+(function (RetailUserEventTypeEnum) {
+    RetailUserEventTypeEnum["RETAIL_USER_CREATED_V1"] = "RetailUserCreatedV1";
+    RetailUserEventTypeEnum["RETAIL_USER_UPDATED_V1"] = "RetailUserUpdatedV1";
+    RetailUserEventTypeEnum["RETAIL_USER_TRANSFERRED_V1"] = "RetailUserTransferredV1";
+    RetailUserEventTypeEnum["RETAIL_USER_STATUS_CHANGED_V1"] = "RetailUserStatusChangedV1";
+})(RetailUserEventTypeEnum || (exports.RetailUserEventTypeEnum = RetailUserEventTypeEnum = {}));

package/bin/retailIntegration/enums/RetailUserRoleEnum.d.ts

@@ -0,0 +1,7 @@
+/** Rol de un usuario de la operación del retailer. */
+export declare enum RetailUserRoleEnum {
+    SELLER = "SELLER",
+    STORE_MANAGER = "STORE_MANAGER",
+    RETAILER_ADMIN = "RETAILER_ADMIN",
+    COLLECTION_AGENT = "COLLECTION_AGENT"
+}

package/bin/retailIntegration/enums/RetailUserRoleEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetailUserRoleEnum = void 0;
+/** Rol de un usuario de la operación del retailer. */
+var RetailUserRoleEnum;
+(function (RetailUserRoleEnum) {
+    RetailUserRoleEnum["SELLER"] = "SELLER";
+    RetailUserRoleEnum["STORE_MANAGER"] = "STORE_MANAGER";
+    RetailUserRoleEnum["RETAILER_ADMIN"] = "RETAILER_ADMIN";
+    RetailUserRoleEnum["COLLECTION_AGENT"] = "COLLECTION_AGENT";
+})(RetailUserRoleEnum || (exports.RetailUserRoleEnum = RetailUserRoleEnum = {}));

package/bin/retailIntegration/enums/StoreEventTypeEnum.d.ts

@@ -0,0 +1,6 @@
+/** `eventType` válidos en `POST /webhooks/stores`. */
+export declare enum StoreEventTypeEnum {
+    STORE_CREATED_V1 = "StoreCreatedV1",
+    STORE_UPDATED_V1 = "StoreUpdatedV1",
+    STORE_STATUS_CHANGED_V1 = "StoreStatusChangedV1"
+}

package/bin/retailIntegration/enums/StoreEventTypeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreEventTypeEnum = void 0;
+/** `eventType` válidos en `POST /webhooks/stores`. */
+var StoreEventTypeEnum;
+(function (StoreEventTypeEnum) {
+    StoreEventTypeEnum["STORE_CREATED_V1"] = "StoreCreatedV1";
+    StoreEventTypeEnum["STORE_UPDATED_V1"] = "StoreUpdatedV1";
+    StoreEventTypeEnum["STORE_STATUS_CHANGED_V1"] = "StoreStatusChangedV1";
+})(StoreEventTypeEnum || (exports.StoreEventTypeEnum = StoreEventTypeEnum = {}));

package/bin/retailIntegration/enums/index.d.ts

@@ -0,0 +1,21 @@
+export * from './RetailEventResultEnum';
+export * from './StoreEventTypeEnum';
+export * from './RetailUserEventTypeEnum';
+export * from './ProductEventTypeEnum';
+export * from './InventoryEventTypeEnum';
+export * from './RetailStoreStatusEnum';
+export * from './RetailProductCategoryEnum';
+export * from './RetailTrackingModeEnum';
+export * from './RetailProductTierEnum';
+export * from './RetailCurrencyEnum';
+export * from './RetailFinancierEnum';
+export * from './RetailMdmProviderEnum';
+export * from './RetailProductStatusEnum';
+export * from './RetailPieceStatusEnum';
+export * from './RetailPieceReasonEnum';
+export * from './RetailUserRoleEnum';
+export * from './RetailUserAccessStatusEnum';
+export * from './RetailSaleTypeEnum';
+export * from './RetailSaleFinancierEnum';
+export * from './RetailPaymentMethodEnum';
+export * from './RetailLinePaymentTypeEnum';

package/bin/retailIntegration/enums/index.js

@@ -0,0 +1,37 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./RetailEventResultEnum"), exports);
+__exportStar(require("./StoreEventTypeEnum"), exports);
+__exportStar(require("./RetailUserEventTypeEnum"), exports);
+__exportStar(require("./ProductEventTypeEnum"), exports);
+__exportStar(require("./InventoryEventTypeEnum"), exports);
+__exportStar(require("./RetailStoreStatusEnum"), exports);
+__exportStar(require("./RetailProductCategoryEnum"), exports);
+__exportStar(require("./RetailTrackingModeEnum"), exports);
+__exportStar(require("./RetailProductTierEnum"), exports);
+__exportStar(require("./RetailCurrencyEnum"), exports);
+__exportStar(require("./RetailFinancierEnum"), exports);
+__exportStar(require("./RetailMdmProviderEnum"), exports);
+__exportStar(require("./RetailProductStatusEnum"), exports);
+__exportStar(require("./RetailPieceStatusEnum"), exports);
+__exportStar(require("./RetailPieceReasonEnum"), exports);
+__exportStar(require("./RetailUserRoleEnum"), exports);
+__exportStar(require("./RetailUserAccessStatusEnum"), exports);
+__exportStar(require("./RetailSaleTypeEnum"), exports);
+__exportStar(require("./RetailSaleFinancierEnum"), exports);
+__exportStar(require("./RetailPaymentMethodEnum"), exports);
+__exportStar(require("./RetailLinePaymentTypeEnum"), exports);

package/bin/retailIntegration/index.d.ts

@@ -0,0 +1,25 @@
+export * from './constants/retailIntegrationLimits';
+export * from './enums';
+export * from './validators/IsIsoDateTimeWithZone';
+export * from './dtos/RetailEventEnvelope';
+export * from './dtos/ReceiveStoreEventRequest';
+export * from './dtos/ReceiveRetailUserEventRequest';
+export * from './dtos/ReceiveProductEventRequest';
+export * from './dtos/ReceiveInventoryEventRequest';
+export * from './dtos/ReceiveRetailEventRequest';
+export * from './dtos/RetailEventResult';
+export * from './dtos/ApplyRetailEventRequest';
+export * from './dtos/RetailTenantQuery';
+export * from './dtos/RetailPagedQuery';
+export * from './dtos/ListRetailStoresRequest';
+export * from './dtos/ListRetailCatalogRequest';
+export * from './dtos/GetRetailInventoryRequest';
+export * from './dtos/ListRetailUsersRequest';
+export * from './dtos/RegisterRetailSaleRequest';
+export * from './dtos/RetailOutboundResponses';
+export * from './models/RetailPageMeta';
+export * from './models/RetailSystemStore';
+export * from './models/RetailSystemProduct';
+export * from './models/RetailSystemInventory';
+export * from './models/RetailSystemUser';
+export * from './models/RetailSystemSale';

package/bin/retailIntegration/index.js

@@ -0,0 +1,41 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./constants/retailIntegrationLimits"), exports);
+__exportStar(require("./enums"), exports);
+__exportStar(require("./validators/IsIsoDateTimeWithZone"), exports);
+__exportStar(require("./dtos/RetailEventEnvelope"), exports);
+__exportStar(require("./dtos/ReceiveStoreEventRequest"), exports);
+__exportStar(require("./dtos/ReceiveRetailUserEventRequest"), exports);
+__exportStar(require("./dtos/ReceiveProductEventRequest"), exports);
+__exportStar(require("./dtos/ReceiveInventoryEventRequest"), exports);
+__exportStar(require("./dtos/ReceiveRetailEventRequest"), exports);
+__exportStar(require("./dtos/RetailEventResult"), exports);
+__exportStar(require("./dtos/ApplyRetailEventRequest"), exports);
+__exportStar(require("./dtos/RetailTenantQuery"), exports);
+__exportStar(require("./dtos/RetailPagedQuery"), exports);
+__exportStar(require("./dtos/ListRetailStoresRequest"), exports);
+__exportStar(require("./dtos/ListRetailCatalogRequest"), exports);
+__exportStar(require("./dtos/GetRetailInventoryRequest"), exports);
+__exportStar(require("./dtos/ListRetailUsersRequest"), exports);
+__exportStar(require("./dtos/RegisterRetailSaleRequest"), exports);
+__exportStar(require("./dtos/RetailOutboundResponses"), exports);
+__exportStar(require("./models/RetailPageMeta"), exports);
+__exportStar(require("./models/RetailSystemStore"), exports);
+__exportStar(require("./models/RetailSystemProduct"), exports);
+__exportStar(require("./models/RetailSystemInventory"), exports);
+__exportStar(require("./models/RetailSystemUser"), exports);
+__exportStar(require("./models/RetailSystemSale"), exports);

package/bin/retailIntegration/models/RetailPageMeta.d.ts

@@ -0,0 +1,10 @@
+/** `meta` de una lista paginada del retailer; `nextToken` en `null` cierra la lectura. */
+export interface RetailPageMeta {
+    count: number;
+    nextToken: string | null;
+}
+/** `meta` del inventario de una tienda. */
+export interface RetailInventoryMeta {
+    storeId: string;
+    generatedAt: string;
+}

package/bin/retailIntegration/models/RetailPageMeta.js

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

package/bin/retailIntegration/models/RetailSystemInventory.d.ts

@@ -0,0 +1,17 @@
+import { RetailPieceReasonEnum, RetailPieceStatusEnum } from '../enums';
+export type RetailPieceStatus = `${RetailPieceStatusEnum}`;
+export type RetailPieceReason = `${RetailPieceReasonEnum}`;
+/** Pieza con IMEI o número de serie. */
+export interface RetailSystemPiece {
+    sku: string;
+    identifier: string;
+    storeId: string;
+    status: RetailPieceStatus;
+    reason: RetailPieceReason | null;
+}
+/** Existencia de un producto sin identificador por unidad. */
+export interface RetailSystemStock {
+    sku: string;
+    storeId: string;
+    qty: number;
+}

package/bin/retailIntegration/models/RetailSystemInventory.js

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

package/bin/retailIntegration/models/RetailSystemProduct.d.ts

@@ -0,0 +1,32 @@
+import { RetailCurrencyEnum, RetailFinancierEnum, RetailMdmProviderEnum, RetailProductCategoryEnum, RetailProductStatusEnum, RetailProductTierEnum, RetailTrackingModeEnum } from '../enums';
+export type RetailProductCategory = `${RetailProductCategoryEnum}`;
+export type RetailTrackingMode = `${RetailTrackingModeEnum}`;
+export type RetailProductTier = `${RetailProductTierEnum}`;
+export type RetailCurrency = `${RetailCurrencyEnum}`;
+export type RetailFinancier = `${RetailFinancierEnum}`;
+export type RetailMdmProvider = `${RetailMdmProviderEnum}`;
+export type RetailProductStatus = `${RetailProductStatusEnum}`;
+/** Precios como decimal en string con dos decimales. */
+export interface RetailSystemProductPrice {
+    basePrice: string;
+    listPrice: string | null;
+    effectiveFrom: string;
+}
+/** Producto tal como lo define la doc de integración. */
+export interface RetailSystemProduct {
+    sku: string;
+    externalId: string;
+    brand: string;
+    model: string;
+    color: string | null;
+    capacity: string | null;
+    description: string | null;
+    category: RetailProductCategory;
+    trackingMode: RetailTrackingMode;
+    tier: RetailProductTier | null;
+    currencyId: RetailCurrency;
+    price: RetailSystemProductPrice;
+    eligibleFinanciers: RetailFinancier[];
+    mdmProvider: RetailMdmProvider | null;
+    status: RetailProductStatus;
+}

package/bin/retailIntegration/models/RetailSystemProduct.js

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

package/bin/retailIntegration/models/RetailSystemSale.d.ts

@@ -0,0 +1,46 @@
+import { RetailLinePaymentTypeEnum, RetailPaymentMethodEnum, RetailSaleFinancierEnum, RetailSaleTypeEnum } from '../enums';
+import { RetailCurrency } from './RetailSystemProduct';
+export type RetailSaleType = `${RetailSaleTypeEnum}`;
+export type RetailSaleFinancier = `${RetailSaleFinancierEnum}`;
+export type RetailPaymentMethod = `${RetailPaymentMethodEnum}`;
+export type RetailLinePaymentType = `${RetailLinePaymentTypeEnum}`;
+export interface RetailSystemSaleCustomer {
+    customerId: string;
+    names: string;
+    paternalLastName: string;
+    maternalLastName: string | null;
+    phone: string;
+}
+export interface RetailSystemSaleComponent {
+    sku: string;
+    qty: number;
+    identifiers: string[];
+}
+export interface RetailSystemSaleLine {
+    lineId: string;
+    sku: string;
+    qty: number;
+    basePrice: string;
+    discount: string;
+    paymentType: RetailLinePaymentType;
+    financedAmount: string;
+    role: 'GIFT' | null;
+    components: RetailSystemSaleComponent[];
+}
+/** Cuerpo de `POST /sales` de la doc; `saleId` es la llave de idempotencia. */
+export interface RetailSystemSale {
+    saleId: string;
+    folio: string;
+    storeId: string;
+    sellerRetailUserId: string;
+    soldAt: string;
+    saleType: RetailSaleType;
+    financier: RetailSaleFinancier;
+    creditId: string | null;
+    currencyId: RetailCurrency;
+    customer: RetailSystemSaleCustomer;
+    equipmentPrice: string;
+    amountPaid: string;
+    paymentMethod: RetailPaymentMethod | null;
+    lines: RetailSystemSaleLine[];
+}

package/bin/retailIntegration/models/RetailSystemSale.js

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

package/bin/retailIntegration/models/RetailSystemStore.d.ts

@@ -0,0 +1,29 @@
+import { RetailStoreStatusEnum } from '../enums';
+export type RetailStoreStatus = `${RetailStoreStatusEnum}`;
+export interface RetailSystemStoreAddress {
+    address1: string;
+    externalNumber: string | null;
+    internalNumber: string | null;
+    neighborhood: string | null;
+    city: string;
+    state: string;
+    zipCode: string;
+    country: string | null;
+    reference: string | null;
+}
+export interface RetailSystemStoreLocation {
+    lat: number | null;
+    lng: number | null;
+}
+/** Tienda tal como la define la doc de integración. */
+export interface RetailSystemStore {
+    storeId: string;
+    code: string;
+    name: string;
+    zoneId: string | null;
+    address: RetailSystemStoreAddress;
+    location: RetailSystemStoreLocation;
+    phone: string;
+    schedule: string | null;
+    status: RetailStoreStatus;
+}

package/bin/retailIntegration/models/RetailSystemStore.js

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

package/bin/retailIntegration/models/RetailSystemUser.d.ts

@@ -0,0 +1,14 @@
+import { RetailUserAccessStatusEnum, RetailUserRoleEnum } from '../enums';
+export type RetailUserRole = `${RetailUserRoleEnum}`;
+export type RetailUserAccessStatus = `${RetailUserAccessStatusEnum}`;
+/** Usuario de la operación del retailer, tal como lo define la doc de integración. */
+export interface RetailSystemUser {
+    retailUserId: string;
+    displayName: string;
+    email: string;
+    phone: string | null;
+    homeStoreId: string;
+    zoneId: string | null;
+    role: RetailUserRole;
+    status: RetailUserAccessStatus;
+}

package/bin/retailIntegration/models/RetailSystemUser.js

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

package/bin/retailIntegration/validators/IsIsoDateTimeWithZone.d.ts

@@ -0,0 +1,6 @@
+import { ValidatorConstraintInterface } from 'class-validator';
+/** Acepta fecha y hora ISO-8601 con segundos y zona; sin zona se rechaza, como dice la doc. */
+export declare class IsIsoDateTimeWithZone implements ValidatorConstraintInterface {
+    validate(value: unknown): boolean;
+    defaultMessage(): string;
+}

package/bin/retailIntegration/validators/IsIsoDateTimeWithZone.js

@@ -0,0 +1,29 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsIsoDateTimeWithZone = void 0;
+const class_validator_1 = require("class-validator");
+const ISO_DATE_TIME_WITH_ZONE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:\d{2})$/;
+/** Descarta fechas que `Date` recorre en silencio, como el 31 de febrero. */
+function isRealCalendarDate(value) {
+    const [year, month, day] = value.slice(0, 10).split('-').map(Number);
+    return !Number.isNaN(Date.parse(value)) && new Date(Date.UTC(year, month - 1, day)).getUTCDate() === day;
+}
+/** Acepta fecha y hora ISO-8601 con segundos y zona; sin zona se rechaza, como dice la doc. */
+let IsIsoDateTimeWithZone = class IsIsoDateTimeWithZone {
+    validate(value) {
+        return typeof value === 'string' && ISO_DATE_TIME_WITH_ZONE.test(value) && isRealCalendarDate(value);
+    }
+    defaultMessage() {
+        return 'debe ser fecha y hora ISO-8601 con zona, por ejemplo 2026-08-17T20:32:05Z';
+    }
+};
+exports.IsIsoDateTimeWithZone = IsIsoDateTimeWithZone;
+exports.IsIsoDateTimeWithZone = IsIsoDateTimeWithZone = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isIsoDateTimeWithZone', async: false })
+], IsIsoDateTimeWithZone);

package/package.json

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

package/src/index.ts

@@ -125,6 +125,8 @@ export * as RetailWizard from './retailWizard';
 // RetailPromotions: DTOs/enums de retail-promotions-business (promos de venta, códigos de descuento y
 // cupones de VentasLuga). Porcentajes en puntos base, dinero en centavos.
 export * as RetailPromotions from './retailPromotions';
+// RetailIntegration: DTOs del retail-integration-connector (webhooks del retailer y salida hacia su sistema).
+export * as RetailIntegration from './retailIntegration';
 export * as DatalakeQuery from './datalakeQuery';
 // LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
 export * as LoanConfig from './loanConfig';

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

@@ -0,0 +1,40 @@
+import { Expose, Type } from 'class-transformer';
+import { IsEnum, IsInt, IsOptional, IsUUID, Min, ValidateNested } from 'class-validator';
+import { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+import { InStorePaymentDetail } from './InStorePaymentDetail';
+
+/** Body de `POST /seller/credits/{creditId}/payments`: el vendedor anota un pago recibido en tienda. */
+export class CreateSellerPaymentRequest {
+    @Expose()
+    @IsEnum(LoanCustomerPaymentTypeEnum)
+    type!: LoanCustomerPaymentTypeEnum;
+
+    /** El monto que vio el vendedor en las opciones; distinto al de hoy → 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    expectedAmountCents!: number;
+
+    /** Solo ADVANCE: cuántas cuotas adelanta. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(2)
+    installmentCount?: number;
+
+    @Expose()
+    @IsEnum(InStorePaymentMethodEnum)
+    method!: InStorePaymentMethodEnum;
+
+    /** Tarjeta: `cardLast4` + `authCode`; SPEI: `speiTrackingKey`; efectivo: sin detalle. */
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => InStorePaymentDetail)
+    detail?: InStorePaymentDetail;
+
+    @Expose()
+    @IsUUID()
+    idempotencyKey!: string;
+}

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

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsString, Length, Matches, ValidateIf } from 'class-validator';
+
+/**
+ * Dato de la forma de pago anotada en tienda; solo valida la forma, nunca lleva CLABE.
+ * Qué campo exige cada método lo decide loan-credit (400 INVALID_PAYMENT_DETAIL).
+ */
+export class InStorePaymentDetail {
+    /** Tarjeta: últimos 4 dígitos. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.cardLast4 !== undefined)
+    @Matches(/^\d{4}$/)
+    cardLast4?: string;
+
+    /** Tarjeta: número de autorización del voucher. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.authCode !== undefined)
+    @Matches(/^[A-Za-z0-9]{1,12}$/)
+    authCode?: string;
+
+    /** SPEI: clave de rastreo. */
+    @Expose()
+    @ValidateIf((detail: InStorePaymentDetail) => detail.speiTrackingKey !== undefined)
+    @IsString()
+    @Length(1, 30)
+    speiTrackingKey?: string;
+}

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

@@ -0,0 +1,51 @@
+import type { PaginatedResult } from '../../../retailOrg';
+import type { CreditCustomerStateEnum } from '../../enums/CreditCustomerStateEnum';
+import type { LoanPaymentOriginEnum } from '../../enums/LoanPaymentOriginEnum';
+
+/** Segmento del catálogo al que pertenece el cliente. */
+export interface CreditCustomerSegment {
+    segmentId: string;
+    name: string;
+}
+
+/** Último pago que entró al crédito: cuándo y por dónde. */
+export interface CreditLastPayment {
+    at: string;
+    origin: LoanPaymentOriginEnum;
+    storeId?: string;
+    storeName?: string;
+}
+
+/** Bloque de crédito de la fila de Clientes; sin lectura todo va en null. */
+export interface CreditCustomerCredit {
+    state: CreditCustomerStateEnum;
+    clientLevel: string | null;
+    sciScore: number | null;
+    /** Si el SCI es el vivo del acreditado o el congelado al originar. */
+    sciSource: string | null;
+    creditsCount: number | null;
+    activeCreditsCount: number | null;
+    settledCreditsCount: number | null;
+    writtenOffCreditsCount: number | null;
+    outstandingBalanceCents: number | null;
+    arrearsDays: number | null;
+    lastPaymentAt: string | null;
+    /** Ausente en créditos sin pago desde que existe el campo: el front cae a `lastPaymentAt`. */
+    lastPayment?: CreditLastPayment;
+    /** Crédito vigente; si hubiera más de uno vivo, el más reciente. */
+    activeCreditId: string | null;
+}
+
+/** Fila de la tabla Clientes del backoffice. */
+export interface CreditCustomerListItem {
+    retailCustomerId: string;
+    fullName: string | null;
+    phone: string | null;
+    originStoreId: string | null;
+    segments: CreditCustomerSegment[];
+    /** `false` = la consulta de segmentos falló: la celda dice «sin leer», no «ninguno». */
+    segmentsRead: boolean;
+    credit: CreditCustomerCredit;
+}
+
+export type CreditCustomerPage = PaginatedResult<CreditCustomerListItem>;

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

@@ -0,0 +1,21 @@
+import type { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
+import type { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
+import type { NamedRef } from './SellerPaymentResult';
+
+/** Un cobro en tienda en la conciliación de la cadena. */
+export interface InStorePaymentListItem {
+    receipt: string;
+    creditId: string;
+    paymentId: string;
+    chargeKind: LoanChargeKindEnum;
+    amountCents: number;
+    method: InStorePaymentMethodEnum;
+    collectedBySeller: NamedRef;
+    appliedAt: string;
+}
+
+/** `GET /seller/stores/{storeId}/in-store-payments`; `nextToken` ausente = última página. */
+export interface InStorePaymentListResponse {
+    items: InStorePaymentListItem[];
+    nextToken?: string;
+}

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

@@ -1,7 +1,10 @@
 import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { MechanismType } from '../../../collection/enums/MechanismType';
 import { CurrencyId } from '../../../currency/enums/CurrencyId';
+import type { InStorePaymentMethodEnum } from '../../enums/InStorePaymentMethodEnum';
 import { LoanChargeKindEnum } from '../../enums/LoanChargeKindEnum';
+import type { LoanPaymentOriginEnum } from '../../enums/LoanPaymentOriginEnum';
+import type { NamedRef } from './SellerPaymentResult';
 
 /** Un pago del historial de un crédito, tal como lo asentó el motor de cobro en `LoanPayment_GT`. */
 export interface LoanPaymentListItem {
@@ -10,7 +13,8 @@ export interface LoanPaymentListItem {
     receipt: string;
     installmentNumber: number;
     attemptId: string;
-    mechanism: MechanismType;
+    /** Ausente en los pagos en tienda: ahí no hubo motor. */
+    mechanism?: MechanismType;
     result: CollectionResultStatus;
     currency: CurrencyId;
     collectedCents: number;
@@ -30,6 +34,12 @@ export interface LoanPaymentListItem {
     chargeKind?: LoanChargeKindEnum;
     /** Saldo de capital del crédito después de este pago. Ausente en pagos viejos. */
     creditPrincipalBalanceAfterCents?: number;
+    /** Ausente en filas viejas = COLLECTION_ENGINE. */
+    origin?: LoanPaymentOriginEnum;
+    inStoreMethod?: InStorePaymentMethodEnum;
+    /** Tienda y vendedor con el nombre congelado al cobrar; el cliente nunca recibe `collectedBySeller.id`. */
+    collectedAtStore?: NamedRef;
+    collectedBySeller?: { id?: string; name: string | null };
 }
 
 /** Página del historial. El fin lo marca la AUSENCIA de `nextToken`, nunca una página corta. */

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

@@ -0,0 +1,11 @@
+import type { SellerNextInstallment } from './SellerPaymentResult';
+
+/** Respuesta de `GET /seller/credits/lookup`: lo mínimo para confirmar que es el crédito correcto. */
+export interface SellerCreditLookupResult {
+    creditId: string;
+    /** PII: nunca se loguea. */
+    customerName: string | null;
+    productBrand: string | null;
+    productModel: string | null;
+    nextInstallment: SellerNextInstallment | null;
+}

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

@@ -0,0 +1,29 @@
+import type { LoanPaymentOptionUnavailableReasonEnum } from '../../enums/LoanPaymentOptionUnavailableReasonEnum';
+import type { SellerNextInstallment } from './SellerPaymentResult';
+
+/** Una opción de cobro en tienda: disponible con su monto o rango, o no con su razón. */
+export interface SellerPaymentOption {
+    available: boolean;
+    unavailableReason?: LoanPaymentOptionUnavailableReasonEnum;
+    amountCents?: number;
+}
+
+/** Resumen del crédito de la opción A del canvas. */
+export interface SellerCreditPaymentSummary {
+    totalCents: number;
+    paidCents: number;
+    remainingCents: number;
+    nextInstallment: SellerNextInstallment | null;
+}
+
+/** Respuesta de `GET /seller/credits/{creditId}/payment-options`: fuente de `expectedAmountCents`. */
+export interface SellerPaymentOptions {
+    creditId: string;
+    summary: SellerCreditPaymentSummary;
+    /** Su cuota: las exigibles hoy (vencidas y la de hoy) o, sin nada exigible, la siguiente. */
+    nextInstallment: SellerPaymentOption & { installmentNumbers?: number[]; overdueCount?: number };
+    advance: SellerPaymentOption & { minInstallments?: number; maxInstallments?: number; installmentAmountsCents?: number[] };
+    prepayment: SellerPaymentOption & { minAmountCents?: number; maxAmountCents?: number };
+    /** Liquidar: el neto de la cotización de hoy. */
+    settlement: SellerPaymentOption;
+}