v1

latestOpenAPI 3.1.02026-07-22733584.5 KB
Invoicing

Create or update an invoice customer

Upserts a party in the invoicing counterparty register. Include id to update an existing party. Requires a write-scoped key.

post/invoice-customers

Request body

idstring

Party id. Include on upsert to update an existing party.

namestring required
business_idstring

Finnish business ID (Y-tunnus), e.g. 1234567-8.

vat_numberstring

EU VAT number, e.g. FI12345678.

address_line1string
postal_codestring
citystring
country_codestring

ISO 3166-1 alpha-2, e.g. FI.

emailstring
einvoice_addressstring

E-invoice (verkkolasku) address, e.g. an OVT identifier.

einvoice_operatorstring

E-invoice operator/intermediator code.

default_payment_terms_daysinteger
default_vat_codestring
default_vat_rate_basis_pointsinteger

Default VAT rate in basis points (25.5% = 2550).

default_invoice_languagestring

Response

Upserted party.

idstring

Party id. Include on upsert to update an existing party.

namestring required
business_idstring

Finnish business ID (Y-tunnus), e.g. 1234567-8.

vat_numberstring

EU VAT number, e.g. FI12345678.

address_line1string
postal_codestring
citystring
country_codestring

ISO 3166-1 alpha-2, e.g. FI.

emailstring
einvoice_addressstring

E-invoice (verkkolasku) address, e.g. an OVT identifier.

einvoice_operatorstring

E-invoice operator/intermediator code.

default_payment_terms_daysinteger
default_vat_codestring
default_vat_rate_basis_pointsinteger

Default VAT rate in basis points (25.5% = 2550).

default_invoice_languagestring