From e69d5901e397f9aa98908a3551d126504bfc8a70 Mon Sep 17 00:00:00 2001 From: Michael Ponrajah Date: Wed, 28 Jun 2023 19:10:20 +0200 Subject: [PATCH 1/2] doc(tax): Add guide for tax object --- docs/guide/10_invoicing/taxes.md | 62 ++++++++++++++++++------------- static/img/tax-hierarchy.png | Bin 0 -> 67252 bytes 2 files changed, 37 insertions(+), 25 deletions(-) create mode 100644 static/img/tax-hierarchy.png diff --git a/docs/guide/10_invoicing/taxes.md b/docs/guide/10_invoicing/taxes.md index 3de678e6c..6f491cf8b 100644 --- a/docs/guide/10_invoicing/taxes.md +++ b/docs/guide/10_invoicing/taxes.md @@ -3,37 +3,49 @@ sidebar_position: 3 --- # Taxes -When generating invoices, you may need to apply taxes. The tax rate applies to all fees (i.e. subscription fees and charges) and appears on the invoices. +A tax object represents various types of taxes that an organization may incur. These taxes can be applied at both the organization level and the customer level. + +## Create taxes +To add a new tax through the user interface: +1. Access to the taxes settings page through the Settings page > Taxes tab +2. In the upper right corner of the list, click **“Add”** to create a new tax; +3. Enter its `name`; +4. Assign it a unique `code` (i.e. unique ID as defined in your backend system) +5. Add a `description` *(optional)*; +6. Define the `rate` that applies to invoices. + +## Editing and deleting taxes +A tax can be deleted or edited even if it is linked to an organization or a customer. However, it's important to note that any changes made to a tax, including its removal, will have an impact on all existing draft invoices or upcoming invoices that are associated with that tax. -## General tax rate -There is a default tax rate at the organization level that applies to all customers and is 0%. +1. **Edit**: allows you to modify the name, code and the rate of the tax; +2. **Delete**: allows you to delete the tax and remove it from the list (this action cannot be undone). -To modify the default tax rate for the organization: -1. Click **"Settings"** in the side menu; -2. Open the **"Invoice & tax"** tab; -3. Select **"Edit tax rate"** on the right; -4. Enter the desired tax rate; and -5. Click **"Edit tax rate"** to confirm. -![Default tax rate at the organization level](../../../static/img/organization-tax-rate.png) +## Apply taxes on objects +When generating invoices, you may need to apply taxes. The tax rate applies to all fees (i.e. subscription fees and charges) and appears on the invoices. + -## Customer-specific tax rate -If you need to define a specific tax rate for a customer, you can override the organization's tax rate by defining a tax rate at customer level. +### Taxes on the organization +To apply tax objects on the organization through the user interface: +1. Access to the invoice settings page through the Settings page > **Invoice** tab +2. In the Taxes on organization section, click **“Add”** to add a new tax +3. Select the tax object you want to apply in the dialog +4. Repeat the action if you want to add more than 1 tax -To define a customer-specific tax rate through the user interface: -1. Click **"Customers"** in the side menu; -2. Select a customer from the list; -3. Open the **"Tax rate"** tab; -4. Click **"Add a tax rate"** on the right; -5. Enter the desired tax rate; and -6. Click **"Add tax rate"** to confirm. -If later you want to edit or delete the customer's tax rate, click the **ellipsis icon** to see all available actions. +### Taxes on a specific customer +To apply tax objects on a specific customer through the user interface: +1. Access to customer taxes settings page through the **Customer** details page > **Settings** tab +2. In the Tax rates section, click **“Add a tax”** to add a new tax +3. Select the tax object you want to apply in the dialog +4. Repeat the action if you want to add more than 1 tax -You can also use the following endpoint to add or edit the customer's tax rate via API: +### Hierarchy between objects on invoice generation +When taxes are applied at the organization level, it is crucial to note that any customers without specific tax settings will inherit the defined taxes. This means that the tax settings defined for the organization will be automatically applied to those customers who do not have their own individual tax configurations. -```curl title="POST" -/api/v1/customers -``` +**Taxes hierarchy when generating an invoice:** +1. Apply taxes defined at the customer level on invoice; if customer’s taxes are empty +2. Apply taxes defined at the organization level on invoice; if organization’s taxes are empty +3. Apply a tax at 0% and display “Tax (0%) on invoice. -To do so, you must include the `vat_rate` argument in the body of the request. \ No newline at end of file +![Tax hierarchy](../../../static/img/tax-hierarchy.png) \ No newline at end of file diff --git a/static/img/tax-hierarchy.png b/static/img/tax-hierarchy.png new file mode 100644 index 0000000000000000000000000000000000000000..f1a3828dcb25f86485ffceef5712c0e6a872e507 GIT binary patch literal 67252 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Ͷ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 Date: Wed, 28 Jun 2023 22:20:02 +0200 Subject: [PATCH 2/2] Minor changes --- docs/guide/10_invoicing/taxes.md | 70 ++++++++++++++++---------------- 1 file changed, 34 insertions(+), 36 deletions(-) diff --git a/docs/guide/10_invoicing/taxes.md b/docs/guide/10_invoicing/taxes.md index 6f491cf8b..d56da7106 100644 --- a/docs/guide/10_invoicing/taxes.md +++ b/docs/guide/10_invoicing/taxes.md @@ -3,49 +3,47 @@ sidebar_position: 3 --- # Taxes -A tax object represents various types of taxes that an organization may incur. These taxes can be applied at both the organization level and the customer level. +An organization may need to collect various taxes, represented by different tax objects. These taxes can be applied at both the organization level and the customer level. ## Create taxes To add a new tax through the user interface: -1. Access to the taxes settings page through the Settings page > Taxes tab -2. In the upper right corner of the list, click **“Add”** to create a new tax; +1. Access the tax settings page through the **Settings** section > **Taxes** tab; +2. In the upper right corner of the list, click **"Add"** to create a new tax; 3. Enter its `name`; -4. Assign it a unique `code` (i.e. unique ID as defined in your backend system) -5. Add a `description` *(optional)*; -6. Define the `rate` that applies to invoices. +4. Assign it a unique `code` (i.e. unique ID as defined in your backend system); +5. Add a `description` *(optional)*; and +6. Define the `rate` that applies. ## Editing and deleting taxes -A tax can be deleted or edited even if it is linked to an organization or a customer. However, it's important to note that any changes made to a tax, including its removal, will have an impact on all existing draft invoices or upcoming invoices that are associated with that tax. +A tax can be deleted or edited even if it is linked to an organization or a customer. However, it's important to note that any change made to a tax object, including its removal, has an impact on all existing draft invoices or upcoming invoices associated with this tax. -1. **Edit**: allows you to modify the name, code and the rate of the tax; -2. **Delete**: allows you to delete the tax and remove it from the list (this action cannot be undone). +Available actions include: +- **Edit**: allows you to modify the name, code and rate of the tax object; and +- **Delete**: allows you to delete the tax object and remove it from the list (this action cannot be undone). - -## Apply taxes on objects +## Apply taxes to objects When generating invoices, you may need to apply taxes. The tax rate applies to all fees (i.e. subscription fees and charges) and appears on the invoices. - -### Taxes on the organization -To apply tax objects on the organization through the user interface: -1. Access to the invoice settings page through the Settings page > **Invoice** tab -2. In the Taxes on organization section, click **“Add”** to add a new tax -3. Select the tax object you want to apply in the dialog -4. Repeat the action if you want to add more than 1 tax - - -### Taxes on a specific customer -To apply tax objects on a specific customer through the user interface: -1. Access to customer taxes settings page through the **Customer** details page > **Settings** tab -2. In the Tax rates section, click **“Add a tax”** to add a new tax -3. Select the tax object you want to apply in the dialog -4. Repeat the action if you want to add more than 1 tax - -### Hierarchy between objects on invoice generation -When taxes are applied at the organization level, it is crucial to note that any customers without specific tax settings will inherit the defined taxes. This means that the tax settings defined for the organization will be automatically applied to those customers who do not have their own individual tax configurations. - -**Taxes hierarchy when generating an invoice:** -1. Apply taxes defined at the customer level on invoice; if customer’s taxes are empty -2. Apply taxes defined at the organization level on invoice; if organization’s taxes are empty -3. Apply a tax at 0% and display “Tax (0%) on invoice. - -![Tax hierarchy](../../../static/img/tax-hierarchy.png) \ No newline at end of file +### Taxes at the organization level +To apply tax objects to the organization through the user interface: +1. Access the invoice settings page through the **Settings** section > **Invoice** tab; +2. In the **Taxes on organization** section, click **"Add"** to add a new tax; +3. Select the tax object you want to apply; and +4. Repeat the action if you want to add another tax. + +### Taxes at the customer level +To apply tax objects to a specific customer through the user interface: +1. Access the customer settings page through the **Customer** details page > **Settings** tab; +2. In the **Tax rates** section, click **"Add a tax"** to add a new tax; +3. Select the tax object you want to apply; and +4. Repeat the action if you want to add another tax. + +### Tax hierarchy +When taxes are defined at the organization level, customers who do not have specific tax settings inherit the default taxes, which means that the organization's tax settings are automatically applied to these customers. + +When an invoice is generated, the tax hierarchy is as follows: +1. Lago applies the tax objects defined at the customer level; +2. If there are no taxes at the customer level, Lago applies the tax objects defined at the organization level; and +3. If there are no taxes at the organization level, Lago applies a 0% tax rate (visible on the invoice). + +![Tax hierarchy](../../../static/img/tax-hierarchy.png)