Invoice Service Data types

The data types are commonly used with Invoice Service endpoints.

Common data types

Date Format

ISO 8601 date format, YYYY-MM-DD
Example: "2021-10-23"

Number format

Floating point w. 2 decimals
Example: 100.25

Currency Code

ISO 4217 standard. Default "EUR"
Options:

EUR

SEK

NOK

Country Code

ISO 3166-1 alpha-2 standard. Default "FI"
Options:

FI (Finland)

SE (Sverige)

NO (Norge)

Language Code

ISO 639-1 standard, 2 letter-code, Uppercase - Default "FI"
Accepted options:

“FI” = Finnish

“SV” = Swedish

“NO” = Norwegian

“EN “= English

Invoice Status

Predefined values

O = Order / Draft

H = Accepted for delivery – Generated with Invoice Number

M = Manual acceptance for delivery by the client from Online service

Payment Terms Code

Predefined values

7 = 7 days net days for payment

14 = 14 days net days for payment

21 = 21 days net days for payment

30 = 30 days net days for payment

45 = 45 days net days for payment

60 = 60 days net days for payment

90 = 90 days net days for payment

0 = If payment term code is zero (0), the invoice payment net days are calculated based on the payment due date (due date - invoice date)

Payment Type (Financial Services)

Predefined payment types are available for the Financial Services invoices - these are:

“FL” - Factoring Loans type of invoice

Sales Type (Entity)

Predefined values

H = Consumer Customer

Y = Business / Corporate Customer

Invoice Type (mandatory)

Predefined values

I = Sales Invoice (basic rule that the invoice total amount is positive value - i.e 100.00)

C = Credit Invoice (basic rule that the invoice total amount is negative value - i.e -100.00)

D = Direct Payment Invoice (contract with end-customer and the bank for electronic invoicing)

R = Reminder Invoice

F = Financial Service Invoice (Factoring)

Invoice Type is also used within electronic invoice to indicate the type of invoice and can be used as validation factor by the net bank

Finvoice Versions

Predefined values. Use this option to define which version (schema) to use when generating the invoice into Finvoice format.

2.01 - default Finvoice schema used when no value has been given

3.0 - Finvoice schema to be generated when selecting this option

Finvoice Specifications

Predefined values. Use this option to define the preferred specification reference when generating the invoice into Finvoice 3.0 format.

B2C - Business to Consumer (adds no specification to Finvoice, and generates an basic invoice content)

B2B - Business to Business ( adds Specification of EN16931-compliant Finvoice)

B2G - Business to Government ( adds Specification to ensure EN16931-compliant Finvoice )

Interest Calculation Type

Predefined values

V = Late Payment Interest Rate (Default)

S = Contract Interest (Used in special contracts with higher interest rates than the standard rates)

Delivery Type

Predefined values

E = Email Invoice

P = Paper Invoice (or in Finland OmaPosti - this will evaluated by the distribution system PostNord Strålfors)

F = Finvoice (also known as EDI invoice)

Automatic Advancement

Predefined values

0 = False, automation is disabled (also invoice number is reset)

1 = True, automation is active (use this as a default value when sending invoices to delivery - original invoice number remains)

Finnish Electronic Invoice Address type (ICD)

List of commonly used Electronic Invoice Address types

ICD	Address type	Description
0037	OVT-tunnus	Verkkolaskuosoite (0037 + Y-tunnus + tarkenne)
0216	Y-tunnus	Business ID (ilman FI-etuliitettä)
0208	GLN	Global Location Number (Large corporations and public sector
9908	IBAN	Tilinumero
9918	Sopimusnumero	Paikallinen sopimusnumero
0021	ALV-numero	FI + Y-tunnus muodossa (VAT ID)

Invoice Service Data types

Common data types#

Date Format#

Number format#

Currency Code#

Country Code#

Language Code#

Invoice Status#

Payment Terms Code#

Payment Type (Financial Services)#

Sales Type (Entity)#

Invoice Type (mandatory)#

Finvoice Versions#

Finvoice Specifications#

Interest Calculation Type#

Delivery Type#

Automatic Advancement#

Finnish Electronic Invoice Address type (ICD)#

Common data types

Date Format

Number format

Currency Code

Country Code

Language Code

Invoice Status

Payment Terms Code

Payment Type (Financial Services)

Sales Type (Entity)

Invoice Type (mandatory)

Finvoice Versions

Finvoice Specifications

Interest Calculation Type

Delivery Type

Automatic Advancement

Finnish Electronic Invoice Address type (ICD)