Draft Invoices
Table of Contents
Draft Invoices is currently in EA (Early Access). Click here to participate.
Draft invoices let you build, review, and correct invoices internally before they are visible to End Users or sync to accounting.
Overview
A draft invoice is a full invoice record. It supports line items, inventory reservation, and serial number assignment. Until you publish it, the invoice is not visible in the End User Portal, cannot be sent via email or snail mail, cannot be paid, has no active due date, and does not sync to QuickBooks Online or QuickBooks Desktop. If using Xero, it will sync as a draft. A DRAFT-marked PDF is available for download at any time.
When you publish a draft invoice, Syncro calculates the due date from the publish moment using the Organization's payment terms. Draft-to-published and published-to-draft transitions are recorded in the invoice's change history.
Draft invoices are deleted, not voided. Void is a concept that applies to published invoices and accounting audit trails. Deleting a draft that has never been published requires no void record.

For step-by-step instructions, see Publish a Draft Invoice, Convert a Published Invoice to Draft, and Manage Draft Invoices.
What You'll See
When you're using the draft invoices feature, you'll notice some changes to these pages.
The Invoices Tab/Table
- Draft invoices appear in the Invoices table with a -DRAFT suffix on the invoice number (for example, #3786-DRAFT).
- A DRAFT INVOICES button above the table shows the current count of draft invoices and filters the table to drafts only when clicked.
- The bulk actions menu includes a Publish Drafts action.
- Bulk actions that apply only to published invoices, such as Email Published Invoices and Quick Pay Published Invoices, are labeled to reflect that restriction and are unavailable when draft invoices are selected. Print becomes Print all when a mixed selection is present.
- In the Quick View modal, the Take Payment and Quick Payment buttons are displayed but disabled on draft invoices.
See also: About the Invoices Tab/Page.
The Invoice Details Page
- A Draft or Published status chip appears adjacent to the invoice title and updates immediately when the invoice state changes.
- The Invoice Date field is renamed to Published Date. On a published invoice it shows the date the invoice was published. On a draft invoice it shows "Not published." If an invoice was published, converted to draft, and re-published, it shows the most recent publish date.
- On a draft invoice, the Take Payment button is replaced by a Publish button. If Quick Payments are enabled, the Quick Payment option appears in the Actions menu but is disabled.
- On a published invoice, the Actions menu includes Convert to Draft. This action is disabled if the invoice has been partially or fully paid or has synced to an accounting integration.
See also: About the Invoice Details Page.
Use Cases
Draft invoices facilitate:
- A billing admin can hold recurring invoices in draft until she has reviewed the full batch, catching quantity errors and billing exceptions before any client sees them.
- A business owner can require all technician-created invoices to queue as drafts, reviewing and releasing them on a set schedule rather than reacting to client complaints after the fact.
- A developer can build a custom approval workflow using the Invoices API, routing drafts through an internal review tool before publishing programmatically.
Best Practices
- Work through your draft queue on a regular billing cadence. Leaving drafts unpublished indefinitely delays due dates and keeps revenue out of accounting.
- If your team reviews all invoices before sending:
- Uncheck the "Publish manually created invoices automatically" box in your Invoice Settings.
- Uncheck the "Publish automatically" box in the Recurring Invoice template.
Conditional Behavior
- If an invoice has been partially or fully paid, or has been synced to an accounting integration, the Convert to Draft option is not available.
- If "Publish manually created invoices automatically" is unchecked in your Invoice Settings, all new invoices that you manually create appear as drafts. Existing invoices and existing Recurring Invoices are NOT affected.
- If a Recurring Invoice has its "Publish automatically" box unchecked, invoices generated from that template are created as drafts.
- If an invoice is cloned, the new invoice honors the settings of the original invoice.
- Draft invoices are not eligible for Overdue status. Overdue applies only to published invoices with past-due active due dates.
Notes
- Existing accounts have "Publish manually created invoices automatically" checked on feature release, preserving current behavior. New accounts have it unchecked, so invoices are created as drafts by default.
- Payment terms are viewable and configurable on draft invoices but do not drive due date calculation until the invoice is published.
- When a published invoice is converted to draft, its active due date is cleared. Upon re-publishing, the due date is recalculated from the new publish timestamp.
- Draft invoices appear in the Line Item Discounts Report and Daily Invoices Report with the -DRAFT suffix, and are counted in the Sales Overview invoices created count. They are excluded from Invoice Aging reports and payment-related reports such as Payments By Day and Sales Detail.
- Draft invoice balances are excluded from the Organization balance in the Customer Overview, but prepay hours reserved by draft invoices are reflected in the Prepay Hours balance.
- Syncro can send a notification when a draft invoice is published. Use the "Invoice-A draft invoice was published" event in the Notification Center.
- To configure the global default, see Invoice Settings.
- To configure the per-template setting, see Work with Recurring Invoices.
Publish a Draft Invoice
Use this procedure to publish a draft invoice and make it visible in the End User Portal.
Prerequisites
Invoice Edit permission.
Steps
- Open the draft invoice. The invoice number includes a -DRAFT suffix.
- Click Publish.
Results
- The invoice is published.
- Syncro calculates the due date from the current moment using the Organization's payment terms.
- The -DRAFT suffix is removed from the invoice number.
- The invoice becomes visible in the End User Portal and is included in the next accounting sync.
- A "Published successfully" banner confirms the transition.
After You Finish
To pull the invoice back to draft, see Convert a Published Invoice to Draft.
Convert a Published Invoice to Draft
Use this procedure to return a published invoice to draft status for corrections or holds.
Prerequisites
- Invoice Edit permission.
- The invoice must not be partially or fully paid and must not have synced to an accounting integration.
Steps
- Open the published invoice.
- In the Actions menu, select Convert to Draft. If the invoice has been paid or has synced to accounting, Convert to Draft is disabled.
Results
- The invoice status changes to Draft.
- The -DRAFT suffix appears on the invoice number.
- The Published Date field displays "Not published."
- The invoice is removed from the End User Portal and excluded from future accounting syncs.
- The active due date is cleared and will be recalculated from the new publish timestamp when the invoice is re-published.
- An "Invoice converted to draft" banner confirms the transition.
After You Finish
To republish the corrected invoice, see Publish a Draft Invoice.
Manage Draft Invoices
Use this procedure to review your draft queue and publish multiple draft invoices at once.
Prerequisites
Invoice Edit permission.
Steps
- Navigate to Invoices.
- Click the DRAFT INVOICES count button above the invoice table. The table filters to draft invoices only.
- Select the invoices you want to publish.
- From the bulk actions menu, select Publish Drafts.
Results
- All selected draft invoices are published.
- Syncro calculates the due date from the publish moment for each invoice.
Draft Invoice Permissions
Use this reference to identify which existing permissions govern draft invoice actions. Draft Invoices does not introduce new permissions.
| Action | Required Permission |
|---|---|
| Create a draft invoice | Invoice Create |
| Edit a draft invoice | Invoice Edit |
| Publish a draft invoice | Invoice Edit |
| Convert a published invoice to draft | Invoice Edit |
| Delete a draft invoice | Invoice Delete |
See also: Security Permissions Reference.