Finland Finvoice 3.0 - GOBL

Key: fi-finvoice-v3 Module: github.com/invopop/gobl.fi.finvoice Support for the Finnish Finvoice 3.0 format for electronic invoicing. Finvoice conforms to the European Norm (EN) 16931, so this addon only adds the Finvoice-specific requirements on top of the EN 16931 rules: a named customer, and the payment data needed to build the Finvoice EpiDetails payment block (credit transfer instructions with an IBAN, a payment reference, and a due date), which is mandatory on every invoice. For more information on Finvoice, visit www.finanssiala.fi.

Validation Rules

bill.Invoice

Field	Test	Validation Code / Message
`customer`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-01` Customer is required (Finvoice BuyerPartyDetails)
`customer.name`	Present	`GOBL-FI-FINVOICE-BILL-INVOICE-02` Customer name is required (Finvoice BuyerOrganisationName)
`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.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[*].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.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)

⌘I