Xero - API

Please note, nominal mapping displayed in this video is for illustration purposes only. Please make sure the correct accounts are chosen to ensure the integration is set up correctly. BrightPay's payroll journal feature allows users to create wage journals from the finalised payslips and upload into your Xero account - using API. Within Payroll - select Journal on the menu toolbar - followed by Xero.

Set your Date Range - the journal will include records for all payslips across all pay frequencies with a pay date within the selected range. Under Roll up - select whether you would like the journal to include individual records for each employee or whether to merge the records for each unique date. Enter the 'Tax Rate' name required, if different from the default of 'Tax Exempt (0%)'

Should you wish to include the employee's department name as the tracking option value tick the box provided. Should the tracking category name differ to 'Department', enter accordingly. Click Continue - Sign into your Xero account if prompted to do so.

Your nominal ledger codes will now be retrieved from Xero. Simply map each payroll data item to the relevant nominal account code - A nominal account code can be used for multiple items. When ready to proceed - click 'Continue'.

Nominal ledger mapping variations, allows you to specify any circumstances for which amounts should be mapped to an alternate nominal account code. For each payroll data item you wish to add a variation for - click Add Variation. For the payroll data item selected set the rules to apply in order for the amount to be mapped to the designated nominal account you enter on this screen.

Rules can be set according to period type directorship, department and specific pay items. Please see video for variation example. Click Save when complete.

Your rule will now be displayed on screen under the payroll data item it is associated with. Further variations can be added for different pay items or for the same payroll data item by simply clicking ‘Add Variation’ again and setting the rules to apply. Once variations have been set, these can be edited, deleted or re-ordered by clicking the spanner symbol next to it.

Also clicking the nominal account information displayed in green provides quick access to the rules that have been set for it. When you have finished creating your variations - click 'Continue'. Your journal will now be displayed on screen for review.

Simply click the 'Back' button to make any amendments. When ready to upload your journal - click 'Send to Xero...' A confirmation will be displayed on screen to confirm successful upload into your Xero account. If you want to print, email or export a copy of your journal as a PDF -‘Press 'Print'

To close the journal screen, simply click the cross at the top right of this screen. If you have made any changes to the journal you will be asked if you wish to save your changes - Click 'Yes' or 'No' as required.