Basics | Plugins | Howtos | Applications

The invoicing plugin

The invoicing plugin adds functionality for automatically generating invoices and other trade documents.

Overview

In applications with this plugin you usually have a command Sales ‣ Generate invoices 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.

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.

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 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.

There is at most one invoicing plan per user in the database.

A mandatory field of an invoicing plan is the invoicing task to use. 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.

invoicing suggestion

One item of an invoicing plan, which represents a single invoice that Lino suggests to generate.

See Item for 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”.

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.