Accounting integration
Enable your users to synchronize accounts payable and receivable data with popular accounting solutions.
Overview
Many SMEs use various accounting solutions to store and prepare their financial data for submission to tax authorities. With Monite, you can connect your users’ data to their preferred accounting software and pull necessary financial data for import into your interface, as well as push data in case they need to do any post-accounting work outside of your application.
Supported accounting systems
Each entity can connect to one of the following accounting systems:
- QuickBooks Online
- Xero
New supported accounting systems will be added in future releases of our platform. If you have any specific requests, please contact our Support team.
An entity can connect their data to only one accounting system. If they want to connect to another accounting system, they have to disconnect the currently connected system first.
Requirements and considerations
- All Monite partners that intend to support accounting integration must create developer accounts in the accounting platforms they intend to support.
- Each entity that wants to connect to an external accounting system (like Xero or QuickBooks) must have an account with that system before attempting to create an accounting connection with the Monite API.
How the integration works
The first step required to enable accounting integration for an entity is to establish a connection to an entity’s accounting software and ask an entity user to authorize the connection. Once the connection has been established, the entity’s financial data will be synchronized automatically between Monite’s and the entity’s accounting software. After the initial synchronization, Monite will automatically trigger synchronizations between both systems every 24 hours.
Monite does not push older invoices or bills to the entity’s accounting software during the initial synchronization. Therefore, only invoices and bills eligible for pushing after the accounting synchronization will be pushed to the accounting software.
You can track the data synchronization status by calling GET /accounting_connections/{connection_id}
. This endpoint returns information about the entity’s connection to an accounting system including the status of the connection and the last synchronization.
What data is synchronized
In our accounting integration, we support two key actions for handling synchronized data:
Currently, Monite pulls and pushes the following data from and to accounting systems. Data is synchronized every 24 hours:
** Invoices are pulled only for access purposes, they are neither matched nor created.
Entities can also pull records from the accounting system on demand by calling POST /accounting_connections/{connection_id}/sync
.
How data is synchronized
After every synchronization, you can track its status and any errors returned by calling GET /accounting_synched_records/{synced_record_id}
. For more information, see Check synchronization logs.
Set up integration with an accounting system
1. Prerequisites
Before starting an accounting integration, you must have a partner account in Monite.
2. Generate a Monite partner access token
To authenticate your API calls with Monite, you need to generate a new partner-level token. To do this, call POST /auth/token
with the following parameters:
The successful response contains the token and its validity time (in seconds):
3. Specify your accounting provider
Next, specify the accounting provider in your Monite partner settings. To do this, call PATCH /settings
and set the accounting.provider
field to railz
:
4. Set up entities in Monite
If you have not already, create entities in Monite that represent your customers. Since the connection to an accounting system is configured on the entity level, Monite partners must have entities in Monite before proceeding further.
Entities that use accounts receivable must also create their product catalog in Monite before setting up an accounting connection.
5. Set up partner accounts on accounting platforms
Partners must set up accounts in QuickBooks and Xero to successfully support an accounting integration on these platforms.
6. Provide accounting credentials
After successfully creating a partner account in QuickBooks or Xero, partners must now provide their secure application keys (API Key and Secret) for whichever platform they intend to support on Monite.
To do this, please send the credentials to dev-accounting@monite.com via a secure password manager or file sharing tool, such as BitWarden.
7. Establish entity connection to an accounting system
To establish a new accounting connection that allows an entity to synchronize all its accounting data with a third-party accounting system, call POST /accounting_connections
. In this request, you must pass the entity ID in the X-Monite-Entity-Id
header:
The successful 201 Created
response contains the information about the newly created connection:
Note down the connection_url
value as you will need it on the next step.
Each entity can connect to only one accounting system at a time. The entity must be disconnected from any previous system before they can successfully establish a new connection. To disconnect an entity from an accounting system, call POST /accounting_connections/{connection_id}/disconnect
endpoint. For more information, see Disconnect an accounting system
8. Entity user authorizes their connection
Send the connection_url
value obtained on the previous step to the entity representative. This URL looks like this:
The entity user must navigate to this URL in their browser. This opens an authorization page, where the entity user must select their preferred accounting system.
After selecting the accounting platform, the entity user must log in and authorize the partner`s developer account to access their data.
Partners can customize specific attributes on the authorization page. To do this, please contact your Monite Customer Success Manager.
Upon successful authorization, the platform
field will contain the entity’s chosen accounting platform and the value of the status
field in the accounting connection object will be connected
. You can confirm this by calling GET /accounting_connections/{id}
.
Troubleshooting
If you experience any issues and need further assistance with the integration, please feel free to contact our Support Team at any time.