Invoice errors in BuildOps are often caused by missing setup in Quote Settings, Labor Settings, or the Service Agreement invoice setup. This guide explains the most common configuration-related invoice issues and how to fix them.
Before you begin
When troubleshooting invoice creation or invoice template issues, first confirm which workflow you are using:
Quoted job invoicing
Time & Material (T&M) job invoicing
Service Agreement invoicing
The setup that controls the invoice depends on that workflow, so the fix is not always in the same place.
Error: A Service Agreement will not activate
If a Service Agreement will not activate, the most common cause is incomplete invoice setup in Step 7 of the agreement workflow.
Check the following:
Make sure Step 7: Invoice Setup has been fully completed.
Confirm an invoice template has been assigned to the agreement.
Make sure the invoice template includes at least one line item.
If the template uses multiple line items, make sure the percentages total exactly 100%.
If the agreement includes multiple properties, review the invoice setup for each property and confirm the required billing details are complete before activating again.
If the fields in Step 7 appear locked or do not respond correctly, reopen the agreement, go back to Step 7, switch the billing schedule option, then re-enter the invoice details and save again.
Error: A quoted job invoice says an invoice item requires a product ID
If you see an error such as createInvoiceFromQuotedAmountJob: InvoiceItem (...) requires a productId, the issue is usually in Quote Settings or in the item mapping used for quoted-job invoicing.
Go to Quote Settings and open the Preferences tab.
Then check the invoice line item setup for quoted jobs:
Confirm the invoice line item setting is configured for quoted jobs.
If you use default line items, make sure each default line points to a valid, active item from your Item List.
If you have multiple default line items, make sure the total percentage allocated equals 100%.
If the item already appears to be selected, clear it and re-select it from the search dropdown, then save again. In some cases, the saved line can appear filled in by name but no longer be properly bound to a valid item in the Item List.
Error: A T&M invoice says an invoice item requires a product ID
If a T&M invoice shows a requires a productId error, the usual cause is a missing default billing product for labor invoice items or an invalid product mapping on the billing hour type.
To fix this:
Go to Labor Settings.
Open Billing Hour Rates and Types.
Confirm a valid Default Billing Product for Labor Invoice Items is selected.
If your team uses multiple billing hour types, verify that the hour types used on the job are also mapped correctly and point to valid active items.
Error: You cannot save or apply an invoice template
If BuildOps will not let you create or apply an invoice template, make sure the template includes at least one line item and that the total percentage allocation equals 100%. These are required for Service Agreement invoice templates and quoted-job default line item setups.
For Service Agreements, after completing the template, click Create & Apply New Invoice Template, then save the agreement draft before activating it.
Error: The item search does not let me select a line item
If the item search does not populate or will not let you pick an item, the selected entry maynot be an active Product in the Item List, or your role may not have permission to edit Quote Settings.
For quoted-job default line items, BuildOps only allows active, non-archived Product items to appear in the selector.
Make sure:
The item exists in the Item List
The item is active
The item is not archived
Your role has permission to edit Quote Settings if the fields are disabled
Best practices
For Service Agreements, complete all required Step 7 invoice details before trying to activate or bulk email invoices.
Confirm the Default Billing Product for Labor Invoice Items is set before creating T&M invoices.
Use valid, active items when configuring default invoice line items for quoted jobs.
Make sure default line item percentages total 100% before saving.