Unit4 Plugin - Config

Start by clicking "New Integration" in Semine, then select Unit4 from the dropdown and click OK.
 

 

By filling in the fields in this dialog, you will set up the integration "Root settings" which will be used for all clients directly under the organization. The root settings will be used as default but it is still possible to enter specific values in all fields for each client.

Note: SEMINE Connect will use the Unit4 API documented here:
https://ubw-accept01.unit4cloud.com/no_boe_acpt_webapi/swagger/ui/index
Make sure to select .../v1 in the dropdown.

Capabilities

• Import of master data to SEMINE
  • Import of ledger accounts and VAT accounts including relations
  • Dimensions including relations. Only active relations are imported (see Dimensions notes below).
  • Import of suppliers
  • Import of Splitkeys from Unit4 (via Information Browser / REST API)
• Export of processed invoice data to Unit4
  • Export of invoice (GL07 / DS05 as applicable)
  • Export of invoice accounting lines / accounting entries (GL07)
  • Export of invoice PDF (original or generated from UBL/EHF)
  • Export of invoice attachments is supported via a configurable option.
  • Export of enriched EHF invoices (SEMINE accounting information added). Optionally include the original received EHF file for auditing.

Note: In Unit4, GL07 refers to the message format for posting General Ledger and Accounts Payable transactions, while DS05 refers to the message format for transferring documents.

Unit4 Cloud setup

Some fixed values have to be set in Unit4 Cloud:

1. Document Type must be set to SEMINE.
   Norwegian: Home -> Felles -> Dokumenttype
   English: Home -> Common -> Document Type

Semine Connect root and client configuration

Below is a consolidated list of the fields and options that appear in Semine Connect for Unit4.

Note: Fields marked * are mandatory for a standard setup.

Unit4 Integration Fields and Example Values

Field	Description	Example Value
Integration Name*		Set a name for the integration
API URL *	Base URL for Unit4 API.  See more details	https://ubw.unit4cloud.com/XX_YYY_prod_webapi/v1/objects
API Username *	Unit4 API username.  See more details	EXAMPLE_USER_NAME
API Password *	Unit4 API password.	Provided by Unit4 support
Company Code *	2–3 letter code identifying the company in Unit4.  See more details	ABC
Use Document Library	Enable/disable DocLibrary inclusion in DS05 export.  See more details	Checked / Unchecked
DocLibrary	Code of document library if enabled.  See more details	DOCLIB001
Ledger Supplier Account *	Accounts Payable ledger account.  See more details	2400
Suppliers, comma-separated	Comma-separated supplier groups to sync.  See more details	10,20,40
Voucher-type, manual vouchers *	Transaction type for manual vouchers.  See more details	GL
Voucher-type, other *	Transaction type for other vouchers.  See more details	SE
Payment Method	Default payment method.  See more details	IP
Tax System Dimension	Dimension code for tax mapping.  See more details	TXSYS
Accounts for VAT-lines (trans_type=TX)	Comma-separated VAT accounts for GL07 export.  See more details	1600,1610,1620
Dimensions *	List of dimensions to import.  See more details	C0,C1,B0,B1,BF,F0
Preserve existing relations	Keep existing SEMINE relations if enabled.  See more details	Checked / Unchecked
Specify allowed Projects, Cost-Centres, Workorders	Restrict which Projects, Cost-Centres, and Workorders are allowed to sync.	Configured by SEMINE Support
Objects mapped into split keys	JSON configuration mapping Unit4 objects into SEMINE split keys.	Configured by SEMINE Support
Send invoice to Unit4 workflows	Enable sending invoice metadata to workflows.  See more details	Checked / Unchecked
FTP Host *	Unit4 SFTP host.	noe-gateway.unit4cloud.com
FTP Port	Port for SFTP connection.  See more details	22
FTP Username *	Username for SFTP login.  See more details	SFTP-IMP-YYY-PROD
FTP Password *	Password for SFTP login.  See more details	Provided by Unit4 support
Export folder-name *	Folder path for GL07 exports.  See more details	/Export/GL07-Semine
Import folder-name *	Folder path for DS05 imports.  See more details	/Import/DS05-Semine
Include attachments	Whether invoice PDFs are exported.  See more details	Checked / Unchecked
Semine Email*	The username for the integration user with access to the Semine client data.	[e-mail]
Semine Password*	The password for the integration user with access to the Semine client data.

API URL *

Free text. Unique for every Semine Customer.
Example:
https://ubw.unit4cloud.com/XX_YYY_prod_webapi/v1/objects

• XX = country code (typically no for Norway)
• YYY = customer code

Contact Unit4 support to obtain the correct API URL for your environment.

API Username *

Example: EXAMPLE_USER_NAME
Contact Unit4 support to obtain this username.

Company Code *

Two to three letter code identifying the company in Unit4. Example: ABC

1. Log into Unit4 Cloud and open the company selector (top-right).
2. Locate the 2–3 letter company code in the left column.

Example URLs:
Preview: https://ubw-preview.unit4cloud.com/XX_YYY_prev_web
Production: https://ubw.unit4cloud.com/XX_YYY_prod_web/Login/Login.aspx

Use Document Library

Checkbox to include or exclude the <DocLibrary> tag in DS05 exports. Checked = include; unchecked = exclude.

Note: If enabled, the DocLibrary field becomes mandatory. If disabled (default), the tag is removed.

DocLibrary

Code of the document library to include in DS05 export when Use Document Library is enabled.

Warning: Leaving this empty when Unit4 expects a value will cause import failures. If no document library is used, uncheck Use Document Library.

Ledger Supplier Account *

Accounts Payable ledger account. Typically 2400.

How to find it in Unit4:

1. Log into Unit4 Cloud, open Home screen menu.
2. Select Felles / Common.
3. Navigate: Accounting Structure → Chart of Accounts.
4. Filter Type column for Accounts Payable.
5. Locate account labelled Leverandørgjeld, often 2400.

Suppliers, comma-separated

Comma-separated list of supplier groups to sync. Example: 10,20,40

How to find supplier groups in Unit4:

1. Navigate to Home → Accounting → Accounts Payable → Supplier information → Vendor group.
2. Identify vendor groups to sync. Example values:
   10 – External suppliers
   20 – Internal suppliers
   40 – Foreign suppliers

Voucher-type, manual vouchers *

Transaction type for manual vouchers. Example: GL

How to find it in Unit4:

1. Navigate to: 
   Home → Common → Fixed Registers → Transaction types 
   (Norwegian: Home → Felles → Faste registere → Bilagsarter).
2. Locate the row for Diversebilag and note the code in the Bilagsart column (commonly GL).

Voucher-type, other *

Transaction type for other vouchers. Example: SE

How to find it in Unit4:

1. Navigate to: 
   Home → Common → Fixed Registers → Transaction types 
   (Norwegian: Home → Felles → Faste registere → Bilagsarter).
2. Locate the appropriate row in Bilagsart and note the code (commonly SE).

Payment Method

Default payment method included with imported/exported transactions. Example: IP

Tax System Dimension

Optional dimension code to map Tax System values for GL07 export. Example: TXSYS

Accounts for VAT-lines (trans_type=TX)

Comma-separated list of accounts treated as VAT accounts in GL07 export. Example: 1600,1610,1620

Dimensions *

List of dimension codes to import. Example: C0,C1,B0,B1,BF,F0

How to find and select dimensions in Unit4:

1. Log into Unit4 Cloud.
2. Navigate to: 
   Home → Common → Attributes and Relations → Attributes 
   (Norwegian: Home → Felles → Begreper og relasjoner → Begreper).
3. Use the Field filter dropdown to select 
   Cat1, Cat2 ... Cat7 
   (Norwegian: Dim1, Dim2 ... Dim7) 
   and filter the list.
4. Copy the values in the ID column for each relevant attribute into the SEMINE Dimensions field. Repeat for each category to sync.

Note: SEMINE only imports relations that are active based on their PeriodFrom and PeriodTo values. Parent relations without date intervals are always considered active.

Preserve existing relations

Checkbox: If enabled, SEMINE keeps existing relations and adds new synced relations. If disabled, existing relations are replaced.

Send invoice to Unit4 workflows

Checkbox to send invoice metadata to Unit4 workflows. Default: unchecked.

FTP Port

Port used for SFTP connection. Default: 22. Custom ports such as 41667 are supported.

Note: Required if SFTP uses a non-standard port.

FTP Username *

Username for SFTP login. Example: SFTP-IMP-YYY-PROD

FTP Password *

Password for SFTP login. Provided by Unit4 support

Export folder-name *

Folder path for GL07 exports on the SFTP server. Example: /Export/GL07-Semine

Warning: This folder must contain subfolders GL07-Semine and DS05-Semine. Create them manually before the first export.

Example filename pattern: {VoucherType}-{CompanyCode}-{VoucherNo}-{BatchId}.xml

GL07 Example XML

Import folder-name *

Folder path for DS05 imports and PDFs. Must end with DS05-Semine.

Tip: For local testing, ensure folder name matches production behavior.

DS05 Example XML

Include attachments

Checkbox to export invoice attachments (PDFs) to Unit4. Checked = include; unchecked = exclude.

Test connection

Use the Test connection button to verify the SEMINE username and password

Invoice Flow and Statuses

When an invoice is posted from SEMINE to Unit4, it goes through a series of statuses that indicate its progress. 

• Posting – The invoice has been submitted from SEMINE and is waiting for processing.
• In-Transit – The invoice file has been successfully uploaded to Unit4 and is awaiting confirmation. SEMINE checks regularly (about every 15 minutes) to verify posting in Unit4.
• Posted – The invoice has been confirmed as successfully posted in Unit4. If purchase order updates were needed, these have also been completed.
• PostingError – The invoice could not be posted in Unit4. This usually requires adjustments in SEMINE (for example, correcting accounting lines) or changes in Unit4 (for example, reopening a closed account).

Purchase Order (PO) Invoices
For PO-invoices, the delivered and remaining amounts are updated in Unit4 after the invoice has been posted. If the PO update fails, SEMINE sets the invoice status to PostingError. In this case, a user must review the issue and take corrective action in SEMINE and/or Unit4 before the posting can be completed successfully.

Note: If a posting error occurs due to changes in Unit4 (such as reopening an account), you must update the settings and then set the invoice back to Posting in SEMINE. The system will then retry the export.