> ## Documentation Index
> Fetch the complete documentation index at: https://eggz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Invoices and Quotes

> View sales invoices and quotes synced from Xero in eggz, track payment status, filter by customer, and monitor your sales pipeline at a glance.

## Sales invoices

The **Sales** page shows all your invoices — those **synced from your connected Xero account** and any **drafts created in eggz** (for example by the AI assistant). Invoices represent money owed to you by your customers. Where an invoice came from matters: synced invoices are managed in Xero, while eggz-created ones can be voided or deleted here (see below).

When you create an invoice, quote, bill, or customer account in eggz, the form includes a **Currency** picker. It starts on your organisation's reporting currency, and the line-item amounts and totals follow whichever currency you pick, so a USD invoice reads in USD from the first line to the total.

### Invoice list

The invoice table displays:

* **Reference**: Invoice number or reference
* **Customer**: Who the invoice is for
* **Consultant**: Who raised the invoice (if tracked)
* **Status**: Draft, Submitted, Authorised, Paid, or Voided
* **Issue date** and **Due date**
* **Total** and **Balance** (amount remaining)
* **Currency**

You can group invoices by customer, status, or consultant using the table controls.

Customer, status, consultant, dates, and amounts can all be edited inline — click a cell to edit it. (The reference is the link that opens the invoice's detail page, so it isn't edited here.) **Total** and **Balance** are locked on invoices synced from Xero, and refused while payments are applied — see [Editing totals and line items](/help/guides/editing-amounts) for what each locked state looks like.

### Invoice detail

Click an invoice to view the full detail page:

* All fields from the list view, plus notes
* PDF download (if a file is attached)
* Payment date (for paid invoices)
* A full [settlement history](#settlement-history) — every payment applied, in order
* [Related records](#related-records) — a **Customer** card, and a **Source quote** card if this invoice came from a converted quote
* An [Activity](#activity) timeline of what's happened to the invoice
* Void or delete, from the **More actions** (**⋯**) menu — see [Voiding and deleting invoices](#voiding-and-deleting-invoices)

<Note>Customer, status, dates, and amounts are edited inline on the **Sales** list (above), not on this detail page.</Note>

### Viewing on your phone

On a small screen, the document preview moves behind a **Details / View document** toggle at the top of the page — **Details** opens first so the fields you're checking are front and centre, and **View document** shows the original file. The page's actions — things like **Record payment** or **Download** — stay pinned to the bottom of the screen, so you never have to scroll to find them.

This layout is the same on every document's detail page: invoices, bills, receipts, and quotes.

### Settlement history

Every invoice detail page shows a **Settlement** panel:

* **Total**, **Paid**, and **Amount due** — Amount due is the headline figure.
* A date-ordered list of every payment, credit note, overpayment, or prepayment applied to the invoice, each row showing its source, the amount applied, and the running balance left after it.

Click any payment-backed row to open its full detail in a side panel: date, amount, method, reference, contact, and where it came from (**Manual** or **Xero**). Rows without a payment behind them — credit notes, overpayments, prepayments — aren't clickable.

<Note>If a payment is later voided or unapplied, its row stays in the history — struck through, with a note explaining why (for example *"Unapplied when the invoice was voided"*). Nothing disappears from the audit trail.</Note>

### Related records

Every invoice detail page shows a **Customer** card linking straight to that customer's account, with a status line if it isn't the everyday **Active** (for example **At Risk** or **Pending**). If the invoice was created by [converting an accepted quote](#converting-a-quote-to-an-invoice), a **Source quote** card sits alongside it, showing the quote's reference, status, and amount.

Bills show the same idea from the other side — a **Supplier** card, plus a card for every receipt attached as evidence. See [Bill detail page](/help/guides/expenses#bill-detail-page).

<Note>Nothing renders here if there's nothing to show — an invoice with no linked customer account, for example, simply has no card.</Note>

### Activity

An **Activity** timeline on the detail page lists what's happened to the document, newest first — things like **Voided**, **Draft created**, **Date set**, or **Converted to an invoice**. Beyond ten events it collapses behind a **Show all (N)** link.

Most entries are simply what you did, with no label. When something happened by AI or automatically, a small chip says so — **AI agent** or **Automation** — and a **System** chip marks events eggz itself triggered.

<Note>The Activity timeline only appears once there's at least one event to show — an empty timeline isn't shown at all. Its absence doesn't mean nothing happened, just that eggz hasn't logged anything for this document yet.</Note>

The same timeline appears on bill, receipt, quote, and customer detail pages.

### Voiding and deleting invoices

What you can do to an invoice depends on its status — the same **Status** labels listed above. The action shows as an icon in the row on the Sales list, or in the **More actions** (**⋯**) menu on the invoice detail page:

| Invoice is                                                        | You can             | What happens                                                                                                                                                                                                                                                                                                   |
| ----------------------------------------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Draft**                                                         | **Delete**          | Removed completely — no financial effect, nothing to undo.                                                                                                                                                                                                                                                     |
| **Submitted** or **Authorised**, no payments applied              | **Void**            | The invoice and its number are kept forever for your audit trail, but it's excluded from your reports and tax totals from that point on. Voiding is permanent.                                                                                                                                                 |
| **Submitted**, **Authorised**, or **Paid**, with payments applied | **Void** (assisted) | eggz can't void an invoice while payments are still applied to it. Choose **Unapply N payments and void** and eggz keeps the invoice for your records, unapplies the payments, and voids it — the payment money is never deleted, it becomes unallocated credit for that customer that can be reapplied later. |

Once voided, a document owes nothing: it shows **\$0 due** everywhere an amount due appears, including the settlement panel and the Outstanding view.

Cleaning up several drafts at once? Select them on the Sales list and click **Delete selected** — the button only enables when everything selected is a draft, so an issued or synced invoice can never slip into a bulk delete.

<Tip>If the sale genuinely happened and the invoice was sent, a credit note is usually the better fix than voiding — voiding says "this shouldn't have counted," a credit note says "this needs an adjustment."</Tip>

<Note>Only invoices created in eggz can be voided or deleted here. Invoices synced from Xero are managed entirely in Xero — see [Xero integration](/help/guides/xero-sync).</Note>

### Syncing invoices

Click the **Sync** button on the Sales page to pull the latest invoices from Xero.

<Note>Invoices synced from Xero are one-way — changes you make in eggz (edits, deletions) don't sync back to Xero.</Note>

### Publish a draft to Xero

Most invoices arrive by syncing from Xero, but you can also **draft an invoice in eggz** — including one the AI assistant prepares for you, or one [converted from an accepted quote](#converting-a-quote-to-an-invoice) — and publish it to Xero as a draft in one click. See [Publish invoices & quotes to Xero](/help/guides/publish-to-xero).

***

## Quotes

The **Quotes** page shows all quotes synced from Xero. Quotes represent potential future revenue in your sales pipeline.

### Quote list

The quote table displays:

* **Reference**: Quote number
* **Prospect**: The potential customer
* **Owner**: Who manages the quote
* **Status**: Draft, Sent, Accepted, Declined, or Invoiced
* **Amount** and **Currency**
* **Expected close date** and **Valid until date**
* **Win likelihood**: Probability of conversion

You can group quotes by prospect, status, or owner.

### Quote detail

Click a quote to view:

* All list fields plus notes
* PDF download (if attached)
* An **Invoice** [related-record card](#related-records) linking to the invoice this quote became, once [converted](#converting-a-quote-to-an-invoice)
* An [Activity](#activity) timeline of what's happened to the quote
* Delete the quote

### Converting a quote to an invoice

An **Accepted** quote you created in eggz — not one synced from Xero — can become an invoice in one step.

<Steps>
  <Step title="Click Convert to invoice">
    On an accepted quote's detail page, click **Convert to invoice**.
  </Step>

  <Step title="Confirm">
    A dialog explains what's about to happen: *"A draft invoice is created with this quote's amount for you to review. Nothing is sent and your reports don't change until you authorise it."* It also flags the one irreversible part: *"The quote is marked Invoiced — this can't be undone."* Click **Convert to invoice** to confirm, or **Cancel** to back out.
  </Step>

  <Step title="Review the draft">
    eggz creates a **Draft** invoice for the quote's amount and takes you straight to it. A draft has no effect on your reports until you authorise it, so nothing about your numbers is final yet.
  </Step>
</Steps>

The two documents link to each other from then on: the quote shows an **Invoice** card, the invoice shows a **Source quote** card (see [Related records](#related-records)) — and the quote's own status becomes **Invoiced**, its final state.

<Note>**Convert to invoice** only appears on a quote that's **Accepted**, created in eggz, and not already converted. A **Draft** or **Sent** quote needs to be marked **Accepted** first; a **Declined** quote can't convert; and a quote synced from Xero is converted in Xero itself, so the two ledgers never disagree.</Note>

### Quotes in analytics

Quotes feed into the **Quote Pipeline** widget on the dashboard, showing the total value of your open quotes for the current month. Click the widget to drill down by month or source type.

<Note>Quotes synced from Xero are one-way — you can't push changes back. But a quote you **draft in eggz** can be published to Xero as a draft. See [Publish invoices & quotes to Xero](/help/guides/publish-to-xero).</Note>
