PUBLIC API v1

Change company invoice defaults

PATCH /api/v1/companies/{company_pk}/invoices/settings/

Only supplied fields change. Existing invoices keep their saved appearance. A partial design keeps the saved controls; a new template starts from that template's defaults.

Permission: write_invoices · Direct link

Company-scoped. Account permissions, plan limits and document state still apply.

Path and query parameters

Parameter	Location / type	Description
`company_pk`Required	path · `string (uuid)`	Not specified

Request body

application/json

Field Type / accepted values Description

setupCompleted boolean Not specified

currency string Not specified

language "de" | "en" | "pl" | "it" | "es" * `de` - de * `en` - en * `pl` - pl * `it` - it * `es` - es

createQr boolean Not specified

invoiceType "GOODS" | "SERVICES" * `GOODS` - GOODS * `SERVICES` - SERVICES

colorSchema string Not specified

font string Not specified

documentDesign

object

Not specified

Nested fields

Field	Type / accepted values	Description
`template`Required	`"heritage" \| "regent" \| "meridian" \| "horizon" \| "atelier" \| "epoque" \| "sovereign"`	* `heritage` - heritage * `regent` - regent * `meridian` - meridian * `horizon` - horizon * `atelier` - atelier * `epoque` - epoque * `sovereign` - sovereign
`version`	`1`	* `1` - 1
`logoSize`	`integer`	Not specified
`textSize`	`"small" \| "medium" \| "large"`	* `small` - small * `medium` - medium * `large` - large
`spacing`	`"compact" \| "standard" \| "spacious"`	* `compact` - compact * `standard` - standard * `spacious` - spacious
`tableBorders`	`"none" \| "dividers" \| "grid"`	* `none` - none * `dividers` - dividers * `grid` - grid

showCustomerNumber boolean Not specified

showContactPerson boolean Not specified

onlinePaymentsDefault boolean Not specified

taxOfficeName string Not specified

taxOfficeCity string Not specified

multipart/form-data

Field Type / accepted values Description

setupCompleted boolean Not specified

currency string Not specified

language "de" | "en" | "pl" | "it" | "es" * `de` - de * `en` - en * `pl` - pl * `it` - it * `es` - es

createQr boolean Not specified

invoiceType "GOODS" | "SERVICES" * `GOODS` - GOODS * `SERVICES` - SERVICES

colorSchema string Not specified

font string Not specified

documentDesign

object

Not specified

Nested fields

Field	Type / accepted values	Description
`template`Required	`"heritage" \| "regent" \| "meridian" \| "horizon" \| "atelier" \| "epoque" \| "sovereign"`	* `heritage` - heritage * `regent` - regent * `meridian` - meridian * `horizon` - horizon * `atelier` - atelier * `epoque` - epoque * `sovereign` - sovereign
`version`	`1`	* `1` - 1
`logoSize`	`integer`	Not specified
`textSize`	`"small" \| "medium" \| "large"`	* `small` - small * `medium` - medium * `large` - large
`spacing`	`"compact" \| "standard" \| "spacious"`	* `compact` - compact * `standard` - standard * `spacious` - spacious
`tableBorders`	`"none" \| "dividers" \| "grid"`	* `none` - none * `dividers` - dividers * `grid` - grid

showCustomerNumber boolean Not specified

showContactPerson boolean Not specified

onlinePaymentsDefault boolean Not specified

taxOfficeName string Not specified

taxOfficeCity string Not specified

application/x-www-form-urlencoded

Field Type / accepted values Description

setupCompleted boolean Not specified

currency string Not specified

language "de" | "en" | "pl" | "it" | "es" * `de` - de * `en` - en * `pl` - pl * `it` - it * `es` - es

createQr boolean Not specified

invoiceType "GOODS" | "SERVICES" * `GOODS` - GOODS * `SERVICES` - SERVICES

colorSchema string Not specified

font string Not specified

documentDesign

object

Not specified

Nested fields

Field	Type / accepted values	Description
`template`Required	`"heritage" \| "regent" \| "meridian" \| "horizon" \| "atelier" \| "epoque" \| "sovereign"`	* `heritage` - heritage * `regent` - regent * `meridian` - meridian * `horizon` - horizon * `atelier` - atelier * `epoque` - epoque * `sovereign` - sovereign
`version`	`1`	* `1` - 1
`logoSize`	`integer`	Not specified
`textSize`	`"small" \| "medium" \| "large"`	* `small` - small * `medium` - medium * `large` - large
`spacing`	`"compact" \| "standard" \| "spacious"`	* `compact` - compact * `standard` - standard * `spacious` - spacious
`tableBorders`	`"none" \| "dividers" \| "grid"`	* `none` - none * `dividers` - dividers * `grid` - grid

showCustomerNumber boolean Not specified

showContactPerson boolean Not specified

onlinePaymentsDefault boolean Not specified

taxOfficeName string Not specified

taxOfficeCity string Not specified

Responses

200 Response fields

application/json

Field Type / accepted values Description

invoiceSettingsRequiredRead only

object

Not specified

Nested fields

Field Type / accepted values Description

setupCompleted boolean Not specified

currencyRequired string Not specified

language "de" | "en" | "pl" | "it" | "es" * `de` - de * `en` - en * `pl` - pl * `it` - it * `es` - es

createQr boolean Not specified

invoiceType "GOODS" | "SERVICES" * `GOODS` - GOODS * `SERVICES` - SERVICES

colorSchema string Not specified

font string Not specified

documentDesign

object

Not specified

Nested fields

Field	Type / accepted values	Description
`template`Required	`"heritage" \| "regent" \| "meridian" \| "horizon" \| "atelier" \| "epoque" \| "sovereign"`	* `heritage` - heritage * `regent` - regent * `meridian` - meridian * `horizon` - horizon * `atelier` - atelier * `epoque` - epoque * `sovereign` - sovereign
`version`	`1`	* `1` - 1
`logoSize`	`integer`	Not specified
`textSize`	`"small" \| "medium" \| "large"`	* `small` - small * `medium` - medium * `large` - large
`spacing`	`"compact" \| "standard" \| "spacious"`	* `compact` - compact * `standard` - standard * `spacious` - spacious
`tableBorders`	`"none" \| "dividers" \| "grid"`	* `none` - none * `dividers` - dividers * `grid` - grid

showCustomerNumber boolean Not specified

showContactPerson boolean Not specified

onlinePaymentsDefault boolean Not specified

taxOfficeName string Not specified

taxOfficeCity string Not specified

logoRequiredRead only string | null Not specified

401 The API key is invalid, expired or revoked.

403 Missing scope, company mismatch, unsupported operation, or a plan/account restriction.

429 Rate limit exceeded. Wait for the Retry-After header before retrying.

Use the base URL https://api.norman.finance/api/v1. Sign up or log in to Norman to create an API key, then send it as a Bearer token. For an OpenAPI JSON file, contact support.