@lucianpacurar/iso20022.js 0.2.7 → 0.2.8

package/dist/index.d.ts

@@ -622,7 +622,7 @@ declare abstract class PaymentInitiation {
     static getBuilder(): XMLBuilder;
 }
 
-type AtLeastOne$4<T> = [T, ...T[]];
+type AtLeastOne$5<T> = [T, ...T[]];
 /**
  * Configuration for SWIFT Credit Payment Initiation.
  *
@@ -635,7 +635,7 @@ interface SWIFTCreditPaymentInitiationConfig$1 {
     /** The party initiating the payment. */
     initiatingParty: Party;
     /** An array of payment instructions. */
-    paymentInstructions: AtLeastOne$4<SWIFTCreditPaymentInstruction>;
+    paymentInstructions: AtLeastOne$5<SWIFTCreditPaymentInstruction>;
     /** 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. */
@@ -692,7 +692,7 @@ declare class SWIFTCreditPaymentInitiation extends PaymentInitiation {
     serialize(): string;
 }
 
-type AtLeastOne$3<T> = [T, ...T[]];
+type AtLeastOne$4<T> = [T, ...T[]];
 /**
  * Configuration for SEPA Credit Payment Initiation.
  *
@@ -706,7 +706,7 @@ interface SEPACreditPaymentInitiationConfig$1 {
     /** The party initiating the SEPA credit transfer. */
     initiatingParty: Party;
     /** An array containing at least one payment instruction for SEPA credit transfer. */
-    paymentInstructions: AtLeastOne$3<SEPACreditPaymentInstruction>;
+    paymentInstructions: AtLeastOne$4<SEPACreditPaymentInstruction>;
     /** 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. */
@@ -739,7 +739,7 @@ declare class SEPACreditPaymentInitiation extends PaymentInitiation {
     initiatingParty: Party;
     messageId: string;
     creationDate: Date;
-    paymentInstructions: AtLeastOne$3<SEPACreditPaymentInstruction>;
+    paymentInstructions: AtLeastOne$4<SEPACreditPaymentInstruction>;
     paymentInformationId: string;
     categoryPurpose?: ExternalCategoryPurpose;
     private formattedPaymentSum;
@@ -816,6 +816,171 @@ declare class SEPACreditPaymentInitiation extends PaymentInitiation {
     static fromXML(rawXml: string): SEPACreditPaymentInitiation;
 }
 
+type AtLeastOne$3<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.
+ */
+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$3<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.
+ */
+interface SEPAMultiCreditPaymentInitiationConfig$1 {
+    /** The top-level party initiating the message (used in GrpHdr). */
+    initiatingParty: Party;
+    /** An array containing at least one payment instruction group. */
+    paymentInstructions: AtLeastOne$3<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]
+ *     }
+ *   ]
+ * });
+ * ```
+ */
+declare class SEPAMultiCreditPaymentInitiation extends PaymentInitiation {
+    initiatingParty: Party;
+    messageId: string;
+    creationDate: Date;
+    paymentInstructions: AtLeastOne$3<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$1);
+    /**
+     * 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;
+}
+
 type AtLeastOne$2<T> = [T, ...T[]];
 /**
  * Configuration for RTP Credit Payment Initiation.
@@ -1394,6 +1559,53 @@ 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
+ * };
+ */
+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
@@ -1575,6 +1787,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.
@@ -1893,4 +2137,4 @@ declare class InvalidXmlNamespaceError extends Iso20022JsError {
     constructor(message: string);
 }
 
-export { type ABAAgent, ACHCreditPaymentInitiation, type ACHCreditPaymentInitiationConfig$1 as ACHCreditPaymentInitiationConfig, type ACHCreditPaymentInstruction, type ACHLocalInstrument, ACHLocalInstrumentCode, ACHLocalInstrumentCodeDescriptionMap, type Account, type Agent, type BICAgent, type Balance, type BalanceType, BalanceTypeCode, BalanceTypeCodeDescriptionMap, type BaseAccount, type BaseStatusInformation as BaseStatus, CashManagementEndOfDayReport, type Entry, type GroupStatusInformation as GroupStatus, type IBANAccount, ISO20022, InvalidXmlError, InvalidXmlNamespaceError, Iso20022JsError, type OriginalGroupInformation, type Party, type PaymentStatusInformation as PaymentStatus, PaymentStatusCode, PaymentStatusReport, RTPCreditPaymentInitiation, type RTPCreditPaymentInitiationConfig$1 as RTPCreditPaymentInitiationConfig, type RTPCreditPaymentInstruction, SEPACreditPaymentInitiation, type SEPACreditPaymentInitiationConfig$1 as SEPACreditPaymentInitiationConfig, type SEPACreditPaymentInstruction, SWIFTCreditPaymentInitiation, type SWIFTCreditPaymentInitiationConfig$1 as SWIFTCreditPaymentInitiationConfig, type SWIFTCreditPaymentInstruction, type Statement, type PaymentStatus as Status, type StatusInformation, type StatusType, type StructuredAddress, type Transaction, type TransactionStatusInformation as TransactionStatus };
+export { type ABAAgent, ACHCreditPaymentInitiation, type ACHCreditPaymentInitiationConfig$1 as ACHCreditPaymentInitiationConfig, type ACHCreditPaymentInstruction, type ACHLocalInstrument, ACHLocalInstrumentCode, ACHLocalInstrumentCodeDescriptionMap, type Account, type Agent, type BICAgent, type Balance, type BalanceType, BalanceTypeCode, BalanceTypeCodeDescriptionMap, type BaseAccount, type BaseStatusInformation as BaseStatus, CashManagementEndOfDayReport, type Entry, type GroupStatusInformation as GroupStatus, type IBANAccount, ISO20022, InvalidXmlError, InvalidXmlNamespaceError, Iso20022JsError, type OriginalGroupInformation, type Party, type PaymentStatusInformation as PaymentStatus, PaymentStatusCode, PaymentStatusReport, RTPCreditPaymentInitiation, type RTPCreditPaymentInitiationConfig$1 as RTPCreditPaymentInitiationConfig, type RTPCreditPaymentInstruction, SEPACreditPaymentInitiation, type SEPACreditPaymentInitiationConfig$1 as SEPACreditPaymentInitiationConfig, type SEPACreditPaymentInstruction, SEPAMultiCreditPaymentInitiation, type SEPAMultiCreditPaymentInitiationConfig$1 as SEPAMultiCreditPaymentInitiationConfig, type SEPAMultiCreditPaymentInstructionGroup, SWIFTCreditPaymentInitiation, type SWIFTCreditPaymentInitiationConfig$1 as SWIFTCreditPaymentInitiationConfig, type SWIFTCreditPaymentInstruction, type Statement, type PaymentStatus as Status, type StatusInformation, type StatusType, type StructuredAddress, type Transaction, type TransactionStatusInformation as TransactionStatus };

package/dist/index.js

@@ -7840,6 +7840,309 @@ 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,
+                            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
@@ -9567,6 +9870,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.
@@ -10036,4 +10378,5 @@ exports.PaymentStatusCode = PaymentStatusCode;
 exports.PaymentStatusReport = PaymentStatusReport;
 exports.RTPCreditPaymentInitiation = RTPCreditPaymentInitiation;
 exports.SEPACreditPaymentInitiation = SEPACreditPaymentInitiation;
+exports.SEPAMultiCreditPaymentInitiation = SEPAMultiCreditPaymentInitiation;
 exports.SWIFTCreditPaymentInitiation = SWIFTCreditPaymentInitiation;

package/dist/index.mjs

@@ -7838,6 +7838,309 @@ 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,
+                            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 +9868,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 +10362,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.8",
   "readme": "README.md",
   "description": "Library to create payment messages.",
   "main": "dist/index.js",