Business Flows
The Mambu-Xero connector’s business flow consists of extracting from Mambu all journal lines created during the previous day and sending them as balanced batches of journal lines to Xero. The process will generally take place at midnight in your local timezone, although the time at which end-of-day processes are run can be configured to be earlier or later.
Types of journal entries handled by the integration
The connector syncs the following journal entry types to your Xero unified ledger:
- Automatic journal entries
- Manual journal entries
- Daily and monthly accruals
Negative use cases
The processes executed by the connector can be broken down into three phases: extracting, processing, and sending the journal entries. The connector handles and records all errors generated during these different phases. Each negative use case is handled differently, depending on the where the issue occurred:
Data extraction
If an error occurs during this phase, the following steps are executed automatically:
- The API call is retried a configurable number of times,
- The error is stored in a dedicated state diagram,
- The journal lines queue is emptied, and
- A task is logged in Mambu to the assigned user.
The notification will advise you to restart the process:
- Trigger the
Main
process, specifying the date.
Process journal lines
The processing phase consists of five subprocesses. If an error occurs during this phase, the following steps are executed automatically:
- The error is stored in a dedicated state diagram, and
- A task is logged in Mambu to the assigned user. This task will contain remediation steps depending on where the error occurred.
If the error occurs while moving from one process to the next you will receive a notification indicating the process which failed to start:
- Trigger the process specified in the notification (
Listener
process).
If the error occurs during one of the processing phases, the notification will advise you to restart the main process. In this case:
- Check if the journal lines queue is empty,
- Check that the state diagrams listed in the notification are empty, and
- Trigger the
Main
process, specifying the date.
Send journal lines
If an error occurs during this phase, the following steps are executed automatically:
- The error is stored in a dedicated state diagram, and
- A task is logged in Mambu to the assigned user.
Follow the instructions from the notification, which will include:
- Check that the state diagrams listed are empty,
- Delete the journal lines already posted to Xero for that specific date, and
- Trigger the process specified in the task.
Manual steps
A final manual step in Xero is required to post the journal lines to the unified ledger. The entries extracted from Mambu and pushed to Xero by this connector will appear as a draft journal with the date covered indicated in the name in the format YYYY-MM-DD.