Create a billing entity
Billing entities let you manage your end customers under distinct billing configurations. To create a billing entity, follow these steps:- Dashboard
- API
- Click Settings in the side navigation bar.
- In the Your billing entities section, click Add an entity.
- Enter a name and a unique code for your billing entity.
- Configure the entity settings as needed.
- Click Create entity to confirm.
The first billing entity created in your organization is considered the default.Billing entity settings apply to the customers assigned to that entity and to the invoices that entity issues. More information is available in the following sections.
Edit a billing entity
You can update all billing entity information except the code after creation. To edit a billing entity:- Dashboard
- API
- Click Settings in the side navigation bar.
- In the Your billing entities section, select the relevant billing entity.
- Click any section to edit its settings.
Billing entity settings
A billing entity carries the settings that Lago applies to the invoices it issues:- Entity details: legal name and number, tax identification number, address, logo and invoice footer
- Default currency and timezone
- Invoice numbering
- Grace period
- Net payment term
- Dunning campaign
- Issuing date preferences
- Document language
- Zero-amount invoices
- Taxes
- Invoice custom sections
- Emails
- E-invoicing
Archive a billing entity
Archiving a billing entity is not available in the Dashboard or through the API. In the Dashboard, the Archive billing entity action of a billing entity asks you to contact Lago.To archive a billing entity, contact the Lago team directly.
Assign a billing entity to a customer
When creating a customer, you can assign it to a billing entity in two ways:- Through the Dashboard by selecting the billing entity.
- Via API by passing the
billing_entity_codein the customer creation payload.
billing_entity_code, Lago assigns the customer to the default billing entity.
The billing entity assigned to a customer acts as their default billing entity.