A new endpoint has been established that allows both Payroll transactions and Cashbook Payments to be accessed through the API. A couple of fields need to be filled in within Infusion, to allow the API posted transactions to go through successfully first.
Setting up Infusion for POSTing payments through the API
Open the Settings module, locate the Financials section and open Payroll Integration. Choose Edit and fill in both the Default Payee Name and Default Bank Account fields.
If the transaction being posted through the API is to be posted automatically, enable Autopost Cashbook Payment. Leaving this option disabled, requires users to manually post the transaction in Infusion
To POST Payroll transactions
The Payroll endpoint is:
/ext/v1/financials/cashbookPayments?payroll=true
When making the POST call these fields are mandatory:
paymentDate
lines (at least one line)
lines.glAccount – either its uuid (lines.glAccount.uuid) or glId (lines.glAccount.glId)
lines.amount
Other fields are optional, and are calculated or loaded from the Payroll Integration Settings.
If the setup hasn’t been completed, then when a transaction is posted through the API, the user will receive a notification at the top of the screen, by way of the bell Icon.
One or more Payroll Integration setting details are missing. Please update these details, and review the Cashbook Payments listed to ensure details are correct
If there are multiple payments that have been sent through, before the settings have been entered in, each payment will be listed in the notification.
To POST Cashbook Payment transactions
A cashbook payment endpoint has been made available, using either of the endpoint addresses:
/ext/v1/financials/cashbookPayments
Or
/ext/v1/financials/cashbookPayments?payroll=false
Posting cashbook payment transactions into Infusion, will use the bank account and payee details in the Settings, under the Financials section in Payroll integration if there is no bank account and payee details in the API request.
If the transaction being posted through the API is to be posted automatically, enable Autopost Cashbook Payment. Leaving this option disabled, requires users to manually post the transaction in Infusion
When making the POST call these fields are mandatory:
paymentDate
lines (at least one line)
lines.glAccount – either its uuid (lines.glAccount.uuid) or glId (lines.glAccount.glId).
lines.amount
Other fields are optional, and are calculated or loaded from the Payroll Integration Settings. If it isn’t specified, the bank account used will be the bank account specified in the Payroll Integration.
If the Payee isn’t included as part of the request, Infusion will assign a default payee of “Payroll”
