XML Field Mapping – AccountingCost and Note
When sending an eInvoice via PEPPOL, you can control what values are written into two specific XML elements: AccountingCost and Note. Both are configured in Sales & Receivables Setup under the Centara Sales Documents group.
These settings tell Centara which field on your sales document to read and copy into the corresponding element in the outbound XML.
The two mapped fields
| Setup field | XML element | XML level |
|---|---|---|
| Accounting Cost Field | cbc:AccountingCost | Document header |
| Note Field | cbc:Note | Document header |
Both fields use the same set of possible source values.
How it works
When a PEPPOL invoice XML is generated, the system reads your configuration from Sales & Receivables Setup and looks up the selected field value directly from the sales invoice or credit memo header at the time of export. The resolved value is then written into the corresponding XML element.
| Option | Source on the sales document |
|---|---|
| (blank) | Element is omitted from the XML entirely |
| Customer No. | Sell-to Customer No. |
| Your Reference | Your Reference |
| External Document No. | External Document No. |
| Responsibility Center | Responsibility Center |
| Reason Code | Reason Code |
| Work Description | Work Description (multi-line text field) |
| Shortcut Dimension 1 Code | Shortcut Dimension 1 Code |
| Shortcut Dimension 2 Code | Shortcut Dimension 2 Code |
Note: If the selected field is blank on a given document, the XML element is sent as empty. If the setup option is left at (blank), the element is omitted from the XML entirely.
cbc:AccountingCost – Buyer’s accounting reference
In the PEPPOL BIS 3.0 standard, AccountingCost is defined as the buyer’s accounting string — typically a cost centre, project code, or internal account reference that the buyer has communicated to the seller and expects to see on the invoice. It appears at the invoice header level, meaning it applies to the entire document.
When the receiver’s system (ERP, financial system, or procurement platform) imports the invoice, this value is typically:
- Pre-populated in a cost centre or account code field
- Used to automatically code the invoice to the correct general ledger account or department
- Displayed in invoice approval workflows so approvers can see which budget or project is being charged
Example XML:
<cbc:AccountingCost>PROJ-2024-042</cbc:AccountingCost>
This is particularly useful in B2B scenarios where the buyer has provided a reference — such as a project number or department code — that you store in, for example, Your Reference or External Document No. on the sales document.
cbc:Note – Free text note on the invoice
Note is a free text field at the invoice header level that carries general remarks about the invoice. The receiver sees this as a note or comment attached to the invoice header — not tied to any specific line.
Typical uses include:
- Payment instructions or terms (when not handled by structured payment means elements)
- References to contracts or agreements
- Any additional information the buyer needs that does not fit a structured field
Example XML:
<cbc:Note>Payment due within 30 days. Contract ref: CT-2023-881.</cbc:Note>
Since the Work Description field in Business Central can hold multi-line text, mapping Note Field → Work Description is a common way to pass longer free-text commentary through to the receiver.
Configuration
Go to: Sales & Receivables Setup → Centara Sales Documents
Set Accounting Cost Field and Note Field independently to the source field that best matches the value your customers expect. These are global settings that apply to all documents sent through Centara.
Tip: If your customers send purchase orders with a cost centre or project reference that you record in Your Reference or External Document No., map Accounting Cost Field to that same field so it flows through correctly on the invoice XML.
Related pages
- Sales & Receivables Setup — full reference for the Centara Sales Documents settings
- Sending Documents — how outbound eInvoices are built and delivered