XERO SETUP GUIDE Abstract Guidelines for integrating Eazy Collect with Xero to issue invoices, collect payment by Direct Debit and reconcile payments back into Xero automatically. Dave Carr
Table of Contents 1. Introduction... 2 Setting up customers... 2 Marking payments as paid... 2 2. Link Eazy Collect Account... 3 Connect to Eazy Collect... 3 Select a Payment Schedule... 3 Enter Direct Debit Information... 4 3. Linking Your Xero Account... 5 Connect to Xero... 5 Authorize the Application... 5 Select Xero Account and Invoice Themes... 6 4. Add a payment URL to a Xero Theme... 7 Configure Payment Service... 7 Add Custom Payment URL... 7 Add Payment Service to Invoices... 8 5. Configuring the Theme... 9 6. Raising an Invoice... 10 7. Matching Existing Xero and Eazy Collect Customers... 14 8. Frequently Asked Questions... 16 When are the payments for new invoices created in Eazy Customer Manager?... 16 When are payments marked as paid in Xero?... 16 Version 5 Page 1
1. Introduction Our Xero integration is a simple self-managed solution to connect invoicing within Xero to our market leading Direct Debit platform, Eazy Customer Manager. Setting up customers The system covers two possible scenarios: A customer that exists within Xero, but not in Eazy Customer Manager In this scenario, the system allows you to create invoice templates which include a pay-link to Eazy Collect s Xero Integration. By clicking on the link, the customer can create a user account in our system where they can sign up by Direct Debit, view pending, paid and unpaid payments and update their bank details. Future invoices raised for that customer in Xero will be picked up and scheduled into Eazy Customer Manager providing they are on an invoice template that has been enabled for Direct Debit. Alternatively, you can setup the Direct Debit on their behalf if authorised. A customer that exists within Xero, but already exists within Eazy Customer Manager Where a customer exists in both Xero and Eazy Customer Manager, it is possible using the administration interface in our integration to identify customers in Xero and connect them to customers within Eazy Customer Manager. In doing so, a new ad-hoc contract is created to carry the Xero invoice payments. Again, any new invoices raised will be scheduled for payment within Eazy Customer Manager providing they are on an invoice template that has been enabled for Direct Debit. Marking payments as paid The integration will also check the status of payments between three and five working days following the collection date and update the Xero invoice payment status based on the response from Eazy Customer Manager. Version 5 Page 2
2. Link Eazy Collect Account Please have the email from Eazy Collect that contains your API and Service User Number (SUN) details to hand as you will need these to complete registration. The system works on a one user account to one Xero company basis, as a result, you will only be able to set up one account from which to administer the Xero link. After creating your account, click on the "Configure Eazy Collect" button in the top menu. Connect to Eazy Collect On the API tab, type in your client code and API Secret and click Save. Select a Payment Schedule On the schedule tab, select a schedule to be used and click Save. Version 5 Page 3
Enter Direct Debit Information And finally on the DD Info tab, enter your Service User Number (SUN), SUN long and short names, company name, customer service email address and telephone number to complete the link with Eazy Collect. Version 5 Page 4
3. Linking Your Xero Account Connect to Xero Now, go to configure Xero in the menu and click connect to Xero. Authorize the Application You'll be taken to the Xero website, where you'll need to login using your Xero account credentials then select the Xero organisation you'd like to use and click authorise. Version 5 Page 5
Select Xero Account and Invoice Themes On the Account tab select the Xero account for payments to be made to in Xero using the dropdown box. Select the invoice themes that you wish to use to collect by Direct Debit; the names here will coincide with the names of the invoice themes you have created within Xero. If you don t select any invoice themes, then all invoices will be collected by Direct Debit. Click save when you ve finished. Version 5 Page 6
4. Add a payment URL to a Xero Theme Configure Payment Service Next we need to set the payment url for the payment button that is sent to customer. This can be done by going to https://go.xero.com/settings/paymentgateways then clicking 'Add payment service' and selecting 'Custom payment url'. Add Custom Payment URL Then typing in Name of Eazy Collect and then pasting in your custom url of http://customer.xo.eazycollect.co.uk/pay/[shortcode]/[invoicenumber] ensuring that there are no spaces before or after the URL. Version 5 Page 7
Add Payment Service to Invoices You'll then need to apply the payment service to your invoice theme, by going to "Edit" and clicking "Invoice Themes" and ticking the theme that you use for your invoices and clicking save. Version 5 Page 8
5. Configuring the Theme If your customers already exist in Xero and Eazy Collect, follow section 7 below to link the individual accounts first. The steps below assume your customer has already been setup in Xero and you simply want to raise an invoice and collect payment by Direct Debit. Once you ve connected Xero to Eazy Collect and assigned a Payment Service (instructions in steps 1-3 above), you can now change the settings on your Invoices to coincide with collecting payments via Direct Debit: 1. From your Xero Dashboard, click Settings, General Settings 2. Under Features, select Invoice Settings 3. Click New Branding Theme, give it a name, e.g. Direct Debit, change the Payment Services drop-down to the service that s linked to the Direct Debit payment service. This ensures the Pay Now button links to the direct debit setup page. 4. Click SAVE. 5. Now to set up Email templates, within the Settings, General Settings section, click Email Settings. Click Edit next to Templates 6. Add Invoice template(s) as required. Version 5 Page 9
6.Raising an Invoice When creating a New Invoice, click Accounts, Sales, then select New, Invoice or New, Repeating Invoice as necessary. It s possible to have different Brands which define which email template gets sent and which Pay Button is assigned. Ensure you have the one you setup above assigned to the invoice for collecting by Direct Debit. 1. Once details are added, click Approve 2. If a repeating invoice, click Invoice Options, Repeat and set the options. 3. Next, click Email button, and select your email template. You can either send to your customer to setup their Direct Debit, or replace their email with yours at the top and send the invoice to yourself for you to complete the Direct Debit details provided you have obtained authorisation to setup the DD. Then click Send Version 5 Page 10
Upon receipt of the first invoice email, you or your customer will need to click the PAY NOW button to set up the direct debit to pay the invoice. This needs to be done once, then all future invoices will be collected by direct debit automatically without any intervention from you or your customer. i.e. the emailed invoice will be for information only. Note: If you completed the direct debit instruction on behalf of your customer, remember to send the invoice email to your customer. 4. After clicking the PAY NOW button, you or your customer will be directed to a page to either sign-in or register. Use Register if the Customer doesn t already exist: Version 5 Page 11
5. If registering on your customer s behalf, you ll need to enter your customer s name, email and provide a password. You won t need to provide this to your customer if doing it on their behalf. Then enter the DD Contract details as below: Version 5 Page 12
6. Once the details have been entered, you will get a confirmation screen: 7. FINALLY, CLICK PAY INVOICE ON THE SCREEN BELOW: 8. All future invoices will now be collected automatically and the dates/amounts controlled entirely by XERO. Successful payments will be logged automatically and reconciled into Xero. Version 5 Page 13
7. Matching Existing Xero and Eazy Collect Customers Where you have accounts that exist in both systems, there needs to be a manual matching process to link the 2 accounts together before invoicing can begin. Firstly contact Eazy Collect to ensure your customers are on Ad-hoc contracts. If not, we can do that for you. Login at https://client.xo.eazycollect.co.uk Go to Import Existing tab. In the left hand column, all your Xero customers will be listed. In the right hand column, is the Eazy Collect Account. If a customer is already linked to Eazy Collect, the Link will say Contract Exists. If not, the link will say Link to Eazy Collect as shown below. Click on Link to Eazy Collect in the right hand column and the following screen will appear. Enter the Eazy Collect Customer Ref number and click Search. The screen will return any matches on the search. Once you ve found the correct Eazy Collect Customer name, click Create Link Version 5 Page 14
The following confirmation screen will appear. If correct, click Link button. Version 5 Page 15
8. Frequently Asked Questions When are the payments for new invoices created in Eazy Customer Manager? New invoices are picked up daily in a batch between 3pm and 5pm each day. Once the invoice has been read into the system it will show in your pending payments in the Xero Integration software and as a pending payment in the Payment History under the customer record in Eazy Customer Manager. The integration will schedule the payment for the earliest available collection date in Eazy Customer Manager. When are payments marked as paid in Xero? Direct Debit operates by exception and we receive reports from the bank within two working days of the collection date. The Xero integration will begin checking a payment s status between three and five working days after the payment collection date and automatically mark the invoice as paid within Xero. Version 5 Page 16