---
title: "Update invoice settings"
method: POST
path: "/setting/invoice"
tags: ["Setting"]
---

# Update invoice settings

`POST /setting/invoice`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/setting/invoice`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/billingserv/apis/billingserv-api-v2/docs/setting/invoice/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this BillingServ API endpoint to update invoice settings. Review the response for the operation result or validation errors.

## Request body

- object
  - `prefix` string
  - `orderReturnURL` string, uri
  - `startNumber` integer
  - `paymentsDue` integer
  - `lateFees` number
  - `lateFeesTax` integer
  - `reminders` integer
  - `reminders4suspend` integer
  - `days2send` integer
  - `total-order` string[]
  - `defaultCurrency` integer
  - `currency` string[]
  - `exchangerate` number
  - `vat` VatSettingsRequest
    - `name` string
    - `number` string
  - `companyRegistration` string
  - `fixedDiscount` boolean
  - `discountCode` boolean

## Response `200`

OK

- ApiResponse
  - `success` boolean

## Other responses

- `401`: Missing or invalid API key
- `403`: Authenticated key does not have permission for this endpoint
- `422`: Validation error

## Changes

- **2026-08-22** `6b9208b64456`: 1 breaking, 2 warning, 8 info
  - the `vat` request property type changed from `integer` to `object`
  - removed the request property `vat.name`
  - removed the request property `vat.number`
  - added the new optional request property `vat/name`
  - …7 more

[Operation history](https://skmtc.dev/billingserv/apis/billingserv-api-v2/changes/setting/invoice/post.md)

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)