Discounts

Overview

A discount is a reduction in the price of a product or service that is offered by the seller. Discounts can be applied either to the final purchase, or to individual line items in an invoice or quote. Line item discounts are applied before overall discounts, and both are applied before VAT is added in.

Monite also allows applying discounts up to the total product amount or invoice amount. This means that invoices and invoice line items can have 100% discounts or an effective price of 0.

Discount types

Discounts can be specified as a percentage (such as 10.5%) or as a flat amount (such as € 12.5). Monite allows setting discount

For example, a percentage discount of 10.5% is specified as follows:

1
"discount": {
2
  "type": "percentage",
3
  "amount": 1050  // 10.5%
4
},

A flat amount discount of € 12.5 is specified as follows, where the amount is represented in minor units:

1
"discount": {
2
  "type": "amount",
3
  "amount": 1250  // € 12.5
4
},

If the discount object is set to null, it means no discount.

Add a discount

When creating a new invoice or quote or when editing an existing draft one, use the discount field on the document level or line item level to specify the discount:

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
       "discount": {
11
         "type": "amount",
12
         "amount": 1250
13
       }
14
     }'

Update a discount

While the invoice or quote is still in the draft status, you can update or remove the discounts if needed. To do this, call PATCH /receivables/{receivable_id} and provide the new discount object:

1
curl -X PATCH 'https://api.sandbox.monite.com/v1/receivables/411dc6eb...6289b3' \
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
      "invoice": {
8
        "discount": {
9
          "type": "amount",
10
          "amount": 1500
11
        }
12
      }
13
    }'

Invoices and quotes in the issued status can no longer be edited, but there are other ways to amend their discount.

For invoices:

• To increase the discount, you can create a credit note for the difference amount.
• To reduce or remove the discount, you can issue a new invoice for the difference amount.

For quotes:

• To update or remove the discount, you can decline the existing quote and create a new one.

Remove a discount

To remove a discount from a draft invoice, draft quote, or an individual line item, call PATCH /receivables/{receivable_id} and set the corresponding document-level discount or line item discount to null. For example:

1
curl -X PATCH 'https://api.sandbox.monite.com/v1/receivables/411dc6eb...6289b3' \
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
      "invoice": {
8
        "discount": null
9
      }
10
    }'

Alternatively, you can set discount.amount to 0.

See also

• Deductions - discounts that are applied after VAT