Special discounts and incentives

Overview

Special deductions and incentives refer to exclusive cost savings on particular products and services. Unlike regular discounts, these deductions do not reduce the taxable base on sales invoices, i.e., they are applied after VAT calculations and do not decrease the taxable base.

Some examples of special deductions include incentives, rebates, etc. By updating your Monite partner settings, you can provide a custom name for these special deductions on your invoice PDFs.

You can provide a value for these deductions when creating and updating invoices or quotes.

Add a deduction

When creating or updating a receivable—invoice or quote, use the deduction_amount field on the document level to specify the deduction. You can also provide additional descriptions for special deductions by using the deduction_memo field as shown:

1
curl -X POST 'https://api.sandbox.monite.com/v1/receivables' \
2
     -H 'X-Monite-Version: 2024-01-31' \
3
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
     -H 'Authorization: Bearer ACCESS_TOKEN' \
5
     -H 'Content-Type: application/json' \
6
     -d '{
7
       "type": "invoice",
8
       "currency": "EUR",
9
       ...
10
       "deduction_amount": 900,
11
       "deduction_memo": "Discount on small-scale renewable energy systems purchase."
12
     }'

After creating a deduction, you can access its value via the deduction_amount field in the invoice or quote object. By default, this value appears under the Incentives heading in the PDF document. However, you can customize the title of these deductions by updating your partner settings with your desired title.

Update the deduction title

You can provide a custom deduction title using the deduction_title partner setting. To update the deduction title:

1
curl -X POST 'https://api.sandbox.monite.com/v1/settings' \
2
     -H 'X-Monite-Version: 2024-01-31' \
3
     -H 'X-Monite-Entity-Id: ENTITY_ID' \
4
     -H 'Authorization: Bearer ACCESS_TOKEN' \
5
     -H 'Content-Type: application/json' \
6
     -d '{
7
       "receivable": {
8
         "deduction_title": "STC incentive"
9
       }
10
     }'

A successful request changes the headings for special deductions on invoice and quote PDFs.