@fiado/type-kit 3.616.0 → 3.618.0

package/bin/transferNote/enums/TransferNoteItemStatusEnum.d.ts

@@ -0,0 +1,5 @@
+/** Estado de un item: en el pool de su par o incluido en una nota. */
+export declare enum TransferNoteItemStatusEnum {
+    POOLED = "POOLED",
+    INCLUDED = "INCLUDED"
+}

package/bin/transferNote/enums/TransferNoteItemStatusEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteItemStatusEnum = void 0;
+/** Estado de un item: en el pool de su par o incluido en una nota. */
+var TransferNoteItemStatusEnum;
+(function (TransferNoteItemStatusEnum) {
+    TransferNoteItemStatusEnum["POOLED"] = "POOLED";
+    TransferNoteItemStatusEnum["INCLUDED"] = "INCLUDED";
+})(TransferNoteItemStatusEnum || (exports.TransferNoteItemStatusEnum = TransferNoteItemStatusEnum = {}));

package/bin/transferNote/enums/TransferNotePartyTypeEnum.d.ts

@@ -0,0 +1,6 @@
+/** Tipo de parte de un par: GATEWAY es quien mueve el dinero (FSA), SOFOM la financiera, RETAILER cada tienda. */
+export declare enum TransferNotePartyTypeEnum {
+    GATEWAY = "GATEWAY",
+    SOFOM = "SOFOM",
+    RETAILER = "RETAILER"
+}

package/bin/transferNote/enums/TransferNotePartyTypeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNotePartyTypeEnum = void 0;
+/** Tipo de parte de un par: GATEWAY es quien mueve el dinero (FSA), SOFOM la financiera, RETAILER cada tienda. */
+var TransferNotePartyTypeEnum;
+(function (TransferNotePartyTypeEnum) {
+    TransferNotePartyTypeEnum["GATEWAY"] = "GATEWAY";
+    TransferNotePartyTypeEnum["SOFOM"] = "SOFOM";
+    TransferNotePartyTypeEnum["RETAILER"] = "RETAILER";
+})(TransferNotePartyTypeEnum || (exports.TransferNotePartyTypeEnum = TransferNotePartyTypeEnum = {}));

package/bin/transferNote/enums/TransferNoteStatusEnum.d.ts

@@ -0,0 +1,9 @@
+/** Estado de una nota; ISSUING es transitorio mientras el corte o la emisión toman sus items. */
+export declare enum TransferNoteStatusEnum {
+    ISSUING = "ISSUING",
+    ISSUED = "ISSUED",
+    SENT = "SENT",
+    RECONCILED = "RECONCILED",
+    CANCELLED = "CANCELLED",
+    DISPUTED = "DISPUTED"
+}

package/bin/transferNote/enums/TransferNoteStatusEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteStatusEnum = void 0;
+/** Estado de una nota; ISSUING es transitorio mientras el corte o la emisión toman sus items. */
+var TransferNoteStatusEnum;
+(function (TransferNoteStatusEnum) {
+    TransferNoteStatusEnum["ISSUING"] = "ISSUING";
+    TransferNoteStatusEnum["ISSUED"] = "ISSUED";
+    TransferNoteStatusEnum["SENT"] = "SENT";
+    TransferNoteStatusEnum["RECONCILED"] = "RECONCILED";
+    TransferNoteStatusEnum["CANCELLED"] = "CANCELLED";
+    TransferNoteStatusEnum["DISPUTED"] = "DISPUTED";
+})(TransferNoteStatusEnum || (exports.TransferNoteStatusEnum = TransferNoteStatusEnum = {}));

package/bin/transferNote/events/TransferNoteReconciledEventDetail.d.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+export declare const TRANSFER_NOTE_EVENTS_SOURCE = "fiado.transferNote";
+export declare enum TransferNoteEventDetailTypeEnum {
+    TRANSFER_NOTE_RECONCILED = "transferNote.TransferNoteReconciled"
+}
+export declare class TransferNoteReconciledEventDetail {
+    /** Fijo por nota: un reenvío llega con el mismo id y el consumidor lo descarta. */
+    eventId: string;
+    tenantId: string;
+    noteId: string;
+    pairKey: string;
+    isoWeek: string;
+    netAmountCents: number;
+    currency: CurrencyId;
+    /** ISO 8601 de la última confirmación. */
+    reconciledAt: string;
+}

package/bin/transferNote/events/TransferNoteReconciledEventDetail.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteReconciledEventDetail = exports.TransferNoteEventDetailTypeEnum = exports.TRANSFER_NOTE_EVENTS_SOURCE = void 0;
+// Origen de los eventos de EventBridge que publica transfer-note-business.
+exports.TRANSFER_NOTE_EVENTS_SOURCE = 'fiado.transferNote';
+var TransferNoteEventDetailTypeEnum;
+(function (TransferNoteEventDetailTypeEnum) {
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_RECONCILED"] = "transferNote.TransferNoteReconciled";
+})(TransferNoteEventDetailTypeEnum || (exports.TransferNoteEventDetailTypeEnum = TransferNoteEventDetailTypeEnum = {}));
+// `detail` de TransferNoteReconciled; el motor recalcula con él el agregado de la semana del par.
+class TransferNoteReconciledEventDetail {
+}
+exports.TransferNoteReconciledEventDetail = TransferNoteReconciledEventDetail;

package/bin/transferNote/index.d.ts

@@ -0,0 +1,34 @@
+export * from './enums/TransferNoteStatusEnum';
+export * from './enums/TransferNoteItemStatusEnum';
+export * from './enums/TransferNoteConceptEnum';
+export * from './enums/TransferNoteConceptSignEnum';
+export * from './enums/TransferNotePartyTypeEnum';
+export * from './enums/TransferNoteDisputeCategoryEnum';
+export * from './enums/TransferNoteDisputeDecisionEnum';
+export * from './enums/TransferNoteIssueOriginEnum';
+export * from './enums/TransferNoteConfigRecordTypeEnum';
+export * from './enums/TransferNoteConfirmationTypeEnum';
+export * from './enums/TransferNoteConfirmationSourceEnum';
+export * from './enums/TransferNoteHistoryActionEnum';
+export * from './enums/TransferNoteFeedConceptEnum';
+export * from './enums/TransferNoteErrorCodeEnum';
+export * from './constants/transferNoteErrorHttpStatus';
+export * from './constants/transferNoteValidation';
+export * from './constants/transferNoteDefaultFees';
+export * from './validators/IsTransferNoteSelectionConstraint';
+export * from './dtos/TransferNote';
+export * from './dtos/TransferNoteItem';
+export * from './dtos/TransferNoteHistoryEntry';
+export * from './dtos/TransferNoteSignedUrl';
+export * from './dtos/TransferNoteConfigRecords';
+export * from './dtos/TransferNoteFeedRecords';
+export * from './dtos/requests/TransferNoteActionRequests';
+export * from './dtos/requests/TransferNoteQueries';
+export * from './dtos/requests/RetailerTransferNoteRequests';
+export * from './dtos/requests/TransferNoteConfigRequests';
+export * from './dtos/requests/PrivateTransferNoteRequests';
+export * from './dtos/responses/TransferNoteResponses';
+export * from './dtos/responses/RetailerTransferNoteResponses';
+export * from './dtos/responses/TransferNoteConfigResponses';
+export * from './dtos/responses/PrivateTransferNoteResponses';
+export * from './events/TransferNoteReconciledEventDetail';

package/bin/transferNote/index.js

@@ -0,0 +1,56 @@
+"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 });
+// Enums
+__exportStar(require("./enums/TransferNoteStatusEnum"), exports);
+__exportStar(require("./enums/TransferNoteItemStatusEnum"), exports);
+__exportStar(require("./enums/TransferNoteConceptEnum"), exports);
+__exportStar(require("./enums/TransferNoteConceptSignEnum"), exports);
+__exportStar(require("./enums/TransferNotePartyTypeEnum"), exports);
+__exportStar(require("./enums/TransferNoteDisputeCategoryEnum"), exports);
+__exportStar(require("./enums/TransferNoteDisputeDecisionEnum"), exports);
+__exportStar(require("./enums/TransferNoteIssueOriginEnum"), exports);
+__exportStar(require("./enums/TransferNoteConfigRecordTypeEnum"), exports);
+__exportStar(require("./enums/TransferNoteConfirmationTypeEnum"), exports);
+__exportStar(require("./enums/TransferNoteConfirmationSourceEnum"), exports);
+__exportStar(require("./enums/TransferNoteHistoryActionEnum"), exports);
+__exportStar(require("./enums/TransferNoteFeedConceptEnum"), exports);
+__exportStar(require("./enums/TransferNoteErrorCodeEnum"), exports);
+// Constantes y validadores
+__exportStar(require("./constants/transferNoteErrorHttpStatus"), exports);
+__exportStar(require("./constants/transferNoteValidation"), exports);
+__exportStar(require("./constants/transferNoteDefaultFees"), exports);
+__exportStar(require("./validators/IsTransferNoteSelectionConstraint"), exports);
+// Entidades del dominio
+__exportStar(require("./dtos/TransferNote"), exports);
+__exportStar(require("./dtos/TransferNoteItem"), exports);
+__exportStar(require("./dtos/TransferNoteHistoryEntry"), exports);
+__exportStar(require("./dtos/TransferNoteSignedUrl"), exports);
+__exportStar(require("./dtos/TransferNoteConfigRecords"), exports);
+__exportStar(require("./dtos/TransferNoteFeedRecords"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/TransferNoteActionRequests"), exports);
+__exportStar(require("./dtos/requests/TransferNoteQueries"), exports);
+__exportStar(require("./dtos/requests/RetailerTransferNoteRequests"), exports);
+__exportStar(require("./dtos/requests/TransferNoteConfigRequests"), exports);
+__exportStar(require("./dtos/requests/PrivateTransferNoteRequests"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/TransferNoteResponses"), exports);
+__exportStar(require("./dtos/responses/RetailerTransferNoteResponses"), exports);
+__exportStar(require("./dtos/responses/TransferNoteConfigResponses"), exports);
+__exportStar(require("./dtos/responses/PrivateTransferNoteResponses"), exports);
+// Eventos
+__exportStar(require("./events/TransferNoteReconciledEventDetail"), exports);

package/bin/transferNote/validators/IsTransferNoteSelectionConstraint.d.ts

@@ -0,0 +1,6 @@
+import { type ValidationArguments, type ValidatorConstraintInterface } from 'class-validator';
+/** Exige `itemIds` (no vacío, sin strings vacíos) o `isoWeek`, nunca los dos ni ninguno. */
+export declare class IsTransferNoteSelectionConstraint implements ValidatorConstraintInterface {
+    validate(itemIds: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/transferNote/validators/IsTransferNoteSelectionConstraint.js

@@ -0,0 +1,28 @@
+"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.IsTransferNoteSelectionConstraint = void 0;
+const class_validator_1 = require("class-validator");
+/** Exige `itemIds` (no vacío, sin strings vacíos) o `isoWeek`, nunca los dos ni ninguno. */
+let IsTransferNoteSelectionConstraint = class IsTransferNoteSelectionConstraint {
+    validate(itemIds, args) {
+        const hasWeek = args.object.isoWeek !== undefined;
+        if (itemIds === undefined)
+            return hasWeek;
+        if (hasWeek || !Array.isArray(itemIds) || itemIds.length === 0)
+            return false;
+        return itemIds.every((id) => typeof id === 'string' && id.trim().length > 0);
+    }
+    defaultMessage() {
+        return 'manda itemIds no vacío o isoWeek, uno de los dos';
+    }
+};
+exports.IsTransferNoteSelectionConstraint = IsTransferNoteSelectionConstraint;
+exports.IsTransferNoteSelectionConstraint = IsTransferNoteSelectionConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'isTransferNoteSelection', async: false })
+], IsTransferNoteSelectionConstraint);

package/package.json

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

package/src/account/dtos/BankAccountMCSendTransferRequest.ts

@@ -1,10 +1,16 @@
 export class BankAccountMCSendTransferRequest {
     transactionNumber!: string;
     amount!: number;
-    beneficiaryEmail!: string;
-    beneficiaryPhoneNumber!: string;
+    /** Intención por email/teléfono: obligatorios salvo que venga beneficiaryExternalAccountId. */
+    beneficiaryEmail?: string;
+    beneficiaryPhoneNumber?: string;
     beneficiaryName?: string;
     beneficiaryLastName?: string;
     concept?: string;
     externalAccountId?: string;
+    /**
+     * Push directo a una tarjeta del mismo programa (CARD_PUSH_FUNDS): cd_ de la tarjeta del
+     * beneficiario, usuario de Fiado. Si viene, CP acredita en la misma llamada sin intención.
+     */
+    beneficiaryExternalAccountId?: string;
 }

package/src/account/dtos/BankAccountMCSendTransferResponse.ts

@@ -1,7 +1,10 @@
 import { TransactionStatusEnum } from "../../transaction";
 
 export class BankAccountMCSendTransferResponse {
+    /** Ids tx_ de los movimientos contables en CP, unidos por "|". */
     externalTransactionId!: string;
+    /** Id mt_ de la network transfer en CP: sirve para consultar, cancelar o auditar el envío. */
+    externalTransferId?: string;
     transactionStatus!: TransactionStatusEnum;
     transactionNumber!: string;
 }

package/src/index.ts

@@ -232,3 +232,11 @@ export * as TaskManager from './task-manager-business';
 
 // CustomerMessages: historial de mensajes del cliente por venta o crédito, contador de cobranza y envío manual.
 export * as CustomerMessages from './customerMessages';
+
+// TransferNote: contrato de transfer-note-business (notas de transferencia entre partes de un tenant):
+// endpoints públicos, rutas de retailer, espejo privado con author, ajustes y registros de sus feeds.
+export * as TransferNote from './transferNote';
+
+// Reconciliation: contrato de reconciliation-engine-business (definiciones, corridas, partidas y resoluciones),
+// su espejo privado con author, el feed genérico que implementa cada dueño y sus eventos.
+export * as Reconciliation from './reconciliation';

package/src/loanRetailAudit/enums/AuditTrailActionEnum.ts

@@ -36,4 +36,16 @@ export enum AuditTrailActionEnum {
     PAUSE = 'PAUSE',
     RESUME = 'RESUME',
     EXPIRE = 'EXPIRE',
+    // M8: la configuración de notas y de definiciones reusa UPDATE.
+    TRANSFER_NOTE_ISSUE = 'TRANSFER_NOTE_ISSUE',
+    TRANSFER_NOTE_SPEI_CAPTURE = 'TRANSFER_NOTE_SPEI_CAPTURE',
+    TRANSFER_NOTE_SPEI_REVERT = 'TRANSFER_NOTE_SPEI_REVERT',
+    TRANSFER_NOTE_RECEPTION_CONFIRM = 'TRANSFER_NOTE_RECEPTION_CONFIRM',
+    TRANSFER_NOTE_SETTLEMENT_CONFIRM = 'TRANSFER_NOTE_SETTLEMENT_CONFIRM',
+    TRANSFER_NOTE_CANCEL = 'TRANSFER_NOTE_CANCEL',
+    TRANSFER_NOTE_DISPUTE = 'TRANSFER_NOTE_DISPUTE',
+    TRANSFER_NOTE_DISPUTE_RESOLVE = 'TRANSFER_NOTE_DISPUTE_RESOLVE',
+    RECONCILIATION_ITEM_RESOLVE = 'RECONCILIATION_ITEM_RESOLVE',
+    RECONCILIATION_ITEM_REACTIVATE = 'RECONCILIATION_ITEM_REACTIVATE',
+    RECONCILIATION_ITEM_NOTE = 'RECONCILIATION_ITEM_NOTE',
 }

package/src/loanRetailAudit/enums/LoanAuditEntityTypeEnum.ts

@@ -9,4 +9,8 @@ export enum LoanAuditEntityTypeEnum {
     LOAN_PARAMETER = 'LoanParameter',
     LOAN_ASSIGNMENT_RULE = 'LoanAssignmentRule',
     LOAN_COLLECTOR_ASSIGNMENT = 'LoanCollectorAssignment',
+    TRANSFER_NOTE = 'TRANSFER_NOTE',
+    TRANSFER_NOTE_CONFIG = 'TRANSFER_NOTE_CONFIG',
+    RECONCILIATION_DEFINITION = 'RECONCILIATION_DEFINITION',
+    RECONCILIATION_ITEM = 'RECONCILIATION_ITEM',
 }

package/src/reconciliation/constants/reconciliationErrorHttpStatus.ts

@@ -0,0 +1,22 @@
+import { ReconciliationErrorCodeEnum as C } from '../enums/ReconciliationErrorCodeEnum';
+import { ReconciliationFeedErrorCodeEnum } from '../enums/ReconciliationFeedErrorCodeEnum';
+
+/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
+export const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422 | 502>> = {
+    [C.DEFINITION_NOT_FOUND]: 404,
+    [C.RUN_IN_PROGRESS]: 409,
+    [C.ITEM_NOT_FOUND]: 404,
+    [C.ITEM_ALREADY_RESOLVED]: 409,
+    [C.ADJUSTMENT_IN_PROGRESS]: 409,
+    [C.ADJUSTMENT_UNDER_EXECUTED]: 422,
+    [C.ADJUSTMENT_NOT_ALLOWED]: 422,
+    [C.ADJUSTMENT_REJECTED]: 422,
+    [C.ADJUSTMENT_UNAVAILABLE]: 502,
+    [C.ITEM_ADJUSTED]: 409,
+    [C.AUTHOR_NOT_ALLOWED]: 422,
+};
+
+/** Status HTTP de los codes del feed genérico. */
+export const RECONCILIATION_FEED_ERROR_HTTP_STATUS: Readonly<Record<ReconciliationFeedErrorCodeEnum, 404>> = {
+    [ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND]: 404,
+};

package/src/reconciliation/constants/reconciliationValidation.ts

@@ -0,0 +1,11 @@
+/** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
+export const RECONCILIATION_PERIOD_KEY_PATTERN = /^\d{4}-((0[1-9]|1[0-2])(-(0[1-9]|[12]\d|3[01]))?|W(0[1-9]|[1-4]\d|5[0-3]))$/;
+
+/** Mes `YYYY-MM`. */
+export const RECONCILIATION_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
+
+/** Largo mínimo de una nota de investigación. */
+export const RECONCILIATION_MIN_NOTE_LENGTH = 10;
+
+/** Registros por página de un feed de dueño. */
+export const RECONCILIATION_FEED_PAGE_SIZE = 500;

package/src/reconciliation/dtos/ReconciliationDefinition.ts

@@ -0,0 +1,44 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { ReconciliationDefinitionStatusEnum } from '../enums/ReconciliationDefinitionStatusEnum';
+import { ReconciliationFeedConceptEnum } from '../enums/ReconciliationFeedConceptEnum';
+import { ReconciliationFeedOwnerEnum } from '../enums/ReconciliationFeedOwnerEnum';
+import { ReconciliationPeriodEnum } from '../enums/ReconciliationPeriodEnum';
+import { ReconciliationRuleTypeEnum } from '../enums/ReconciliationRuleTypeEnum';
+import { ReconciliationSourceRoleEnum } from '../enums/ReconciliationSourceRoleEnum';
+
+/** Feed que lee una definición; `partName` solo en las piezas de completitud. */
+export interface ReconciliationDefinitionSource {
+    role: ReconciliationSourceRoleEnum;
+    domain: ReconciliationFeedOwnerEnum;
+    concept: ReconciliationFeedConceptEnum;
+    partName?: string;
+}
+
+export interface ReconciliationDefinition {
+    tenantId: string;
+    definitionId: string;
+    /** Módulo de negocio de la definición, p. ej. M8. */
+    module: string;
+    ruleType: ReconciliationRuleTypeEnum;
+    status: ReconciliationDefinitionStatusEnum;
+    sources: ReconciliationDefinitionSource[];
+    /** Nombre del lado para «Falta en {lado}», p. ej. FSA, SK o EdC. */
+    expectedSideName?: string;
+    executedSideName?: string;
+    amountToleranceCents: number;
+    waitBusinessDays: number;
+    period: ReconciliationPeriodEnum;
+    aggregatePeriod?: ReconciliationPeriodEnum;
+    /** Si ADJUST mueve dinero en esta definición. */
+    moneyMovement: boolean;
+    currency: CurrencyId;
+    /** Registros de estos retailers o directorios quedan en TEST. */
+    sandboxRetailerIds: string[];
+    sandboxDirectoryIds: string[];
+    activeFrom?: string;
+    version: number;
+    createdAt: string;
+    createdBy: string;
+    updatedAt: string;
+    updatedBy?: string;
+}

package/src/reconciliation/dtos/ReconciliationFeedRecord.ts

@@ -0,0 +1,44 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { TransferNotePartyTypeEnum } from '../../transferNote/enums/TransferNotePartyTypeEnum';
+import { ReconciliationFeedConceptEnum } from '../enums/ReconciliationFeedConceptEnum';
+
+/** Lista cerrada de ids que un registro de feed puede traer; un registro con otra llave se rechaza. */
+export interface ReconciliationFeedRefs {
+    creditId?: string;
+    saleId?: string;
+    customerId?: string;
+    bonusId?: string;
+    promotionId?: string;
+    attemptId?: string;
+    executionId?: string;
+    transactionId?: string;
+    contractId?: string;
+    directoryId?: string;
+    sellerId?: string;
+    periodId?: string;
+    noteId?: string;
+    itemId?: string;
+    trackingKey?: string;
+    /** Marca de reversa: el registro original que esta fila compensa. */
+    reversesRecordId?: string;
+    retailerId?: string;
+    counterpartyId?: string;
+}
+
+/** Forma base de un registro de `GET /private/reconciliation-feeds/{concept}`; una reversa es una fila nueva. */
+export interface ReconciliationFeedRecord {
+    recordId: string;
+    tenantId: string;
+    concept: ReconciliationFeedConceptEnum;
+    /** Llave con la que el motor empareja esperado y ejecutado. */
+    matchKey: string;
+    /** Centavos con signo; una reversa trae el signo contrario a su original. */
+    amountCents: number;
+    currency: CurrencyId;
+    /** Fecha del movimiento en el origen, ISO 8601. */
+    occurredAt: string;
+    /** Día CDMX `YYYY-MM-DD` del índice del dueño. */
+    feedDay: string;
+    counterpartyType?: TransferNotePartyTypeEnum;
+    refs: ReconciliationFeedRefs;
+}

package/src/reconciliation/dtos/ReconciliationItem.ts

@@ -0,0 +1,84 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+import { ReconciliationFeedConceptEnum } from '../enums/ReconciliationFeedConceptEnum';
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationLayerEnum } from '../enums/ReconciliationLayerEnum';
+import { ReconciliationResolutionArchiveReasonEnum } from '../enums/ReconciliationResolutionArchiveReasonEnum';
+import { ReconciliationResolutionStatusEnum } from '../enums/ReconciliationResolutionStatusEnum';
+import { ReconciliationResolutionTypeEnum } from '../enums/ReconciliationResolutionTypeEnum';
+import { ReconciliationFeedRefs } from './ReconciliationFeedRecord';
+
+/** Un lado de la partida tal como llegó del feed. */
+export interface ReconciliationItemSide {
+    recordId: string;
+    amountCents: number;
+    occurredAt: string;
+    refs: ReconciliationFeedRefs;
+}
+
+/** Pieza de completitud: sin `recordId` es la caja vacía. */
+export interface ReconciliationItemPart {
+    partName: string;
+    concept: ReconciliationFeedConceptEnum;
+    recordId?: string;
+    amountCents?: number;
+    noteId?: string;
+}
+
+export interface ReconciliationResolution {
+    type: ReconciliationResolutionTypeEnum;
+    status: ReconciliationResolutionStatusEnum;
+    reason: string;
+    resolvedBy: string;
+    resolvedAt: string;
+    version: number;
+    /** Llave idempotente del ajuste al cliente; lleva tenantId. */
+    adjustmentKey?: string;
+    adjustmentTransactionId?: string;
+    adjustmentItemId?: string;
+    adjustedAmountCents?: number;
+}
+
+export interface ReconciliationResolutionHistoryEntry extends ReconciliationResolution {
+    archivedAt: string;
+    archivedBy: string;
+    archiveReason: ReconciliationResolutionArchiveReasonEnum;
+}
+
+export interface ReconciliationItemNote {
+    text: string;
+    author: string;
+    createdAt: string;
+}
+
+/** Partida persistente; `itemKey` es `{concept}#{matchKey}`. */
+export interface ReconciliationItem {
+    tenantId: string;
+    definitionId: string;
+    itemKey: string;
+    concept: ReconciliationFeedConceptEnum;
+    matchKey: string;
+    layer: ReconciliationLayerEnum;
+    periodKey: string;
+    state: ReconciliationItemStateEnum;
+    currency: CurrencyId;
+    counterpartyId?: string;
+    expected?: ReconciliationItemSide;
+    executed?: ReconciliationItemSide;
+    parts?: ReconciliationItemPart[];
+    differenceCents?: number;
+    resolution?: ReconciliationResolution;
+    firstSeenRunId: string;
+    lastSeenRunId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/** Los 6 campos de MAX-14, consultados en vivo; el que falle se omite. */
+export interface ReconciliationItemLiveDetail {
+    customerName?: string;
+    customerPhone?: string;
+    creditId?: string;
+    amountCents?: number;
+    productModel?: string;
+    sellerName?: string;
+}

package/src/reconciliation/dtos/ReconciliationRun.ts

@@ -0,0 +1,31 @@
+import { ReconciliationFeedConceptEnum } from '../enums/ReconciliationFeedConceptEnum';
+import { ReconciliationFeedOwnerEnum } from '../enums/ReconciliationFeedOwnerEnum';
+import { ReconciliationItemStateEnum } from '../enums/ReconciliationItemStateEnum';
+import { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStatusEnum';
+
+export interface ReconciliationStateCount {
+    state: ReconciliationItemStateEnum;
+    count: number;
+}
+
+/** Feed que no respondió en la corrida. */
+export interface ReconciliationRunFeedFailure {
+    domain: ReconciliationFeedOwnerEnum;
+    concept: ReconciliationFeedConceptEnum;
+    /** Code que devolvió el dueño del feed; queda abierto porque cada lambda trae su catálogo. */
+    errorCode: string;
+}
+
+export interface ReconciliationRun {
+    runId: string;
+    tenantId: string;
+    definitionId: string;
+    periodKey: string;
+    status: ReconciliationRunStatusEnum;
+    countsByState: ReconciliationStateCount[];
+    rejectedRecordCount: number;
+    failedFeeds?: ReconciliationRunFeedFailure[];
+    startedAt: string;
+    finishedAt?: string;
+    startedBy: string;
+}