When a new invoice is generated, Lago also sends an invoice.created webhook (learn more).

When an invoice is linked to an add-on, another type of webhook is sent, called invoice.add_on_added.

Invoice object

Invoices include (but are not limited to):

  • Invoice number;
  • Billing period;
  • Customer information;
  • Fees; and
  • Taxes.

You can download invoices or use the invoice object to create your own invoice template.

You can also use the invoice object to transmit information to your accounting software or payment service provider.

Invoice numbering

With Lago, invoice numbering is generated every time an invoice is finalized. You have the flexibility to customize how invoice numbers are incremented to align with your organizational structure and customer management approach.

  • Invoice numbering per customer: This setting is designed to increment invoice numbers individually for each customer. It ensures that each customer has their own unique sequence of invoice numbers, separate from other customers. This approach is ideal for maintaining distinct and isolated numbering patterns for each customer, aiding in clear tracking and accounting processes.
  • Invoice numbering across the organization: Opting for this method applies a global sequence for incrementing invoice numbers across your entire organization. Instead of having individual sequences for each customer, all invoices within the organization follow a single, unified numbering system. This creates a continuous and organization-wide sequence for all invoice numbers, simplifying the invoice management process. In that case, invoices are incremented per month (dynamic value used is YYYYMM).

Invoice prefix customization

Lago also allows you to customize the prefix for documents, including invoices and credit notes. By default, Lago auto-generates this prefix by combining the first three letters of your organization’s name with the last four digits of your organization ID. However, you have the flexibility to fully customize this field to better align with your organization’s branding or numbering conventions. This feature ensures clarity and consistency across your documents while allowing you to maintain a professional and personalized appearance in your invoicing system.

Custom invoice grouping

Grouping invoice line items in a way that provides clearer insight for your customers can be more beneficial than sticking to the default charge setup in Lago.

For instance, as an AI service provider, you might prefer to regroup all fees associated to one charge by a specific model used by a customer, without the need to individually list each model in Lago.

When setting up a charge with a standard charge model, you can use model_name as an event property in the grouped_by attribute. If every event reported to Lago includes a model_name, Lago is capable of adjusting your invoice so that charges are organized under the respective model name for that particular charge. Consequently, Lago will also automatically allocate the usage costs for each model.

You can specify multiple grouped_by keys for your charge; the order you set them in dictates how they will be displayed on the invoice, affecting the presentation of charges.

The grouped_by feature is exclusively available for the standard charge model.