Skip to main content

What fields does the XML file include?

The description of each message item contains:

  1. Group Header Segment
  2. Payment Information Segment
    • Transaction Information Segment (multiple records)

Group Header Segment

Name XML tag Level Type Description
Group Header GrpHdr Top   Tag Only
Message Identification MsgId 1 Alphanumeric
Max Length: 35		 Unique file reference. If no unique file reference is used for each file, the file is rejected.
Creation Date Time CreDtTm 1 Datetime Creation date and time of the file
Example: 2012-02-03T11:20:45
Number of Transactions NbOfTxs 1 Numeric
Max length:15		 The number of transactions with different debtors’ accounts within the file. Jinius checks the given value with the total number of group of payments per debtor in the entire message
ControlSum CtrlSum 1 Amount Total amount of all individual transactions within the file.
Initiating Party InitgPty 1   Tag Only

 

Payment Information Segment

Name XML tag Level Type Description
Payment Information PmtInf Top   Tag Only
Payment Information Id PmtInfId 1 Alphanumeric
Max Length: 35		 Unique file reference. If no unique file reference is used for each file, the file is rejected.
Payment Method PmtMtd 1 Alphanumeric TRF (Fixed Value)
Number of Transactions NbOfTxs 1 Numeric
Max length:15		 The number of transactions. Jinius checks the given value with the total number of transactions.
ControlSum CtrlSum 1 Amount Total amount of all individual transactions within the file.
Requested Execution Date ReqdExctnDt 1 Date Batch Payment Execution date – should be current or future date
Example: 2022-05-03
Debtor Dbtr 1   Tag Only
Name Nm 2   Debtor Name
Debtor Account DbtrAcct 1   Tag Only
Id Id 2   Tag Only
IBAN IBAN 3   Debtor IBAN
Debtor Agent DbtrAgt 1   Tag Only
Financial Institution FinInstnId 2   Tag Only
BIC BIC 3 Alphanumeric
Max Length:11		 Debtor’s bank BIC

Transaction Information Segment

Name XML tag Level Type Description
Credit transaction Information CdtTrfTxInf 1   Tag Only
PaymentIdentification PmtId 2   Tag Only
EndtoEndIdentification EndToEndId 3 Alphanumeric
Max Length: 35		 End-to-End UNIQUE Reference number of the credit transfer. This information is sent to the beneficiary. This number/code should be UNIQUE.
Amount Amt 2   Tag Only
Instructed Amount InstdAmt 3   Amount of the credit transfer in EUR.
Creditor Cdtr 2   Tag Only
Name Nm 3 Alphanumeric Name of the beneficiary
Id Id 3   Tag Only
Organisation Id OrgId 4   Tag Only
Other Othr 5   Tag Only
Id Id 6 Alphanumeric Defines the key for each creditor company details
Available Options:
  1. taxIdentificationNumber (Creditor’s Company Tax Identification Number/Code)
  2. vatNumber (Creditor’s Company VAT)
  3. companyRegistrationNumber (Creditor’s Company Registration number)
Scheme Name SchmeNm 6   Tag Only
Proprietary Prtry 7   Combined with field “Id” above.
The related values based on defined Id value.
Contact Details CtctDtls 3   Tag Only
Email Address EmailAdr 4   Creditor Email Address

 

Creditor Account CdtrAcct 2   Tag Only
Id Id 3   Tag Only
IBAN IBAN 4 Alphanumeric
Max Length: 34		 Creditor IBAN
Other Othr 4   Tag Only
Id Id 5 Alphanumeric
Max Length: 34

Bill account number

Used for BoC Factor’s payments – If payment is related to BoC Factoring Division then this field should be used instead of IBAN.
Name Nm 3 Alphanumeric
Max Length: 70		 Creditor Beneficiary Name
Remittance Information RmtInf 2   Tag Only
Unstructured Ustrd 3 Alphanumeric Additional description in bank’s statement
(used in general payments)
Structured Strd 3   Tag Only
Referred Document Information RfrdDocInf 4   Tag Only
Number Nb 5 Alphanumeric
Max Length: 35		 Invoice reference number based on user’s system
RelatedDate RltdDt 5   Invoice issue date - available for crosschecks within the platform for invoice validity - if invoice exists in the platform
ReferredDocumentAmount RfrdDocAmt 4   Tag Only
DuePayableAmount DuePyblAmt 5 Amount Invoice final payable amount.
Jinius checks the given value in the sum for total amount.
DiscountAppliedAmount DscntApldAmt   Amount Invoice discount amount.
Jinius is using this value just for information. This value it’s not counted in the total payment amount.
CreditNoteAmount CdtNoteAmt   Amount Standalone credit note amount. If DuePyblAmt is not provided, then this value will be counted as negative value for total transaction amount.
CreditorReferenceInformation CdtrRefInf 4   Tag Only
Reference Ref 5   Issued invoice number - as provided by the supplier

 

Example file:

<?xml version="1.0" encoding="utf-8"?>

<Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03">

    <CstmrCdtTrfInitn>

        <GrpHdr>

            <MsgId>REMXML00000252</MsgId>

            <CreDtTm>2024-10-29T00:00:00</CreDtTm>

            <NbOfTxs>3</NbOfTxs>

            <CtrlSum>1350.12</CtrlSum>

            <InitgPty></InitgPty>

        </GrpHdr>

        <PmtInf>

            <PmtInfId>REMXML00000252</PmtInfId>

            <PmtMtd>TRF</PmtMtd>

            <NbOfTxs>3</NbOfTxs>

            <CtrlSum>1350.12</CtrlSum>

            <ReqdExctnDt>2024-10-29</ReqdExctnDt>

            <Dbtr>

                <Nm>Debtor Ltd</Nm>

            </Dbtr>

            <DbtrAcct>

                <Id>

                    <IBAN>CY34002003510000001234567300</IBAN>

                </Id>

            </DbtrAcct>

            <DbtrAgt>

                <FinInstnId>

                    <BIC>BCYPCY2NXXX</BIC>

                </FinInstnId>

            </DbtrAgt>

            <CdtTrfTxInf>

                <PmtId>

                    <EndToEndId>AEN2000000000001</EndToEndId>

                </PmtId>

                <Amt>

                    <InstdAmt Ccy="EUR">307.66</InstdAmt>

                </Amt>

                <Cdtr>

                    <Nm>Supplier A Ltd (Comp details - Invoices type General)</Nm>

                    <Id>

                        <OrgId>

                           <Othr>

                                <Id>taxIdentificationNumber</Id>

                                <SchmeNm>

                                    <Prtry>62817161L</Prtry>

                                </SchmeNm>

                            </Othr>

                        <Othr>

                                <Id>vatNumber</Id>

                                <SchmeNm>

                                    <Prtry>12312314A</Prtry>

                                </SchmeNm>

                            </Othr>                                                                                             

                            <Othr>

                                <Id>companyRegistrationNumber</Id>

                                <SchmeNm>

                                    <Prtry>HE62866</Prtry>

                                </SchmeNm>

                            </Othr>

                        </OrgId>

                    </Id>

                </Cdtr>

                <CdtrAcct>

                    <Id>

                        <IBAN>CY79002012220000002222222221</IBAN>

                    </Id>

                    <Nm>Supplier A Ltd (Comp details - Invoices type General)</Nm>

                </CdtrAcct>

                <RmtInf>

                    <Strd>

                        <RfrdDocInf>

                            <Nb>BREF0001</Nb>

                            <RltdDt>2024-02-16</RltdDt>

                        </RfrdDocInf>

                        <RfrdDocAmt>

                            <DuePyblAmt Ccy="EUR">13.00</DuePyblAmt>

                        </RfrdDocAmt>

                        <CdtrRefInf>

                            <Ref>SUP0001</Ref>

                        </CdtrRefInf>

                    </Strd>

                    <Strd>

                        <RfrdDocInf>

                            <Nb>BREF0002</Nb>

                            <RltdDt>2021-07-18</RltdDt>

                        </RfrdDocInf>

                        <RfrdDocAmt>

                            <CdtNoteAmt Ccy="EUR">5.34</CdtNoteAmt>

                        </RfrdDocAmt>

                        <CdtrRefInf>

                            <Ref>SUP0002</Ref>

                        </CdtrRefInf>

                    </Strd>

                    <Strd>

                        <RfrdDocInf>

                            <Nb>BREF0003</Nb>

                            <RltdDt>2021-07-18</RltdDt>

                        </RfrdDocInf>

                        <RfrdDocAmt>

                            <DuePyblAmt Ccy="EUR">100.00</DuePyblAmt>

                        </RfrdDocAmt>

                        <CdtrRefInf>

                            <Ref>SUP0003</Ref>

                        </CdtrRefInf>

                    </Strd>

                    <Strd>

                        <RfrdDocInf>

                              <Tp>

                                  <CdOrPrtry>

                                  <Prtry>General</Prtry>

                                  </CdOrPrtry>

                              </Tp>

                            <Nb>BREF0004</Nb>

                            <RltdDt>2021-07-18</RltdDt>                                                

                        </RfrdDocInf>

                        <RfrdDocAmt>

                            <DuePyblAmt Ccy="EUR">200.00</DuePyblAmt>

                        </RfrdDocAmt>

                        <CdtrRefInf>

                            <Ref>SUP0004</Ref>

                        </CdtrRefInf>

                    </Strd>

                </RmtInf>

            </CdtTrfTxInf>

            <CdtTrfTxInf>

                <PmtId>

                    <EndToEndId>AEN2000000000002</EndToEndId>

                </PmtId>

                <Amt>

                    <InstdAmt Ccy="EUR">1031.2</InstdAmt>

                </Amt>

                <Cdtr>

                    <Nm>Supplier B ltd (Company details - Missing invoice info)</Nm>

                    <Id>

                        <OrgId>

                            <Othr>

                                <Id>vatNumber</Id>

                                <SchmeNm>

                                    <Prtry>12807060Z</Prtry>

                                </SchmeNm>

                            </Othr>

                          <Othr>

                                <Id>companyRegistrationNumber</Id>

                                <SchmeNm>

                                    <Prtry>ΗΕ807060</Prtry>

                                </SchmeNm>

                            </Othr>

                        </OrgId>

                    </Id>

                    <CtctDtls>

                        <EmailAdr>sample2@sampleemail.com</EmailAdr>

                    </CtctDtls>

                </Cdtr>

                <CdtrAcct>

                    <Id>

                        <IBAN>CY79002012220000002222222221</IBAN>

                    </Id>

                    <Nm>Supplier B ltd (Company details - Missing invoice info)</Nm>

                </CdtrAcct>

            </CdtTrfTxInf>

            <CdtTrfTxInf>

                <PmtId>

                    <EndToEndId>AEN2000000000003</EndToEndId>

                </PmtId>

                <Amt>

                    <InstdAmt Ccy="EUR">11.26</InstdAmt>

                </Amt>

                <Cdtr>

                    <Nm>Supplier C ltd (No details Supplier - No invoices)</Nm>

                    <CtctDtls>

                        <EmailAdr>sample3@sampleemail.com</EmailAdr>

                    </CtctDtls>

                </Cdtr>

                <CdtrAcct>

                    <Id>

                        <IBAN>CY79002012220000002222222221</IBAN>

                    </Id>

                    <Nm>Supplier C ltd (No details Supplier - No invoices)</Nm>

                </CdtrAcct>

               <RmtInf>

                        <Ustrd>payment description custom</Ustrd>

               </RmtInf>

            </CdtTrfTxInf>

        </PmtInf>

    </CstmrCdtTrfInitn>

</Document>