Cash discount

Cash discount speeds up payments. You offer a discount if the debtor pays before a given date.

How it works

Add cashdiscountrow under the invoice dataset. It is an array, even if you only send one discount.

Fields

• discountdate (YYYY-MM-DD)

• discountpercent (0–100)

• discountamount (EUR)

• discountfreetext (optional)

Example

{
  "datastream": {
    "dataset": [
      {
        "jobtype": "0",
        "customertype": "1",
        "company": "Example Company",
        "address": "Example street 1",
        "postcode": "00100",
        "city": "Helsinki",
        "billdate": "2026-02-06",
        "paydate": "2026-02-20",
        "payrow": [
          { "desc": "Subscription", "count": "1", "amount": "1415.00", "taxpr": "24" }
        ],
        "cashdiscountrow": [
          {
            "discountdate": "2026-02-16",
            "discountpercent": "2",
            "discountamount": "28.30",
            "discountfreetext": "10 days -2%"
          }
        ]
      }
    ]
  }
}

If you omit discountfreetext, the service can generate the text automatically.

The service validates discountpercent and discountamount against the invoice totals. Keep rounding consistent in your own calculations.