Aritma bank integration set up (ARITMASETUP) application
1. To set up the new integration, start with activating the following Company settings (CSV) in RamBase:
Activate Bank Integration – Setting for the bank integration, containing bank statements, incoming payments and remittance. Please note that a valid bank agreement has to be made and that agreement ID is added on relevant bank accounts in the BANK application.
Use production environment – If this setting is activated, the bank integration will use the production environment of the providers. Activate this setting only on production systems!
2. Bank integration configuration
When the Company settings (CSV) in step one is activated, you will see a new component in the BANK application, Bank Integration Configuration. There must be a valid SWIFT-code in the Swift-code field before this component will show. SWIFT-code is the key to RamBase/Bankconnector to understand which bank the setup applies to.
![Bank124.jpg](../../image/uuid-de9b44c0-acb3-39f0-277f-dd150a5ca2f8.jpg)
3. Product terms
Note that the customer must accept the Product terms to get access to the 6 fields under Bank Integration Configuration.
Before approval:
![Aritma_bilde_nr_1002.jpg](../../image/uuid-0796dc4b-16f0-c55b-ce23-0597a6637b69.jpg)
After approval:
![Artima_2023_2.jpg](../../image/uuid-d131975f-6e77-e376-6891-00a19823f9ca.jpg)
4. Activating the bank integration
To activate the bank integration, the company must set up a banking agreement between company and bank. The process for this is different depending on the bank. By entering Setup Aritma Bank Integration you will see onboarding instructions.
NB: It is important that the customer informs the bank that approval of outgoing payments should be done in the online bank. Approval of outgoing payments is currently not supported by RamBase.
![Aritma_6_onboarding.jpg](../../image/uuid-8e732158-47e9-e28b-0cce-b2111546762b.jpg)
5. Onboarding process
When the customer has ordered the integration at the bank, the consultant can start the onboarding process with Aritma.
(Request Process):
Request Company ID
![Aritma_bilde_nr_005.jpg](../../image/uuid-fcdb2edc-36d4-01a1-c35b-7bdada4918ef.jpg)
Request Service
![Aritma_bilde_nr_003.jpg](../../image/uuid-667f50ce-1af8-ecce-88c3-5ce2b194608d.jpg)
NB! If the company being set up must approve the payments in the Aritma portal, then Bank approval must NOT be ticked. If Bank Approval is ticked, then approval of the payments must take place in the bank (the user must log in to the bank to approve the payments).
Request Bank Account
![Aritma_bilde_nr_100.jpg](../../image/uuid-280be097-bdf9-20a5-b6e6-b5d13f2f2fc6.jpg)
Request Company User:
For most banks it is not necessary to request company user. This is only necessary if the customer is using Nordea and don’t have “Corporate nettbank” or if they use some of the Eika banks.
For more information, see Bank specific information in the bottom of the documentation.
If you must create a company user the process for this is:
Add the user that shall send the payment. It is not recommended to fill out password in this step. When the user gets created, that person will get an email from Aritma with a link where the user can create a password.
NB: As mentioned the user will get an email from Aritma that a user has been created, so the user should be informed about this beforehand.
![Aritma_bilde_nr_007.jpg](../../image/uuid-a9cff93e-eea1-609d-d3b2-7d0e9df66495.jpg)
6. Status
Until the bank has finished their setup the status will be «WaitForAritmaApprove».
It is important NOT to tick the boxes for Activate Bank Statements, Activate remittance or Activate Incoming Payments before the status is Active. This will normally be the same day as the bank has finished their setup.
![Aritma_bilde_nr_8.jpg](../../image/uuid-00e94911-f93b-4ed0-23bf-03ecebf02f61.jpg)
7. Active status
When status is changed to Active you could tick of the 3 boxes in the BANK application. The integrations are activated and ready to use when this is done.
Please note that it is not necessary to fill out Contract Id, User Name or Password.
![Aritma_bilde_nr_8.jpg](../../image/uuid-00e94911-f93b-4ed0-23bf-03ecebf02f61.jpg)
![Aritma_bilde_nr_002.jpg](../../image/uuid-e47c8b27-88de-a1e2-7a48-6630f1c34fd5.jpg)
8. Request process for more bank accounts for the same company
With regards to the request process, it is only necessary to run the Request bank account on the rest of the accounts as long as it is the same bank. If the bank is different, the same setup must be done all over for the new bank, including a new bank agreement with this bank.
9. Payments
Mark and copy the Sendno from the PAY you need more detail about:
![Aritma_bilde_nr_101.jpg](../../image/uuid-1f71a186-0066-4a85-033f-cfda31f00387.jpg)
Paste it in ARITMASETUP – in the Payment tab in the Sendno field and press enter.
All the payments belonging to this Sendno is presented in the box Payments list. Mark the payment you wish to see more details about. The details are presented in the box Payment details:
![Aritma_bilde_nr_0011.jpg](../../image/uuid-f2be56ae-23d0-c1c0-5f5c-b146e162b0d1.jpg)
10. Bank reconciliation document (BST)
When the first bank reconciliation document (BST) gets imported to RamBase, ingoing balance must match either the last Bank statement (BST) document (May have been created manually) or the balance on the given BANK.
If this does not match, the Bank statement (BST) will stay in Status 2 with an error message.
![Aritma_bilde_nr_008.jpg](../../image/uuid-9ba8b847-9be2-c3c4-b90b-8947ba6aee79.jpg)
To get this right you must reconcile the bank until the date of the first Bank statement (BST) document. The first Bank statement (BST) document from the bank will only contain transactions and outgoing balance. To find the ingoing balance, RamBase calculated this by taking outgoing balance + transactions. It is the calculated IB that gets controlled against either the last Bank statement (BST) documents, or balance on the given BANK.
To find out what calculated IB is and how big the difference is, you can enter the iol/bankstatement.balances and enter one of the jobs there. You will find one job per bank several times a day.
![Aritma_bilde_nr_009.jpg](../../image/uuid-25da5109-4d3f-82eb-cc7e-f1735c293af3.jpg)
If you for some reason lack some Bank statement (BST) documents for a given period, it is possible to request historical transactions. In the Bank statement (BST) application user can right-click, choose Import Bank Statements from Bank Integration. Here you choose the correct bank and from/to date. It is possible to request transactions back to the day the integration where activated.
![Aritma_import_bank_statements.jpg](../../image/uuid-ca761544-8fc3-6125-67ed-d00a5b687d48.jpg)
Misc:
Aritma does not need information that a new customer has been onboarded. They receive this information through the API. But, if there is a demand of a specific start date, they should deliver files from a given date, this must be emailed to them specifically. This information can be sent to: Support@aritma.com
Bank specific information:
Nordea:
In Nordea you could either have a “Nettbank bedrift” deal or “Corporate Nettbank”. If the company has “Nettbank Bedrift” it is not possible to approve payments in the online bank. This is only possible then using “Corporate nettbank”. For companies with “nettbank bedrift” it is 2 alternatives to get outgoing payments to work using the bank integration:
Create a Corporate nettbank deal with Nordea.
Customer can approve payments on Aritma site by logging into pay.zdata.no with the user that gets created through the APIs by using “Request company user” in step 4.
Eika Banks:
Eika banks does not support approval of outgoing payments in the online bank. To get this to work the customer must approve payments by logging in to pay.zdata.no with the user that gets created through the APIs by using “Request company user” in step 4.
The Aritma bank integration set up must be done by a RamBase consultant or a RamBase partner consultant.