> For the complete documentation index, see [llms.txt](https://learn.withessential.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md).

# Bill a project: progress invoices, retainage, and change orders

A project's billing schedule splits the contract into billing lines, such as a deposit, a payment at rough-in, and a final payment. Each line becomes **Ready to bill** when its trigger happens. Nothing is invoiced automatically: when a line is ready, someone creates its progress invoice from the project, reviews it in the invoice editor, and sends it as usual. The schedule can also hold back retainage on each progress invoice until the work is complete. Signed change orders raise the contract and are billed from the same schedule.

> **Where to find it:** Scheduling > Jobs, open the job, then scroll below the related-record table to **Project Management** and select **Billing Schedule**.

## Before you start

* The job must be a project. Billing is chosen per project, not in Settings. A project starts without a billing schedule; set one up in Project Management's **Billing Schedule** tab (see [Set up billing](#set-up-billing)). See [Track a job as a project](https://learn.withessential.com/customers-and-work/jobs/track-a-job-as-a-project.md).
* To bill on a schedule, you need a **signed** quote for the work: one linked to the job, or, if you can edit quotes, one on the job's property (setting up billing links it). The job and that quote must not already have an invoice that isn't void (drafts included).
* Quotes with a configured quote deposit or a deposit invoice cannot fund a project billing schedule, including change-order quotes. Project invoices cannot apply quote deposit credits. This restriction also applies to voided deposit invoices, which can still hold payment history. A billing-schedule **Deposit** line is a separate way to bill the project.
* Project Management's **Billing Schedule** tab and the money figures on the job's **Project Overview** card appear only for roles that can view invoices, in businesses that use invoicing. A change order's number links to its quote only for roles that can view quotes.
* In businesses that use invoicing, roles that can view quotes but not invoices see the project's change orders in a **Change orders** card in the job page's right column, under **Project Overview**, without amounts or billing actions.
* Creating invoices, releasing retainage, and changing the schedule need invoice edit access. Adding a change order needs quote edit access.
* The project must be turned on. While it's off, nothing on its schedule can be billed.

## Set up billing

Until a project has a billing schedule, the **Billing Schedule** tab shows "No billing schedule yet." and **Set Up Billing**. Under **Change orders**, select **Create** to quote extra work, even before billing is set up (see [Change orders](#change-orders)). The job is billed the usual way until you set up billing.

1. On the **Billing Schedule** tab, select **Set Up Billing**. The **Set Up Billing** dialog opens.
2. Choose the **Signed quote** the schedule divides. The job's own signed quotes come first, each with its number, description, and amount after discounts and before tax, such as "#Q1042 · Sprinkler retrofit $25,000.00". When the job has only one, it's already chosen. If you can edit quotes, type a quote number (such as #Q1056) or words from its description to find other signed quotes on the job's property. A quote that isn't on the job yet is marked **Not on this job**; choosing it shows "Saving links this quote to the job." Only quotes that can fund a billing schedule are listed: not already invoiced, not billed by another job's project, and not a change order on this project.
3. Optionally, enter a **Deposit**: a whole percentage of the quote that's ready to bill right away. Leave it empty for no deposit.
4. Optionally, enter **Retainage**: a percentage held back from each progress invoice until you release it at the end. Leave it empty if you don't hold retainage.
5. Check the sentence under the fields. It spells out what becomes ready to bill and when, such as "Ready to bill: deposit $5,000.00 now, then 80% when Closeout is complete. 10% of that is held as retainage until you release it." With no deposit it reads "Ready to bill: 100% when Closeout is complete."
6. Select **Set Up Billing**. A quote that wasn't on the job is linked to it first (it then appears on the job's **Quotes** tab), and the schedule is created.

The schedule starts with these lines. You can change any line until it's billed (see [Change the billing schedule](#change-the-billing-schedule)), and change retainage from the **Billing settings** ⋮ menu above the schedule.

* **Deposit** (when you entered a deposit) is ready to bill right away. Retainage is never held on the deposit.
* **Final** is the rest of the quote. It's called **Contract** when there's no deposit. It becomes ready to bill when the project's last phase is complete: every item in it, inspections and tests included, is done. To bill it at another point, change its trigger.
* **Retainage release** is added when you entered retainage. It holds the retainage kept back on progress invoices until you release it.

The schedule adds up to 100% of the signed quote, after discounts and before tax, as the quote is when you set up billing.

**Set Up Billing** is unavailable (hover it to see why) when:

* Your role can't create invoices: "Needs permission to create invoices."
* The job has no signed quote and your role can't edit quotes: "Link a signed quote to this job to set up billing."

When no quote can fund a schedule, the dialog says "No signed quote on this job's property can be billed on a schedule." (or "No signed quote on this job can be billed on a schedule." if you can't edit quotes). It refuses to save, with the reason at the top, when the job or the quote was already invoiced the ordinary way, the quote's total before tax is zero, or another job's project already bills the quote. A refused save links nothing.

## Read the billing schedule

The **Contract total** appears above the schedule. Select **View breakdown** to see the base quote, approved change orders, any pending change orders, and the retainage percentage.

Each billing line shows:

* Its name and **status**, with the billing trigger underneath, such as "When Rough-in inspection is done". A line whose item is no longer on the project asks you to **choose another trigger** (see [When a line's item leaves the project](#when-a-lines-task-leaves-the-project)).
* Its **amount before tax**, with any retainage beneath it.
* **Open invoice** for an existing invoice, or **Create invoice** when the line is ready. Other actions are in the line's ⋮ menu.

| Status              | Meaning                                                                                       | What you can do            |
| ------------------- | --------------------------------------------------------------------------------------------- | -------------------------- |
| **Waiting**         | Its trigger hasn't happened yet. For example, its item isn't done or the date hasn't arrived. | ⋮ > **Bill early**         |
| **Ready to bill**   | Its trigger has happened. No invoice exists yet.                                              | **Create invoice**         |
| **Bill when ready** | It has no automatic trigger. You decide when to bill it.                                      | **Create invoice**         |
| **Draft**           | A draft invoice bills it.                                                                     | Open the draft and send it |
| **Sent**            | Its invoice was sent, or finalized without sending, and isn't paid yet.                       | Nothing to do              |
| **Paid**            | Its invoice is paid.                                                                          | Nothing to do              |

The **Retainage release** line has its own statuses:

* **Nothing held**: no sent progress invoice has held retainage yet.
* **Held**: retainage is waiting to be released.
* **Draft**: a release invoice is in draft.
* **Released**: everything held so far has been released.

**Add billing line** and the **Billing settings** ⋮ menu are above the schedule. Use **Billing settings** > **Change retainage** to change the percentage. When retainage is available to release, the release action appears on the **Retainage release** line.

If the schedule doesn't add up to the contract, **Not on the schedule** or **Scheduled over the contract** stays visible below the contract summary, even when the breakdown is closed.

The **Change orders** section below the schedule lists each change order with its status and amount. Select **Create** to quote additional work.

The **Project Overview** card in the job page's right column shows the rest, once the project has a billing schedule (before you set one up, the card shows progress and operational facts):

* **Billed**: what has been billed on invoices that were sent or finalized, net of retainage.
* **Retained**: the retainage still held.
* **Left to bill**: the contract minus everything already invoiced and sent or finalized. Retainage you'll release later doesn't count as left to bill.

Drafts don't count as billed until you send or finalize them.

## Create a progress invoice

A line that reaches **Ready to bill** stays there until someone creates its invoice. Essential never creates or sends a progress invoice on its own.

1. On the **Billing Schedule** tab, find a line that shows **Ready to bill** or **Bill when ready**.
2. Select **Create invoice**. Essential creates a draft invoice for that line and opens it in the invoice editor.
3. Review the draft. Its customer, property, and payment terms come from the job's property and customer. Then send it or finalize it as you would any invoice. See [Send an invoice to a customer](https://learn.withessential.com/revenue/invoices/send-an-invoice-to-a-customer.md).

The line shows **Draft** until you send or finalize the invoice. Then it shows **Sent**, and **Paid** once it's paid.

The draft contains:

* **One line per billing line**, named after it, such as "Deposit". If the quote mixes taxed and untaxed items, the billing line is split so that each part carries the same tax as the quote.
* **A change order line**, when a change order was added to the billing line. It's named like "Final — CO-2".
* **Less retainage**, when the line holds retainage. It's a negative, untaxed line such as "10% held until the retainage release". Tax is charged on the full progress amount.

### The project billing summary on the invoice

Progress invoices and retainage releases print a **Project billing summary** under the invoice total, so your customer can see where the contract stands. It appears on the PDF, the emailed invoice, the payment page, and in the invoice editor's preview. Other invoices don't show it.

| Row                                 | What it shows                                                                                                                                                                                                  |
| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Original contract**               | The signed quote, after discounts and before tax.                                                                                                                                                              |
| **Approved change orders**          | The total of signed change orders.                                                                                                                                                                             |
| **Contract to date**                | The original contract plus approved change orders.                                                                                                                                                             |
| **Work billed before this invoice** | Progress billed on invoices that were sent or finalized before this one (they have lower invoice numbers). Drafts and voided invoices don't count. On a draft, every invoice already sent or finalized counts. |
| **Work billed on this invoice**     | The progress lines on this invoice, before retainage.                                                                                                                                                          |
| **Work billed to date**             | The two rows above added together.                                                                                                                                                                             |
| **Retainage held to date**          | Retainage held on progress invoices up to and including this one, minus retainage already released. Shown when the project holds retainage.                                                                    |
| **Balance to finish**               | The contract to date minus the work billed to date.                                                                                                                                                            |

A retainage release shows **Work billed to date**, **Retainage released on this invoice**, and **Retainage still held** instead of the before/on this invoice rows.

All amounts are before tax. The summary only explains the invoice: the **Less retainage** line is the only place retainage comes off the total.

**The figures stay as they were when the invoice went out.** When you send or finalize a progress invoice, Essential saves its summary. Reminders, the paid PDF, the payment page, and downloads keep printing those figures, even if you later sign a change order, send another progress invoice, or void an earlier one. A draft shows the current figures, counting every invoice already sent or finalized, until you send or finalize it. That includes an invoice you revert to draft: while it's a draft, its summary also counts progress invoices sent after it. When you send or finalize it again, the summary is saved again as of its invoice number, so invoices numbered after it don't count.

The summary is part of Essential's built-in invoice styles. If your business uses a customized invoice template, add the project variables in **Edit code** (see [Choose and customize your invoice document template](https://learn.withessential.com/administration/settings/choose-and-customize-your-invoice-document-template.md)).

### What you can't change on a progress invoice

* **The project's lines are read-only on the invoice.** You can't change their price, quantity, or tax, or remove them. Below each one, **Edit on the project schedule ›** opens the job's **Billing Schedule** tab. To change an amount, void the invoice, change the line on the schedule, and create the invoice again.
* **No other charges.** **+ Add item** is hidden, and the items list reads "Project progress invoices hold only their billing lines. Bill other charges on a separate invoice."
* **No discounts.** **Additional options** > **Discounts** reads "Project progress invoices can't take a discount. Adjust the billing schedule instead."
* **The customer, the property, and the project's job link are fixed.**
* **You can't duplicate a progress invoice.** Create it from the project instead.

## Bill a line early

When a line is **Waiting** but you need to bill it now, for example because the customer agreed to pay before the inspection passed:

1. Open the line's ⋮ menu and select **Bill early**.
2. Confirm **Bill "*****line*****" early?** with **Create invoice**. The invoice is created as a draft, so you can review it before sending.

A line billed early is never flagged as "trigger no longer met".

## Change the billing schedule

You can add, edit, and remove lines on the **Billing Schedule** tab until they're billed.

### Add or edit a line

1. Select **Add billing line** above the schedule. To change an existing line, open its ⋮ menu and select **Edit**.
2. Enter a **Name**, such as "Rough-in".
3. Under **Amount**, choose one:
   * **A share of the signed quote**, then enter the **Share** as a percentage. The quote's amount before tax is shown for reference. This option isn't available when the project has no signed quote.
   * **A fixed amount**, then enter the **Fixed amount** (in your business's currency).
4. Under **Bill it**, choose when the line becomes ready:
   * **When the project starts**: ready right away.
   * **When an item is done**: choose the **Checklist item**. Each of the project's items is listed with its phase, such as "Rough-in inspection · Rough-in". Use this for a line that bills when an inspection or test passes, or when the customer signs off: the line becomes ready when that item is marked done. An item that's already done makes the line ready right away.
   * **When a phase is complete**: choose the **Phase**. The line becomes ready when every item in the phase is done.
   * **On a date**: choose the **Date**. The line is ready from that day in your business's time zone.
   * **When you bill it**: no trigger. The line shows **Bill when ready**.
5. If the project holds retainage, leave **Hold N% retainage on it** checked to hold retainage on this line, or clear it.
6. Select **Add Line**, or **Save** when editing.

### Remove a line

Open the line's ⋮ menu, select **Remove**, and confirm with **Remove**. The line comes off the schedule, and its share isn't billed until you add it to another line.

### Rules for changing lines

* Only lines that no invoice bills show the ⋮ menu. To change a billed line, void or delete its invoice first.
* A line that combines change orders can't be edited or removed here.
* A line that was billed before, even on an invoice that was later voided or deleted, can be edited but not removed: its ⋮ menu shows only **Edit**.
* The schedule can't bill more of the signed quote than the quote holds. A line that would push it over is refused with "The billing schedule would add up to more than the signed quote. Lower this line or another one, or bill extra work as a change order."
* When part of the contract isn't on any line (for example after you remove a line), **Contract** shows **Not on the schedule** with the amount. Add or edit a line to cover it. A project can't show **Closed** until its schedule matches the contract and everything on it has been billed.
* A project without a billing schedule shows "No billing schedule yet." on the **Billing Schedule** tab. Its quote is invoiced the usual way, and billing doesn't keep the project from closing.
* A share of the signed quote is always a share of the quote's amount when billing was set up.
* **Add billing line** checks that the signed quote is still the one billing was set up with. If the quote was voided, reopened, or its lines, prices, or taxes changed since then, the line is refused with "The project's quote changed after the project started (it was voided, reopened, or edited), so it can't be billed on a schedule." Bill it the ordinary way, or start a new project from the re-signed quote.

## Retainage

Retainage is a percentage held back from progress invoices until the work is complete, which is common on construction contracts.

### How retainage is held

* Each progress invoice for a line that holds retainage includes a **Less retainage** line. That line holds back the retainage percentage of the progress amount.
* Retainage counts as held only once its invoice is sent or finalized. A draft holds nothing yet.
* Retainage appears beneath each line's amount when it is greater than zero. **Retained** on the **Project Overview** card shows the total still held.
* The deposit created by **Set Up Billing** never holds retainage.

### Release retainage

1. When retainage is held, **Release retainage** appears on the **Retainage release** line. Select it.
2. Essential creates one draft invoice for the full amount available and opens it in the invoice editor. The draft has a single untaxed **Retainage release** line.
3. Review the draft and send it.

You can release retainage whenever it's held, including before the work is done if your contract allows.

Only one release can be in draft at a time. While it's in draft, the button is hidden and the release line shows **Draft**. If more progress invoices hold retainage after a release, the release line goes back to **Held** and you can release again.

### Change the retainage percentage

1. Above the schedule, open the **Billing settings** ⋮ menu and select **Change retainage**.
2. In the **Retainage** dialog, enter the new percentage, or leave it empty for no retainage.
3. Select **Save**.

The new percentage applies to lines billed from now on. Invoices already created keep what they hold. You can't change retainage while a release is in draft. Send or delete that draft first.

Turning retainage on doesn't change existing lines. Edit each line that should hold retainage and check **Hold N% retainage on it**. Lines you add afterward hold retainage by default. Turning retainage off clears **Hold N% retainage on it** from every line, so turning it back on later starts with no line holding retainage. Invoices already created keep what they hold.

## Change orders

A change order is a quote for extra work on the job. Create it directly from the project, send it for signature, then choose how to bill it from the schedule.

> **Where to find it:** **Jobs** → open the project job → **Billing Schedule** → **Change orders** → **Create**. Without invoice access, use **Create** on the **Change orders** card in the job page's right column.

1. Select **Create**. The quote editor opens with the customer, property, and job linked, using your usual quote template.
2. Edit **Description** to explain the extra work. It starts with "Change order to Quote #1042" when the project has an original quote, or "Change order" otherwise, followed by: "The total shown is the additional amount payable for this change. It is in addition to the original contract price." This text appears on the customer's quote. Internal project names aren't copied into the description. Add the price for the extra work and any payment terms; the original job's items aren't copied.
3. Select **Save**. This saves the quote and adds it to the project's change orders together, with the next number, such as **CO-1**. Numbers are never reused. Leaving the editor without saving doesn't create a quote or change order.
4. Send the quote for signature as usual. While it's out for signature, it shows **Waiting for signature**. Its amount appears under **Pending change orders**.
5. Once the customer signs, the amount moves into **Approved change orders** and the **Contract**, and the change order shows **Choose billing**.
6. Select **Choose billing** next to the change order. In **How should CO-N be billed?**, choose one:
   * **Bill it on its own line**: enter a **Line name** (it defaults to "Change order CO-N") and choose whether to **Hold N% retainage on it**. The new line shows **Bill when ready**.
   * **Add it to a line that hasn't been billed**: choose the **Billing line**. The change order is billed with that line's next invoice. This option is unavailable when every line has already been billed.
7. Select **Save**. The change order shows **On the schedule:** and the line's name.

A change order is billed once, for its amount after discounts and before tax. Its invoice line carries the change order quote's tax.

Already have a quote for the extra work? In the **Change orders** section's **⋮** menu, select **Add existing quote**, choose the quote, and select **Add Change Order**. The quote must already be linked to this job. The original project quote and quotes that are or were change orders on this job aren't offered. See [Link quotes and invoices to a job](https://learn.withessential.com/customers-and-work/jobs/link-quotes-and-invoices-to-a-job.md).

Rules for change orders:

* **Create** links the new quote automatically. **Add existing quote** requires a quote already linked to this job.
* A quote that was already invoiced the ordinary way can't become a change order.
* If the job itself was already invoiced the ordinary way and the project doesn't bill on a schedule yet, change orders can't be added: "This job was already invoiced the ordinary way, so its change orders can't bill through the project. Invoice this quote the ordinary way instead."
* A quote bills through one project only. A quote that is another job's project quote or change order can't be added, and fails with "This quote already belongs to another job's project, so it can't be billed through this one too." That includes a deleted job whose project already billed the quote.
* A change order can't be billed until its quote is signed, and while its quote is still linked to the job.
* Once a quote is added as a change order, it bills through the project: **Create Invoice** on it is refused even before you choose how to bill it. Once it's on the schedule, its quote also can't be unlinked from the job, voided, or deleted.

To undo a change order, use its **⋮** menu:

* **Take off the schedule** removes it from its billing line (or removes its own line) while nothing has billed it yet. If an invoice already bills it, void or delete that invoice first.
* **Void change order** (only when it isn't on the schedule) stops it counting toward the contract, after you confirm with **Void Change Order**. The quote stays on the job. To bill the change later, create a new quote and add it as a new change order; a voided change order's quote can't be added again.

A change order whose quote is still a draft shows **Quote in draft**; one whose quote was voided shows **Quote voided**.

On the **Change orders** card in the job page's right column (for roles that can view quotes but not invoices), each change order shows its number and its quote's state, such as **Signed**. You can add change orders there and void ones that aren't on the schedule. Amounts, **Choose billing**, and **Take off the schedule** are on the **Billing Schedule** tab only.

## Void or delete a progress invoice

Voiding or deleting a progress invoice frees its line. The line goes back to **Ready to bill**, **Waiting**, or **Bill when ready**, so you can change it and bill it again. This is also how you correct an amount after a progress invoice was created.

Some limits apply:

* **Returning a progress invoice to draft.** Whether you choose **Revert to Draft** on a voided progress invoice or directly from an issued one, the project must be turned on, its job must not be deleted (restore it first if it is), and the invoice must keep its customer, property, and project job.
* **Reopening a voided progress invoice.** Bringing a voided invoice back also requires that its line wasn't billed again and the schedule hasn't changed since it was voided. Otherwise it fails, for example with "The billing schedule changed since this invoice was voided. Bill the line again instead of reopening it."
* **Retainage that was already released.** You can't void, or revert to draft, a progress invoice whose retainage a sent release already billed: "A retainage release already billed retainage held on this invoice. Void that release invoice first." If a release draft is holding that retainage, delete the release draft first.

See [Void an invoice (and reopening a voided one)](https://learn.withessential.com/revenue/invoices/void-an-invoice-and-reopening-a-voided-one.md).

## "Its billing trigger is no longer met"

A line can stop meeting its trigger after you drafted its invoice. For example, its item was reopened, its item left the project, or a phase is no longer complete. When that happens:

* The line shows **· trigger no longer met** on the schedule.
* When you select **Send**, **Finalize**, **Record Payment**, **Charge Payment Method**, or **Mark as Uncollectible** on the draft, a confirmation titled **Its billing trigger is no longer met** asks whether to go ahead, because each of these issues the invoice. Select the **Continue to …** button to bill it anyway, or cancel and wait for the trigger. Essential checks the project's schedule again each time you select one of these, so an item reopened after you opened the invoice still asks first. If the schedule can't be loaded, you see "Couldn't load this invoice's project billing schedule. Try again in a moment."

Lines billed early, and lines set to **When you bill it**, are never flagged.

A line that isn't billed yet just goes back to **Waiting** when its item is reopened, and becomes **Ready to bill** again once the item is done.

## When a line's item leaves the project

A line set to **When an item is done** waits on that one item. Moving the item to another phase doesn't change anything. But if the item is no longer one of the project's items, the line can't become ready:

* The item was taken off the project (**Remove from the Project** in the popup of an ordinary Task from another folder, or moved to a folder outside the project without a phase).
* The item was deleted.
* The item was linked to another job.

When that happens, a line that isn't billed yet stays **Waiting** and shows **· choose another trigger**. Open the line's ⋮ menu, select **Edit**, and choose another item or another trigger under **Bill it**. A draft invoice already on the line is flagged as [no longer meeting its trigger](#its-billing-trigger-is-no-longer-met) instead, unless it was billed early.

If the item comes back, for example because its deleted job was restored, the line works again on its own.

## Things to know

* **The project's quote is billed only from the project.** Once a project bills its signed quote on a schedule, **Create Invoice** on that quote fails with "This quote is billed through its project's billing schedule. Bill it from the project instead." The quote also can't be voided or reverted to draft while the schedule bills it (the same applies to a change order's quote while it's on the schedule), because the schedule bills from its lines and tax.
* **A billing schedule needs a signed quote.** Set Up Billing records the quote you choose as the project's quote, as it is then, and links it to the job if it wasn't. A quote that was reopened and signed again before you set up billing is fine.
* **Deleting the job** is blocked while a draft invoice still bills its project's schedule: delete or void that invoice first.
* **Deleting the project's quote** is blocked while the schedule bills it (and a change order's quote while it's on the schedule). Deleting the whole job removes the project with it.
* **A deleted job's project keeps the quotes it billed.** Once any invoice billed a quote through the project, even one later voided, that quote still can't be invoiced the ordinary way, voided or reverted to draft, and no other job's project can bill it, while the job is deleted. A quote it never billed is free: you can invoice it, void it or reopen it, or another project can use it.
* **Restoring a deleted project job** fails if, while the job was deleted, a quote its project bills from was deleted ("A quote this job's project bills from was deleted, so the job can't be restored."), now bills through another job's project ("A quote this job's project bills from now belongs to another job's project, so the job can't be restored."), was invoiced the ordinary way ("A quote this job's project bills from was invoiced the ordinary way while the job was deleted, so the job can't be restored."), or was voided, reopened or edited ("A quote this job's project bills from was voided or changed while the job was deleted, so the job can't be restored."). For an ordinary invoice, void it first, then restore the job.
* **Turning the project off** stops all billing from the schedule. You can't turn it off while a draft invoice bills the schedule.
* **Billing a turned-off project** fails with "This project is turned off. Turn it back on to bill it."

## Related guides

* [Track a job as a project](https://learn.withessential.com/customers-and-work/jobs/track-a-job-as-a-project.md)
* [Manage a project's checklist and phases](https://learn.withessential.com/customers-and-work/jobs/project-plan-phases-and-tasks.md)
* [Send an invoice to a customer](https://learn.withessential.com/revenue/invoices/send-an-invoice-to-a-customer.md)
* [Void an invoice (and reopening a voided one)](https://learn.withessential.com/revenue/invoices/void-an-invoice-and-reopening-a-voided-one.md)
* [Why can't I edit an invoice?](https://learn.withessential.com/revenue/invoices/why-cant-i-edit-an-invoice.md)
* [How a customer reviews and signs a quote](https://learn.withessential.com/revenue/quotes/how-a-customer-reviews-and-signs-a-quote.md)
* [Link quotes and invoices to a job](https://learn.withessential.com/customers-and-work/jobs/link-quotes-and-invoices-to-a-job.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://learn.withessential.com/customers-and-work/jobs/project-billing-progress-invoices-retainage-and-change-orders.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
