@lucianpacurar/iso20022.js 0.2.7 → 0.2.9

package/dist/index.mjs

@@ -7744,13 +7744,15 @@ class SEPACreditPaymentInitiation extends PaymentInitiation {
                         CtrlSum: this.formattedPaymentSum,
                         InitgPty: {
                             Nm: this.initiatingParty.name,
-                            Id: {
-                                OrgId: {
-                                    Othr: {
-                                        Id: this.initiatingParty.id,
+                            ...(this.initiatingParty.id && {
+                                Id: {
+                                    OrgId: {
+                                        Othr: {
+                                            Id: this.initiatingParty.id,
+                                        },
                                     },
                                 },
-                            },
+                            }),
                         },
                     },
                     PmtInf: {
@@ -7838,6 +7840,311 @@ class SEPACreditPaymentInitiation extends PaymentInitiation {
     }
 }
 
+/**
+ * Represents a SEPA Multi Credit Payment Initiation.
+ * This class handles the creation and serialization of SEPA credit transfer messages
+ * with multiple payment information blocks (multiple debtors) according to the ISO20022 standard.
+ * @class
+ * @extends PaymentInitiation
+ * @param {SEPAMultiCreditPaymentInitiationConfig} config - The configuration for the SEPA Multi Credit Payment Initiation message.
+ * @example
+ * ```typescript
+ * // Creating a SEPA multi-payment message
+ * const payment = new SEPAMultiCreditPaymentInitiation({
+ *   initiatingParty: { name: 'Company Ltd', id: '12345' },
+ *   paymentInstructions: [
+ *     {
+ *       initiatingParty: debtor1,
+ *       payments: [payment1, payment2]
+ *     },
+ *     {
+ *       initiatingParty: debtor2,
+ *       payments: [payment3]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+class SEPAMultiCreditPaymentInitiation extends PaymentInitiation {
+    initiatingParty;
+    messageId;
+    creationDate;
+    paymentInstructions;
+    paymentInformationIdBase;
+    formattedPaymentSum;
+    totalTransactionCount;
+    /**
+     * Creates an instance of SEPAMultiCreditPaymentInitiation.
+     * @param {SEPAMultiCreditPaymentInitiationConfig} config - The configuration object for the SEPA multi credit transfer.
+     */
+    constructor(config) {
+        super({ type: "sepa" });
+        this.initiatingParty = config.initiatingParty;
+        this.paymentInstructions = config.paymentInstructions;
+        this.messageId = config.messageId || v4().replace(/-/g, '');
+        this.creationDate = config.creationDate || new Date();
+        this.paymentInformationIdBase = sanitize(v4(), 35);
+        this.totalTransactionCount = this.countAllTransactions();
+        this.formattedPaymentSum = this.sumAllPayments();
+        this.validate();
+    }
+    /**
+     * Counts the total number of transactions across all payment instruction groups.
+     * @private
+     * @returns {number} The total count of all transactions.
+     */
+    countAllTransactions() {
+        return this.paymentInstructions.reduce((total, group) => {
+            return total + group.payments.length;
+        }, 0);
+    }
+    /**
+     * Calculates the sum of all payment instructions across all groups.
+     * @private
+     * @returns {string} The total sum formatted as a string with 2 decimal places.
+     */
+    sumAllPayments() {
+        let totalAmount = 0;
+        let currency = null;
+        for (const group of this.paymentInstructions) {
+            for (const payment of group.payments) {
+                if (currency === null) {
+                    currency = payment.currency;
+                }
+                totalAmount += payment.amount;
+            }
+        }
+        if (currency === null) {
+            throw new Error('No payments found');
+        }
+        return Dinero({ amount: totalAmount, currency }).toFormat('0.00');
+    }
+    /**
+     * Calculates the sum of payment instructions for a single group.
+     * @private
+     * @param {AtLeastOne<SEPACreditPaymentInstruction>} payments - Array of payment instructions.
+     * @returns {string} The total sum formatted as a string with 2 decimal places.
+     * @throws {Error} If payment instructions have different currencies.
+     */
+    sumPaymentInstructions(payments) {
+        this.validateGroupInstructionsHaveSameCurrency(payments);
+        const instructionDineros = payments.map(instruction => Dinero({ amount: instruction.amount, currency: instruction.currency }));
+        return instructionDineros.reduce((acc, next) => {
+            return acc.add(next);
+        }, Dinero({ amount: 0, currency: payments[0].currency })).toFormat('0.00');
+    }
+    /**
+     * Validates the payment initiation data according to SEPA requirements.
+     * @private
+     * @throws {Error} If messageId exceeds 35 characters.
+     * @throws {Error} If any group's payment instructions have different currencies.
+     */
+    validate() {
+        if (this.messageId.length > 35) {
+            throw new Error('messageId must not exceed 35 characters');
+        }
+        // Validate each group has same currency within its payments
+        for (const group of this.paymentInstructions) {
+            this.validateGroupInstructionsHaveSameCurrency(group.payments);
+        }
+    }
+    /**
+     * Validates that all payment instructions in a group have the same currency.
+     * @private
+     * @param {AtLeastOne<SEPACreditPaymentInstruction>} payments - Array of payment instructions.
+     * @throws {Error} If payment instructions have different currencies.
+     */
+    validateGroupInstructionsHaveSameCurrency(payments) {
+        if (!payments.every((i) => { return i.currency === payments[0].currency; })) {
+            throw new Error("In order to calculate the payment instructions sum, all payment instruction currencies within a group must be the same.");
+        }
+    }
+    /**
+     * Generates payment information for a single SEPA credit transfer instruction.
+     * @param {SEPACreditPaymentInstruction} instruction - The payment instruction.
+     * @returns {Object} The payment information object formatted according to SEPA specifications.
+     */
+    creditTransfer(instruction) {
+        const paymentInstructionId = sanitize(instruction.id || v4(), 35);
+        const endToEndId = sanitize(instruction.endToEndId || instruction.id || v4(), 35);
+        const dinero = Dinero({ amount: instruction.amount, currency: instruction.currency });
+        return {
+            PmtId: {
+                InstrId: paymentInstructionId,
+                EndToEndId: endToEndId,
+            },
+            Amt: {
+                InstdAmt: {
+                    '#': dinero.toFormat('0.00'),
+                    '@Ccy': instruction.currency,
+                },
+            },
+            ...(instruction.creditor.agent && { CdtrAgt: this.agent(instruction.creditor.agent) }),
+            Cdtr: this.party(instruction.creditor),
+            CdtrAcct: {
+                Id: { IBAN: instruction.creditor.account.iban },
+                Ccy: instruction.currency,
+            },
+            RmtInf: instruction.remittanceInformation ? {
+                Ustrd: instruction.remittanceInformation,
+            } : undefined,
+        };
+    }
+    /**
+     * Serializes the SEPA multi credit transfer initiation to an XML string.
+     * @returns {string} The XML representation of the SEPA multi credit transfer initiation.
+     */
+    serialize() {
+        const builder = PaymentInitiation.getBuilder();
+        // Generate multiple PmtInf entries, one per payment instruction group
+        const paymentInfoEntries = this.paymentInstructions.map((group, index) => {
+            const groupSum = this.sumPaymentInstructions(group.payments);
+            const pmtInfId = sanitize(`${this.paymentInformationIdBase}-${index + 1}`, 35);
+            return {
+                PmtInfId: pmtInfId,
+                PmtMtd: 'TRF',
+                NbOfTxs: group.payments.length.toString(),
+                CtrlSum: groupSum,
+                PmtTpInf: {
+                    SvcLvl: { Cd: 'SEPA' },
+                    ...(group.categoryPurpose && {
+                        CtgyPurp: { Cd: group.categoryPurpose }
+                    }),
+                },
+                ReqdExctnDt: this.creationDate.toISOString().split('T')[0],
+                Dbtr: this.party(group.initiatingParty),
+                DbtrAcct: this.account(group.initiatingParty.account),
+                DbtrAgt: this.agent(group.initiatingParty.agent),
+                ChrgBr: 'SLEV',
+                CdtTrfTxInf: group.payments.map(p => this.creditTransfer(p)),
+            };
+        });
+        const xml = {
+            '?xml': {
+                '@version': '1.0',
+                '@encoding': 'UTF-8'
+            },
+            Document: {
+                '@xmlns': 'urn:iso:std:iso:20022:tech:xsd:pain.001.001.03',
+                '@xmlns:xsi': 'http://www.w3.org/2001/XMLSchema-instance',
+                CstmrCdtTrfInitn: {
+                    GrpHdr: {
+                        MsgId: this.messageId,
+                        CreDtTm: this.creationDate.toISOString(),
+                        NbOfTxs: this.totalTransactionCount.toString(),
+                        CtrlSum: this.formattedPaymentSum,
+                        InitgPty: {
+                            Nm: this.initiatingParty.name,
+                            ...(this.initiatingParty.id && {
+                                Id: {
+                                    OrgId: {
+                                        Othr: {
+                                            Id: this.initiatingParty.id,
+                                        },
+                                    },
+                                },
+                            }),
+                        },
+                    },
+                    PmtInf: paymentInfoEntries,
+                }
+            },
+        };
+        return builder.build(xml);
+    }
+    /**
+     * Parses an XML string and creates a SEPAMultiCreditPaymentInitiation instance.
+     * Supports multiple PmtInf blocks in the XML document.
+     * @param {string} rawXml - The XML string to parse.
+     * @returns {SEPAMultiCreditPaymentInitiation} A new instance created from the XML data.
+     * @throws {InvalidXmlError} If the XML format is invalid.
+     * @throws {InvalidXmlNamespaceError} If the namespace is not pain.001.001.03.
+     */
+    static fromXML(rawXml) {
+        const parser = new fxp.XMLParser({ ignoreAttributes: false });
+        const xml = parser.parse(rawXml);
+        // Validate XML structure
+        if (!xml.Document) {
+            throw new InvalidXmlError("Invalid XML format");
+        }
+        // Validate namespace
+        const namespace = (xml.Document['@_xmlns'] || xml.Document['@_Xmlns']);
+        if (!namespace.startsWith('urn:iso:std:iso:20022:tech:xsd:pain.001.001.03')) {
+            throw new InvalidXmlNamespaceError('Invalid PAIN.001 namespace');
+        }
+        // Extract GrpHdr data
+        const messageId = xml.Document.CstmrCdtTrfInitn.GrpHdr.MsgId;
+        const creationDate = new Date(xml.Document.CstmrCdtTrfInitn.GrpHdr.CreDtTm);
+        // Extract top-level initiating party from GrpHdr
+        const topLevelInitiatingParty = {
+            name: xml.Document.CstmrCdtTrfInitn.GrpHdr.InitgPty.Nm,
+            id: xml.Document.CstmrCdtTrfInitn.GrpHdr.InitgPty.Id?.OrgId?.Othr?.Id,
+        };
+        // Normalize PmtInf to array (handle both single object and array cases)
+        const rawPmtInf = Array.isArray(xml.Document.CstmrCdtTrfInitn.PmtInf)
+            ? xml.Document.CstmrCdtTrfInitn.PmtInf
+            : [xml.Document.CstmrCdtTrfInitn.PmtInf];
+        // Map each PmtInf to SEPAMultiCreditPaymentInstructionGroup
+        const paymentInstructions = rawPmtInf.map((pmtInf) => {
+            // Extract debtor info as the group's initiating party
+            const groupInitiatingParty = {
+                name: pmtInf.Dbtr.Nm,
+                id: pmtInf.Dbtr.Id?.OrgId?.Othr?.Id,
+                agent: parseAgent(pmtInf.DbtrAgt),
+                account: parseAccount(pmtInf.DbtrAcct),
+            };
+            // Extract optional category purpose
+            const categoryPurpose = pmtInf.PmtTpInf?.CtgyPurp?.Cd;
+            // Normalize CdtTrfTxInf to array
+            const rawInstructions = Array.isArray(pmtInf.CdtTrfTxInf)
+                ? pmtInf.CdtTrfTxInf
+                : [pmtInf.CdtTrfTxInf];
+            // Parse each CdtTrfTxInf to SEPACreditPaymentInstruction
+            const payments = rawInstructions.map((inst) => {
+                const currency = inst.Amt.InstdAmt['@_Ccy'];
+                const amount = parseAmountToMinorUnits(Number(inst.Amt.InstdAmt['#text']), currency);
+                const rawPostalAddress = inst.Cdtr.PstlAdr;
+                return {
+                    ...(inst.PmtId.InstrId && { id: inst.PmtId.InstrId.toString() }),
+                    ...(inst.PmtId.EndToEndId && { endToEndId: inst.PmtId.EndToEndId.toString() }),
+                    type: 'sepa',
+                    direction: 'credit',
+                    amount: amount,
+                    currency: currency,
+                    creditor: {
+                        name: inst.Cdtr?.Nm,
+                        agent: parseAgent(inst.CdtrAgt),
+                        account: parseAccount(inst.CdtrAcct),
+                        ...((rawPostalAddress && (rawPostalAddress.StrtNm || rawPostalAddress.BldgNb || rawPostalAddress.PstCd || rawPostalAddress.TwnNm || rawPostalAddress.Ctry)) ? {
+                            address: {
+                                ...(rawPostalAddress.StrtNm && { streetName: rawPostalAddress.StrtNm.toString() }),
+                                ...(rawPostalAddress.BldgNb && { buildingNumber: rawPostalAddress.BldgNb.toString() }),
+                                ...(rawPostalAddress.TwnNm && { townName: rawPostalAddress.TwnNm.toString() }),
+                                ...(rawPostalAddress.CtrySubDvsn && { countrySubDivision: rawPostalAddress.CtrySubDvsn.toString() }),
+                                ...(rawPostalAddress.PstCd && { postalCode: rawPostalAddress.PstCd.toString() }),
+                                ...(rawPostalAddress.Ctry && { country: rawPostalAddress.Ctry }),
+                            }
+                        } : {}),
+                    },
+                    ...(inst.RmtInf?.Ustrd && { remittanceInformation: inst.RmtInf.Ustrd.toString() })
+                };
+            });
+            return {
+                initiatingParty: groupInitiatingParty,
+                payments: payments,
+                ...(categoryPurpose && { categoryPurpose }),
+            };
+        });
+        // Return new instance
+        return new SEPAMultiCreditPaymentInitiation({
+            messageId: messageId,
+            creationDate: creationDate,
+            initiatingParty: topLevelInitiatingParty,
+            paymentInstructions: paymentInstructions,
+        });
+    }
+}
+
 /**
  * Represents a RTP Credit Payment Initiation.
  * This class handles the creation and serialization of RTP credit transfer messages
@@ -9565,6 +9872,45 @@ class ISO20022 {
             creationDate: config.creationDate,
         });
     }
+    /**
+     * Creates a SEPA Multi Credit Payment Initiation message with multiple payment information blocks.
+     * @param {SEPAMultiCreditPaymentInitiationConfig} config - Configuration containing payment instruction groups and optional parameters.
+     * @example
+     * const payment = iso20022.createSEPAMultiCreditPaymentInitiation({
+     *   paymentInstructions: [
+     *     {
+     *       initiatingParty: debtor1,
+     *       payments: [
+     *         {
+     *           type: 'sepa',
+     *           direction: 'credit',
+     *           amount: 1000, // €10.00 Euros
+     *           currency: 'EUR',
+     *           creditor: {
+     *             name: 'Hans Schneider',
+     *             account: {
+     *               iban: 'DE1234567890123456',
+     *             },
+     *           },
+     *           remittanceInformation: 'Invoice payment #123',
+     *         },
+     *       ],
+     *       categoryPurpose: 'SALA', // Optional
+     *     },
+     *   ],
+     *   messageId: 'SEPA-MULTI-MSG-001', // Optional
+     *   creationDate: new Date('2025-03-01'), // Optional
+     * });
+     * @returns {SEPAMultiCreditPaymentInitiation} A new SEPA Multi Credit Payment Initiation object.
+     */
+    createSEPAMultiCreditPaymentInitiation(config) {
+        return new SEPAMultiCreditPaymentInitiation({
+            initiatingParty: this.initiatingParty,
+            paymentInstructions: config.paymentInstructions,
+            messageId: config.messageId,
+            creationDate: config.creationDate,
+        });
+    }
     /**
      * Creates a RTP Credit Payment Initiation message.
      * @param {RTPCreditPaymentInitiationConfig} config - Configuration containing payment instructions and optional parameters.
@@ -10020,4 +10366,4 @@ class CashManagementEndOfDayReport {
 }
 registerISO20022Implementation(CashManagementEndOfDayReport);
 
-export { ACHCreditPaymentInitiation, ACHLocalInstrumentCode, ACHLocalInstrumentCodeDescriptionMap, BalanceTypeCode, BalanceTypeCodeDescriptionMap, CashManagementEndOfDayReport, ISO20022, InvalidXmlError, InvalidXmlNamespaceError, Iso20022JsError, PaymentStatusCode, PaymentStatusReport, RTPCreditPaymentInitiation, SEPACreditPaymentInitiation, SWIFTCreditPaymentInitiation };
+export { ACHCreditPaymentInitiation, ACHLocalInstrumentCode, ACHLocalInstrumentCodeDescriptionMap, BalanceTypeCode, BalanceTypeCodeDescriptionMap, CashManagementEndOfDayReport, ISO20022, InvalidXmlError, InvalidXmlNamespaceError, Iso20022JsError, PaymentStatusCode, PaymentStatusReport, RTPCreditPaymentInitiation, SEPACreditPaymentInitiation, SEPAMultiCreditPaymentInitiation, SWIFTCreditPaymentInitiation };

package/dist/src/index.d.ts

@@ -48,6 +48,8 @@ export type { SWIFTCreditPaymentInitiationConfig } from './pain/001/swift-credit
 export { SWIFTCreditPaymentInitiation } from './pain/001/swift-credit-payment-initiation';
 export type { SEPACreditPaymentInitiationConfig } from './pain/001/sepa-credit-payment-initiation';
 export { SEPACreditPaymentInitiation } from './pain/001/sepa-credit-payment-initiation';
+export type { SEPAMultiCreditPaymentInitiationConfig, SEPAMultiCreditPaymentInstructionGroup } from './pain/001/sepa-multi-credit-payment-initiation';
+export { SEPAMultiCreditPaymentInitiation } from './pain/001/sepa-multi-credit-payment-initiation';
 export type { RTPCreditPaymentInitiationConfig } from './pain/001/rtp-credit-payment-initiation';
 export { RTPCreditPaymentInitiation } from './pain/001/rtp-credit-payment-initiation';
 export type { ACHCreditPaymentInitiationConfig } from './pain/001/ach-credit-payment-initiation';

package/dist/src/iso20022.d.ts

@@ -1,6 +1,7 @@
 import { Party, SWIFTCreditPaymentInstruction, SEPACreditPaymentInstruction, RTPCreditPaymentInstruction, ACHCreditPaymentInstruction } from './lib/types.js';
 import { SWIFTCreditPaymentInitiation } from './pain/001/swift-credit-payment-initiation';
 import { SEPACreditPaymentInitiation } from './pain/001/sepa-credit-payment-initiation';
+import { SEPAMultiCreditPaymentInitiation, SEPAMultiCreditPaymentInstructionGroup } from './pain/001/sepa-multi-credit-payment-initiation';
 import { RTPCreditPaymentInitiation } from './pain/001/rtp-credit-payment-initiation';
 import { ACHCreditPaymentInitiation } from './pain/001/ach-credit-payment-initiation';
 import { GenericISO20022Message, ISO20022MessageTypeName } from './lib/interfaces';
@@ -130,6 +131,53 @@ export interface SEPACreditPaymentInitiationConfig {
      */
     creationDate?: Date;
 }
+/**
+ * Configuration interface for SEPA Multi Credit Payment Initiation.
+ * @interface SEPAMultiCreditPaymentInitiationConfig
+ * @example
+ * const config: SEPAMultiCreditPaymentInitiationConfig = {
+ *     paymentInstructions: [
+ *       {
+ *         initiatingParty: debtor1,
+ *         payments: [
+ *           {
+ *             type: 'sepa',
+ *             direction: 'credit',
+ *             amount: 1000, // €10.00 Euros
+ *             currency: 'EUR',
+ *             creditor: {
+ *               name: 'Hans Schneider',
+ *               account: {
+ *                 iban: 'DE1234567890123456',
+ *               },
+ *             },
+ *             remittanceInformation: 'Invoice payment #123',
+ *           },
+ *         ],
+ *         categoryPurpose: 'SALA', // Optional
+ *       },
+ *     ],
+ *     messageId: 'MSGID123', // Optional
+ *     creationDate: new Date(), // Optional
+ * };
+ */
+export interface SEPAMultiCreditPaymentInitiationConfig {
+    /**
+     * An array of payment instruction groups, each with its own debtor.
+     * @type {AtLeastOne<SEPAMultiCreditPaymentInstructionGroup>}
+     */
+    paymentInstructions: AtLeastOne<SEPAMultiCreditPaymentInstructionGroup>;
+    /**
+     * Optional unique identifier for the message. If not provided, a UUID will be generated.
+     * @type {string}
+     */
+    messageId?: string;
+    /**
+     * Optional creation date for the message. If not provided, current date will be used.
+     * @type {Date}
+     */
+    creationDate?: Date;
+}
 /**
  * Configuration interface for RTP Credit Payment Initiation.
  * @interface RTPCreditPaymentInitiationConfig
@@ -311,6 +359,38 @@ declare class ISO20022 {
      * @returns {SEPACreditPaymentInitiation} A new SEPA Credit Payment Initiation object.
      */
     createSEPACreditPaymentInitiation(config: SEPACreditPaymentInitiationConfig): SEPACreditPaymentInitiation;
+    /**
+     * Creates a SEPA Multi Credit Payment Initiation message with multiple payment information blocks.
+     * @param {SEPAMultiCreditPaymentInitiationConfig} config - Configuration containing payment instruction groups and optional parameters.
+     * @example
+     * const payment = iso20022.createSEPAMultiCreditPaymentInitiation({
+     *   paymentInstructions: [
+     *     {
+     *       initiatingParty: debtor1,
+     *       payments: [
+     *         {
+     *           type: 'sepa',
+     *           direction: 'credit',
+     *           amount: 1000, // €10.00 Euros
+     *           currency: 'EUR',
+     *           creditor: {
+     *             name: 'Hans Schneider',
+     *             account: {
+     *               iban: 'DE1234567890123456',
+     *             },
+     *           },
+     *           remittanceInformation: 'Invoice payment #123',
+     *         },
+     *       ],
+     *       categoryPurpose: 'SALA', // Optional
+     *     },
+     *   ],
+     *   messageId: 'SEPA-MULTI-MSG-001', // Optional
+     *   creationDate: new Date('2025-03-01'), // Optional
+     * });
+     * @returns {SEPAMultiCreditPaymentInitiation} A new SEPA Multi Credit Payment Initiation object.
+     */
+    createSEPAMultiCreditPaymentInitiation(config: SEPAMultiCreditPaymentInitiationConfig): SEPAMultiCreditPaymentInitiation;
     /**
      * Creates a RTP Credit Payment Initiation message.
      * @param {RTPCreditPaymentInitiationConfig} config - Configuration containing payment instructions and optional parameters.

package/dist/src/pain/001/sepa-multi-credit-payment-initiation.d.ts

@@ -0,0 +1,167 @@
+import type { ExternalCategoryPurpose, Party, SEPACreditPaymentInstruction } from "../../lib/types";
+import { PaymentInitiation } from './payment-initiation';
+type AtLeastOne<T> = [T, ...T[]];
+/**
+ * Represents a group of payment instructions for a single debtor (PmtInf block).
+ *
+ * @property {Party} initiatingParty - The party (debtor) for this specific payment information block.
+ * @property {AtLeastOne<SEPACreditPaymentInstruction>} payments - An array containing at least one payment instruction for this debtor.
+ * @property {ExternalCategoryPurpose} [categoryPurpose] - Optional category purpose code for this payment information block.
+ */
+export interface SEPAMultiCreditPaymentInstructionGroup {
+    /** The party (debtor) for this specific payment information block. */
+    initiatingParty: Party;
+    /** An array containing at least one payment instruction for this debtor. */
+    payments: AtLeastOne<SEPACreditPaymentInstruction>;
+    /** Optional category purpose code for this payment information block. */
+    categoryPurpose?: ExternalCategoryPurpose;
+}
+/**
+ * Configuration for SEPA Multi Credit Payment Initiation.
+ *
+ * @property {Party} initiatingParty - The top-level party initiating the message (used in GrpHdr).
+ * @property {AtLeastOne<SEPAMultiCreditPaymentInstructionGroup>} paymentInstructions - An array containing at least one payment instruction group.
+ * @property {string} [messageId] - Optional unique identifier for the message. If not provided, a UUID will be generated.
+ * @property {Date} [creationDate] - Optional creation date for the message. If not provided, current date will be used.
+ */
+export interface SEPAMultiCreditPaymentInitiationConfig {
+    /** The top-level party initiating the message (used in GrpHdr). */
+    initiatingParty: Party;
+    /** An array containing at least one payment instruction group. */
+    paymentInstructions: AtLeastOne<SEPAMultiCreditPaymentInstructionGroup>;
+    /** Optional unique identifier for the message. If not provided, a UUID will be generated. */
+    messageId?: string;
+    /** Optional creation date for the message. If not provided, current date will be used. */
+    creationDate?: Date;
+}
+/**
+ * Represents a SEPA Multi Credit Payment Initiation.
+ * This class handles the creation and serialization of SEPA credit transfer messages
+ * with multiple payment information blocks (multiple debtors) according to the ISO20022 standard.
+ * @class
+ * @extends PaymentInitiation
+ * @param {SEPAMultiCreditPaymentInitiationConfig} config - The configuration for the SEPA Multi Credit Payment Initiation message.
+ * @example
+ * ```typescript
+ * // Creating a SEPA multi-payment message
+ * const payment = new SEPAMultiCreditPaymentInitiation({
+ *   initiatingParty: { name: 'Company Ltd', id: '12345' },
+ *   paymentInstructions: [
+ *     {
+ *       initiatingParty: debtor1,
+ *       payments: [payment1, payment2]
+ *     },
+ *     {
+ *       initiatingParty: debtor2,
+ *       payments: [payment3]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+export declare class SEPAMultiCreditPaymentInitiation extends PaymentInitiation {
+    initiatingParty: Party;
+    messageId: string;
+    creationDate: Date;
+    paymentInstructions: AtLeastOne<SEPAMultiCreditPaymentInstructionGroup>;
+    paymentInformationIdBase: string;
+    private formattedPaymentSum;
+    private totalTransactionCount;
+    /**
+     * Creates an instance of SEPAMultiCreditPaymentInitiation.
+     * @param {SEPAMultiCreditPaymentInitiationConfig} config - The configuration object for the SEPA multi credit transfer.
+     */
+    constructor(config: SEPAMultiCreditPaymentInitiationConfig);
+    /**
+     * Counts the total number of transactions across all payment instruction groups.
+     * @private
+     * @returns {number} The total count of all transactions.
+     */
+    private countAllTransactions;
+    /**
+     * Calculates the sum of all payment instructions across all groups.
+     * @private
+     * @returns {string} The total sum formatted as a string with 2 decimal places.
+     */
+    private sumAllPayments;
+    /**
+     * Calculates the sum of payment instructions for a single group.
+     * @private
+     * @param {AtLeastOne<SEPACreditPaymentInstruction>} payments - Array of payment instructions.
+     * @returns {string} The total sum formatted as a string with 2 decimal places.
+     * @throws {Error} If payment instructions have different currencies.
+     */
+    private sumPaymentInstructions;
+    /**
+     * Validates the payment initiation data according to SEPA requirements.
+     * @private
+     * @throws {Error} If messageId exceeds 35 characters.
+     * @throws {Error} If any group's payment instructions have different currencies.
+     */
+    private validate;
+    /**
+     * Validates that all payment instructions in a group have the same currency.
+     * @private
+     * @param {AtLeastOne<SEPACreditPaymentInstruction>} payments - Array of payment instructions.
+     * @throws {Error} If payment instructions have different currencies.
+     */
+    private validateGroupInstructionsHaveSameCurrency;
+    /**
+     * Generates payment information for a single SEPA credit transfer instruction.
+     * @param {SEPACreditPaymentInstruction} instruction - The payment instruction.
+     * @returns {Object} The payment information object formatted according to SEPA specifications.
+     */
+    creditTransfer(instruction: SEPACreditPaymentInstruction): {
+        Cdtr: any;
+        CdtrAcct: {
+            Id: {
+                IBAN: string;
+            };
+            Ccy: "EUR";
+        };
+        RmtInf: {
+            Ustrd: string;
+        } | undefined;
+        CdtrAgt?: {
+            FinInstnId: {
+                BIC: string;
+                ClrSysMmbId?: undefined;
+            };
+        } | {
+            FinInstnId: {
+                ClrSysMmbId: {
+                    ClrSysId: {
+                        Cd: string;
+                    };
+                    MmbId: string;
+                };
+                BIC?: undefined;
+            };
+        } | undefined;
+        PmtId: {
+            InstrId: string;
+            EndToEndId: string;
+        };
+        Amt: {
+            InstdAmt: {
+                '#': string;
+                '@Ccy': "EUR";
+            };
+        };
+    };
+    /**
+     * Serializes the SEPA multi credit transfer initiation to an XML string.
+     * @returns {string} The XML representation of the SEPA multi credit transfer initiation.
+     */
+    serialize(): string;
+    /**
+     * Parses an XML string and creates a SEPAMultiCreditPaymentInitiation instance.
+     * Supports multiple PmtInf blocks in the XML document.
+     * @param {string} rawXml - The XML string to parse.
+     * @returns {SEPAMultiCreditPaymentInitiation} A new instance created from the XML data.
+     * @throws {InvalidXmlError} If the XML format is invalid.
+     * @throws {InvalidXmlNamespaceError} If the namespace is not pain.001.001.03.
+     */
+    static fromXML(rawXml: string): SEPAMultiCreditPaymentInitiation;
+}
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucianpacurar/iso20022.js",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "readme": "README.md",
   "description": "Library to create payment messages.",
   "main": "dist/index.js",