Main error messages and solutions with native integrations

When pushing your payables to an accounting software using a native integration, you may encounter an error message that prevents you from exporting successfully. Here below you can find a list of error messages with solutions to unblock you.

Important notes:

If an export failed because of some settings or missing data, you need to click on Send back to Prepare. Your payable will then go back to the Bookkeep > Prepare tab so that you can edit and retry the export.
If an export failed because the expense date is from a locked period, you will not be able to export it. Therefore you need to click on Mark as manually exported, then manually import this payable in your accounting software.

Authentication and connection errors

In this section you will find error messages related to authentication permissions or connection issues. You would need to go either to your accounting software account, or on Spendesk to Settings > Accounting Setup > Accounting integration.

Error message '[Accounting software] has been disconnected.'

It is very likely that you were disconnected from your accounting software when you pushed your expense. Please reconnect on Settings > Accounting Setup > Accounting integration and then retry to push your expense.

Error message 'We couldn't connect to your [Accounting software] account.'

Please reconnect on Settings > Accounting Setup > Accounting integration and then retry to push your expense.

Error message 'Make sure that the following values are correct: "Account ID, "Client ID", "Client Secret".'

For some native integrations, you need to provide some API credentials such as the account ID, client ID and client secret so that Spendesk can establish the connection. These credentials might have been changed or are incorrect. Please check in your accounting software and change them on Spendesk connection flow.

Error message 'You should also make sure your [Accounting software] settings are set up correctly so that we can connect to your [Accounting software] account.'

We suggest to check your accounting software account settings to verify that you granted the permissions or actions that are required for this integration.

Error message 'Your current plan does not include this native integration.'

For some native integrations, it is required to have a specific pricing plan as prerequisite. You can read the articles related to your integration.

Error message 'Server not responding.'

Your local server is not responding. The first action to perform in this case is to go to Settings > Accounting Setup > Accounting integration and click on the red button Refresh server status. This will try to relaunch the connection with the local agent on your server. If it does not solve the issue, please read the articles related to your integration.

Error message 'We cannot reach your [Accounting software] server. Please check with your [Accounting software] integrator that everything is running correctly on your server, ensuring the server agent is active. Once you've confirmed this, please click the button below to reconnect.'

We cannot reach your accounting software server. Please reach out to your integrator to check that everything is set up correctly, and read the articles related to your integration.

Accounting settings errors

In this section you will find error messages related to your accounting settings that you can change if you go to Settings > Accounting Setup.

Error message 'Please update your accounting settings to prevent export issues.'

It seems some settings information is missing. Please fill in all the fields under Settings > Accounting Setup.

Error message 'Exports may fail with the current accounting settings. Please visit the Accounting Settings page to update them.'

It seems some settings information is missing. Please fill in all the fields under Settings > Accounting Setup.

Error message 'Update your bank accounts here.'

The bank accounts are not fully set up. Please go to Settings > Chart of accounts and update your bank accounts.

Error message 'Update your purchase and bank journals here.'

The purchase journals and bank journals are not fully set up. Please go to Settings > Accounting Setup > Accounting integration and update them.

Error message 'Go to Accounting Settings.'

It seems some settings information is missing. Please fill in all the fields under Settings > Accounting Setup.

Error message 'Please configure your purchase and bank journals below.'

The purchase journals and bank journals are not fully set up. Please go to Settings > Accounting Setup > Accounting integration and update them.

Error message 'Please select purchase journals.'

The purchase journal needs to be selected.

Error message 'Please select a bank journal.'

The bank journal needs to be selected.

Failed export errors

In this section you will find error messages related to failed exports occurring on Bookkeep > Export. After checking the message and performing the required action, you can click on Send back to prepare, then edit your payables and retry the export. If the expense date is from a locked period, you will not be able to export it, so you need to click on Mark as manually exported, then manually import this payable in your accounting software.

Error message 'The payable failed to export because the analytical field is not mapped. Please go to Settings -> Accounting and refresh your settings.'

The analytical dimensions are not mapped correctly. Please go to Settings > Accounting Setup > Mapping and map them.

Error message 'The payable failed to be exported because the correct journal is not selected. Please go to Settings > Accounting Setup and select correct journal.'

The purchase journals are not mapped correctly. Please go to Settings > Accounting Setup > Accounting integration and map them.

Error message 'One of the accounts you are trying to save has not been found. Please refresh your settings, send the payable back to prepare and choose correct accounts.'

One expense account, bank account or VAT account has not been found. Please go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'The payable failed to be exported because of an error on [Accounting software]'.

We had an unknown error, you can try again in a few minutes. If the issue persists, you can contact our customer support.

Error message 'The payable failed to be exported because of an error related to documentary evidence. Please try again and if it won't work please contact support.'

We had an unknown error, you can try again in a few minutes. If the issue persists, you can contact our customer support.

Error message 'Missing configuration for FX gain/loss accounts. Please navigate to Settings > Chart of accounts and set up FX gain/loss accounts.'

There is a missing configuration for your FX gain and loss accounts. Please go to Settings > Chart of accounts and update them.

Error message 'This supplier isn't mapped to any supplier in [Accounting software]. Make sure a supplier with the same name exists in [Accounting software], then click 'Refresh Settings' (this might take around 5 min).'

There is a mapping issue with a supplier. We map suppliers based on email address and full name. Please make sure the name is the same between Spendesk and your accounting software, then go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'Please make sure a supplier with the name and email address of this employee exists in [Accounting software], then click 'Refresh Settings' (this might take around 5 min).'

We map suppliers based on email address and full name. Please make sure the name is the same between Spendesk and your accounting software, then go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'Export failed: analytical value not mapped'

The analytical dimensions are not mapped correctly. Please go to Settings > Accounting Setup > Mapping and map them.

Error message 'Please make sure analytical value "[Analytical value]" exists in [Accounting software], then click 'Refresh settings' (this might take around 5 min)'

One analytical value is not correct. Please make sure it exists in your accounting software, then go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'Please configure an exchange rate in [Accounting software] for the currency of this payable.'

You need to configure an exchange rate in your accounting software, go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings. Then you can try again the export of this payable.

Error message 'The payable failed to export because of Spendesk error. Please try again and if the error returns reach out to our support.'

We had an unknown error, you can try again in a few minutes. If the issue persists, you can contact our customer support.

Error message 'This payable failed to export for unknown reasons. Please contact our support or "mark as manually exported" and import manually in [Accounting software].'

We had an unknown error, you can try again in a few minutes. If the issue persists, you can contact our customer support.

Error message 'The journal entry failed to export because the journal was open in [Accounting software]. Please close the journal and try again.'

The purchase journal is open in your accounting software, please close it and try exporting again on Spendesk.

Error message 'One of the accounts you are trying to save has not been found. Please refresh your settings and try to re-export this payment.'

One expense account, bank account or VAT account has not been found. Please go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'This payment failed to export for unknown reasons. Please contact our support or "mark as manually exported" and import manually in [Accounting software].'

We had an unknown error, you can try again in a few minutes. If the issue persists, you can contact our customer support.

Error message 'Please update your accounting settings to be valid and try to export this settlement again.'

The settlement was not exported, please go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'Please update your accounting settings to be valid and try to export this bank fee again.'

The bank fee was not exported, please go to Settings > Accounting Setup > Accounting integration and click on Refresh accounting settings.

Error message 'The payment failed to be exported because the correct journal is not selected. Please go to Settings > Accounting and select the correct journal.'

The bank journal is not correctly mapped. Please go to Settings > Accounting Setup > Accounting integration and map them.

Error message 'Please configure an exchange rate in [Accounting software] for the currency of this bank fee.'

If you come across other issues with our your native integration, you can read the articles related to this integration.