With Nemhandel Mapping With Nemhandel Mapping you can decide which data is sent in your e-invoices and e-credit notes from Uniconta. You do this by “mapping” (linking) Uniconta fields to fields in the e-document.
Differences between credit note and invoice
When you set up a Nemhandel Mapping for e-invoices and e-credit notes, the list of possible Nemhandel Tags changes . These are the available Nemhandel Tags you can map:
🧾 Invoice
- AccountingCost
- InvoiceLine/AccountingCost
- InvoiceLine/Item/BuyersItemIdentification/ID
- InvoiceLine/Item/Name
- InvoiceLine/Note
- Note
- OrderReference/ID
- PaymentTerms/Note
📉 Credit note
- AccountingCost
- BillingReference/InvoiceDocumentReference/ID
- CreditNoteLine/AccountingCost
- CreditNoteLine/Item/BuyersItemIdentification/ID
- CreditNoteLine/Item/Name
- CreditNoteLine/Note
- Note
The tags we allow you to change initially have been developed with some partners. Contact us at support if you want us to open up the ability to map more tags, and we will find out internally if this is possible and get back to you.
But before you can set up mappings on these tags, you need to create a Nemhandel mapping group.
Nemhandel mapping group
A mapping group defines which document type and version your setup applies to.
- Version: At the moment, only UBL 2.1 is supported, but we will continuously update with new versions as they become supported by Nemhandel and Uniconta.
-
Document type: Uniconta supports sending 2 documents:
- Invoice
- Credit note
Default
In Group Setup, you can choose to mark a group as Default or not.
- ✅ (Default group) - This means that this setup is used as the default for all e-documents. You can create as many groups as you want, but only one default group per document type and version.
- ❌ (Customer group) - If you want a specific setup for certain customers, you can create a customer mapping group. A customer group is created without a checkmark in the “Default” field
-
-
You can assign one or more customers to a group for either,
- an individual setup (one customer per group).
- a common setup (combine multiple customers into one group)
- When an e-invoice or e-credit note is sent to one of these customers, the mapping setup defined in the customer group is used – even if a default group exists (customer group takes precedence).
-
You can assign one or more customers to a group for either,
You must always have either a default or a customer group for the setup to be applied. If a group is neither marked as default nor has any customers assigned, it is ignored.
Nemhandel Mapping
Once you have created a Nemhandel mapping group, you can proceed to the Nemhandel mapping tab. This function gives you control over which information is sent with your e-documents (invoice or credit note). You choose, which field in the e-document should be filled in, and where the information comes from in Uniconta.
Group
On this page, you can switch or create (the ➕ button) a new mapping group. The bottom datagrid is updated automatically with the existing mapping setup for the selected group. The dropdown to the right of the group is updated automatically in accordance with the group’s options.
If you click ‘add line’ without a group, you will get an error message.
Create a new mapping
Click “Add line” and fill in the following:
| Column | Description |
| Nemhandel Tag | The field in the e-document that must be filled in |
| Table id | Uniconta table from which the data must be retrieved |
| Field | The specific field in the table |
| Value | Display of the field’s value via the selected invoice/credit note |
| Apply default value if empty? | Determines what happens when the value in your mapping is empty. If activated, Uniconta/Nemhandel’s default value for the field is applied. If disabled, the tag is omitted entirely from the UBL file. |
⚠️Validation and limitations
- All three fields (Tag, Table, Field) must be filled in – otherwise you will get an error message.
- A Nemhandel Tag may only be used once per group – recycling causes an error.
- Existing lines cannot be edited: If you want to change the table/field on an existing tag, the line must be deleted and recreated.
-
The document is validated against Nemhandel’s official XSD file (UBL 2.1); this happens when you click “Save” or ‘View’.
- We always validate when sending your e-document.
The View button
The “View” button allows you to see the result of your mappings before you save it. A PDF view of the document is shown, where your mappings have been applied. This ensures that your fields are correct, both structurally and in accordance with the Nemhandel standard.
Notification
Validation of your new mappings takes place when they are created, but this means issues may occur with your mappings on other invoices/credit notes when it is used in production, i.e. when you send an e-document.
Therefore, we have made it possible to register for the notification system where you will be notified about the various errors that may occur during validation. The error messages will likely be in English, as the XSD file outputs them that way.
