@fiado/type-kit 3.621.0 → 3.623.0

package/_test_/unit/reconciliation/m8AdditiveBatch.test.ts

@@ -0,0 +1,101 @@
+import 'reflect-metadata';
+import * as Reconciliation from '../../../src/reconciliation';
+import * as TransferNote from '../../../src/transferNote';
+import * as TransactionProcessor from '../../../src/transactionProcessor';
+import { CurrencyId } from '../../../src/currency/enums/CurrencyId';
+
+const { TransferNoteErrorCodeEnum: TN, TRANSFER_NOTE_ERROR_HTTP_STATUS } = TransferNote;
+const { ReconciliationErrorCodeEnum: RC, RECONCILIATION_ERROR_HTTP_STATUS } = Reconciliation;
+const { ReconciliationAdjustmentErrorCodeEnum: RA, RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS } = TransactionProcessor;
+
+describe('codes de transfer-note con su status', () => {
+    it.each([
+        [TN.NOTE_DISPUTED, 409],
+        [TN.NOT_NOTE_PAYER, 422],
+        [TN.NOTE_NOT_SENT, 409],
+        [TN.NOT_NOTE_PAYEE, 422],
+        [TN.SETTLEMENT_NOT_REQUIRED, 422],
+        [TN.DISPUTE_ON_PAID_NOTE_PENDING_DECISION, 409],
+        [TN.ADJUSTMENT_KEY_CONFLICT, 409],
+        [TN.CONTACT_EMAIL_MISSING, 422],
+        [TN.NOTICE_PUBLISH_FAILED, 502],
+        [TN.BANK_CALENDAR_UNAVAILABLE, 502],
+        [TN.CUTOFF_DISPATCH_FAILED, 502],
+        [TN.CONCURRENT_WRITE_CONFLICT, 409],
+        [TN.AUDIT_QUEUE_PUBLISH_FAILED, 502],
+    ])('%s responde %d', (code, status) => {
+        expect(code).toBeDefined();
+        expect(TRANSFER_NOTE_ERROR_HTTP_STATUS[code]).toBe(status);
+    });
+});
+
+describe('codes del motor con su status', () => {
+    it.each([
+        [RC.INVALID_DEFINITION_STATUS_TRANSITION, 409],
+        [RC.DEFINITION_ACTIVE_FROM_REQUIRED, 422],
+        [RC.DEFINITION_NOT_RUNNABLE, 409],
+        [RC.RULE_TYPE_NOT_SUPPORTED, 422],
+        [RC.BANK_CALENDAR_UNAVAILABLE, 502],
+        [RC.RUN_DISPATCH_FAILED, 502],
+        [RC.BANK_STATEMENT_UNAVAILABLE, 502],
+        [RC.INVALID_SEED_TENANT, 400],
+    ])('%s responde %d', (code, status) => {
+        expect(code).toBeDefined();
+        expect(RECONCILIATION_ERROR_HTTP_STATUS[code]).toBe(status);
+    });
+});
+
+describe('codes del ajuste en el processor', () => {
+    it('el catálogo es exactamente el del ajuste', () => {
+        expect(Object.values(RA).sort()).toEqual([
+            'ADJUSTMENT_IN_PROGRESS',
+            'ADJUSTMENT_KEY_CONFLICT',
+            'ADJUSTMENT_OUTCOME_UNKNOWN',
+            'ADJUSTMENT_REJECTED',
+            'ADJUSTMENT_UNAVAILABLE',
+            'AUTHOR_NOT_ALLOWED',
+            'COLLECTION_TENANT_MISSING',
+        ]);
+    });
+
+    it.each([
+        [RA.ADJUSTMENT_KEY_CONFLICT, 409],
+        [RA.ADJUSTMENT_IN_PROGRESS, 409],
+        [RA.ADJUSTMENT_OUTCOME_UNKNOWN, 409],
+        [RA.ADJUSTMENT_REJECTED, 422],
+        [RA.ADJUSTMENT_UNAVAILABLE, 502],
+        [RA.AUTHOR_NOT_ALLOWED, 422],
+        [RA.COLLECTION_TENANT_MISSING, 400],
+    ])('%s responde %d', (code, status) => {
+        expect(RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS[code]).toBe(status);
+    });
+});
+
+describe('evento TransferNoteIssued', () => {
+    it('vive en transferNote con su source y detailType', () => {
+        expect(TransferNote.TRANSFER_NOTE_EVENTS_SOURCE).toBe('fiado.transferNote');
+        expect(TransferNote.TransferNoteEventDetailTypeEnum.TRANSFER_NOTE_ISSUED).toBe('transferNote.TransferNoteIssued');
+        expect(TransferNote.TransferNoteEventDetailTypeEnum.TRANSFER_NOTE_RECONCILED).toBe('transferNote.TransferNoteReconciled');
+        const detail: TransferNote.TransferNoteIssuedEventDetail = {
+            eventId: 'surekeep#n-1#ISSUED',
+            tenantId: 'surekeep',
+            noteId: 'n-1',
+            pairKey: 'FSA#SK',
+            isoWeek: '2026-W44',
+            netAmountCents: 125000,
+            currency: CurrencyId.MXN,
+            issuedAt: '2026-10-27T06:01:00.000Z',
+            dueAt: '2026-10-29T06:00:00.000Z',
+        };
+        expect(detail.dueAt).toBe('2026-10-29T06:00:00.000Z');
+    });
+});
+
+describe('liquidación con la cuenta destino capturada', () => {
+    it('paidToClabe es opcional y sigue el patrón de CLABE', () => {
+        const paidTo: TransferNote.TransferNoteSettlementFeedRecord['paidToClabe'] = '012180009876543210';
+        const notCaptured: TransferNote.TransferNoteSettlementFeedRecord['paidToClabe'] = undefined;
+        expect(TransferNote.TRANSFER_NOTE_CLABE_PATTERN.test(paidTo ?? '')).toBe(true);
+        expect(notCaptured).toBeUndefined();
+    });
+});

package/_test_/unit/reconciliation/m8EngineBatch.test.ts

@@ -0,0 +1,81 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validateSync } from 'class-validator';
+import * as Reconciliation from '../../../src/reconciliation';
+
+const {
+    ConfigureReconciliationDefinitionRequest,
+    PrivateConfigureReconciliationDefinitionRequest,
+    ListReconciliationItemsQuery,
+    PrivateListReconciliationItemsQuery,
+    ReconciliationResolutionStatusEnum,
+    ReconciliationResolutionArchiveReasonEnum: AR,
+    ReconciliationErrorCodeEnum: RC,
+    RECONCILIATION_ERROR_HTTP_STATUS,
+} = Reconciliation;
+
+function errorsOf<T extends object>(cls: new () => T, payload: Record<string, unknown>): string[] {
+    const dto = plainToInstance(cls, payload, { excludeExtraneousValues: true });
+    return validateSync(dto).map((e) => e.property);
+}
+
+const operator = { tenantId: 'surekeep', author: 'conciliacion-dashboard', actorId: 'aZ3x9Qk-azure-ad-sub_01' };
+
+describe('resolutionStatus en la lista de partidas', () => {
+    it.each([
+        [ListReconciliationItemsQuery, { definitionId: 'd1' }],
+        [PrivateListReconciliationItemsQuery, { definitionId: 'd1', ...operator }],
+    ])('%p acepta el enum y rechaza otro valor', (cls, base) => {
+        const ok = plainToInstance(cls as never, { ...base, resolutionStatus: 'ADJUSTED' }, { excludeExtraneousValues: true }) as { resolutionStatus?: string };
+        expect(ok.resolutionStatus).toBe(ReconciliationResolutionStatusEnum.ADJUSTED);
+        expect(errorsOf(cls as never, { ...base, resolutionStatus: 'ADJUSTED' })).toEqual([]);
+        expect(errorsOf(cls as never, base)).toEqual([]);
+        expect(errorsOf(cls as never, { ...base, resolutionStatus: 'NOPE' })).toEqual(['resolutionStatus']);
+    });
+});
+
+describe('ajustes de banco en configurar definición', () => {
+    const accounts = [{ bank: 'BANORTE', account: '0123_45-6' }];
+    it.each([
+        [ConfigureReconciliationDefinitionRequest, { status: 'ACTIVE' }],
+        [PrivateConfigureReconciliationDefinitionRequest, { status: 'ACTIVE', ...operator }],
+    ])('%p valida los tres campos', (cls, base) => {
+        const ok = { ...base, bankAccounts: accounts, statementGraceBusinessDays: 30, fillPayeeConfirmationOnCredit: true };
+        expect(errorsOf(cls as never, ok)).toEqual([]);
+        expect(errorsOf(cls as never, base)).toEqual([]);
+        const dto = plainToInstance(cls as never, ok, { excludeExtraneousValues: true }) as { bankAccounts?: object[] };
+        expect(dto.bankAccounts?.[0]).toEqual(accounts[0]);
+        expect(errorsOf(cls as never, { ...base, bankAccounts: [{ bank: 'BAN/ORTE', account: '1' }] })).toEqual(['bankAccounts']);
+        expect(errorsOf(cls as never, { ...base, bankAccounts: [{ bank: 'B', account: 'x'.repeat(129) }] })).toEqual(['bankAccounts']);
+        expect(errorsOf(cls as never, { ...base, bankAccounts: Array.from({ length: 11 }, (_, i) => ({ bank: 'B', account: `${i}` })) })).toEqual(['bankAccounts']);
+        expect(errorsOf(cls as never, { ...base, statementGraceBusinessDays: 31 })).toEqual(['statementGraceBusinessDays']);
+        expect(errorsOf(cls as never, { ...base, statementGraceBusinessDays: -1 })).toEqual(['statementGraceBusinessDays']);
+        expect(errorsOf(cls as never, { ...base, fillPayeeConfirmationOnCredit: 'yes' })).toEqual(['fillPayeeConfirmationOnCredit']);
+    });
+
+    it('la respuesta de definición admite los ajustes de banco', () => {
+        const settings: Pick<Reconciliation.ReconciliationDefinition, 'bankAccounts' | 'statementGraceBusinessDays' | 'fillPayeeConfirmationOnCredit'> = {
+            bankAccounts: [{ bank: 'BANORTE', account: '1' }],
+            statementGraceBusinessDays: 3,
+            fillPayeeConfirmationOnCredit: false,
+        };
+        expect(settings.bankAccounts).toHaveLength(1);
+    });
+});
+
+describe('motivos de archivo nuevos', () => {
+    it.each(['SUPERSEDED', 'ADJUSTMENT_REJECTED'])('%s existe', (reason) => {
+        expect(Object.values(AR)).toContain(reason);
+    });
+});
+
+describe('codes nuevos del motor con su status', () => {
+    it.each([
+        ['ADJUSTMENT_NEEDS_REVIEW', 409],
+        ['ADJUSTMENT_REFERENCE_MISSING', 422],
+        ['BANK_ACCOUNTS_NOT_CONFIGURED', 409],
+    ])('%s responde %d', (code, status) => {
+        expect(Object.values(RC)).toContain(code);
+        expect(RECONCILIATION_ERROR_HTTP_STATUS[code as Reconciliation.ReconciliationErrorCodeEnum]).toBe(status);
+    });
+});

package/_test_/unit/transferNote/transferNoteEventsAndFeeds.test.ts

@@ -58,6 +58,26 @@ describe('registros de feed de notas con la forma base', () => {
         expect(Object.keys(reversal)).not.toContain('noteId');
     });
 
+    it('un item de ajuste apunta al item original que corrige', () => {
+        const adjustment: TransferNote.TransferNoteItemFeedRecord = {
+            recordId: 'it-3',
+            tenantId: 'surekeep',
+            concept: ReconciliationFeedConceptEnum.TRANSFER_NOTE_ITEM,
+            matchKey: 'att-1',
+            amountCents: -500,
+            currency: CurrencyId.MXN,
+            occurredAt: '2026-10-28T15:00:00.000Z',
+            feedDay: '2026-10-28',
+            refs: { noteId: 'n-2', itemId: 'it-3' },
+            itemConcept: TransferNoteConceptEnum.ADJUSTMENT,
+            pairKey: 'FSA#SK',
+            sourceRecordId: 'it-1',
+            includedAt: '2026-10-28T06:01:00.000Z',
+            adjustedItemId: 'it-1',
+        };
+        expect(adjustment.adjustedItemId).toBe('it-1');
+    });
+
     it('la liquidación de una nota se lee con el cliente genérico', () => {
         const settlement: TransferNote.TransferNoteSettlementFeedRecord = {
             recordId: 'n-1',

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.d.ts

@@ -1,6 +1,6 @@
 import { ReconciliationErrorCodeEnum as C } from '../enums/ReconciliationErrorCodeEnum';
-/** Status HTTP de cada code: 404 no existe · 409 conflicto de estado · 422 regla de negocio · 502 falló el dueño del dinero. */
-export declare const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 422 | 502>>;
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export declare const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422 | 502>>;
 /** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
 export declare const RECONCILIATION_FEED_ERROR_HTTP_STATUS: {
     readonly FEED_RECORD_NOT_FOUND: 404;

package/bin/reconciliation/constants/reconciliationErrorHttpStatus.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = exports.RECONCILIATION_ERROR_HTTP_STATUS = void 0;
 const ReconciliationErrorCodeEnum_1 = require("../enums/ReconciliationErrorCodeEnum");
 const ReconciliationFeedErrorCodeEnum_1 = require("../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. */
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
 exports.RECONCILIATION_ERROR_HTTP_STATUS = {
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.DEFINITION_NOT_FOUND]: 404,
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.RUN_IN_PROGRESS]: 409,
@@ -16,6 +16,17 @@ exports.RECONCILIATION_ERROR_HTTP_STATUS = {
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_UNAVAILABLE]: 502,
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ITEM_ADJUSTED]: 409,
     [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.INVALID_DEFINITION_STATUS_TRANSITION]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.DEFINITION_ACTIVE_FROM_REQUIRED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.DEFINITION_NOT_RUNNABLE]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.RULE_TYPE_NOT_SUPPORTED]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.BANK_CALENDAR_UNAVAILABLE]: 502,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.RUN_DISPATCH_FAILED]: 502,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.BANK_STATEMENT_UNAVAILABLE]: 502,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.INVALID_SEED_TENANT]: 400,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_NEEDS_REVIEW]: 409,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.ADJUSTMENT_REFERENCE_MISSING]: 422,
+    [ReconciliationErrorCodeEnum_1.ReconciliationErrorCodeEnum.BANK_ACCOUNTS_NOT_CONFIGURED]: 409,
 };
 /** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */
 exports.RECONCILIATION_FEED_ERROR_HTTP_STATUS = {

package/bin/reconciliation/constants/reconciliationValidation.d.ts

@@ -4,5 +4,13 @@ export declare const RECONCILIATION_PERIOD_KEY_PATTERN: RegExp;
 export declare const RECONCILIATION_MONTH_PATTERN: RegExp;
 /** Largo mínimo de una nota de investigación. */
 export declare const RECONCILIATION_MIN_NOTE_LENGTH = 10;
+/** Banco o cuenta del EdC: forman la ruta `EDO_CTA/{bank}/{account}/` del bucket. */
+export declare const RECONCILIATION_BANK_PATH_SEGMENT_PATTERN: RegExp;
+/** Largo máximo de un banco o una cuenta del EdC. */
+export declare const RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = 128;
+/** Cuentas de banco por definición. */
+export declare const RECONCILIATION_MAX_BANK_ACCOUNTS = 10;
+/** Días hábiles máximos de espera del EdC. */
+export declare const RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
 /** Registros por página de un feed de dueño. */
 export declare const RECONCILIATION_FEED_PAGE_SIZE = 500;

package/bin/reconciliation/constants/reconciliationValidation.js

@@ -1,11 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RECONCILIATION_FEED_PAGE_SIZE = exports.RECONCILIATION_MIN_NOTE_LENGTH = exports.RECONCILIATION_MONTH_PATTERN = exports.RECONCILIATION_PERIOD_KEY_PATTERN = void 0;
+exports.RECONCILIATION_FEED_PAGE_SIZE = exports.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = exports.RECONCILIATION_MAX_BANK_ACCOUNTS = exports.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = exports.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN = exports.RECONCILIATION_MIN_NOTE_LENGTH = exports.RECONCILIATION_MONTH_PATTERN = exports.RECONCILIATION_PERIOD_KEY_PATTERN = void 0;
 /** Periodo de una corrida: día `YYYY-MM-DD`, semana ISO `YYYY-Www` o mes `YYYY-MM`. */
 exports.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`. */
 exports.RECONCILIATION_MONTH_PATTERN = /^\d{4}-(0[1-9]|1[0-2])$/;
 /** Largo mínimo de una nota de investigación. */
 exports.RECONCILIATION_MIN_NOTE_LENGTH = 10;
+/** Banco o cuenta del EdC: forman la ruta `EDO_CTA/{bank}/{account}/` del bucket. */
+exports.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9_-]+$/;
+/** Largo máximo de un banco o una cuenta del EdC. */
+exports.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = 128;
+/** Cuentas de banco por definición. */
+exports.RECONCILIATION_MAX_BANK_ACCOUNTS = 10;
+/** Días hábiles máximos de espera del EdC. */
+exports.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
 /** Registros por página de un feed de dueño. */
 exports.RECONCILIATION_FEED_PAGE_SIZE = 500;

package/bin/reconciliation/dtos/ReconciliationDefinition.d.ts

@@ -12,6 +12,11 @@ export interface ReconciliationDefinitionSource {
     concept: ReconciliationFeedConceptEnum;
     partName?: string;
 }
+/** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
+export interface ReconciliationDefinitionBankAccountView {
+    bank: string;
+    account: string;
+}
 export interface ReconciliationDefinition {
     tenantId: string;
     definitionId: string;
@@ -34,6 +39,10 @@ export interface ReconciliationDefinition {
     sandboxRetailerIds: string[];
     sandboxDirectoryIds: string[];
     activeFrom?: string;
+    /** Ajustes del EdC; solo en las definiciones BANK_STATEMENT. */
+    bankAccounts?: ReconciliationDefinitionBankAccountView[];
+    statementGraceBusinessDays?: number;
+    fillPayeeConfirmationOnCredit?: boolean;
     version: number;
     createdAt: string;
     createdBy: string;

package/bin/reconciliation/dtos/requests/ReconciliationActionRequests.d.ts

@@ -1,5 +1,10 @@
 import { ReconciliationDefinitionStatusEnum } from '../../enums/ReconciliationDefinitionStatusEnum';
 import { ReconciliationResolutionTypeEnum } from '../../enums/ReconciliationResolutionTypeEnum';
+/** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
+export declare class ReconciliationDefinitionBankAccount {
+    bank: string;
+    account: string;
+}
 /** Body de publicConfigureReconciliationDefinition. */
 export declare class ConfigureReconciliationDefinitionRequest {
     status: ReconciliationDefinitionStatusEnum;
@@ -9,6 +14,10 @@ export declare class ConfigureReconciliationDefinitionRequest {
     sandboxRetailerIds?: string[];
     sandboxDirectoryIds?: string[];
     activeFrom?: string;
+    /** Reemplaza la lista completa de cuentas del EdC. */
+    bankAccounts?: ReconciliationDefinitionBankAccount[];
+    statementGraceBusinessDays?: number;
+    fillPayeeConfirmationOnCredit?: boolean;
 }
 /** Body de publicRunReconciliation: responde 202 con `runId` y corre asíncrono. */
 export declare class RunReconciliationRequest {

package/bin/reconciliation/dtos/requests/ReconciliationActionRequests.js

@@ -9,12 +9,31 @@ 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.AddReconciliationItemNoteRequest = exports.ReactivateReconciliationItemRequest = exports.ResolveReconciliationItemRequest = exports.RunReconciliationRequest = exports.ConfigureReconciliationDefinitionRequest = void 0;
+exports.AddReconciliationItemNoteRequest = exports.ReactivateReconciliationItemRequest = exports.ResolveReconciliationItemRequest = exports.RunReconciliationRequest = exports.ConfigureReconciliationDefinitionRequest = exports.ReconciliationDefinitionBankAccount = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const reconciliationValidation_1 = require("../../constants/reconciliationValidation");
 const ReconciliationDefinitionStatusEnum_1 = require("../../enums/ReconciliationDefinitionStatusEnum");
 const ReconciliationResolutionTypeEnum_1 = require("../../enums/ReconciliationResolutionTypeEnum");
 const reconciliationRequestDecorators_1 = require("./reconciliationRequestDecorators");
+/** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
+class ReconciliationDefinitionBankAccount {
+}
+exports.ReconciliationDefinitionBankAccount = ReconciliationDefinitionBankAccount;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(reconciliationValidation_1.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH),
+    (0, class_validator_1.Matches)(reconciliationValidation_1.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN),
+    __metadata("design:type", String)
+], ReconciliationDefinitionBankAccount.prototype, "bank", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(reconciliationValidation_1.RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH),
+    (0, class_validator_1.Matches)(reconciliationValidation_1.RECONCILIATION_BANK_PATH_SEGMENT_PATTERN),
+    __metadata("design:type", String)
+], ReconciliationDefinitionBankAccount.prototype, "account", void 0);
 /** Body de publicConfigureReconciliationDefinition. */
 class ConfigureReconciliationDefinitionRequest {
 }
@@ -62,6 +81,29 @@ __decorate([
     (0, class_validator_1.IsISO8601)(),
     __metadata("design:type", String)
 ], ConfigureReconciliationDefinitionRequest.prototype, "activeFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(reconciliationValidation_1.RECONCILIATION_MAX_BANK_ACCOUNTS),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ReconciliationDefinitionBankAccount),
+    __metadata("design:type", Array)
+], ConfigureReconciliationDefinitionRequest.prototype, "bankAccounts", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(reconciliationValidation_1.RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS),
+    __metadata("design:type", Number)
+], ConfigureReconciliationDefinitionRequest.prototype, "statementGraceBusinessDays", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ConfigureReconciliationDefinitionRequest.prototype, "fillPayeeConfirmationOnCredit", void 0);
 /** Body de publicRunReconciliation: responde 202 con `runId` y corre asíncrono. */
 class RunReconciliationRequest {
 }

package/bin/reconciliation/dtos/requests/ReconciliationQueries.d.ts

@@ -4,6 +4,7 @@ import { ReconciliationExportFormatEnum } from '../../enums/ReconciliationExport
 import { ReconciliationFeedConceptEnum } from '../../enums/ReconciliationFeedConceptEnum';
 import { ReconciliationItemStateEnum } from '../../enums/ReconciliationItemStateEnum';
 import { ReconciliationLayerEnum } from '../../enums/ReconciliationLayerEnum';
+import { ReconciliationResolutionStatusEnum } from '../../enums/ReconciliationResolutionStatusEnum';
 import { ReconciliationRuleTypeEnum } from '../../enums/ReconciliationRuleTypeEnum';
 import { ReconciliationRunStatusEnum } from '../../enums/ReconciliationRunStatusEnum';
 /** Query de publicListReconciliationDefinitions. */
@@ -49,6 +50,7 @@ export declare class ListReconciliationItemsQuery {
     concept?: ReconciliationFeedConceptEnum;
     counterpartyId?: string;
     format?: ReconciliationExportFormatEnum;
+    resolutionStatus?: ReconciliationResolutionStatusEnum;
     limit?: number;
     nextToken?: string;
 }

package/bin/reconciliation/dtos/requests/ReconciliationQueries.js

@@ -19,6 +19,7 @@ const ReconciliationExportFormatEnum_1 = require("../../enums/ReconciliationExpo
 const ReconciliationFeedConceptEnum_1 = require("../../enums/ReconciliationFeedConceptEnum");
 const ReconciliationItemStateEnum_1 = require("../../enums/ReconciliationItemStateEnum");
 const ReconciliationLayerEnum_1 = require("../../enums/ReconciliationLayerEnum");
+const ReconciliationResolutionStatusEnum_1 = require("../../enums/ReconciliationResolutionStatusEnum");
 const ReconciliationRuleTypeEnum_1 = require("../../enums/ReconciliationRuleTypeEnum");
 const ReconciliationRunStatusEnum_1 = require("../../enums/ReconciliationRunStatusEnum");
 const reconciliationRequestDecorators_1 = require("./reconciliationRequestDecorators");
@@ -182,6 +183,12 @@ __decorate([
     (0, class_validator_1.IsEnum)(ReconciliationExportFormatEnum_1.ReconciliationExportFormatEnum),
     __metadata("design:type", String)
 ], ListReconciliationItemsQuery.prototype, "format", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(ReconciliationResolutionStatusEnum_1.ReconciliationResolutionStatusEnum),
+    __metadata("design:type", String)
+], ListReconciliationItemsQuery.prototype, "resolutionStatus", void 0);
 __decorate([
     (0, reconciliationRequestDecorators_1.PageLimit)(),
     __metadata("design:type", Number)

package/bin/reconciliation/enums/ReconciliationErrorCodeEnum.d.ts

@@ -20,5 +20,21 @@ export declare enum ReconciliationErrorCodeEnum {
     /** Una partida ajustada no se reactiva. */
     ITEM_ADJUSTED = "ITEM_ADJUSTED",
     /** El `author` del espejo privado no está en la lista permitida del lambda. */
-    AUTHOR_NOT_ALLOWED = "AUTHOR_NOT_ALLOWED"
+    AUTHOR_NOT_ALLOWED = "AUTHOR_NOT_ALLOWED",
+    INVALID_DEFINITION_STATUS_TRANSITION = "INVALID_DEFINITION_STATUS_TRANSITION",
+    /** Activar una definición exige su fecha de inicio. */
+    DEFINITION_ACTIVE_FROM_REQUIRED = "DEFINITION_ACTIVE_FROM_REQUIRED",
+    /** La definición no está activa o aún no entra en vigor. */
+    DEFINITION_NOT_RUNNABLE = "DEFINITION_NOT_RUNNABLE",
+    RULE_TYPE_NOT_SUPPORTED = "RULE_TYPE_NOT_SUPPORTED",
+    BANK_CALENDAR_UNAVAILABLE = "BANK_CALENDAR_UNAVAILABLE",
+    RUN_DISPATCH_FAILED = "RUN_DISPATCH_FAILED",
+    BANK_STATEMENT_UNAVAILABLE = "BANK_STATEMENT_UNAVAILABLE",
+    INVALID_SEED_TENANT = "INVALID_SEED_TENANT",
+    /** El ajuste quedó con resultado incierto y se revisa a mano. */
+    ADJUSTMENT_NEEDS_REVIEW = "ADJUSTMENT_NEEDS_REVIEW",
+    /** A la partida le falta la referencia que pide el ajuste. */
+    ADJUSTMENT_REFERENCE_MISSING = "ADJUSTMENT_REFERENCE_MISSING",
+    /** La definición de banco no tiene cuentas configuradas. */
+    BANK_ACCOUNTS_NOT_CONFIGURED = "BANK_ACCOUNTS_NOT_CONFIGURED"
 }

package/bin/reconciliation/enums/ReconciliationErrorCodeEnum.js

@@ -25,4 +25,20 @@ var ReconciliationErrorCodeEnum;
     ReconciliationErrorCodeEnum["ITEM_ADJUSTED"] = "ITEM_ADJUSTED";
     /** El `author` del espejo privado no está en la lista permitida del lambda. */
     ReconciliationErrorCodeEnum["AUTHOR_NOT_ALLOWED"] = "AUTHOR_NOT_ALLOWED";
+    ReconciliationErrorCodeEnum["INVALID_DEFINITION_STATUS_TRANSITION"] = "INVALID_DEFINITION_STATUS_TRANSITION";
+    /** Activar una definición exige su fecha de inicio. */
+    ReconciliationErrorCodeEnum["DEFINITION_ACTIVE_FROM_REQUIRED"] = "DEFINITION_ACTIVE_FROM_REQUIRED";
+    /** La definición no está activa o aún no entra en vigor. */
+    ReconciliationErrorCodeEnum["DEFINITION_NOT_RUNNABLE"] = "DEFINITION_NOT_RUNNABLE";
+    ReconciliationErrorCodeEnum["RULE_TYPE_NOT_SUPPORTED"] = "RULE_TYPE_NOT_SUPPORTED";
+    ReconciliationErrorCodeEnum["BANK_CALENDAR_UNAVAILABLE"] = "BANK_CALENDAR_UNAVAILABLE";
+    ReconciliationErrorCodeEnum["RUN_DISPATCH_FAILED"] = "RUN_DISPATCH_FAILED";
+    ReconciliationErrorCodeEnum["BANK_STATEMENT_UNAVAILABLE"] = "BANK_STATEMENT_UNAVAILABLE";
+    ReconciliationErrorCodeEnum["INVALID_SEED_TENANT"] = "INVALID_SEED_TENANT";
+    /** El ajuste quedó con resultado incierto y se revisa a mano. */
+    ReconciliationErrorCodeEnum["ADJUSTMENT_NEEDS_REVIEW"] = "ADJUSTMENT_NEEDS_REVIEW";
+    /** A la partida le falta la referencia que pide el ajuste. */
+    ReconciliationErrorCodeEnum["ADJUSTMENT_REFERENCE_MISSING"] = "ADJUSTMENT_REFERENCE_MISSING";
+    /** La definición de banco no tiene cuentas configuradas. */
+    ReconciliationErrorCodeEnum["BANK_ACCOUNTS_NOT_CONFIGURED"] = "BANK_ACCOUNTS_NOT_CONFIGURED";
 })(ReconciliationErrorCodeEnum || (exports.ReconciliationErrorCodeEnum = ReconciliationErrorCodeEnum = {}));

package/bin/reconciliation/enums/ReconciliationResolutionArchiveReasonEnum.d.ts

@@ -2,5 +2,9 @@
 export declare enum ReconciliationResolutionArchiveReasonEnum {
     REACTIVATED = "REACTIVATED",
     /** La corrida encontró que ambos lados ya cuadran. */
-    MATCHED_ON_RECALCULATION = "MATCHED_ON_RECALCULATION"
+    MATCHED_ON_RECALCULATION = "MATCHED_ON_RECALCULATION",
+    /** Otra resolución la reemplazó. */
+    SUPERSEDED = "SUPERSEDED",
+    /** El dueño del dinero rechazó el ajuste. */
+    ADJUSTMENT_REJECTED = "ADJUSTMENT_REJECTED"
 }

package/bin/reconciliation/enums/ReconciliationResolutionArchiveReasonEnum.js

@@ -7,4 +7,8 @@ var ReconciliationResolutionArchiveReasonEnum;
     ReconciliationResolutionArchiveReasonEnum["REACTIVATED"] = "REACTIVATED";
     /** La corrida encontró que ambos lados ya cuadran. */
     ReconciliationResolutionArchiveReasonEnum["MATCHED_ON_RECALCULATION"] = "MATCHED_ON_RECALCULATION";
+    /** Otra resolución la reemplazó. */
+    ReconciliationResolutionArchiveReasonEnum["SUPERSEDED"] = "SUPERSEDED";
+    /** El dueño del dinero rechazó el ajuste. */
+    ReconciliationResolutionArchiveReasonEnum["ADJUSTMENT_REJECTED"] = "ADJUSTMENT_REJECTED";
 })(ReconciliationResolutionArchiveReasonEnum || (exports.ReconciliationResolutionArchiveReasonEnum = ReconciliationResolutionArchiveReasonEnum = {}));

package/bin/transactionProcessor/constants/reconciliationAdjustmentErrorHttpStatus.d.ts

@@ -0,0 +1,3 @@
+import { ReconciliationAdjustmentErrorCodeEnum as C } from '../enums/ReconciliationAdjustmentErrorCodeEnum';
+/** Status HTTP de cada code: 400 request inválido · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export declare const RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 409 | 422 | 502>>;

package/bin/transactionProcessor/constants/reconciliationAdjustmentErrorHttpStatus.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS = void 0;
+const ReconciliationAdjustmentErrorCodeEnum_1 = require("../enums/ReconciliationAdjustmentErrorCodeEnum");
+/** Status HTTP de cada code: 400 request inválido · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+exports.RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS = {
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.ADJUSTMENT_KEY_CONFLICT]: 409,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.ADJUSTMENT_IN_PROGRESS]: 409,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.ADJUSTMENT_OUTCOME_UNKNOWN]: 409,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.ADJUSTMENT_REJECTED]: 422,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.ADJUSTMENT_UNAVAILABLE]: 502,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.AUTHOR_NOT_ALLOWED]: 422,
+    [ReconciliationAdjustmentErrorCodeEnum_1.ReconciliationAdjustmentErrorCodeEnum.COLLECTION_TENANT_MISSING]: 400,
+};

package/bin/transactionProcessor/enums/ReconciliationAdjustmentErrorCodeEnum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Codes de error del ajuste de conciliación en transaction-processor; el status de cada uno está en
+ * `RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS`.
+ */
+export declare enum ReconciliationAdjustmentErrorCodeEnum {
+    /** La misma `adjustmentKey` llegó con otro contenido. */
+    ADJUSTMENT_KEY_CONFLICT = "ADJUSTMENT_KEY_CONFLICT",
+    ADJUSTMENT_IN_PROGRESS = "ADJUSTMENT_IN_PROGRESS",
+    /** Un intento previo con la misma llave no dejó resultado conocido. */
+    ADJUSTMENT_OUTCOME_UNKNOWN = "ADJUSTMENT_OUTCOME_UNKNOWN",
+    ADJUSTMENT_REJECTED = "ADJUSTMENT_REJECTED",
+    ADJUSTMENT_UNAVAILABLE = "ADJUSTMENT_UNAVAILABLE",
+    AUTHOR_NOT_ALLOWED = "AUTHOR_NOT_ALLOWED",
+    COLLECTION_TENANT_MISSING = "COLLECTION_TENANT_MISSING"
+}

package/bin/transactionProcessor/enums/ReconciliationAdjustmentErrorCodeEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReconciliationAdjustmentErrorCodeEnum = void 0;
+/**
+ * Codes de error del ajuste de conciliación en transaction-processor; el status de cada uno está en
+ * `RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS`.
+ */
+var ReconciliationAdjustmentErrorCodeEnum;
+(function (ReconciliationAdjustmentErrorCodeEnum) {
+    /** La misma `adjustmentKey` llegó con otro contenido. */
+    ReconciliationAdjustmentErrorCodeEnum["ADJUSTMENT_KEY_CONFLICT"] = "ADJUSTMENT_KEY_CONFLICT";
+    ReconciliationAdjustmentErrorCodeEnum["ADJUSTMENT_IN_PROGRESS"] = "ADJUSTMENT_IN_PROGRESS";
+    /** Un intento previo con la misma llave no dejó resultado conocido. */
+    ReconciliationAdjustmentErrorCodeEnum["ADJUSTMENT_OUTCOME_UNKNOWN"] = "ADJUSTMENT_OUTCOME_UNKNOWN";
+    ReconciliationAdjustmentErrorCodeEnum["ADJUSTMENT_REJECTED"] = "ADJUSTMENT_REJECTED";
+    ReconciliationAdjustmentErrorCodeEnum["ADJUSTMENT_UNAVAILABLE"] = "ADJUSTMENT_UNAVAILABLE";
+    ReconciliationAdjustmentErrorCodeEnum["AUTHOR_NOT_ALLOWED"] = "AUTHOR_NOT_ALLOWED";
+    ReconciliationAdjustmentErrorCodeEnum["COLLECTION_TENANT_MISSING"] = "COLLECTION_TENANT_MISSING";
+})(ReconciliationAdjustmentErrorCodeEnum || (exports.ReconciliationAdjustmentErrorCodeEnum = ReconciliationAdjustmentErrorCodeEnum = {}));

package/bin/transactionProcessor/index.d.ts

@@ -46,6 +46,8 @@ export * from './dtos/ReconciliationAdjustmentReference';
 export * from './dtos/PrivateAuthorizeReconciliationAdjustmentRequest';
 export * from './dtos/PrivateAuthorizeReconciliationAdjustmentResponse';
 export * from './enums/TransactionProcessorCodesEnum';
+export * from './enums/ReconciliationAdjustmentErrorCodeEnum';
+export * from './constants/reconciliationAdjustmentErrorHttpStatus';
 export * from './enums/AsyncTxStatusEnum';
 export * from './enums/AppEnum';
 export * from './enums/TransactionInfoStatusEnum';

package/bin/transactionProcessor/index.js

@@ -62,6 +62,8 @@ __exportStar(require("./dtos/ReconciliationAdjustmentReference"), exports);
 __exportStar(require("./dtos/PrivateAuthorizeReconciliationAdjustmentRequest"), exports);
 __exportStar(require("./dtos/PrivateAuthorizeReconciliationAdjustmentResponse"), exports);
 __exportStar(require("./enums/TransactionProcessorCodesEnum"), exports);
+__exportStar(require("./enums/ReconciliationAdjustmentErrorCodeEnum"), exports);
+__exportStar(require("./constants/reconciliationAdjustmentErrorHttpStatus"), exports);
 __exportStar(require("./enums/AsyncTxStatusEnum"), exports);
 __exportStar(require("./enums/AppEnum"), exports);
 __exportStar(require("./enums/TransactionInfoStatusEnum"), exports);

package/bin/transferNote/constants/transferNoteErrorHttpStatus.d.ts

@@ -1,3 +1,3 @@
 import { TransferNoteErrorCodeEnum as C } from '../enums/TransferNoteErrorCodeEnum';
-/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export declare const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422>>;
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export declare const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422 | 502>>;

package/bin/transferNote/constants/transferNoteErrorHttpStatus.js

@@ -4,7 +4,7 @@ exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = void 0;
 const reconciliationErrorHttpStatus_1 = require("../../reconciliation/constants/reconciliationErrorHttpStatus");
 const ReconciliationFeedErrorCodeEnum_1 = require("../../reconciliation/enums/ReconciliationFeedErrorCodeEnum");
 const TransferNoteErrorCodeEnum_1 = require("../enums/TransferNoteErrorCodeEnum");
-/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
 exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = {
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.TRANSFER_NOTE_NOT_FOUND]: 404,
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTE_NOT_DISPUTABLE]: 409,
@@ -27,4 +27,11 @@ exports.TRANSFER_NOTE_ERROR_HTTP_STATUS = {
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.SOURCE_ITEM_NOT_FOUND]: 404,
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.TRANSFER_NOTE_ITEM_NOT_FOUND]: 404,
     [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.FEED_RECORD_NOT_FOUND]: reconciliationErrorHttpStatus_1.RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum_1.ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND],
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.DISPUTE_ON_PAID_NOTE_PENDING_DECISION]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.ADJUSTMENT_KEY_CONFLICT]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.NOTICE_PUBLISH_FAILED]: 502,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.BANK_CALENDAR_UNAVAILABLE]: 502,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CUTOFF_DISPATCH_FAILED]: 502,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.CONCURRENT_WRITE_CONFLICT]: 409,
+    [TransferNoteErrorCodeEnum_1.TransferNoteErrorCodeEnum.AUDIT_QUEUE_PUBLISH_FAILED]: 502,
 };

package/bin/transferNote/dtos/TransferNoteFeedRecords.d.ts

@@ -16,6 +16,8 @@ export interface TransferNoteItemFeedRecord extends ReconciliationFeedRecord {
     /** `recordId` en el feed del dueño del que salió el item. */
     sourceRecordId: string;
     includedAt: string;
+    /** itemId del item original que corrige un item de concepto ADJUSTMENT. */
+    adjustedItemId?: string;
 }
 /** Registro del feed TRANSFER_NOTE_SETTLEMENT: lo que una nota debe pagar y lo capturado; `recordId` y `matchKey` son el noteId. */
 export interface TransferNoteSettlementFeedRecord extends ReconciliationFeedRecord {
@@ -35,4 +37,6 @@ export interface TransferNoteSettlementFeedRecord extends ReconciliationFeedReco
     payeeClabe: string;
     paidAt?: string;
     paidAmountCents?: number;
+    /** CLABE destino del SPEI capturado (`TRANSFER_NOTE_CLABE_PATTERN`); el motor la compara contra `payeeClabe`. */
+    paidToClabe?: string;
 }

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

@@ -28,5 +28,15 @@ export declare enum TransferNoteErrorCodeEnum {
     /** No hay item para el concepto y registro de origen pedidos en by-source. */
     TRANSFER_NOTE_ITEM_NOT_FOUND = "TRANSFER_NOTE_ITEM_NOT_FOUND",
     /** Mismo code del feed genérico que implementa cada dueño. */
-    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND"
+    FEED_RECORD_NOT_FOUND = "FEED_RECORD_NOT_FOUND",
+    /** La nota pagada ya tiene una objeción esperando decisión. */
+    DISPUTE_ON_PAID_NOTE_PENDING_DECISION = "DISPUTE_ON_PAID_NOTE_PENDING_DECISION",
+    /** La misma llave de ajuste llegó con otro contenido. */
+    ADJUSTMENT_KEY_CONFLICT = "ADJUSTMENT_KEY_CONFLICT",
+    NOTICE_PUBLISH_FAILED = "NOTICE_PUBLISH_FAILED",
+    BANK_CALENDAR_UNAVAILABLE = "BANK_CALENDAR_UNAVAILABLE",
+    CUTOFF_DISPATCH_FAILED = "CUTOFF_DISPATCH_FAILED",
+    /** Otra escritura cambió el registro entre la lectura y el guardado. */
+    CONCURRENT_WRITE_CONFLICT = "CONCURRENT_WRITE_CONFLICT",
+    AUDIT_QUEUE_PUBLISH_FAILED = "AUDIT_QUEUE_PUBLISH_FAILED"
 }

package/bin/transferNote/enums/TransferNoteErrorCodeEnum.js

@@ -33,4 +33,14 @@ var TransferNoteErrorCodeEnum;
     TransferNoteErrorCodeEnum["TRANSFER_NOTE_ITEM_NOT_FOUND"] = "TRANSFER_NOTE_ITEM_NOT_FOUND";
     /** Mismo code del feed genérico que implementa cada dueño. */
     TransferNoteErrorCodeEnum["FEED_RECORD_NOT_FOUND"] = "FEED_RECORD_NOT_FOUND";
+    /** La nota pagada ya tiene una objeción esperando decisión. */
+    TransferNoteErrorCodeEnum["DISPUTE_ON_PAID_NOTE_PENDING_DECISION"] = "DISPUTE_ON_PAID_NOTE_PENDING_DECISION";
+    /** La misma llave de ajuste llegó con otro contenido. */
+    TransferNoteErrorCodeEnum["ADJUSTMENT_KEY_CONFLICT"] = "ADJUSTMENT_KEY_CONFLICT";
+    TransferNoteErrorCodeEnum["NOTICE_PUBLISH_FAILED"] = "NOTICE_PUBLISH_FAILED";
+    TransferNoteErrorCodeEnum["BANK_CALENDAR_UNAVAILABLE"] = "BANK_CALENDAR_UNAVAILABLE";
+    TransferNoteErrorCodeEnum["CUTOFF_DISPATCH_FAILED"] = "CUTOFF_DISPATCH_FAILED";
+    /** Otra escritura cambió el registro entre la lectura y el guardado. */
+    TransferNoteErrorCodeEnum["CONCURRENT_WRITE_CONFLICT"] = "CONCURRENT_WRITE_CONFLICT";
+    TransferNoteErrorCodeEnum["AUDIT_QUEUE_PUBLISH_FAILED"] = "AUDIT_QUEUE_PUBLISH_FAILED";
 })(TransferNoteErrorCodeEnum || (exports.TransferNoteErrorCodeEnum = TransferNoteErrorCodeEnum = {}));

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

@@ -0,0 +1,15 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+export declare class TransferNoteIssuedEventDetail {
+    /** Fijo por nota: un reenvío llega con el mismo id. */
+    eventId: string;
+    tenantId: string;
+    noteId: string;
+    pairKey: string;
+    isoWeek: string;
+    netAmountCents: number;
+    currency: CurrencyId;
+    /** ISO 8601 de la emisión. */
+    issuedAt: string;
+    /** ISO 8601 del vencimiento del SPEI. */
+    dueAt: string;
+}

package/bin/transferNote/events/TransferNoteIssuedEventDetail.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferNoteIssuedEventDetail = void 0;
+// `detail` de TransferNoteIssued; source `TRANSFER_NOTE_EVENTS_SOURCE`, detail-type `TRANSFER_NOTE_ISSUED`.
+class TransferNoteIssuedEventDetail {
+}
+exports.TransferNoteIssuedEventDetail = TransferNoteIssuedEventDetail;

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

@@ -1,7 +1,8 @@
 import { CurrencyId } from '../../currency/enums/CurrencyId';
 export declare const TRANSFER_NOTE_EVENTS_SOURCE = "fiado.transferNote";
 export declare enum TransferNoteEventDetailTypeEnum {
-    TRANSFER_NOTE_RECONCILED = "transferNote.TransferNoteReconciled"
+    TRANSFER_NOTE_RECONCILED = "transferNote.TransferNoteReconciled",
+    TRANSFER_NOTE_ISSUED = "transferNote.TransferNoteIssued"
 }
 export declare class TransferNoteReconciledEventDetail {
     /** Fijo por nota: un reenvío llega con el mismo id y el consumidor lo descarta. */

package/bin/transferNote/events/TransferNoteReconciledEventDetail.js

@@ -6,6 +6,7 @@ exports.TRANSFER_NOTE_EVENTS_SOURCE = 'fiado.transferNote';
 var TransferNoteEventDetailTypeEnum;
 (function (TransferNoteEventDetailTypeEnum) {
     TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_RECONCILED"] = "transferNote.TransferNoteReconciled";
+    TransferNoteEventDetailTypeEnum["TRANSFER_NOTE_ISSUED"] = "transferNote.TransferNoteIssued";
 })(TransferNoteEventDetailTypeEnum || (exports.TransferNoteEventDetailTypeEnum = TransferNoteEventDetailTypeEnum = {}));
 // `detail` de TransferNoteReconciled; el motor recalcula con él el agregado de la semana del par.
 class TransferNoteReconciledEventDetail {

package/bin/transferNote/index.d.ts

@@ -32,3 +32,4 @@ export * from './dtos/responses/RetailerTransferNoteResponses';
 export * from './dtos/responses/TransferNoteConfigResponses';
 export * from './dtos/responses/PrivateTransferNoteResponses';
 export * from './events/TransferNoteReconciledEventDetail';
+export * from './events/TransferNoteIssuedEventDetail';

package/bin/transferNote/index.js

@@ -54,3 +54,4 @@ __exportStar(require("./dtos/responses/TransferNoteConfigResponses"), exports);
 __exportStar(require("./dtos/responses/PrivateTransferNoteResponses"), exports);
 // Eventos
 __exportStar(require("./events/TransferNoteReconciledEventDetail"), exports);
+__exportStar(require("./events/TransferNoteIssuedEventDetail"), exports);

package/package.json

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

package/src/reconciliation/constants/reconciliationErrorHttpStatus.ts

@@ -1,8 +1,8 @@
 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>> = {
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422 | 502>> = {
     [C.DEFINITION_NOT_FOUND]: 404,
     [C.RUN_IN_PROGRESS]: 409,
     [C.ITEM_NOT_FOUND]: 404,
@@ -14,6 +14,17 @@ export const RECONCILIATION_ERROR_HTTP_STATUS: Readonly<Record<C, 404 | 409 | 42
     [C.ADJUSTMENT_UNAVAILABLE]: 502,
     [C.ITEM_ADJUSTED]: 409,
     [C.AUTHOR_NOT_ALLOWED]: 422,
+    [C.INVALID_DEFINITION_STATUS_TRANSITION]: 409,
+    [C.DEFINITION_ACTIVE_FROM_REQUIRED]: 422,
+    [C.DEFINITION_NOT_RUNNABLE]: 409,
+    [C.RULE_TYPE_NOT_SUPPORTED]: 422,
+    [C.BANK_CALENDAR_UNAVAILABLE]: 502,
+    [C.RUN_DISPATCH_FAILED]: 502,
+    [C.BANK_STATEMENT_UNAVAILABLE]: 502,
+    [C.INVALID_SEED_TENANT]: 400,
+    [C.ADJUSTMENT_NEEDS_REVIEW]: 409,
+    [C.ADJUSTMENT_REFERENCE_MISSING]: 422,
+    [C.BANK_ACCOUNTS_NOT_CONFIGURED]: 409,
 };
 
 /** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */

package/src/reconciliation/constants/reconciliationValidation.ts

@@ -7,5 +7,17 @@ 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;
 
+/** Banco o cuenta del EdC: forman la ruta `EDO_CTA/{bank}/{account}/` del bucket. */
+export const RECONCILIATION_BANK_PATH_SEGMENT_PATTERN = /^[A-Za-z0-9_-]+$/;
+
+/** Largo máximo de un banco o una cuenta del EdC. */
+export const RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH = 128;
+
+/** Cuentas de banco por definición. */
+export const RECONCILIATION_MAX_BANK_ACCOUNTS = 10;
+
+/** Días hábiles máximos de espera del EdC. */
+export const RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS = 30;
+
 /** Registros por página de un feed de dueño. */
 export const RECONCILIATION_FEED_PAGE_SIZE = 500;

package/src/reconciliation/dtos/ReconciliationDefinition.ts

@@ -14,6 +14,12 @@ export interface ReconciliationDefinitionSource {
     partName?: string;
 }
 
+/** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
+export interface ReconciliationDefinitionBankAccountView {
+    bank: string;
+    account: string;
+}
+
 export interface ReconciliationDefinition {
     tenantId: string;
     definitionId: string;
@@ -36,6 +42,10 @@ export interface ReconciliationDefinition {
     sandboxRetailerIds: string[];
     sandboxDirectoryIds: string[];
     activeFrom?: string;
+    /** Ajustes del EdC; solo en las definiciones BANK_STATEMENT. */
+    bankAccounts?: ReconciliationDefinitionBankAccountView[];
+    statementGraceBusinessDays?: number;
+    fillPayeeConfirmationOnCredit?: boolean;
     version: number;
     createdAt: string;
     createdBy: string;

package/src/reconciliation/dtos/requests/ReconciliationActionRequests.ts

@@ -1,9 +1,46 @@
-import { Expose } from 'class-transformer';
-import { ArrayUnique, IsArray, IsEnum, IsInt, IsISO8601, IsNotEmpty, IsOptional, IsString, Min } from 'class-validator';
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayMaxSize,
+    ArrayUnique,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Matches,
+    Max,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import {
+    RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH,
+    RECONCILIATION_BANK_PATH_SEGMENT_PATTERN,
+    RECONCILIATION_MAX_BANK_ACCOUNTS,
+    RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS,
+} from '../../constants/reconciliationValidation';
 import { ReconciliationDefinitionStatusEnum } from '../../enums/ReconciliationDefinitionStatusEnum';
 import { ReconciliationResolutionTypeEnum } from '../../enums/ReconciliationResolutionTypeEnum';
 import { NoteText, PeriodKey, RequiredId, RequiredReason } from './reconciliationRequestDecorators';
 
+/** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */
+export class ReconciliationDefinitionBankAccount {
+    @Expose()
+    @IsString()
+    @MaxLength(RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH)
+    @Matches(RECONCILIATION_BANK_PATH_SEGMENT_PATTERN)
+    bank!: string;
+
+    @Expose()
+    @IsString()
+    @MaxLength(RECONCILIATION_BANK_PATH_SEGMENT_MAX_LENGTH)
+    @Matches(RECONCILIATION_BANK_PATH_SEGMENT_PATTERN)
+    account!: string;
+}
+
 /** Body de publicConfigureReconciliationDefinition. */
 export class ConfigureReconciliationDefinitionRequest {
     @Expose()
@@ -43,6 +80,27 @@ export class ConfigureReconciliationDefinitionRequest {
     @IsOptional()
     @IsISO8601()
     activeFrom?: string;
+
+    /** Reemplaza la lista completa de cuentas del EdC. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayMaxSize(RECONCILIATION_MAX_BANK_ACCOUNTS)
+    @ValidateNested({ each: true })
+    @Type(() => ReconciliationDefinitionBankAccount)
+    bankAccounts?: ReconciliationDefinitionBankAccount[];
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(RECONCILIATION_MAX_STATEMENT_GRACE_BUSINESS_DAYS)
+    statementGraceBusinessDays?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    fillPayeeConfirmationOnCredit?: boolean;
 }
 
 /** Body de publicRunReconciliation: responde 202 con `runId` y corre asíncrono. */

package/src/reconciliation/dtos/requests/ReconciliationQueries.ts

@@ -7,6 +7,7 @@ import { ReconciliationExportFormatEnum } from '../../enums/ReconciliationExport
 import { ReconciliationFeedConceptEnum } from '../../enums/ReconciliationFeedConceptEnum';
 import { ReconciliationItemStateEnum } from '../../enums/ReconciliationItemStateEnum';
 import { ReconciliationLayerEnum } from '../../enums/ReconciliationLayerEnum';
+import { ReconciliationResolutionStatusEnum } from '../../enums/ReconciliationResolutionStatusEnum';
 import { ReconciliationRuleTypeEnum } from '../../enums/ReconciliationRuleTypeEnum';
 import { ReconciliationRunStatusEnum } from '../../enums/ReconciliationRunStatusEnum';
 import { PageLimit, PageToken, PeriodKey, RequiredId } from './reconciliationRequestDecorators';
@@ -140,6 +141,11 @@ export class ListReconciliationItemsQuery {
     @IsEnum(ReconciliationExportFormatEnum)
     format?: ReconciliationExportFormatEnum;
 
+    @Expose()
+    @IsOptional()
+    @IsEnum(ReconciliationResolutionStatusEnum)
+    resolutionStatus?: ReconciliationResolutionStatusEnum;
+
     @PageLimit()
     limit?: number;
 

package/src/reconciliation/enums/ReconciliationErrorCodeEnum.ts

@@ -21,4 +21,20 @@ export enum ReconciliationErrorCodeEnum {
     ITEM_ADJUSTED = 'ITEM_ADJUSTED',
     /** El `author` del espejo privado no está en la lista permitida del lambda. */
     AUTHOR_NOT_ALLOWED = 'AUTHOR_NOT_ALLOWED',
+    INVALID_DEFINITION_STATUS_TRANSITION = 'INVALID_DEFINITION_STATUS_TRANSITION',
+    /** Activar una definición exige su fecha de inicio. */
+    DEFINITION_ACTIVE_FROM_REQUIRED = 'DEFINITION_ACTIVE_FROM_REQUIRED',
+    /** La definición no está activa o aún no entra en vigor. */
+    DEFINITION_NOT_RUNNABLE = 'DEFINITION_NOT_RUNNABLE',
+    RULE_TYPE_NOT_SUPPORTED = 'RULE_TYPE_NOT_SUPPORTED',
+    BANK_CALENDAR_UNAVAILABLE = 'BANK_CALENDAR_UNAVAILABLE',
+    RUN_DISPATCH_FAILED = 'RUN_DISPATCH_FAILED',
+    BANK_STATEMENT_UNAVAILABLE = 'BANK_STATEMENT_UNAVAILABLE',
+    INVALID_SEED_TENANT = 'INVALID_SEED_TENANT',
+    /** El ajuste quedó con resultado incierto y se revisa a mano. */
+    ADJUSTMENT_NEEDS_REVIEW = 'ADJUSTMENT_NEEDS_REVIEW',
+    /** A la partida le falta la referencia que pide el ajuste. */
+    ADJUSTMENT_REFERENCE_MISSING = 'ADJUSTMENT_REFERENCE_MISSING',
+    /** La definición de banco no tiene cuentas configuradas. */
+    BANK_ACCOUNTS_NOT_CONFIGURED = 'BANK_ACCOUNTS_NOT_CONFIGURED',
 }

package/src/reconciliation/enums/ReconciliationResolutionArchiveReasonEnum.ts

@@ -3,4 +3,8 @@ export enum ReconciliationResolutionArchiveReasonEnum {
     REACTIVATED = 'REACTIVATED',
     /** La corrida encontró que ambos lados ya cuadran. */
     MATCHED_ON_RECALCULATION = 'MATCHED_ON_RECALCULATION',
+    /** Otra resolución la reemplazó. */
+    SUPERSEDED = 'SUPERSEDED',
+    /** El dueño del dinero rechazó el ajuste. */
+    ADJUSTMENT_REJECTED = 'ADJUSTMENT_REJECTED',
 }

package/src/transactionProcessor/constants/reconciliationAdjustmentErrorHttpStatus.ts

@@ -0,0 +1,12 @@
+import { ReconciliationAdjustmentErrorCodeEnum as C } from '../enums/ReconciliationAdjustmentErrorCodeEnum';
+
+/** Status HTTP de cada code: 400 request inválido · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export const RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 409 | 422 | 502>> = {
+    [C.ADJUSTMENT_KEY_CONFLICT]: 409,
+    [C.ADJUSTMENT_IN_PROGRESS]: 409,
+    [C.ADJUSTMENT_OUTCOME_UNKNOWN]: 409,
+    [C.ADJUSTMENT_REJECTED]: 422,
+    [C.ADJUSTMENT_UNAVAILABLE]: 502,
+    [C.AUTHOR_NOT_ALLOWED]: 422,
+    [C.COLLECTION_TENANT_MISSING]: 400,
+};

package/src/transactionProcessor/enums/ReconciliationAdjustmentErrorCodeEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Codes de error del ajuste de conciliación en transaction-processor; el status de cada uno está en
+ * `RECONCILIATION_ADJUSTMENT_ERROR_HTTP_STATUS`.
+ */
+export enum ReconciliationAdjustmentErrorCodeEnum {
+    /** La misma `adjustmentKey` llegó con otro contenido. */
+    ADJUSTMENT_KEY_CONFLICT = 'ADJUSTMENT_KEY_CONFLICT',
+    ADJUSTMENT_IN_PROGRESS = 'ADJUSTMENT_IN_PROGRESS',
+    /** Un intento previo con la misma llave no dejó resultado conocido. */
+    ADJUSTMENT_OUTCOME_UNKNOWN = 'ADJUSTMENT_OUTCOME_UNKNOWN',
+    ADJUSTMENT_REJECTED = 'ADJUSTMENT_REJECTED',
+    ADJUSTMENT_UNAVAILABLE = 'ADJUSTMENT_UNAVAILABLE',
+    AUTHOR_NOT_ALLOWED = 'AUTHOR_NOT_ALLOWED',
+    COLLECTION_TENANT_MISSING = 'COLLECTION_TENANT_MISSING',
+}

package/src/transactionProcessor/index.ts

@@ -47,6 +47,8 @@ export * from './dtos/PrivateAuthorizeReconciliationAdjustmentRequest';
 export * from './dtos/PrivateAuthorizeReconciliationAdjustmentResponse';
 
 export * from './enums/TransactionProcessorCodesEnum';
+export * from './enums/ReconciliationAdjustmentErrorCodeEnum';
+export * from './constants/reconciliationAdjustmentErrorHttpStatus';
 export * from './enums/AsyncTxStatusEnum';
 export * from './enums/AppEnum';
 export * from './enums/TransactionInfoStatusEnum';

package/src/transferNote/constants/transferNoteErrorHttpStatus.ts

@@ -2,8 +2,8 @@ import { RECONCILIATION_FEED_ERROR_HTTP_STATUS } from '../../reconciliation/cons
 import { ReconciliationFeedErrorCodeEnum } from '../../reconciliation/enums/ReconciliationFeedErrorCodeEnum';
 import { TransferNoteErrorCodeEnum as C } from '../enums/TransferNoteErrorCodeEnum';
 
-/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto de estado · 422 regla de negocio. */
-export const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422>> = {
+/** Status HTTP de cada code: 400 request inválido · 404 no existe · 409 conflicto · 422 regla de negocio · 502 falló un externo. */
+export const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409 | 422 | 502>> = {
     [C.TRANSFER_NOTE_NOT_FOUND]: 404,
     [C.NOTE_NOT_DISPUTABLE]: 409,
     [C.NET_NOT_POSITIVE]: 422,
@@ -25,4 +25,11 @@ export const TRANSFER_NOTE_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 404 | 409
     [C.SOURCE_ITEM_NOT_FOUND]: 404,
     [C.TRANSFER_NOTE_ITEM_NOT_FOUND]: 404,
     [C.FEED_RECORD_NOT_FOUND]: RECONCILIATION_FEED_ERROR_HTTP_STATUS[ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND],
+    [C.DISPUTE_ON_PAID_NOTE_PENDING_DECISION]: 409,
+    [C.ADJUSTMENT_KEY_CONFLICT]: 409,
+    [C.NOTICE_PUBLISH_FAILED]: 502,
+    [C.BANK_CALENDAR_UNAVAILABLE]: 502,
+    [C.CUTOFF_DISPATCH_FAILED]: 502,
+    [C.CONCURRENT_WRITE_CONFLICT]: 409,
+    [C.AUDIT_QUEUE_PUBLISH_FAILED]: 502,
 };

package/src/transferNote/dtos/TransferNoteFeedRecords.ts

@@ -14,6 +14,8 @@ export interface TransferNoteItemFeedRecord extends ReconciliationFeedRecord {
     /** `recordId` en el feed del dueño del que salió el item. */
     sourceRecordId: string;
     includedAt: string;
+    /** itemId del item original que corrige un item de concepto ADJUSTMENT. */
+    adjustedItemId?: string;
 }
 
 /** Registro del feed TRANSFER_NOTE_SETTLEMENT: lo que una nota debe pagar y lo capturado; `recordId` y `matchKey` son el noteId. */
@@ -32,4 +34,6 @@ export interface TransferNoteSettlementFeedRecord extends ReconciliationFeedReco
     payeeClabe: string;
     paidAt?: string;
     paidAmountCents?: number;
+    /** CLABE destino del SPEI capturado (`TRANSFER_NOTE_CLABE_PATTERN`); el motor la compara contra `payeeClabe`. */
+    paidToClabe?: string;
 }

package/src/transferNote/enums/TransferNoteErrorCodeEnum.ts

@@ -31,4 +31,14 @@ export enum TransferNoteErrorCodeEnum {
     TRANSFER_NOTE_ITEM_NOT_FOUND = 'TRANSFER_NOTE_ITEM_NOT_FOUND',
     /** Mismo code del feed genérico que implementa cada dueño. */
     FEED_RECORD_NOT_FOUND = ReconciliationFeedErrorCodeEnum.FEED_RECORD_NOT_FOUND,
+    /** La nota pagada ya tiene una objeción esperando decisión. */
+    DISPUTE_ON_PAID_NOTE_PENDING_DECISION = 'DISPUTE_ON_PAID_NOTE_PENDING_DECISION',
+    /** La misma llave de ajuste llegó con otro contenido. */
+    ADJUSTMENT_KEY_CONFLICT = 'ADJUSTMENT_KEY_CONFLICT',
+    NOTICE_PUBLISH_FAILED = 'NOTICE_PUBLISH_FAILED',
+    BANK_CALENDAR_UNAVAILABLE = 'BANK_CALENDAR_UNAVAILABLE',
+    CUTOFF_DISPATCH_FAILED = 'CUTOFF_DISPATCH_FAILED',
+    /** Otra escritura cambió el registro entre la lectura y el guardado. */
+    CONCURRENT_WRITE_CONFLICT = 'CONCURRENT_WRITE_CONFLICT',
+    AUDIT_QUEUE_PUBLISH_FAILED = 'AUDIT_QUEUE_PUBLISH_FAILED',
 }

package/src/transferNote/events/TransferNoteIssuedEventDetail.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+
+// `detail` de TransferNoteIssued; source `TRANSFER_NOTE_EVENTS_SOURCE`, detail-type `TRANSFER_NOTE_ISSUED`.
+export class TransferNoteIssuedEventDetail {
+    /** Fijo por nota: un reenvío llega con el mismo id. */
+    eventId!: string;
+    tenantId!: string;
+    noteId!: string;
+    pairKey!: string;
+    isoWeek!: string;
+    netAmountCents!: number;
+    currency!: CurrencyId;
+    /** ISO 8601 de la emisión. */
+    issuedAt!: string;
+    /** ISO 8601 del vencimiento del SPEI. */
+    dueAt!: string;
+}

package/src/transferNote/events/TransferNoteReconciledEventDetail.ts

@@ -5,6 +5,7 @@ export const TRANSFER_NOTE_EVENTS_SOURCE = 'fiado.transferNote';
 
 export enum TransferNoteEventDetailTypeEnum {
     TRANSFER_NOTE_RECONCILED = 'transferNote.TransferNoteReconciled',
+    TRANSFER_NOTE_ISSUED = 'transferNote.TransferNoteIssued',
 }
 
 // `detail` de TransferNoteReconciled; el motor recalcula con él el agregado de la semana del par.

package/src/transferNote/index.ts

@@ -43,3 +43,4 @@ export * from './dtos/responses/PrivateTransferNoteResponses';
 
 // Eventos
 export * from './events/TransferNoteReconciledEventDetail';
+export * from './events/TransferNoteIssuedEventDetail';