Finland Finvoice 3.0 - GOBL

Key: fi-finvoice-v3 Module: github.com/invopop/gobl.fi.finvoice Support for Finvoice 3.0, the Finnish electronic invoice format that Finance Finland maintains and Finnish operators and banks exchange. Finvoice conforms to the European Norm (EN) 16931, so this addon adds only what the format needs on top of the EN 16931 rules: the e-invoice addresses and operators that route the message, values that fit their Finvoice elements whole, and the payment data for the EpiDetails payment order, which every Finvoice invoice carries. For more information on Finvoice, visit www.finanssiala.fi.

Extensions

Finnish e-invoice operator

Identifier of the e-invoice operator (intermediator) that serves the party’s e-invoice address, quoted alongside that address: an operator’s own OVT code such as 003700010001, or a bank’s BIC such as NDEAFIHH. A Finnish e-invoice address may be registered with several operators, and the operator decides where an invoice is delivered. Set it on the party that receives the message, the customer or the supplier of a self-billed invoice, to have the Finvoice message routed to that operator:

"customer": {
	"name": "Ostaja Oy",
	"endpoints": [
		{ "uri": "iso6523-actorid-upis::0216:003745678907" }
	],
	"ext": {
		"fi-finvoice-operator": "003700010001"
	}
}

fi-finvoice-operator

Pattern: ^[A-Za-z0-9]{2,35}$

Validation Rules

bill.Invoice

Field	Test	Validation Code / Message
Invoice	Invoice number fits	`GOBL-FI-FINVOICE-BILL-INVOICE-23` Invoice number with its series must be at most 20 characters (Finvoice InvoiceNumber)
Invoice	Whole amount	`GOBL-FI-FINVOICE-BILL-INVOICE-30` The due date must cover the whole amount (Finvoice EpiInstructedAmount)
Invoice	One reason per category	`GOBL-FI-FINVOICE-BILL-INVOICE-31` One exemption reason per VAT category (Finvoice VatExemptionReasonCode, VatFreeText)
Invoice	VAT percentages fit	`GOBL-FI-FINVOICE-BILL-INVOICE-37` VAT percentage must have at most 3 decimals (Finvoice RowVatRatePercent, VatRatePercent)
Invoice	Quantities fit	`GOBL-FI-FINVOICE-BILL-INVOICE-32` Quantity must be at most 14 characters (Finvoice InvoicedQuantity)
`supplier`	E-invoice address	`GOBL-FI-FINVOICE-BILL-INVOICE-13` Supplier needs an e-invoice address, an ISO 6523 endpoint or a coded inbox (Finvoice SellerOrganisationUnitNumber)
`supplier`	E-invoice address fits	`GOBL-FI-FINVOICE-BILL-INVOICE-15` E-invoice address code must be 2 to 35 characters and its scheme at most 10 (Finvoice SellerOrganisationUnitNumber, FromIdentifier, ToIdentifier)
`supplier.name`	Rune length at least 2	`GOBL-FI-FINVOICE-BILL-INVOICE-38` Supplier name must be at least 2 characters (Finvoice SellerOrganisationName)
`supplier.identities[*].code`	Legal scope Rune length at most 35	`GOBL-FI-FINVOICE-BILL-INVOICE-14` Legal identity code must be at most 35 characters (Finvoice SellerPartyIdentifier)
`supplier.ext`	Ext ‘fi-finvoice-operator’ matches pattern ’^[A-Za-z0-9]$‘	`GOBL-FI-FINVOICE-BILL-INVOICE-16` Supplier ‘fi-finvoice-operator’ extension must be 2 to 35 letters or digits
`customer`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-01` Customer is required (Finvoice BuyerPartyDetails)
`customer`	E-invoice address	`GOBL-FI-FINVOICE-BILL-INVOICE-17` Customer needs an e-invoice address, an ISO 6523 endpoint or a coded inbox (Finvoice BuyerOrganisationUnitNumber)
`customer`	E-invoice address fits	`GOBL-FI-FINVOICE-BILL-INVOICE-19` E-invoice address code must be 2 to 35 characters and its scheme at most 10 (Finvoice BuyerOrganisationUnitNumber, FromIdentifier, ToIdentifier)
`customer.name`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-02` Customer name is required (Finvoice BuyerOrganisationName)
`customer.name`	Rune length at least 2	`GOBL-FI-FINVOICE-BILL-INVOICE-39` Customer name must be at least 2 characters (Finvoice BuyerOrganisationName)
`customer.identities[*].code`	Legal scope Rune length at most 35	`GOBL-FI-FINVOICE-BILL-INVOICE-18` Legal identity code must be at most 35 characters (Finvoice BuyerPartyIdentifier)
`customer.ext`	Ext ‘fi-finvoice-operator’ matches pattern ’^[A-Za-z0-9]$‘	`GOBL-FI-FINVOICE-BILL-INVOICE-20` Customer ‘fi-finvoice-operator’ extension must be 2 to 35 letters or digits (Finvoice ToIntermediator)
`code`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-21` Invoice code is required (Finvoice InvoiceNumber)
`attachments`	Empty	`GOBL-FI-FINVOICE-BILL-INVOICE-22` Attachments are not supported, Finvoice carries them as separate attachment messages
`currency` Calculated	Currency fits the payment order	`GOBL-FI-FINVOICE-BILL-INVOICE-24` Currency must use at most 2 decimals (Finvoice EpiInstructedAmount)
`preceding`	One preceding document	`GOBL-FI-FINVOICE-BILL-INVOICE-43` At most one preceding document is allowed (Finvoice OriginalInvoiceNumber)
`preceding[*]`	Document number fits	`GOBL-FI-FINVOICE-BILL-INVOICE-25` Preceding document number must be at most 20 characters (Finvoice OriginalInvoiceNumber)
`ordering`	Ordering references fit	`GOBL-FI-FINVOICE-BILL-INVOICE-26` Ordering references must be at most 70 characters (Finvoice BuyerReferenceIdentifier, SellerReferenceIdentifier, OrderIdentifier, AgreementIdentifier, ProjectReferenceIdentifier, TenderReference)
`ordering`	One reference of each kind	`GOBL-FI-FINVOICE-BILL-INVOICE-27` At most one reference of each kind is allowed (Finvoice SellerReferenceIdentifier, OrderIdentifier, AgreementIdentifier, ProjectReferenceIdentifier, TenderReference)
`delivery.receiver`	Name and address	`GOBL-FI-FINVOICE-BILL-INVOICE-42` Delivery receiver needs a name and an address with a town and post code (Finvoice DeliveryPartyDetails)
`delivery.receiver.name`	Rune length at least 2	`GOBL-FI-FINVOICE-BILL-INVOICE-40` Delivery receiver name must be at least 2 characters (Finvoice DeliveryOrganisationName)
`delivery.receiver.identities[*].code`	Legal scope Rune length at most 35	`GOBL-FI-FINVOICE-BILL-INVOICE-28` Legal identity code must be at most 35 characters (Finvoice DeliveryPartyIdentifier)
`delivery.period`	Both dates	`GOBL-FI-FINVOICE-BILL-INVOICE-29` Delivery period must have both dates (Finvoice DeliveryPeriodDetails)
`lines[*].item.ref`	Rune length at most 70	`GOBL-FI-FINVOICE-BILL-INVOICE-33` Item reference must be at most 70 characters (Finvoice ArticleIdentifier)
`payment`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-03` Payment details are required (Finvoice EpiDetails)
`payment.instructions`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-04` Payment instructions are required (Finvoice EpiDetails)
`payment.instructions.key`	Be or starts with one of [credit-transfer]	`GOBL-FI-FINVOICE-BILL-INVOICE-05` Payment instructions key must be credit-transfer
`payment.instructions.ref`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-06` Payment reference is required (Finvoice EpiReference)
`payment.instructions.ref`	Rune length at most 35	`GOBL-FI-FINVOICE-BILL-INVOICE-34` Payment reference must be at most 35 characters (Finvoice EpiReference)
`payment.instructions.credit_transfer`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-07` Credit transfer details are required (Finvoice EpiAccountID)
`payment.instructions.credit_transfer`	First entry has IBAN	`GOBL-FI-FINVOICE-BILL-INVOICE-08` First credit transfer IBAN is required (Finvoice EpiAccountID)
`payment.instructions.credit_transfer`	Later entries have a BIC	`GOBL-FI-FINVOICE-BILL-INVOICE-35` Credit transfers after the first need a BIC (Finvoice SellerBic)
`payment.instructions.credit_transfer[*].iban`	Matches ^[A-Z]\d[A-Z0-9]$, and has matching check digits	`GOBL-FI-FINVOICE-BILL-INVOICE-09` Credit transfer IBAN is not valid
`payment.instructions.credit_transfer[*].bic`	Matches ^[A-Z][A-Z0-9]([A-Z0-9])?$	`GOBL-FI-FINVOICE-BILL-INVOICE-10` Credit transfer BIC is not valid (Finvoice EpiBfiIdentifier)
`payment.instructions.credit_transfer[*].number`	Rune length between 2 and 35	`GOBL-FI-FINVOICE-BILL-INVOICE-41` Credit transfer account number must be 2 to 35 characters (Finvoice SellerAccountID)
`payment.terms`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-11` Payment terms are required (Finvoice EpiDateOptionDate)
`payment.terms.due_dates`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-12` At least one due date is required (Finvoice EpiDateOptionDate)
`payment.terms.due_dates`	Length at most 1	`GOBL-FI-FINVOICE-BILL-INVOICE-36` At most one due date is allowed (Finvoice EpiDateOptionDate)