Features

• Synchronisation of wallet balance from Airwallex to Odoo
• Synchronisation of bank statement from Airwallex to Odoo

1. Installation

1.1. Download

• To get started with the Airwallex module, download one of the supported versions: Version 16, Version 15, or Version 14.

1.2. Install module on the Odoo

• After downloading the correct version, unzip the module and place it in the add-ons folder on your server. Then, log in as an administrator and navigate to the Applications menu. Click on 'Update Apps list' to refresh the module list. Finally, locate the Airwallex application and click on 'Install'.
  

2. Configure Airwallex

2.1. Application Overview

• After installation, the Airwallex application will appear on the main menu. If you can't see the application, ensure that the logged-in user has the required Airwallex user access rights.
  
  
  
  

2.2. Create account and login

• The first step after installation is to create an Airwallex account. To create an account, go to Airwallex → Configuration → Airwallex Account and create a new account.
  
  Note: Ensure that you choose the correct environment (demo for staging or production for real credentials) while entering your credentials
  

2.2.1. OAuth2 Authentication

• OAuth2 authentication is the preferred way to register an account. To get started with authentication using OAuth2, simply click on the "OAuth2 Authentication" button. This will redirect you to the OAuth2 flow where you can securely connect & authorize access to your account.
  
  
  You will be redirected to log in to your Airwallex account, select the account that you want to connect to Odoo, and review the relevant permissions that Odoo is requesting.
  
  
  
  
  
  
  Once connected, you will see an Airwallex account created with a timestamp.You can refresh/renew the authentication by clicking the “Renew Authentication” button.
  
  
  Click the 'Get Airwallex Balance' button to retrieve all wallet transactions from Airwallex and synchronize them with your Odoo account.
  
  
  You can check the synchronized wallets by clicking the Airwallex wallet tab.
  
  
  
  Note: We will only sync currencies that are active in Odoo - refer to section ‘Set up currencies’ below to activate more currency feeds Odoo will only sync active currencies. To activate additional currencies, search for ‘currencies’ on the main dashboard, activate the required currency, and then click on the 'Refresh Airwallex balance' button.
  
  
  On the account page, you can choose the frequency of Airwallex balance update and bank statement posting. For more information, refer to the field “Sync Period” and “Bank Statement Period” below.
  
  Note: The bank statement feature has been removed in version 16, so there is no need to post the bank statement.

2.3. Setup Currencies

• In Odoo, we can only synchronize an Airwallex wallet if the currency is active in Odoo. Therefore, if a wallet is not syncing in Odoo, check the status of the currency by searching for ‘currencies’ on the main dashboard or open menu Invoicing → Configuration → Currencies.
  
  
  You can activate the required currency on this page by clicking on the "Active" column of the currency record.
  • If the "Active" button is green, it indicates that the currency is already active.
  
  
  Then, go back to your Airwallex account and click on the button ‘Refresh Airwallex balance’
  
  Now, you can see that the new currency feed setup in Airwallex Wallet
  
  
  

2.4. Journal Creation

• Click on Accounting menu
  


• Choose Configuration → Journals menu
  


• Click on Create button
  


• Fill in the data to Journal form
  
  
  1. Journal Name : filled with the name of the journal
  2. Type : filled with the type of journal
  3. Bank Account : filled with a bank account
  4. Suspense Account : filled with bank intermediary account
  5. Profit Account : filled with profit account
  6. Loss Account : filled with loss account
  7. Short Code : filled with the code for the journal created
  8. Account Number : filled with the bank account number


• Click Save button

2.5. Initiate Your Bank Account Journal

• This is the last step to synchronize the transaction from your wallet to Odoo. Click on the Airwallex wallet that you want to configure and then click on the "Edit" button.
  
  Note: Only user with Airwallex Administrator can see the Edit button


• After clicking on the 'Edit' button, you will be shown a dialog box
  
  • The journal you want to assign the wallet to
  • The Initialisation method:
    • Import historical data
      Will import all the data starting from the chosen date
    • Set initial balance
      Will create only one record with the current balance
    • None
      Will not initialize the journal


• Choose the journal and the method according to your needs.
• In the following example, we will Import historical data
  
  Once you click on 'Apply', Odoo will fetch all the records until the chosen date and create a bank statement record with all the lines.


• You can see the bank statement by clicking on the "Bank Statements" button on the top-right:
  
  


• You can verify the value imported and post the bank statement
  

3. Advanced Configuration

3.1. Refresh Frequency

• On the Airwallex account configuration page, you can set up the frequency (hourly, daily or weekly) for Odoo to import information from Airwallex.
  


• To set up the refresh frequency, you can access the feature through the search function if you have an ‘Admin’ role and are in developer mode. The scheduled action is performed using ‘Airwallex.account.ir.cron’ to fetch information from Airwallex.
  


• You can modify the value here to select your preferred refresh frequency: