Financial (invoicing)
Financial is the SmartLabSys app for invoicing, the price list and electronic invoices. This page explains what SmartLIMS shares with Financial, what Financial reports back, and how to add price-list items to your forms.
Who this is for: Laboratory owners and administrators, and lab staff who need to see whether a request is invoiced · You need: your company connected to Financial through the SmartLabSys platform; the "See invoices from Financial on requests" permission to see invoice details
The idea in short
SmartLIMS describes the work. Financial decides what to charge.
| SmartLIMS | Financial |
|---|---|
| Holds the requests, samples and tests you did | Decides who pays, which price applies and the amounts |
| Shares each request with Financial: its tracking number, status, customers, samples, products, groups of parameters, parameters and any price-list items picked on the form | Turns requests into invoices, by default once they are Authorized |
| Shows where each request stands in invoicing | Issues invoices, credit notes and electronic invoices |
SmartLIMS never shows prices or amounts. Electronic invoicing (SEF) is handled in Financial, not in SmartLIMS.
The customer details Financial receives come from your customers: name, tax ID, registration number, address, and the billing or official email address. Keep them complete, and Financial has what it needs.
What Financial picks up
- Financial checks SmartLIMS for new and changed requests on its own. You don't send anything by hand.
- A change to a request's fields, samples, status, groups or parameters counts as a change. Entering results doesn't, since results aren't billed.
- A request deleted in SmartLIMS (only possible while it is Received) drops out. Anything Financial had already picked up stays in Financial.
A request with several reports
When a request is reported in parts (Several reports for one request), Financial invoices it per report. Each issued report goes to Financial as soon as it is issued, even before the request is Authorized, with only the samples and groups it is the first to cover. Price-list items picked on the request are invoiced once, with the first report. A replacing report covers nothing new, so it is not invoiced again. Until the first report is issued, the request is shared as a whole, as usual.
How to connect Financial
The connection is made on the SmartLabSys platform, not in SmartLIMS.
- Make sure your organization is connected to SmartLIMS on the platform. See The SmartLabSys platform.
- On the platform, connect your organization to Financial as well.
- Financial can now read your requests and your price list becomes available in SmartLIMS forms.
If Financial isn't connected, SmartLIMS works normally. Price-list fields stay empty and show "Financial is not connected, so the price list is empty."
How to add price-list items to a form
A price-list field lets the person filling in a request pick items from Financial's price list, for example a sampling fee or an urgent-handling surcharge. Financial uses the picked items when it prices the request.
- Add a field of type Price list item (Financial) to the form, at request or sample level. See Forms and report templates and Custom fields and formulas.
- In the form builder, open the field's settings to limit what it offers:
- Price-list categories: only items in these categories.
- Price-list items: only these items, by code.
- Leave both empty to offer the whole price list.
- Save the form.
When filling in a request, the field shows each item's Code, Name, Unit and Category.
📷 Screenshot: a request with a price-list field open, showing items with code, name, unit and category
How to see whether a request is invoiced
Financial reports the invoice state of each request back to SmartLIMS. You see it in three places:
- Requests list: the Billing column shows the state of each request. Use the Billing filter to list, for example, everything Not invoiced.
- Request page: the Invoice panel shows the details (see the table below) and an Open in Financial link. Its footer says when Financial last updated it ("Updated by Financial on …").
- Edit page: an invoiced request shows "This request is invoiced (number). Changes are flagged in Financial for review." You can still edit it. Financial marks the invoice for review, so someone in finance can check whether it needs a correction.
📷 Screenshot: the Invoice panel on a request page with invoice number, status and payment
| Billing state | Meaning |
|---|---|
| Not invoiced | Financial hasn't started an invoice for this request yet. |
| Invoice in preparation | An invoice is being drafted in Financial. |
| Invoiced | The request is on an invoice. |
| Credited | A credit note was issued against the invoice. |
The Invoice panel can also show:
| Field | Values |
|---|---|
| Invoice number, Internal number, Issue date | As in Financial |
| Invoice status | Draft, In review, Approved, Issued |
| Payment | Unpaid, Partially paid, Paid |
| Credit notes | Each credit note with its number and date |
| Billed per report | For a request invoiced per report: each later report with its own state and invoice number |
When the billing state or the invoice number changes, the request's audit trail gets an entry "Billing updated by Financial". Payment updates alone don't add an entry.
Who can see invoice information
All of this is behind the permission See invoices from Financial on requests.
- The Owner and Member roles have it. When the feature arrived, every existing role that could manage requests got it too.
- Without it, the Invoice panel, the Billing column and filter and the edit-page notice are hidden.
- Remove it from roles whose users shouldn't see invoice information. See Users, roles and permissions.
Messages you may see
| Message | What to do |
|---|---|
| Financial is not connected, so the price list is empty. | Connect your organization to Financial on the platform. |
| The price list could not be loaded from Financial. Try again later. | Financial couldn't be reached. Try again later. |
Tips
- Use price-list fields for extras that the tests themselves don't show, such as sampling, travel or urgency. Financial can price tests from the groups and parameters directly.
- Limit each form's price-list field to the categories that make sense for it, so staff see a short list.
- To find requests that still need invoicing, filter the Requests list by Billing › Not invoiced and status Authorized.