This page answers common questions about creating, numbering, sending and getting paid for invoices in Legalsense. For an overview of the invoice lifecycle, see the article ↪ Invoice management.
In this article
- 01Why do I get "Out of codes" or "No new valid number could be found" when I create an invoice?
- 02How do I change the invoice numbering for the new year?
- 03Can I unfinalize an invoice?
- 04Does the invoice number change if I unfinalize and then finalize an invoice again?
- 05Can I change an invoice's number?
- 06Why is my Peppol ID rejected?
- 07Why can't I send my invoice via Peppol?
- 08Why doesn't my invoice open or download as a PDF ("Invalid color value")?
- 09How do I download or print many invoices at once?
- 10How do I change the letterhead or layout of my invoices?
- 11Why is my LEDES file rejected, for example by Brightflag?
- 12Why do I get "Assigned contact should be a debtor with default billing address."?
- 13Why does my invoice show the wrong debtor?
- 14Why is the paid amount on an invoice different from the amount in reports or the debtor overview?
- 15Can I apply an unpaid advance to an invoice?
- 16What is the format of our XML invoices?
Why do I get "Out of codes" or "No new valid number could be found" when I create an invoice?
The two messages have different causes:
- "Out of codes" means you've used every invoice number your number format allows. If your invoice number has, for example, a 4-digit counter that restarts each year, you can create up to 9,999 invoices per year, and that limit has now been reached.
- "No new valid number could be found" means the numbers that come next in the series are already in use, for example because an older invoice was numbered wrongly. Contact Legalsense Support with the message and the invoice you were creating. Support corrects the numbering, so the series can continue.
For "Out of codes", Legalsense Support needs to change your invoice number format; you can't change it yourself. There are two options:
- Option A: add a digit to the counter. The counter grows from 4 to 5 digits, so you can create up to 99,999 invoices per year. Apart from being one digit longer, your invoice numbers look the same.
- Option B: add the month to the invoice number. The month appears between the year and the counter, and the counter restarts every month instead of every year. You can then create up to 9,999 invoices per month. For example, an invoice number could look like 2026010091 (year, month, counter).
We recommend Option A. It's the smallest change, because your invoice numbers keep the same format. Option B changes how your invoice numbers look from now on. That can matter if your firm has its own numbering conventions, or if your accounting software or other exports depend on the current format. If you want a lot of room for growth, you can also combine both options.
To solve the issue:
- Choose one of the options above.
- Contact Legalsense Support. Tell them you get the "Out of codes" error when creating an invoice, and which option you've chosen.
- Once Support confirms the change, create your invoice again.
Note: Whichever option you choose, your existing invoice numbers don't change. The new format only applies to invoices you create after the change.
How do I change the invoice numbering for the new year?
Usually you don't need to change anything. If your invoice number contains the year, as it does in most environments, Legalsense restarts the numbering each year automatically, and your first invoice of the new year gets a number starting with that year.
Contact Legalsense Support if your invoice number has a fixed prefix instead of the year, if your firm's financial year doesn't follow the calendar year, or if you want to keep using last year's numbers for a while in the new year. Support then adjusts the number series for you.
How Legalsense chooses the year
The Date field on the invoice decides which year's number it gets. The day you click Finalize doesn't matter.
- If you leave the Date field empty, Legalsense fills in today's date when you finalize. An invoice you finalize in the new year therefore gets a number for the new year.
- If an invoice is dated in the previous year, it gets a number for that year, even if you finalize it in January. For example, you might date an invoice in December because it covers work done that month. This is intended: the numbering follows the invoice date.
If an invoice gets last year's number
- Open the draft invoice.
- Check the Date field.
Edit page of a draft invoice, showing the Date field in the invoice details.
- If you want a number for the new year, change the date to a day in the new year, or leave the field empty so Legalsense uses today's date.
- Click Finalize.
If you deliberately dated the invoice in the previous year, for example for December work, it keeps last year's number whenever you finalize it. That's expected.
Note: There's no setting to switch to the new year's numbering. If your invoice number contains the year, Legalsense already does this automatically, based on each invoice's own date.
Can I unfinalize an invoice?
Yes, if no payments are registered on it, it hasn't been credited and it hasn't been synced to your accounting software. Click Mark as draft on the invoice to turn it back into a draft. Unfinalizing is an optional feature that needs a permission, and it's meant for correcting mistakes before the invoice has left your firm.
For the steps, what changes and what to do if you don't see the button, see the article ↪ Unfinalizing an invoice.
Does the invoice number change if I unfinalize and then finalize an invoice again?
No. The invoice keeps its original number. Unfinalizing only reopens the invoice for editing; it doesn't reset or reassign the number. You can safely unfinalize an invoice, make your change, and finalize it again.
Can I change an invoice's number?
Only if you have the right permission. The edit page of a draft invoice has a Number field, but it's greyed out unless your role has permission to edit invoice numbers. If you leave the field empty, Legalsense assigns a number automatically when you finalize. If you don't have the permission, ask your Legalsense administrator. In exceptional cases, Legalsense can change the number for you, but we prefer not to renumber invoices, and only do so if all of the following apply:
- The invoice is unfinalized.
- The invoice hasn't been sent to the client.
- Your invoices don't sync to an external accounting system. If you use an accounting integration, we can't renumber the invoice.
If your invoice meets these conditions, contact Legalsense Support with the invoice details and the number you need. We'll check whether we can make the change.
Why is my Peppol ID rejected?
Usually because it isn't in the right format. A Peppol ID has two parts, separated by a colon: a scheme code and an identifier. For example, 0106:12345678 is a Dutch Chamber of Commerce (KVK) number. You enter it in the Peppol endpoint ID field. There are two common reasons a Peppol ID is rejected:
- There's no colon. Enter the ID as scheme:number, not just the number.
- Legalsense doesn't recognize the scheme. The part before the colon must be a valid scheme code, such as 0106. If you're not sure which scheme applies, ask your accountant or the organization that registered the Peppol ID. You can also look up an organization's Peppol ID in the ⧉ Peppol Directory.
Edit contact page, showing the Peppol endpoint ID field with the error "Invalid Peppol ID format. It must consist of a scheme ID and an endpoint ID, separated by a colon (e.g., 0106:12345678)."
Note: Legalsense always checks that the Peppol ID is correctly formatted. If your firm sends invoices via eConnect or Inexchange, Legalsense also checks that the ID exists, and shows "This Peppol ID does not exist." or "This Peppol ID is not known in Inexchange." if it doesn't. Without eConnect or Inexchange, Legalsense doesn't check that the ID is registered and active on the Peppol network, so an invoice sent to a correctly formatted ID can still fail to arrive.
Why can't I send my invoice via Peppol?
Usually because one of the requirements isn't met yet. You can only send an invoice via Peppol if all of the following apply:
- The invoice is finalized. You can't send a draft invoice.
- Your firm's Peppol ID is filled in under Settings → General → Firm.
- Your client's Peppol ID is filled in the Peppol endpoint ID field on their debtor contact.
- If you added or changed your client's Peppol ID after creating the invoice, you recreated the invoice afterwards. Otherwise, the invoice still uses the old or missing ID.
When you click Send via Peppol, Legalsense schedules the invoice for sending. It's usually sent within a few minutes, and the delivery confirmation can take a little longer. If something is missing, such as a Peppol ID, Legalsense tells you straight away which requirement isn't met. If something goes wrong later, while the invoice is being sent, Legalsense sends you a notification with a link to the invoice. To check the status of an invoice you've sent, open the invoice and click Peppol.
Invoice page, showing the Peppol panel opened from the invoice toolbar, with the Sent and Status columns and the Send via Peppol button.
The most common cause is a wrong or wrongly formatted Peppol ID on the debtor, so check that first; see Why is my Peppol ID rejected? above. If you've checked all of the above and the invoice still isn't sent, contact Legalsense Support with the invoice number. For setting up Peppol, see the article ↪ Peppol.
Why doesn't my invoice open or download as a PDF ("Invalid color value")?
Almost always because text was pasted into one of the invoice's text fields from another program, such as Word, Outlook or a web page. Text you paste from those programs often brings hidden formatting with it. Sometimes that formatting includes a color that Legalsense can't read when it creates the PDF, and then Legalsense can't create the PDF at all. The problem is the hidden formatting, not the content or amounts on your invoice.
Fix the pasted text
- Find the text field where you pasted text. This is usually a line description or an invoice note.
- Copy the text and paste it somewhere else, then copy it and paste it back again. There's no button to clear formatting.
- Open or download the PDF again.
Prevent the problem
When you paste text from Word, Outlook or a web page into an invoice, paste it as plain text. This removes the hidden formatting before it reaches Legalsense. In most programs, right-click and choose the option to paste as plain text, or press Ctrl+Shift+V.
If the PDF still won't open or download, contact Legalsense Support. Tell us which invoice it is and which field you edited, and we'll look into it.
How do I download or print many invoices at once?
- Go to Invoices and use the filters to find the invoices you want, for example by invoice date or debtor.
- Select the invoices with the check boxes in the list. To select all invoices in the list, use the check box in the header row.
- Click Download and choose a format:
- Merged PDF file with logos or Merged PDF file without logos: one PDF with all selected invoices, so you can print them in one go.
- Multiple PDF files with logos or Multiple PDF files without logos: a ZIP file with a separate PDF for each invoice.
Choose Merged PDF file without logos or Multiple PDF files without logos if you print on pre-printed letterhead paper.
Note: Download a large number of invoices in smaller batches. A single download of very many invoices can take too long and stop with an error.
How do I change the letterhead or layout of my invoices?
Legalsense Support makes these changes for you, for example new bank details or a new address on your letterhead, a different layout, or an extra invoice template. Send your request to support@legalsense.nl. Support first checks what's possible.
What to send for a new letterhead
- A high-quality PDF of the letterhead, exactly as it should be used. It contains only the fixed details that appear on every invoice, such as your logo, address and bank details. Legalsense Support can send you the PDF you use now as a starting point.
- A separate PDF for each language, if you send invoices in more than one language.
Don't send loose logo images, a Word document, or an invoice with real client data. Legalsense Support then has to make the letterhead itself, which doesn't always give the result you want and can cost extra.
Other changes to the layout
Describe what you want and preferably include an example of the result. "Show the matter name on the invoice" doesn't say where it should appear. If you want a different font, send the font files; the font may need a license.
What happens next
A change usually takes five working days, so send your request in good time. Legalsense charges template changes at its standard consultancy rate.
- Legalsense Support tests the change on a copy of your environment.
- Legalsense Support applies the change to your environment.
- Check the result by creating a new draft invoice.
Existing draft invoices get the new layout when you finalize them.
Why is my LEDES file rejected, for example by Brightflag?
Usually because the totals in the file don't add up the way the client's e-billing platform expects, or because the platform requires codes that are missing from the file. Platforms such as Brightflag check every LEDES file against their own rules before they accept it, and the error message usually tells you which rule failed.
The invoice total doesn't match the line totals
Brightflag, for example, rejects the file with error R410: "The INVOICE_TOTAL doesn't match with the LINE_ITEM_TOTALS". Most often, the difference is a cent or two. The LEDES file rounds the VAT on each line separately, so the line totals can add up to a slightly different amount than the invoice total.
- If the invoice is still a draft, open the invoice, click Edit, choose + 0.01 or - 0.01 in the Apply VAT correction? dropdown and save. Then finalize the invoice and export the LEDES file again.
Edit page of a draft invoice, showing the Apply VAT correction? dropdown, just below the time entries section.
- If the invoice is already finalized, create a credit invoice for it, then create a new invoice, choose a correction in the Apply VAT correction? dropdown before you finalize it, and export that invoice. See the article ↪ Creating a credit invoice.
If the difference is larger than a few cents, check the disbursement lines. Earlier versions of Legalsense left the VAT out of the line total for disbursements and advances in LEDES files, so the line totals fell short by exactly that VAT. This has been fixed. Download the LEDES file again to get the corrected totals.
The file is missing required codes
Many e-billing platforms require a UTBMS task and activity code on every line, and a classification for every timekeeper. Legalsense doesn't fill these in by default, so your firm needs to add them:
- Enter the task and activity codes on your activities and expense types.
- Enter the LEDES classification, such as PT for Partner or AS for Associate, on each function under Settings → Lists → Functions.
Edit function page, showing the LEDES classification field filled in with PT.
Then export the LEDES file again. See the article ↪ Invoices in LEDES format.
The platform expects a different LEDES variant
Clients and e-billing platforms interpret the LEDES standard differently. By default, Legalsense exports a variant based on the one Tymetrix uses, which another platform may not accept. Legalsense can set up other variants for your firm. Contact Legalsense Support with the invoice number and the error message from the platform, and we'll check which variant you need.
Why do I get "Assigned contact should be a debtor with default billing address."?
Because the contact you selected isn't set up as a debtor yet, or doesn't have a default billing address. Legalsense needs both before it can use the contact as a debtor. To fix it:
- Go to Matters → Contacts and open the contact.
- Make sure Debtor? is selected.
Edit contact page, showing the Debtor? checkbox selected.
- Add a billing address to the contact. If the contact already has an address, click Set as default billing address next to it.
Important: If the contact already had an address before you selected Debtor?, selecting the checkbox alone doesn't fix the error. Afterwards, click Set as default billing address next to the address on the contact page.
Why does my invoice show the wrong debtor?
This usually isn't an error. The invoice shows the debtor that was set on the matter when the invoice was created. If you change a matter's debtor later, existing invoices don't change. Only invoices you create after the change use the new debtor.
On a draft invoice, you can change the debtor yourself: open the invoice, click Edit and choose the debtor. A finalized invoice keeps its debtor, so it stays an accurate record of who it was issued to. If a finalized invoice needs to show the current debtor, create a credit invoice for it, then create a new invoice. See the article ↪ Creating a credit invoice.
Why is the paid amount on an invoice different from the amount in reports or the debtor overview?
Usually because a payment was recorded twice, or because a payment is missing in Legalsense. Common causes are a payment entered by hand next to the same payment synchronized from your accounting software, and payments in your accounting software that never reached Legalsense.
Why the screens disagree
Reports show the total of every payment recorded for an invoice. The invoice page and the debtor overview show whether the invoice is paid: an invoice is paid when its open amount is exactly 0. Legalsense recalculates this every time a payment is added or removed.
If a payment is recorded twice:
- Reports show more money received than the invoice amount, because they count every payment.
- The open amount becomes negative, so the invoice page and the debtor overview show the invoice as not fully paid, even though reports show it's been overpaid.
Find and remove the duplicate payment
- Open the invoice and check its payment history.
Invoice page, showing the Payments panel opened from the invoice toolbar, with two payments of the same amount and date in the Date, Description and Amount columns.
- Look for two payments that seem to be the same transaction: the same amount, the same or a very similar date, and a matching reference.
- Remove the duplicate payment.
Legalsense then shows the same paid amount everywhere again.
Important: A payment that came from your accounting software can't be removed in Legalsense. If the duplicate is such a payment, enter a separate payment with a negative amount to cancel it out instead. See the article ↪ Payment status billing.
If you can't tell which payment is the duplicate, you don't find one, or a payment seems to be missing in Legalsense, contact Legalsense Support with the invoice number and we'll look into it.
Can I apply an unpaid advance to an invoice?
Yes, if the Allow settling unpaid advances setting is turned on. This setting is on by default.
- If the setting is on, you can settle an advance on an invoice whether or not the advance has been paid. Legalsense lowers the amount due by the amount of the advance.
- If the setting is off, you can only settle advances that have been paid. Wait until the advance is paid, then settle it on the invoice.
You can find the setting under Settings → General → System. If you're not sure how it's configured, or you'd like it changed, contact Legalsense Support and we'll check or adjust it for you.
System settings page, showing the Allow settling unpaid advances checkbox in the Billing section.
How to settle an advance
You can settle an advance when you create the invoice, or afterwards by clicking Settle advances on the edit page of the draft invoice. When you create the invoice, choose one of these options under Settle outstanding advances:
- Yes, settle with this invoice lowers the invoice by the amount of the advance, down to €0 at most.
- Yes, settle all outstanding advances fully settles every outstanding advance on the invoice. If the advances add up to more than the invoice amount, the result is a negative amount (a credit invoice), which you can pay back to your client.
New invoice form, showing the Settle outstanding advances options No, Yes, settle with this invoice and Yes, settle all outstanding advances fully.
For the full steps, see the article ↪ Settling advances on an invoice.
What is the format of our XML invoices?
They are ⧉ BIS Billing 3.0 invoices. BIS Billing 3.0 is a set of rules on top of UBL 2.1: the file is a UBL 2.1 invoice that also meets the extra requirements of BIS Billing 3.0. "BIS Billing invoice" is therefore a more precise name than "UBL invoice" or "XML invoice".
BIS Billing invoices are also known as "Peppol invoices", because Peppol requires BIS Billing 3.0. You can still use them without Peppol, because Peppol is only a way to send invoices. A valid BIS Billing invoice does need the debtor's Peppol ID, also when you don't send it through Peppol.
Legalsense doesn't create LEDES XML invoices. LEDES exports from Legalsense are LEDES 1998B text files, not XML.
Note: Both our formerly used UBL format and the current BIS Billing 3.0 format comply with the ⧉ EN 16931 standard.
Here's a helpful Venn diagram:
Venn diagram showing how XML, EN16931, UBL 2.1, BIS Billing 3.0 and LEDES 2.1 relate to each other.
Validation
You can use ⧉ https://test.peppolautoriteit.nl/validate to validate the generated invoice, make sure to use the European Norm (base) format.
Important: Never upload invoices to a third party without redacting them first.
The Validate form of the Peppol validator, with European Norm (base) selected as the format.
Comments
0 comments
Please sign in to leave a comment.