Introduction
Use Your Ref. as Order Ref. ID is a setting in Electronic Invoicing with Sproom that replaces the order reference on outgoing OIO-UBL electronic invoices and credit memos with the value of the Your Reference field from the sales document. Many Danish public-sector and large private customers require their own order or requisition number on incoming electronic invoices so their systems can match the invoice automatically. This setting makes sure that the reference your customer gave you is the reference they receive back on the electronic document.
Feature Overview
Use Your Ref. as Order Ref. ID changes what is sent as the order reference when an electronic document is created and sent through the Sproom service. By default, the order reference on an OIO-UBL invoice or credit memo contains the posted document number. When the setting is enabled on the Sproom Service Settings page and the Your Reference field on the sales document is filled in, that value is used as the order reference instead. If Your Reference is empty, nothing changes — the document is sent with the posted document number as the order reference, exactly as before. The result is that customers who match incoming invoices against their own purchase order or requisition numbers can process your invoices without manual intervention.
Typical Use Cases
- A company sells to Danish municipalities that require a requisition number (rekvisitionsnummer) on every electronic invoice. The requisition number is entered in Your Reference on the sales order, and the electronic invoice automatically carries it as the order reference.
- As an accounts receivable employee, I want the customer's purchase order number to appear as the order reference on the electronic invoice, so that the customer's invoice matching does not reject our invoices.
- A finance team keeps receiving returned or unmatched e-invoices because the receiver's system expects their own order number, not the sender's invoice number. Enabling the setting resolves the mismatch without changing how documents are posted.
- A bookkeeper issues a credit memo for a delivery that was invoiced electronically. The credit memo carries the same customer reference as the original invoice, so the customer can connect the two documents.
- A consultant setting up electronic invoicing for a client with many public-sector customers enables the setting once, company-wide, instead of handling reference requirements invoice by invoice.
Key Concepts
- Your Reference — a standard Business Central field on sales documents where you record the reference your customer gave you, such as a purchase order number or requisition number.
- Order reference — the part of an OIO-UBL electronic document that tells the receiver which of their orders the invoice relates to. Many receiving systems use it for automatic invoice matching.
- OIO-UBL — the Danish standard format for electronic invoices and credit memos, required when invoicing the Danish public sector.
- Default behavior — with the setting disabled, the posted document number is used as the order reference, which is the original behavior of the app.
Relations to Other Features or Apps
Use Your Ref. as Order Ref. ID is part of the document content options on the Sproom Service Settings page, alongside options such as Enable Attachments and Include Invoice as PDF. It builds on the standard Business Central Your Reference field on sales quotes, orders, invoices, and credit memos, and on the OIO-UBL document format provided by Microsoft's OIOUBL extension. The setting applies to all electronic invoices and credit memos sent through the Sproom service for the company.
Frequently Asked Questions
What happens if the Your Reference field is empty on the sales document?
When Your Reference is empty, the electronic document keeps the posted document number as its order reference. The setting only takes effect on documents where Your Reference contains a value, so enabling it never produces documents with a missing order reference.
Does the setting apply to credit memos as well as invoices?
Yes — Use Your Ref. as Order Ref. ID applies to both electronic sales invoices and electronic sales credit memos sent via Sproom, so credit memos carry the same customer reference as the invoices they correct.
Is the setting company-wide or per customer?
Use Your Ref. as Order Ref. ID is a single company-wide option on the Sproom Service Settings page. Once enabled, it applies to every electronic document sent through Sproom; documents for customers who don't provide a reference are unaffected because their Your Reference field is simply left empty.
When This Feature Adds Value
- Your customers — especially Danish public-sector institutions — require their own order or requisition number on electronic invoices for approval and matching.
- Electronic invoices are being rejected or held for manual handling because the order reference contains your invoice number instead of the customer's order number.
- You already record customer references in the Your Reference field and want that information to flow into the electronic documents without extra work.