--- title: Configuring Your Invoice Sync Options description: This guide explores how to configure your Xero invoice options --- [Skip to content](https://kb.clouddepot.com/knowledge/invoice-options#main-content) English Show submenu for translations ![CoudDepot\_LOGO\_RGB.png\]](https://kb.clouddepot.com/hs-fs/hubfs/CoudDepot_LOGO_RGB.png?height=40&name=CoudDepot_LOGO_RGB.png) - [Read Our Blog](https://blog.clouddepot.com/) Open main navigation Close main navigation - [Read Our Blog](https://blog.clouddepot.com/) - English Show submenu for translations - [Go to clouddepot.com](https://www.clouddepot.com/) [Go to clouddepot.com](https://www.clouddepot.com/) Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Cloud Depot Knowledge Base](https://kb.clouddepot.com/knowledge?hsLang=en) 2. [Product - Autotask to Xero](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en) 3. [Setup](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#setup) # Configuring Your Invoice Sync Options ## Our sync platform offers a comprehensive set of configuration options, enabling you to tailor the appearance and behavior of your Xero invoices. Because the Autotask API structures data slightly differently to the Autotask web console, we have optimised our mapping so Xero invoices closely mirror the original layout. Minor variations may still occur, and our support team can work with you on advanced configuration if you would like to further refine the presentation. Autotask to Xero -\> Configuration -\> Xero Options ### 1. The Workflow: Import Status (Invoices import into Xero as) Choose how invoices should first appear in your Xero organization. We recommend starting with **Draft** to verify your data mapping before moving to a fully automated workflow. - **Draft (Recommended):** Invoices are synced but require a manual "Approve" click in Xero. Great for initial testing. - **Approved:** Invoices are marked as Approved immediately upon sync. - **Approved and Set as Sent:** Invoices are marked as Approved and the "Sent" flag is checked in Xero. - *Note: This does not physically email the invoice to the customer; it only updates the status within Xero.* --- ### 2. The Identity: Invoice Numbering (Xero Invoice Numbers) Consistency between platforms is key for reconciliation. You can choose which system "owns" the invoice number. - **Use Xero Invoice Numbers:** Xero generates the next available number in its sequence. This effectively eliminates sync conflicts. - **Use Autotask ID Number:** Invoices will be formatted as `INV:{AutotaskID}`. This provides a direct link to the Autotask record and reduces conflicts. - **Use Autotask Invoice Numbers:** Uses the specific invoice number generated by the Autotask billing run. (see caution note below) **⚠️ CAUTION: Using Autotask Invoice Numbers** We generally advise **against** using the Autotask Invoice Number unless your internal processes are strictly locked down. **The Risk: **Many MSPs configure Autotask and Xero to use similar invoice number sequences, which means Autotask may generate or reuse an invoice number that already exists in Xero. **The Result:** If that invoice number has already been synced to Xero, the sync engine will attempt to push the "new" data to the "old" number. Depending on your Xero settings, this will either fail (causing a sync fault) or, worse, potentially overwrite/duplicate data. **Our Recommendation:** Use the **Autotask ID Number** or **Xero Sequence** to ensure every transaction remains unique. --- ### 3. Invoice Due Date: ##### 1. Default Behaviour (Autotask Driven) By default, Cloud Depot pulls the **Due Date** directly from the invoice record in Autotask. This date is usually calculated in Autotask based on the "Payment Terms" assigned to that specific Company (e.g., Net 30, Due on Receipt). - **Pros:** Keeps both systems perfectly mirrored. - **Cons:** If your service team hasn't updated the terms in Autotask, but your finance team has updated them in Xero, the Xero data will be "wrong" because it was forced to use the Autotask date. ##### 2. The "Override Due Date" Option (Xero Driven) In your **Invoice Options**, there is a setting in **Xero Advanced Options **to Override Xero Invoice Due Date with the Xero Customer Card. If no date is setup it will default back to the option above. ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Jan-20-2021-10-52-54-23-PM.png?width=437&height=154&name=image-png-Jan-20-2021-10-52-54-23-PM.png) When enabled, Cloud Depot ignores the date coming from Autotask and instead tells Xero: *"Here is the invoice; apply whatever due date rules you have saved for this specific Contact."* - **When to use this:** Use this if your accounting team manages all credit terms and payment dates exclusively within Xero. - **The Benefit:** It ensures that if a customer has "Special Terms" (like 45 days) set up in Xero, the sync won't accidentally overwrite it with the standard 30-day term from Autotask. --- ### 4. Sync History (How many days back should invoices be synced) This option defines how far back in time the sync should look for invoices. Any invoice that already has a Web Service Date set in Autotask will be excluded from syncing. You can clear this date from the Invoice History page in the Autotask console if you need the invoice to sync. If you are just starting, we recommend setting this to a small number. - [Once your sync is running smoothly, a **30-day window** is recommended](https://kb.clouddepot.com/knowledge/sync-history-option?hsLang=en) --- ### 5. Autotask to Xero Contact Matching (In Advanced Option) ### ![](https://kb.clouddepot.com/hs-fs/hubfs/image-png-Nov-14-2024-01-22-16-2965-AM.png?width=348&height=289&name=image-png-Nov-14-2024-01-22-16-2965-AM.png) Cloud Depot matches your Autotask Companies (Accounts) to Xero Contacts. - **Match by Name:** By default, we match by exact name. - **Case Sensitivity:** Xero can be configured to treat company (contact) names as case sensitive. We recommend enabling the option “Turn off contact name case sensitivity between Autotask and Xero”  - **Update Xero Contacts:** When enabled, Cloud Depot will update the contact’s address and details in Xero with the latest information from Autotask each time a new invoice is synced.  Important: If you enable this option, the sync will run in strict mode and requires either a configured UDF or a Main Billing contact. If neither is set up, the sync will fault.   (please read the caution below) **⚠️ CAUTION: Update Xero Contacts** [Set up the required Autotask contact UDF so the sync can reliably identify which Autotask contact to use for billing.](https://kb.clouddepot.com/knowledge/xero-contacts-keep-changing?hsLang=en) - **Match by Account Number:**  How to use: Matching by Account Number [Use this method when the company names stored in Autotask and Xero differ but need to sync to the same underlying contact record.](https://kb.clouddepot.com/knowledge/autotask-account-number-mapping?hsLang=en)     --- ### 4. The Presentation: Line Item Formatting Customize how information from Autotask appears to your customers in Xero. - **Show Resource on Invoices:** Adds the technician's name to the description for ticket-based line items. - **Show Date in Description:** Prepends the ticket date to the start of the line item description. - **Hide Service Contract Descriptions:** Strips the long contract descriptions to keep the invoice clean and professional. - **4 Decimal Place Rounding:** Enables support for unit amounts with up to 4 decimal places. - *Important: This must also be enabled within your Autotask system settings to prevent rounding discrepancies.* - **Paid Invoices Only:** An optional setting to only sync invoices once they have been marked as fully paid in Autotask (Contact support to enable). --- ### 5. Advanced Options - Fault sync if no Autotask billing items attached: We recommend enabling this option, as an invoice with no billing items almost always indicates a sync issue. - After-hours quiet mode: Because Autotask and Xero enforce strict usage limits, this feature shifts non-urgent sync activity outside business hours, helping your daytime invoice processing remain fast and reliable. - Void Autotask Invoices: When enabled, this option will void or delete the corresponding Xero invoice when it is voided in Autotask. [Please refer to this article for more information.](https://kb.clouddepot.com/knowledge/autotask-voided-invoices-automatically-voided-in-xero?hsLang=en) --- **Further cosmetic changes to the billing line-items.** The Autotask API displays data differently than the Autotask web-console. We have put in significant effort to align Xero invoices as closely as possible to the original format. While there may be slight variations in some cases, our support team can assist with advanced options to further customize the appearance. Feel free to reach out to us for additional guidance. ![](https://kb.clouddepot.com/hubfs/Knowledge%20Base%20Import/support.clouddepot.comsupportsolutionsarticles5000769118-invoice-optionshit-3.gif) - [Product - Autotask to Xero](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#main-content) - [Getting Started](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#getting-started) - [Setup](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#setup) - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-autotask-to-xero?hsLang=en#troubleshooting) - [Product - Recurring Payment Service (RPS)](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#main-content) - [Getting Started](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#getting-started) - [Customers & Invoices](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customers-invoices) - [Payment Rules & Auto Pay](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-rules-auto-pay) - [Customer Portal](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#customer-portal) - [Surcharges](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#surcharges) - [Payment Gateways](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#payment-gateways) - [Troubleshooting](https://kb.clouddepot.com/knowledge/product-recurring-payment-service-rps?hsLang=en#troubleshooting) - [Product - HostedPay](https://kb.clouddepot.com/knowledge/product-hostedpay?hsLang=en) - [Integrations](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#main-content) - [Xero](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#xero) - [Autotask](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#autotask) - [HaloPSA](https://kb.clouddepot.com/knowledge/integrations?hsLang=en#halopsa) - [Support, security & updates](https://kb.clouddepot.com/knowledge/support-security-updates?hsLang=en) - [Billing and Accounting](https://kb.clouddepot.com/knowledge/billing-and-accounting?hsLang=en) - [Setting up Cloud Depot](https://kb.clouddepot.com/knowledge/setting-up-cloud-depot?hsLang=en) - [Cloud Depot Status and Contacting Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#main-content) - [View Service Status](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#view-service-status) - [Support](https://kb.clouddepot.com/knowledge/cloud-depot-status-and-contacting-support?hsLang=en#support) - [Sync Customization Documentation](https://kb.clouddepot.com/knowledge/sync-customization-documentation?hsLang=en) - [Read Our Blog](https://blog.clouddepot.com/) # Cloud Depot Cloud Depot Help Center Copyright © 2026, Cloud Depot