What you see
- In the Contract invoice column, the row shows "Visits pending", "Free" or a dash, not the Contract invoice button.
- Or the invoice box shows:
- "Could not load contract"
- "Invoice date and due date are required"
- "All items must have a description and unit price > 0"
- "Failed to create invoice", "Invoice created but PDF download failed" or "Failed to download PDF"
- Or it shows Download PDF and "Invoice already exists, downloading PDF...".
- Or the box badge reads "Service Contract" for an AMC.
- Or the dashboard's Billing follow-ups alert opens Billing on contracts that are not the ones it counted.
Why it happens
- A contract is ready to invoice when every visit is done, it has no contract invoice yet and it is not a warranty. "Visits pending" means visits are still to do; "Free" means a warranty, which is never billed.
- A dash, or no button, with every visit done: the button needs Add on Invoices.
- One invoice per period: when an invoice for the same period exists, the box downloads it instead of making a second one.
- The box checks the dates and the lines before it creates the invoice.
- The badge: the box reads "AMC Contract" only for AMCs brought over from the old AMC screens. Every other contract, including an AMC added on New contract, shows "Service Contract". The invoice is still a Service invoice for that contract.
- Billing follow-ups counts visits marked "follow up" or "pending", but opens Billing filtered to contracts ready to invoice, a different set.
- Parts on a visit are not billed from this box. The parts box on Billing is read only.
What to do
- For "Visits pending", complete or cancel the remaining visits first. See Complete a visit.
- For a missing button, ask your Owner or Admin for Add on Invoices.
- Fill in Invoice Date and Due Date, and give every line a description and a unit price above 0. Then select Create & Download PDF again. See Create a contract invoice from Billing.
- For "Invoice created but PDF download failed", open the invoice and download it there. See View an invoice and download its PDF.
- To bill parts, or several contracts on one invoice, create the invoice in the Financial module. See Invoice service jobs from Job Costing and Create an invoice.
If it still happens
For "Could not load contract" or "Failed to create invoice", reload Billing and try again. If it is refused again, submit a request with the contract number and the message.
