Difference between revisions of "KashFlow Accounting"
| (One intermediate revision by the same user not shown) | |||
| Line 52: | Line 52: | ||
== Requirements == | == Requirements == | ||
| − | The KashFlow API requires SOAP in your server's PHP build. To check whether you have this, go to '''Utilities > System > PHP Info''' in WHMCS. If you do not see references to SOAP, you will need to recompile PHP. | + | The KashFlow API requires SOAP in your server's PHP build. To check whether you have this, go to '''Utilities > System > [[PHP Info]]''' in WHMCS. If you do not see references to SOAP, you will need to recompile PHP. |
== The Syncing Process == | == The Syncing Process == | ||
| Line 59: | Line 59: | ||
* The module can process a maximum of 200 invoices each time. | * The module can process a maximum of 200 invoices each time. | ||
| − | * The system records errors in the log at '''Utilities > Activity Log'''. We recommend that you review this periodically. | + | * The system records errors in the log at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > [[System Logs]]''' or, prior to WHMCS 8.0, '''Utilities > Activity Log'''. We recommend that you review this periodically. |
* The first few runs may require a longer period of time as they attempt to sync all existing customers and paid invoices. | * The first few runs may require a longer period of time as they attempt to sync all existing customers and paid invoices. | ||
| Line 71: | Line 71: | ||
# When creating client accounts in KashFlow via this integration, WHMCS sends the appropriate currency ID. The currency code '''must''' match. | # When creating client accounts in KashFlow via this integration, WHMCS sends the appropriate currency ID. The currency code '''must''' match. | ||
| − | Make sure to configure all of your currencies in both KashFlow and WHMCS. You can find your configured currencies in WHMCS at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > Currencies''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''. | + | Make sure to configure all of your currencies in both KashFlow and WHMCS. You can find your configured currencies in WHMCS at '''Configuration (<i class="fa fa-wrench" aria-hidden="true"></i>) > System Settings > [[Currencies]]''' or, prior to WHMCS 8.0, '''Setup > Payments > Currencies'''. |
== Troubleshooting == | == Troubleshooting == | ||
Latest revision as of 20:06, 11 May 2022
Contents
About this Addon Module
KashFlow is an accounting system for small businesses, particularly for businesses in the UK. This addon automates the entry of paid invoices into the KashFlow system.
The sync process runs as part of the daily cron job and creates clients, invoices, and transactions in KashFlow to mirror the invoice and transaction records in WHMCS.
| Addon Name | Latest Release | Current Version | Compatible With | Included in WHMCS |
|---|---|---|---|---|
| KashFlow Accounting | N/A | N/A | N/A | Yes |
Activating KashFlow Accounting
You must download and upload this addon before you can activate it through the Admin Area.
To do this:
- Make certain that your WHMCS installation meets the requirements below.
- Download the latest version of the addon.
- Unzip the files.
- Upload the kashflow folder from the ZIP file to the /modules/addons/ directory in WHMCS.
- Log in to the Kashflow control panel.
- Go to Settings > External Services > API Settings.
- Check the following options:
- Enabled
- Restrict Access to specific IP Addresses
- Separate API password
- Click edit addresses list.
- Add your server's IP address to the Authorised IP Addresses list.
- Return to the previous page and enter an API password.
- Log in to the WHMCS Admin Area.
- Go to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
- Click Activate for KashFlow Accounting.
- Click Configure.
- Choose the KashFlow payment method and bank account to assign to transactions for each WHMCS payment gateway when syncing.
- Enter your KashFlow username and API password.
- Select the admin role groups who will have access to this addon.
- Click Save Changes.
Requirements
The KashFlow API requires SOAP in your server's PHP build. To check whether you have this, go to Utilities > System > PHP Info in WHMCS. If you do not see references to SOAP, you will need to recompile PHP.
The Syncing Process
If it is enabled, the sync process runs as part of the daily cron job.
- The module can process a maximum of 200 invoices each time.
- The system records errors in the log at Configuration () > System Logs or, prior to WHMCS 8.0, Utilities > Activity Log. We recommend that you review this periodically.
- The first few runs may require a longer period of time as they attempt to sync all existing customers and paid invoices.
Multi-Currency Support
Both WHMCS and Kashflow support the use of multiple currencies.
When you use this:
- WHMCS will connect to KashFlow and retrieve the configured currencies.
- WHMCS will match the KashFlow currency codes with the codes in WHMCS.
- When creating client accounts in KashFlow via this integration, WHMCS sends the appropriate currency ID. The currency code must match.
Make sure to configure all of your currencies in both KashFlow and WHMCS. You can find your configured currencies in WHMCS at Configuration () > System Settings > Currencies or, prior to WHMCS 8.0, Setup > Payments > Currencies.
Troubleshooting
KashFlow: Error Inserting Transaction xx
Seeing this error in the logs indicates that the transaction data does not meet Kashflow's requirements. Review the information at Billing > Transactions List and Billing > Invoices to ensure that all transactions and invoices have an assigned payment gateway and that transactions have a transaction ID.
Error Inserting Customer x: Customer Code is not unique
Seeing this error in the logs after Kashflow synchronisation indicates that the client's email address no longer matches the email address in Kashflow. To resolve this, update the client's email address in Kashflow to match it in WHMCS.
Change Log
N/A