Search our Help.

Xero Customer Credit Limits


The Credit Limits feature allows you to enable a credit limit for your customers in Unleashed. It will then automatically sync and update the value of the customers outstanding invoice balance from Xero.

This will provide better visibility for you to limit the value of outstanding invoices for a customer. 

Points to Note

  • On the Xero Integration page | Configuration tab, the Enable Customer Credit Limits toggle must be enabled.
  • Credit Limits must be set at a customer level for each customer in Unleashed.
  • The base currency between Unleashed and Xero MUST be the same to ensure accurate credit balance values.
  • The Credit Limits feature in Unleashed can be controlled by the super user using the appropriate role permissions.
  • Once you enable and set the credit limit for a customer, you can still create a sales order and invoice but you cannot complete a sales order (shipment) for the customer if they are over the credit limit. 
  • You can ignore the Credit Limit and complete sales orders by assigning the Override Credit Limits role permission. 



Enable the Credit Limits toggle

  1. Go to Integration | Integration Store | Xero.
  2. Click Configuration and scroll down to Advanced Features.
  3. Under Advanced Features, select the Enable Customer Credit Limits toggle.

Screen Shot 2023-09-14 at 3.17.01 PM.png

Select Role Permissions

  1. Go to Settings | Security | Role Permissions.
  2. Select the required role from the Role drop-down list.
  3. Click Expand All and then click Sales | Customer.
  4. The following permissions will be displayed for Credit Limits:
    • Override Credit Limits: Enables completion of sales orders even when the customer is over the set credit limit value.
    • Set Credit Limits: Enables setting the credit limit for each customer.

Screen Shot 2023-09-14 at 3.19.10 PM.png

Setting the Credit Limit 

  1. Go to Customer | View Customers.
  2. Open the required customer record. The Apply Credit Limit toggle will be displayed.

Screen Shot 2023-09-14 at 3.21.08 PM.png

  1. Once you select the toggle, the following fields will be displayed:
    • Set Credit Limit: You can specify the value for the credit limit you want to assign to this customer.
    • Credit Balance: This field will automatically be synced to the integrated Xero account and display the balance. The automatic sync runs every 1 hour.
  2. If you have multiple customers you wish to apply credit limits to, you can do this in bulk by exporting the Customers list to a CSV file from the Import/Export function (Customers>Import/Export> Export> Customers) and update the relevant columns (Import Customers fields definition). Before making any changes to this CSV file export, we would recommend you take a backup copy of the original exported file.
Note: The Credit Balance field will sync only when you have approved invoice(s) in Xero for the customer. The manual sync will refresh ONLY once every 15 minutes. 

Creating Sales Orders

  • If a customer has exceeded the credit limit value you have assigned, you can still create and invoice a sales order. However, you will not be able to complete the order or dispatch any shipments.
    The logic here is that we still want the invoice journal to export to Xero so as to make the owing balance visible there as well, but prevent the Sales Order from completing, as that information is purely based within Unleashed, and is a way to physically stop overriding the credit limits.
  • You can select the Ignore Credit Limit checkbox if you want to complete the order:

Screen Shot 2023-09-14 at 3.41.52 PM.png


Was this article helpful?
0 out of 1 found this helpful