Sending e-invoices to the UWV via eConnect: two cash flows, invoice requirements, error codes and Order flip.
The UWV is one of the largest e-invoice recipients in the Netherlands and sets specific requirements for the content and structure of invoices. With eConnect, you can send invoices to the UWV via Peppol, but it is important to know the correct cash flow, the right OINO number and the mandatory fields. This article explains everything step by step.
The UWV distinguishes two cash flows, each with its own OINO number (Organisation Identification Number Government) and specific invoice requirements:
0000000419177124900000000004172892677000Important: the OINO is always 20 digits long, including leading zeros. If you leave out any zeros, the invoice will not be delivered.
Use the OINO of the correct cash flow when creating the invoice. If you are not sure which cash flow your invoice belongs to, check with your contact person at the UWV.
The Large Cash Flow has the most extensive requirements. Your invoice must meet the following conditions:
Mandatory fields at document level:
Mandatory fields per invoice line:
Tip: you can find the product codes in the purchase order you received from the UWV. Copy them exactly, as deviating codes lead to rejection.
The Small Cash Flow has slightly different requirements:
Mandatory fields at document level:
Mandatory fields per invoice line:
Check the total amount: the total amount of your invoice must not exceed the amount on the corresponding purchase order. A higher amount leads to automatic rejection.
The UWV uses different postal addresses per cash flow. Although this is not relevant for Peppol delivery (the invoice is delivered electronically), it is good practice to include the correct address on the invoice:
When you receive a purchase order from the UWV via Peppol, you can convert it to an invoice in the eConnect platform with just a few clicks. This is called the Order flip. The platform automatically carries over the order data (order number, lines, product codes, amounts), so you only need to review and send.
The Order flip prevents typos and ensures your invoice meets all UWV requirements straight away, because the mandatory fields are automatically taken from the purchase order.
Need to correct an invoice? The UWV only accepts full crediting: credit the full original amount and then create a new invoice with the correct amount. The credit note must have a new, unique invoice number.
Before you can invoice the UWV for the first time, you need to register as a supplier. You do this via the eConnect platform by activating your organisation and sending an invoice to the correct OINO number. The UWV recognises you as a new supplier as soon as the first invoice arrives.
If you already have a contract with the UWV and have received a purchase order, you can invoice via Peppol right away. No separate registration step is needed at eConnect, as the Peppol registration is handled automatically when you activate your organisation.
If your invoice does not meet the requirements, you will receive an error message with a UWV-specific error code. The UWV applies its own validation rules on top of the standard Peppol/NLCIUS validation.
Important: the UWV validates the UBL-XML of the e-invoice, not the PDF representation. A value that is visible on the PDF but is in the wrong UBL field in the XML -- or missing there -- leads to rejection. For error codes always check the XML fields, not the PDF.
Tip: received an error code not listed here? Contact support@econnect.eu and we will help you further.
UWV017 is not a standard field validation but an invoiceCheck: the eConnect platform checks via the InvoiceCheck service in the UWV system (PeopleSoft) whether the order number provided is a valid, existing UWV order number in combination with the supplier's Chamber of Commerce number. If no valid combination is found, the order number field is cleared and UWV017 follows.
Error message per cash flow:
Purchase order delivery method plays no role. UWV017 (and UWV014) check the UBL content of the e-invoice against PeopleSoft/order fields -- not how the related UWV purchase order was sent (email, Peppol or otherwise). A PO via email does not by itself cause UWV017 or UWV014; the error remains data/content (order number, Chamber of Commerce match, product codes). Order flip remains possible only when the purchase order arrived via Peppol.
Requirements for the order number:
Invoice/OrderReference/ID (maximum one order number per invoice -- multiple order numbers result in UWV009).Solution:
Invoice/OrderReference/ID (format AN10, at least 7 digits).Note (KG): when the order number field is cleared by the invoiceCheck, you will only see UWV017 and not UWV013 (order line number). The invoiceCheck is centrally configured and cannot be adjusted per supplier.
UWV014 means that on one or more invoice lines the product code is missing or does not meet the required format. The product code is mandatory in the Large Cash Flow (GG) and by default optional in the Small Cash Flow (KG).
Requirements for the product code:
Invoice/InvoiceLine[n]/Item/BuyersItemIdentification/ID.A2_N4_N3 (2 letters, 4 digits, 3 digits), or N4 (4 digits), or N3 (3 digits).Solution:
Item/BuyersItemIdentification/ID, in format A2_N4_N3, N4 or N3.productcode, product or code (optionally with UWV, case-insensitive, a : after the prefix is allowed), for example in Item/Name, Item/Description or InvoiceLine/Note.OrderReference/ID, AccountingCost and AccountingCostCode, a product code without prefix is recognised as soon as it matches the format -- for some suppliers the only way to include a product code.The invoice is delivered to the UWV via Peppol. You can track the status in your Outbox.
Want to know how e-orders from the UWV work? Read more about receiving e-orders via Peppol.
Discover how eConnect can help