Basics | Plugins | Howtos | Applications
The invoicing plugin¶
The invoicing plugin adds functionality for automatically generating
invoices and other business documents.
Overview¶
In applications with this plugin you usually have a command in your main menu.
You also have a button 
in the toolbar of a partner.
Both commands open your invoicing plan, i.e. your plan to let Lino generate a series of invoices. See Your invoicing plan below.
Before users can generate invoices, the site manager you must configure a list of invoicing tasks available on this site. This is described in How to configure invoicing tasks.
Concepts¶
- invoiceable¶
A database object that can cause Lino to generate an invoice or any other type of trading document.
For example a working session in Lino Noi or an activity enrolment in Lino Voga are invoiceable.
- invoicing order¶
A database object that can act as a starting point for running an invoicing plan.
- invoicing suggestion¶
One item of an invoicing plan, which represents a single invoice that Lino suggests to generate.
See
Itemfor a description of the individual fields.- invoicing task¶
A database row that describes a group of business activities for which end users can start an invoicing plan.
Each invoicing task is also a background task that can be scheduled to run automatically.
- invoicing event¶
A database object that is part of a series and potentially causes a new contingent should be invoiced.
can yield a series of invoiceables for a given date.
invoicing events can be instances of any model, but the generator’s
get_invoiceable_event_formatter()must understand them.- event pass¶
A product that, when sold, gives its owner the right to use (participate in) a given number of invoicing events.
- event pass type¶
The type of an event pass. It specifies the number of events, and other information like when to write a next invoice.
- invoice recipient¶
The partner who gets the invoice.
- invoiceable partner¶
The partner who asks for the service or good and who will consume or own it.
This is usually synonym of “client” or “customer”.
Your invoicing plan¶
There is at most one invoicing plan per user in the database.
- invoicing plan¶
A temporary database row that represents the plan of a given user to let Lino generate a series of invoices (or other types of trading vouchers).
The invoicing plan has a 
button in the toolbar. Click on
this to fill your plan. Lino then gives a series of suggestions, one line for every invoice that Lino suggests to
generate.
Click on the 
button of a suggestion to actually generate that invoice.
Or click on the button in the toolbar to generate all suggested
invoices.
A mandatory field of an invoicing plan is the invoicing task to use. The list of available invoicing tasks must have been configured by your site manager.
See Plan for a description of the other fields.
Every invoicing plan has a list of invoicing suggestions. To update the plan means to let Lino fill that list. To execute the plan means to generate an invoice for each suggestion.
How to configure invoicing tasks¶
You must be site manager.
Open the menu command .
Invoice recipients¶
In applications with this plugin you can open the detail window of any partner to specify an invoice recipient.
For example 10 children from an orphanage attend to different activities. The orphanage pays for it. The price of each activity depends on the age of the child. We want to send the orphanage one invoice (not 10 invoices) every month. On that invoice they want to see the costs separated per child. Every child is an invoiceable partner, the orphanage is invoice recipient.