@fiado/type-kit 3.620.0 → 3.622.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/retailIntegration/reconciliationContracts.test.ts

@@ -119,6 +119,24 @@ describe('respuestas de la revisión', () => {
     expect(catalog.storesPending).toBe(0);
   });
 
+  it('las respuestas GET exponen el motivo del aborto, el último error y el intento', () => {
+    const counts = { seen: 0, created: 0, updated: 0, deactivated: 0, reactivated: 0, skipped: 0 };
+    const org: GetOrgReconciliationResponse = {
+      runId: 'run-o', retailerId: 'r-1', entity: ReconciliationEntityEnum.STORES,
+      status: ReconciliationRunStatusEnum.ABORTED, trigger: ReconciliationTriggerEnum.MANUAL,
+      startedAt: '2026-10-25T10:00:00.000Z', pagesProcessed: 0, counts,
+      abortReason: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', lastErrorCode: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', attempt: 1, maxAttempts: 5,
+    };
+    const catalog: GetCatalogReconciliationResponse = {
+      runId: 'run-c', retailerId: 'r-1', entity: ReconciliationEntityEnum.CATALOG,
+      status: ReconciliationRunStatusEnum.RUNNING, trigger: ReconciliationTriggerEnum.SCHEDULED,
+      startedAt: '2026-10-25T10:00:00.000Z', pagesProcessed: 0, counts,
+      abortReason: null, lastErrorCode: 'RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE', attempt: 3, maxAttempts: 5,
+    };
+    expect(org.abortReason).toBe('RETAIL_INTEGRATION_CONNECTOR_UNAVAILABLE');
+    expect([catalog.attempt, catalog.maxAttempts]).toEqual([3, 5]);
+  });
+
   it('GetCatalogReconciliationResponse admite MOVEMENTS con su ventana', () => {
     const movements: GetCatalogReconciliationResponse = {
       runId: 'run-m',

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,14 @@ 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,
 };
 /** 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/enums/ReconciliationErrorCodeEnum.d.ts

@@ -20,5 +20,15 @@ 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"
 }

package/bin/reconciliation/enums/ReconciliationErrorCodeEnum.js

@@ -25,4 +25,14 @@ 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";
 })(ReconciliationErrorCodeEnum || (exports.ReconciliationErrorCodeEnum = ReconciliationErrorCodeEnum = {}));

package/bin/retailIntegration/dtos/GetReconciliationResponses.d.ts

@@ -3,8 +3,19 @@ import type { ReconciliationRunStatusEnum } from '../enums/ReconciliationRunStat
 import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEnum';
 import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
+/** Fallos de una corrida: por qué se abortó y en qué intento de SQS va la página que falla. */
+export interface ReconciliationRunAttempts {
+    /** Motivo del ABORTED (`MAX_ATTEMPTS`, `ROW_WITHOUT_ID`, el `code` del externo caído, etc.); null si no se abortó. */
+    abortReason?: string | null;
+    /** `code` del último error de la página en curso; null si la página no ha fallado. */
+    lastErrorCode?: string | null;
+    /** Intento de SQS (1-based) en que falló la página en curso; null si no ha fallado. */
+    attempt?: number | null;
+    /** Intentos de SQS que tiene una página antes de abortar la corrida. */
+    maxAttempts?: number;
+}
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
-export interface GetOrgReconciliationResponse {
+export interface GetOrgReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
@@ -22,7 +33,7 @@ export interface GetOrgReconciliationResponse {
     preview?: ReconciliationPreview;
 }
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
-export interface GetCatalogReconciliationResponse {
+export interface GetCatalogReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;

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.620.0",
+  "version": "3.622.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,14 @@ 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,
 };
 
 /** Status HTTP de los codes del feed genérico: 400 request inválido · 404 no existe · 502 falló la fuente. */

package/src/reconciliation/enums/ReconciliationErrorCodeEnum.ts

@@ -21,4 +21,14 @@ 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',
 }

package/src/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -4,8 +4,20 @@ import type { ReconciliationTriggerEnum } from '../enums/ReconciliationTriggerEn
 import type { ReconciliationPreview } from './ReconciliationPreview';
 import type { ReconciliationRunCounts } from './ReconciliationRunCounts';
 
+/** Fallos de una corrida: por qué se abortó y en qué intento de SQS va la página que falla. */
+export interface ReconciliationRunAttempts {
+    /** Motivo del ABORTED (`MAX_ATTEMPTS`, `ROW_WITHOUT_ID`, el `code` del externo caído, etc.); null si no se abortó. */
+    abortReason?: string | null;
+    /** `code` del último error de la página en curso; null si la página no ha fallado. */
+    lastErrorCode?: string | null;
+    /** Intento de SQS (1-based) en que falló la página en curso; null si no ha fallado. */
+    attempt?: number | null;
+    /** Intentos de SQS que tiene una página antes de abortar la corrida. */
+    maxAttempts?: number;
+}
+
 /** Respuesta 200 de GET .../reconciliations/{runId} en org (backofficeGetOrgReconciliation). */
-export interface GetOrgReconciliationResponse {
+export interface GetOrgReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.STORES | ReconciliationEntityEnum.USERS;
@@ -24,7 +36,7 @@ export interface GetOrgReconciliationResponse {
 }
 
 /** Respuesta 200 de GET .../reconciliations/{runId} en catalog (backofficeGetCatalogReconciliation). */
-export interface GetCatalogReconciliationResponse {
+export interface GetCatalogReconciliationResponse extends ReconciliationRunAttempts {
     runId: string;
     retailerId: string;
     entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;

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';