Field | Sub Field | Type | Description |
Remittance Advice Id |
Alphanumeric
|
Unique number to identify batch file Notes: UNIQUE per file |
|
Creation DateTime | Datetime | Creation date and time of the file Example: 2012-02-03T11:20:45 |
|
Number of Payments | Integer (Long) |
The total number of transactions within the file. Jinius checks the given value with the total number of group of payments | |
Total Amount | Amount |
Total payment amount of all transactions within the file. Notes: |
|
Execution Date | Date |
Batch Payment Execution date Example: 2022-07-03 Notes: current or future date |
|
Payments | Array | Remittance record defined by required fields for the payment | |
Supplier | Object | ||
Company Name | String Selected special chars allowed ( .,-?:+’/\ ) |
Recipient's Company Name - as is written in company registration records | |
Company TIN |
Alphanumeric Standard format: 8digits + 1 char at the end |
Recipient's Company Tax Identification Number/Code | |
Company VAT |
Alphanumeric Standard format: 8digits + 1 char at the end |
Recipient's Company VAT | |
Company Registration Number |
Alphanumeric ends with 1 to 8 digits |
Recipient's Company Registration number | |
Recipient email for contact | |||
Payment Details | Object | ||
Debtor Details | Object | ||
Account Number | Numeric | Bank account number which will be used to pay the specific payment record Notes: - currently only Bank of Cyprus accounts are supported – account number should contain only numbers, without dashes (–) or spaces |
Creditor Details | Object | ||
Creditor IBAN | IBAN |
Recipient IBAN Notes: any valid IBAN could be provided – IBAN is checked based on international standards |
|
Creditor Factors Account Number | Numeric (16 digits) |
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. |
|
Creditor Beneficiary name | String Selected special chars allowed (.,-?:+’/\) |
Recipient Account Name | |
Remittance Amount | Amount |
Total payment amount for the specific record Notes: |
|
Payment Reference Number | Alphanumeric Selected special chars allowed (-) |
Unique reference number - this will be used to be identified by the recipient – reference number defined by user’s system – Notes: UNIQUE for all batch files and for each payment within the same file. | |
Description | String Allowed special chars: / - ? : ( ) . , ‘ + space |
Additional description in bank’s statement (used in general payments) |
|
Payment Options | |||
Payment Type | String | Payment type define if the payment includes invoicing information or not Available values: 1) General 2) Invoices Notes:
|
Invoices | Object | ||
Buyer Reference Number | String | Invoice reference number based on user’s system | |
Supplier Invoice Number | String | Issued invoice number - as provided by the supplier | |
Invoice Total Amount | Amount | Invoice amount to be paid Notes: - Currency by default EUR - Integer or double with 2 decimals |
|
Invoice Discount Amount | Amount | Invoice discount - just informative value - not used for sums Notes: - Currency by default EUR - Integer or double with 2 decimals - If not available can be set to 0 |
|
Issue Date | Date | Invoice issue date - available for crosschecks within the platform for invoice validity - if invoice exists in the platform Example: 2022-06-03 |
An example of file is as below:
{ "groupHeader": { "remittanceAdviceId": "111111", "creationDateTime": "2021-08-16T13:30:31.176Z", "executionDate": "2021-08-16", "numberOfPayments": 1, "totalAmount": 100.00 }, "payments": [ { "paymentDetails": { "debtorDetails": { "accountNumber": "2222222" }, "creditorDetails": { "iban": "string", "creditorName": "333333" }, "amount": 100.00, "paymentReference": "122222" }, "supplier": { "taxIdentificationNumber": "11111111A", "vatNumber": "11111111A ", "companyRegistrationNumber": "A111111 ", "companyName": "Company Ltd", "email": "companyemail@companyemail.com" }, "invoices": [ { "buyerReferenceNumber": "DE133333", "supplierInvoiceNumber": "Q1444444", "amount": 100.00, "discount": 0, "issueDate": "2021-08-16" } ] } ] } |