Important: The DATEV Lohnauswertungsdatenservice and/or the DATEV Lohnergebnisdatenservice (whichever you plan to use) must be ordered from DATEV and activated before use (DATEV-Datenservices einrichten). DATEV Lohnaustauschdatenservice (LAUDS) must also be installed and connected in Factorial first (see Prerequisites in Factorial).
Overview
The integration connects Factorial to two DATEV data services. For each legal entity, you choose which data service it uses: either one, or both.
| DATEV Lohnauswertungsdatenservice | DATEV Lohnergebnisdatenservice | |
|---|---|---|
| What Factorial retrieves |
Payslips Employer reports, such as Lohnjournal or Beitragsnachweis |
Payroll results |
| Where the data lands |
Payslips: bulk distribution in Documents Employer reports: Documents › Private, folder DATEV |
Payroll run in Compensations (also shown in Financial Planning) |
| Where you start the import in Factorial |
Payslips: Documents → bulk distribution → Import from DATEV Employer reports: Documents → Private → Import from DATEV (the reports are chosen on the integration's Lohnauswertungsdatenservice Documents tab) |
Compensations → payroll run → Import payroll results → Import from DATEV |
For both data services:
- Supported DATEV payroll programs: DATEV LODAS and DATEV Lohn und Gehalt
- Data flow: read-only, from DATEV to Factorial. Factorial never writes data back to DATEV.
- Where the data comes from in DATEV: the payroll data your tax advisor provides from DATEV LODAS or DATEV Lohn und Gehalt once the accounting month is closed there (DATEV help documents 1019845 and 1025558).
- What happens after the transfer: the data is only used in Factorial. Payslips go to the bulk distribution in Documents, payroll results to the payroll run in Compensations. Employer reports go to Documents › Private. Nothing is processed further in DATEV.
- Authorisation per legal entity: each legal entity is authorised within DATEV. Factorial reads only the data for the clients and data services you have allowed.
DATEV Lohnauswertungsdatenservice
Factorial retrieves the payslips directly from DATEV once a payroll cycle is closed. The payslips land in Factorial's bulk distribution. There, you can check how the payslips were matched and make them available to your employees. You no longer need to download, rename or forward files by email. Each payslip is matched to an employee by first name, last name and tax ID (Steuer-ID). Nobody sees the payslips until you have checked the matching and made them available.
Factorial can also file your DATEV employer reports, such as the Lohnjournal, Beitragsnachweis or Lohnsteuer-Anmeldung, into Documents › Private. On the integration's Lohnauswertungsdatenservice Documents tab, you choose once which reports to retrieve and whether they are filed by month or by report type. You then import a month's reports from Documents › Private with Import from DATEV. Each report is filed as one PDF per report and month, for every legal entity connected to the DATEV Lohnauswertungsdatenservice. You can only choose reports your tax advisor has released to Factorial in DATEV. See Importing employer reports (DATEV Lohnauswertungsdatenservice).
Data retrieved
- Payslips (Brutto/Netto-Abrechnung, DATEV document type LOBN) for every employee
- Employer reports per legal entity, the ones you select on the Lohnauswertungsdatenservice Documents tab, for example Lohnjournal, Buchungsbeleg, Beitragsnachweis or Lohnsteuer-Anmeldung
DATEV Lohnergebnisdatenservice
Factorial imports a month's payroll results from DATEV into that month's payroll run. You don't have to type the figures in by hand or import files. You start the import from the payroll run, and Factorial imports the data for every employee of that run who belongs to a legal entity connected to the DATEV Lohnergebnisdatenservice, for all those legal entities at once.
Data retrieved (per employee and accounting month)
- Gross wage types, with wage type number, name and amount
- Net additions and deductions, with number, name and amount
- Net pay
- Recalculations of earlier months (Rückrechnungen), merged into the imported month
When importing payroll results, Factorial uses the wage types already mapped in the DATEV LAUDS settings, step Wage Types. However, some special cases may require a new mapping for this integration. See the section below for details.
Which wage types you map in Factorial
Factorial first uses the mapping from the DATEV LAUDS settings, step Wage Types. There, each DATEV wage type (Lohnart) is linked to a Factorial payroll concept. If a wage type is linked to a monetary concept there, it is imported directly into that concept without Factorial ever prompting you.
DATEV may send wage types that aren't covered by your LAUDS settings. Because Factorial can't import these automatically, you'll need to manually link them to a Factorial payroll concept. There are three possible scenarios:
| Case | What it means | Example |
|---|---|---|
| Net additions and deductions (Nettobezüge / Nettoabzüge) | Additions to or deductions from net pay. Because LAUDS settings only cover gross wage types, these are never mapped there. | A tax-free travel expense refund, an advance (Vorschuss) being paid back |
| Gross wage types without mapping in LAUDS | Gross wage types that DATEV includes in the payroll results, but that weren't linked to a concept in the LAUDS Wage Types step | A one-off bonus wage type created in DATEV after LAUDS was already set up |
| Gross wage types that are only linked to a non-monetary concept in LAUDS | In LAUDS, the wage type is linked to a Factorial concept measured in hours, days or kilometres. Because DATEV payroll results are always reported in euros, that monetary amount can't be imported into a unit-based concept. | An overtime wage type linked to an "Overtime hours" concept, or a mileage allowance linked to a concept measured in kilometres |
You'll link these wage types to a concept during your first import. You can update these mappings at any time from the Payroll results wage types mapping tab on the integration's page (see Mapping wage types in Factorial). Keep the following rules in mind:
- Each wage type can only be linked to one concept. However, you can link multiple wage types to the same concept: when you do, their amounts are added together.
- For the third case, choose a concept whose value type is Money.
- If a concept is already populated by your LAUDS settings, you can't link additional wage types to it.
- Any wage type left set to Not mapped won't be imported.
Keep in mind that any new mappings you create for the payroll results import apply only to this integration. Your LAUDS settings will continue working as usual and won't be affected by these changes.
Preparations and setup
Prerequisites for using the DATEV data services at DATEV eG
General information about the DATEV data services is available from DATEV eG here:
Information about ordering and setting them up at DATEV eG is available under DATEV-Datenservices einrichten and in the help documents www.datev.de/hilfe/1007329 (for tax advisory firms) and www.datev.de/hilfe/1022677 (for companies). For each data service:
| Setup | Help document | |
|---|---|---|
| DATEV Lohnauswertungsdatenservice | DATEV Lohnauswertungsdatenservice einrichten | DATEV Lohnauswertungsdatenservice (1019845) |
| DATEV Lohnergebnisdatenservice | DATEV Lohnergebnisdatenservice einrichten | DATEV Lohnergebnisdatenservice (1025558) |
Additional DATEV help documents:
- Allgemeine Informationen zu den DATEV-Datenservices Personalwirtschaft (1018461): general information on the payroll data services, including how to order them.
- DATEV-Cloud-Lösungen für Mandanten über MyDATEV Mandantenregistrierung bestellen und einrichten (1002326): ordering and setting up the data services for a client.
Besides tax advisory firms, DATEV Partner Onboarding also helps set up DATEV data services for companies in member-bound client business that work on their own with a DATEV accounting programme.
Member-bound client business means there is a direct business relationship between DATEV and the company, and the services concerned are invoiced directly to the client. More information: www.datev.de/hilfe/1004960.
Appointments and further information are available at go.datev.de/partner-onboarding-info. DATEV offers help registering the data services at www.datev.de/partner-onboarding.
In short, your tax advisor does this in DATEV:
- Order and activate the DATEV Lohnauswertungsdatenservice and/or the DATEV Lohnergebnisdatenservice for every client (Mandant) you want to connect to Factorial.
- Make sure the client is set up for data exchange through the DATEV data centre (RZ-Kommunikation).
- Give the person who will connect your legal entities from your company's Factorial account a DATEV login (DATEV SmartLogin, DATEV SmartCard or DATEV mIDentity) with the DATEV right to use the ordered data service for that client.
Enabling the Lohnauswertungsdatenservice and/or Lohnergebnisdatenservice in DATEV
After ordering the data services from DATEV, data sharing through these services must be enabled so that the integration can retrieve the data correctly. Follow these steps:
- Open the DATEV Arbeitsplatz application.

- Open the client (Mandant) for which you want to enable the Lohnauswertungsdatenservice and/or Lohnergebnisdatenservice.
- Follow the steps below for the DATEV payroll program you use (Lohn und Gehalt or LODAS).
Lohn und Gehalt
- Within the client, go to Extras and select Einstellungen.

- In the window that opens, select the Online-Anwendungen tab.

- Tick the checkbox for the Lohnauswertungsdatenservice and/or the Lohnergebnisdatenservice, as shown below.


- Save in the top bar, otherwise all changes are lost.
LODAS
- Within the client, go to Mandantendaten › Auswertungssteuerung › Zusatzeinstellungen in the Inhalt section on the left-hand side.

- In the window that opens, select the Unternehmen online tab.

- The option Lohn-Zahlungsverkehr is ticked by default: leave it as it is. Tick the checkbox for the Lohnauswertungsdatenservice and/or the Lohnergebnisdatenservice, as shown below.


- Save in the top bar, otherwise all changes are lost.
Prerequisites in Factorial
-
DATEV Lohnaustauschdatenservice (LAUDS) is installed and connected. The integration takes the following from DATEV Lohnaustauschdatenservice:
- your Beraternummer (consultant number)
- which Mandantennummer (client number) belongs to each legal entity
- for the DATEV Lohnergebnisdatenservice, the gross wage type mappings already configured in your DATEV LAUDS settings. Any uncovered wage types, such as net additions and deductions, can be linked to a Factorial payroll concept during your first import (see Which wage types you map in Factorial).
- The legal entity is in Germany and paired with its Mandantennummer in DATEV LAUDS. Only these legal entities are listed and can be connected.
-
The right permissions are set up for the correct roles in Factorial (this is done during the Factorial onboarding and can always be edited):
- Manage integrations (under the Marketplace category). This permission is included in the default Admin group and is needed to install the integration, open its page in the Marketplace (tabs Connections, Lohnauswertungsdatenservice Documents and Payroll results wage types mapping), connect legal entities and uninstall it.
- Permission to import payslips: the View and edit all company and employee documents permission, or edit access to employee documents for all employees.
- Permission to import employer reports: upload files in Documents › Private. Only people with this permission see the Import from DATEV button.
- Permissions to import payroll results: see compensations, import and view payroll results, and import resources.
- Self-service setup. You don't need Factorial to activate this integration for you: you can install it directly from the Factorial Marketplace.
-
For the DATEV Lohnergebnisdatenservice only:
- The Compensation module must be enabled in Factorial.
- A regular payroll run must exist in Factorial for the month you want to import data for.
- The payroll run belongs to a German payroll cycle. Off-cycle payroll runs and payroll runs of other countries can't be imported.
What to review with your tax advisor
For both data services:
- Beraternummer: the tax advisory firm's consultant number for your company, as stored in DATEV Lohnaustauschdatenservice (LAUDS).
- Client per legal entity: which Mandantennummer (DATEV client number) belongs to which legal entity in Factorial.
- Ordering and access rights: who orders the data services in DATEV, who grants the DATEV rights, and who connects each legal entity in Factorial.
- Closing the accounting month: when the month is closed in DATEV. Data is only accessible after the month is closed.
For the DATEV Lohnauswertungsdatenservice:
- Employer reports: which reports (Auswertungen) your tax advisor releases to Factorial in DATEV. Only released reports can be selected on the Lohnauswertungsdatenservice Documents tab.
For the DATEV Lohnergebnisdatenservice:
- Wage types: which DATEV gross wage types (Lohnarten) are used, and which Factorial compensation concept each one is linked to. This mapping is set in the DATEV Lohnaustauschdatenservice (LAUDS) settings, step Wage Types.
- Wage types DATEV LAUDS leaves out: which net additions and deductions are used (for example 9983 AG-Zuschuss zur PV or 9051 Pensionskasse), which gross wage types are unmapped in DATEV LAUDS or are only mapped to non-monetary concepts, and which Factorial concept each one should be linked to. You'll map these in Factorial during your first import with the Lohnergebnisdatenservice integration (see Mapping wage types in Factorial), unless they're already linked to a monetary concept in your DATEV LAUDS settings.
- Personnel numbers: Factorial matches payroll results by DATEV personnel number. The personnel numbers in Factorial must match those in DATEV. They are synced through DATEV Lohnaustauschdatenservice (LAUDS).
Access for your tax advisor
To connect a legal entity, a person needs two things:
- a DATEV SmartLogin (or a DATEV SmartCard or DATEV mIDentity) that is authorised for that legal entity's client in DATEV, and
- the Manage integrations permission in Factorial.
Usually, this is the person who runs your company's payroll. If nobody internally has the required DATEV login, your tax advisor can connect the integration instead (the Factorial admin and the DATEV admin don't have to be the same person, which is ideal when working with an external tax advisor):
- A Factorial admin of your company installs the integration first (see Setup in Factorial).
- Your tax advisor connects the legal entity with their own DATEV login (see Setup in Factorial). For this, your tax advisor needs a Factorial login with the Manage integrations permission.
In Factorial, the connection belongs to your company:
- Factorial shows the name of who authorised the connection, for reference only.
- In DATEV, the access stays tied to that person's DATEV login.
- If access to the client is lost, or the consent is withdrawn in DATEV, the connection stops working and has to be established again.
- To end the connection, disconnect the legal entity (see Managing connections) or reconnect it with someone else's DATEV login.
Setup in Factorial
-
Install the integration
Open the Factorial Marketplace, find the DATEV integration DATEV Lohnauswertungsdatenservice und/ oder Lohnergebnisdatenservice and click Install for company.
The Installation succeeded message confirms that the integration is active and reminds you to connect each German legal entity on the Connections tab of the integration's page. Click Got it to go to the integration's page. If DATEV LAUDS isn't installed yet, you see an Installation has failed message stating DATEV LAUDS is not installed instead. In that case, install DATEV LAUDS first, then install this integration again. -
Open Connections
On the integration's page, the Connections tab lists all your German legal entities as cards, in the format "Legal entity name (Beraternummer-Mandantennummer)", for example "Alpenblick Maschinenbau AG (455148-10020)". Above the list, you see how many of them are connected.
Each card shows the Status (Not connected, or Connected for followed by the data services), Connected by, Connected on and Expires on. -
Choose a legal entity and click Connect
The Connect a legal entity to DATEV screen opens for that legal entity. -
Choose the data services
Under DATEV services to authorise, tick what this legal entity should use: Lohnauswertungsdatenservice · Payroll reports and payslips (hr:payrollreports), Lohnergebnisdatenservice · Payroll results (hr:exports) or both. Nothing is selected by default.
Factorial asks DATEV for exactly the data services you select here. -
Sign in to DATEV
Click Connect (Reconnect if the legal entity is already connected). A DATEV window opens.
Sign in with your DATEV SmartLogin, DATEV SmartCard or DATEV mIDentity. When using a SmartLogin, scan the QR code with the DATEV SmartLogin app.
Once DATEV confirms, Factorial checks whether it has access to this client for each data service. Any data service that DATEV denies is removed from the connection, and the window lists it along with DATEV's error code. If DATEV denies all of them, no connection is created.
If you still have other German legal entities left to connect, you return to Connections. Once all of them are connected, you see a Connected to DATEV for… message, and Factorial takes you back to the integration's page. -
Check the connection
In Connections, check the legal entity's card to see Connected for (listing the data services DATEV approved), who made the connection and when, and the Expires on date (two years after the last renewal: DATEV extends the connection every time Factorial uses it, see Managing connections).
If DATEV confirmed fewer data services than you selected, you see DATEV confirmed only … for this legal entity (see Troubleshooting). - Repeat steps 3 to 6 for each additional legal entity.
-
Choose the employer reports (optional)
On the integration's Lohnauswertungsdatenservice Documents tab, select the reports Factorial should retrieve, choose how they are filed and click Save (see Importing employer reports (DATEV Lohnauswertungsdatenservice)).
Using the integration
Importing payslips (DATEV Lohnauswertungsdatenservice)
You need the permission to import payslips listed under Prerequisites in Factorial.
Once your tax advisor has closed the accounting month in DATEV:
- In Factorial, open Documents and click Send in bulk to start a bulk distribution of files.
- In the upload step, click Import from DATEV.
- Choose the Accounting month and click Start. By default, the last closed month is selected. You can choose any month from January of the previous year up to the current month. Months follow German time.
- Factorial retrieves that month's payslips (Brutto/Netto-Abrechnung, DATEV document type LOBN) for every legal entity connected to the DATEV Lohnauswertungsdatenservice and combines them into one PDF named after the month, for example Payslip_09_2026.pdf (Lohnabrechnung_09_2026.pdf if you use Factorial in German).
- In the distribution wizard, Factorial splits the document by page and matches each page to an employee by first name, last name and tax identification number (Steuer-ID). Double-check that all employees are matched correctly before making the payslips available.
If DATEV doesn't have any payslips ready for a specific legal entity, or denies access to it, Factorial still imports the payslips for your other legal entities. If no payslips are available for the month across any of your legal entities, Factorial displays the reason and nothing is imported. If DATEV's request limit is reached, nothing is imported and a message tells you when to try again.
If no legal entity is connected to the DATEV Lohnauswertungsdatenservice, the form displays No legal entity connected for payslips instead of the month. If your connections need renewing, you see Legal entities need reconnecting instead. In either case, go to the Connections tab on the integration's page.
Note: Starting the import doesn't send anything to your employees yet: you review a preview in the distribution wizard before confirming delivery. Always check the matching before you distribute. A DATEV document can include employees who don't exist in Factorial. Pages with no matching employee stay unassigned until you review them.
Importing employer reports (DATEV Lohnauswertungsdatenservice)
In addition to payslips, the DATEV Lohnauswertungsdatenservice provides your company's monthly payroll reports, such as the Lohnjournal (payroll journal) and Beitragsnachweis (social security contribution statement). Factorial saves the reports you select to Documents › Private for every legal entity connected to the service.
Before you start
- The legal entity is connected, with Lohnauswertungsdatenservice · Payroll reports and payslips (hr:payrollreports) selected on the Connections tab. Payroll reports use the same DATEV connection as payslips.
- Your tax advisor has released the reports in DATEV. Only released reports can be imported.
- You can upload files in Documents › Private (see Prerequisites in Factorial).
Choosing the reports
- Open the integration's page in the Factorial Marketplace and go to the Lohnauswertungsdatenservice Documents tab.
- Under How imported documents are filed, choose By month (one folder per month, for example DATEV / legal entity / 2026-09) or By report type (one folder per report type, for example DATEV / legal entity / Lohnjournal).
- Under Documents to import every month, select the reports you want to retrieve.
- Click Save. You see "Saved. The next import uses these settings."
- Company-wide selection: your report choices apply to the entire company. Every connected legal entity imports the reports you select, provided your tax advisor has released them. If different reports have been released for different legal entities, the tab displays a separate section for each entity: click Show documents to expand one. Selecting a report in any section imports it for every legal entity where it has been released.
- Greyed-out reports haven't been released by your tax advisor yet, so you can't select them. The tab displays the reports available when each legal entity was connected or last imported. If your tax advisor changes which reports are released, reconnect the legal entity under Connections to see the changes right away.
- Changes to how reports are filed take effect from your next import and apply to all legal entities. Previously imported reports remain in their current folders, and any month you re-import after the change is filed again in the new folders.
Which reports you can choose
The tab lists the 21 company-level reports (employer reports) of the DATEV Lohnauswertungsdatenservice. Reports per employee, such as payslips, are not offered here: payslips are imported through the bulk distribution (see Importing payslips (DATEV Lohnauswertungsdatenservice)).
| Report on the Lohnauswertungsdatenservice Documents tab | What it is |
|---|---|
| Lohnjournal (LOJO) | Payroll journal |
| Lohnjournal Einzelaufstellung (LOJE) | Itemised payroll journal |
| Lohnjournal Englisch (LJOE) | Payroll journal in English |
| Buchungsbeleg (BUBE) | Accounting voucher |
| Beitragsnachweis (KBNW) | Social security contribution statement |
| Beitragsnachweis-Erläuterung (SBNW) | Explanation of the contribution statement |
| Kostenstellenwerte (KOST) | Cost centre values |
| Kostenträgerwerte (KOTR) | Cost unit values |
| Lohnartenwerte (LOWE) | Wage type values |
| Lohnartenwerte erweitert (LOPN) | Extended wage type values |
| Personalkosten (LOPS) | Personnel costs |
| Personalkosten Englisch (LOPE) | Personnel costs in English |
| Personalreport (LORE) | Personnel report |
| DÜ Zahlungen (PRZA) | Payments transmitted by data transfer |
| Übersicht Zahlungen (ZAKF) | Payment overview |
| Barauszahlungswerte (ZABR) | Cash payments |
| Überzahlungen (ZAUW) | Overpayments |
| Lohnsteuer-Anmeldung (LSTA) | Wage tax return |
| Darlehenswerte (DAWE) | Employee loans |
| Pfändungswerte (PFAN) | Wage garnishments |
| Wertguthaben je Arbeitnehmer (WEAN) | Long-term working time account balances per employee |
Importing the reports
Once your tax advisor has closed the accounting month in DATEV:
- In Factorial, open Documents › Private and click Import from DATEV, next to Upload files. The button is on the Private root page and inside every Private folder.
- Choose the Accounting month. By default, the last closed month is selected. You can choose any month from January of the previous year up to the current month.
- Click Import. Factorial retrieves the reports you selected on the Lohnauswertungsdatenservice Documents tab for every legal entity connected to the DATEV Lohnauswertungsdatenservice, and files them into Documents › Private. The reports are filed in your name.
- When it finishes, the window shows a summary per legal entity: how many reports were imported or were already there, and which ones were not filed and why (Failed, Not attempted, Not released by your tax advisor or Not available yet).
If DATEV has none of the chosen reports for that month yet, nothing is imported and you see "DATEV has none of the chosen reports for … yet, so nothing was imported." If no legal entity is connected, or no reports are selected yet, the form tells you so.
Where the reports are filed
- Each report is filed as one PDF per legal entity and month, named after the report and the month, for example Lohnjournal_2026-09.pdf. It lands in Documents › Private › DATEV › legal entity › month or report type. If your company has only one legal entity, there is no legal-entity folder: DATEV › month or report type. If a folder named DATEV already exists there, Factorial uses DATEV (Factorial Code) instead.
- A report already filed is skipped. To import it again, move it to the Bin first: the next import files it again.
- A released report can be missing for a month until DATEV provides it. Import the month again later.
Note: If your tax advisor never produces one of the reports you selected, you can't import it.
Importing payroll results (DATEV Lohnergebnisdatenservice)
You need the permissions and the Compensation module listed under Prerequisites in Factorial.
Once your tax advisor has closed the accounting month in DATEV:
- In Factorial, open the payroll run for the month you want to import under Compensations. It must be a regular payroll run of your German payroll cycle.
- Open the three-dots menu (⋮) on the top right and click Import payroll results. In the upload step, click Import from DATEV.
- In the dialog that opens, click Read from DATEV: Factorial reads the month's payroll results from DATEV. You don't choose a legal entity: Factorial imports everyone in the payroll run who belongs to a legal entity connected to the DATEV Lohnergebnisdatenservice, across all those legal entities. The accounting month comes from the payroll run. If no legal entity is connected to the DATEV Lohnergebnisdatenservice, the form shows No legal entity connected for payroll results instead of the button.
Before importing, Factorial checks that everything is ready:
- The payroll run is a regular payroll run of a German payroll cycle.
- The Beraternummer is set up in DATEV Lohnaustauschdatenservice (LAUDS), and at least one legal entity is connected to the DATEV Lohnergebnisdatenservice.
- The payroll run's employees have DATEV personnel numbers. Employees without one, or outside the connected legal entities, are left out.
Then, for each DATEV client (Mandant):
- The wage type mapping can be read.
- DATEV has payroll results for that month.
- DATEV's payroll results include the employees' DATEV personnel numbers.
If a check fails for the entire payroll run, you see the reason right away and nothing is imported. If a check fails for a single DATEV client, only that client's legal entities are excluded: the next step explains why, while your other clients are still imported. If none of your clients pass their checks, or if no employees in the payroll run can be imported, Factorial displays the reasons and nothing is imported.
Next, the wage type mapping step opens, displaying one of the options below:
- Everything is configured. A note says "All required mappings are already configured. To review or edit them, open Payroll results wage types mapping from the Marketplace page." Click Start import.
-
Something to review. A warning banner above the form explains the reason and shows what needs your review:
- On the DATEV side, when DATEV sends a wage type that requires mapping and hasn't been mapped yet: "DATEV provided wage types that are not yet mapped. Select below how to import them."
- On the Factorial side, when a Factorial concept has been deleted, disabled, or changed to a non-monetary unit since it was mapped: "Some previously mapped payroll concepts were deleted or deactivated in Factorial. Please review the mappings to ensure everything is set up correctly."
- On the DATEV LAUDS side, when a Factorial concept you mapped is now linked to a wage type directly in your DATEV LAUDS settings: "DATEV LAUDS settings have changed: a payroll concept you previously mapped is now assigned to a different wage type, overriding your selection. Please review the mappings below to ensure everything is correct."
If more than one condition applies, each corresponding message is displayed. Review the mapping (see Mapping wage types in Factorial), then click Start import.
- Nothing to map. When DATEV doesn't send any wage types to map, the note reads: "No wage types were received from DATEV for this payroll run." Click Start import.
The note at the top also lists anything that will be excluded from the import: any legal entity whose DATEV client was denied (along with DATEV's reason), any legal entity where none of the employees have a DATEV personnel number, and any employees who don't belong to a connected legal entity.
Time limit: you have 4 hours to finish the mapping step. After that, clicking Start import doesn't save anything and returns you to the initial dialog with the message "The mapping session timed out, so the import was not started. Please try again." Click Read from DATEV again.
Once you click Start import, you see a confirmation message: "Trying to import payroll results for n/total employee(s) across [legal entities], accounting month [month]. You can close this window." (n shows how many employees are being imported out of the total in the payroll run.) Below that, you see where your summary will be sent: "When the import finishes, we'll email [email address] a summary of the import with next steps if applicable." If Factorial doesn't have an email address on file for you, you instead see a list of any imports that weren't started (with reasons) and the number of excluded employees.
The import runs in the background. Once it finishes, the summary report shows how many employees in the payroll run Factorial attempted to import and how many were imported successfully. Anything that needs your attention is grouped into its own section, with a next step listed for each item:
- Not started: DATEV clients that were not imported, with the reason.
- Not in a legal entity connected to DATEV: employees of the payroll run outside the connected legal entities.
- No DATEV personnel number: employees with no DATEV personnel number in Factorial.
- Not imported: data to review and Not imported: error: employees whose payroll results could not be imported, with the reason.
- Wage types with no mapping: wage types DATEV sent whose amounts were not imported, including the ones left as Not mapped in the mapping step.
- Wage types for concepts that are not money: wage types mapped in your DATEV LAUDS settings to concepts measured in non-monetary units (such as hours, days or kilometres). Because DATEV payroll results are always reported in euros, these amounts weren't imported.
If everything was imported, the email says "Everything was imported. No action needed."
Only one payroll results import can run at a time for your company, regardless of the payroll run or DATEV clients involved. If an import is already in progress, clicking Start import displays the message: "Another import is already running. Please try again later."
Mapping wage types in Factorial
If a wage type is already mapped to a monetary concept in your DATEV Lohnaustauschdatenservice (LAUDS) settings, Factorial imports it using that existing mapping. All other wage types sent by DATEV are mapped directly within this integration, per legal entity. This includes gross wage types (Lohnarten) that aren't mapped in LAUDS, net additions and deductions (Nettobezüge/-abzüge), and wage types mapped in LAUDS only to non-monetary concepts (such as hours, days or kilometres), since DATEV payroll results are always reported in euros. Factorial remembers your selections for future imports without modifying your DATEV LAUDS settings.
How the mapping form works
- For each legal entity, you see one row per DATEV wage type (showing both its number and name, on the left), paired with a dropdown menu of Factorial payroll concepts (on the right). To prevent conflicts, the dropdown excludes base salary, net pay, disabled concepts, non-monetary concepts, and any concepts already linked in your DATEV LAUDS settings.
- In each dropdown, select the target Factorial payroll concept for the corresponding wage type.
- Each DATEV wage type can map to only one Factorial concept. However, multiple wage types can map to the same concept: when they do, their amounts are added together, and a note above the form shows how many wage types share a concept. If a previous configuration mapped one DATEV wage type to multiple Factorial concepts, only the first available concept is displayed, and only that mapping is kept when you save.
- Choose Not mapped for a wage type that should not be imported. It is not imported, and you aren't asked about it again. The report email still lists it under Wage types with no mapping.
- Dropdowns may come pre-filled with a name-based suggestion labelled "Suggested match. Please verify before continuing." In addition, if this isn't your first import, the dropdowns may already contain your previous selections.
- DATEV LAUDS takes precedence: if a wage type is already mapped to a monetary concept in your DATEV LAUDS settings, it doesn't appear as a row here, and any concepts already linked in LAUDS are excluded from the dropdowns. The import always uses your DATEV LAUDS mapping for those wage types. If you previously mapped a wage type here and later mapped it in DATEV LAUDS, your earlier selection is ignored and the next import prompts you to review your mappings. To update these mappings, edit them directly in your DATEV LAUDS settings. If all wage types for a legal entity are already mapped in DATEV LAUDS, the form displays: "All wage types for this legal entity are already mapped in DATEV LAUDS. No additional mapping is required."
- Non-monetary concepts: when your DATEV LAUDS settings map wage types to concepts measured in hours, days or kilometres, a note titled Concepts with a non-monetary unit appears at the top of the form to list them. Because DATEV payroll results are always reported in euros, nothing is imported for these wage types by default. If you still want to import them, select a concept with the Money value type in their row. This applies only to this integration and doesn't change your DATEV LAUDS settings.
When Factorial asks again
During an import, the mapping form only appears if something has changed: DATEV sends a wage type that requires mapping and hasn't been mapped yet, a concept you previously mapped is now linked to a wage type in your DATEV LAUDS settings, or a mapped Factorial concept has been deleted, disabled, or changed to a non-monetary unit. If DATEV doesn't send a wage type in a given month, its existing mapping is kept.
Review or change the mapping at any time
- Open the integration's page in the Factorial Marketplace and go to the Payroll results wage types mapping tab.
- This page displays the same mapping form for every connected legal entity that has saved wage types. It lists all wage types from previous imports that aren't already mapped in your DATEV LAUDS settings.
- Make your changes and click Save. You see "The mappings have been saved and will be applied to your next payroll results import."
Before you run your first import, this page is empty. Once you complete your first DATEV import, it automatically fills with the imported wage types. Any wage types already mapped to a monetary concept in DATEV Lohnaustauschdatenservice (LAUDS) don't appear on this page.
Managing connections
- Change a legal entity's data services: on the Connections tab of the integration's page, choose the legal entity, select the data services you want and click Reconnect. You need to sign in to DATEV again. A data service you unselect is removed once DATEV confirms the new sign-in.
- Renew an expired or revoked connection: in Connections, you can see each legal entity's expiry date under Expires on. DATEV automatically extends the connection every time Factorial uses it, pushing the expiry date forward with each import. However, a connection expires if it goes unused for two years. If a legal entity shows the status Expired — reconnecting needed or Needs reconnecting — DATEV revoked the connection, select the entity in Connections, click Reconnect and sign in to DATEV again. Until you reconnect it, imports skip that legal entity. If an entity shows Renewal failing since …, DATEV couldn't renew the connection during the last attempt: Factorial automatically retries on the next import, and if that fails as well, you need to reconnect the entity manually.
- Disconnect specific legal entities: choose Disconnect specific legal entities, select the ones you want and finish with Confirm. The integration stays installed, and you can reconnect a legal entity in Connections at any time. The wage type mapping of a disconnected legal entity is kept, so you don't need to map it again when you reconnect. The employer reports chosen on the Lohnauswertungsdatenservice Documents tab are kept too.
- Uninstall the integration: choose Uninstall. Every legal entity is disconnected from DATEV, and the integration's own records, such as its connections, the wage type mappings and the employer reports chosen on the Lohnauswertungsdatenservice Documents tab, are deleted. A payroll results import that is still running is stopped (disconnecting specific legal entities doesn't stop it). Employer reports already filed in Documents › Private stay there.
Disconnecting or uninstalling doesn't delete any payroll data
Neither in DATEV nor in Factorial does disconnecting or uninstalling erase any payroll data. Your payslips and payroll results stay in DATEV, and the employees' documents and payroll results you already imported stay in Factorial. Disconnecting only ends Factorial's access to DATEV: Factorial cancels the connection on DATEV's side and revokes all previously granted access permissions. You can check this in DATEV's Connected applications, which is linked directly from the Connections tab. If Factorial can't cancel the connection automatically, you're prompted to remove it in DATEV yourself. To reconnect later, a user simply needs to sign in to DATEV again: you don't need to set up the integration from scratch unless it was uninstalled.
Scope and limitations
For both data services:
- German legal entities only.
- On demand only. Factorial retrieves data only when you start the import, not on a schedule.
- DATEV request limit: DATEV limits the number of requests allowed per hour for each data service. If this limit is reached, Factorial shows when you can try again (in German time). When this happens during a payslip import, no document is delivered at all, preventing an incomplete result with missing legal entities.
- Master data comes from DATEV Lohnaustauschdatenservice (LAUDS). Change the Beraternummer, Mandantennummern, personnel numbers and gross wage type mapping in DATEV Lohnaustauschdatenservice (LAUDS). Any wage types left out by DATEV LAUDS (net additions and deductions, gross wage types without a mapping, or wage types mapped only to non-monetary concepts) are mapped directly within this integration on the Payroll results wage types mapping tab. Any wage type already mapped to a monetary concept in DATEV LAUDS always uses that LAUDS mapping.
DATEV Lohnauswertungsdatenservice:
- Accounting months: you can retrieve any month from January of the previous year up to the current month. If an accounting month hasn't been closed in DATEV yet, there is nothing to import.
- Documents are always retrieved for all employees: DATEV returns payslips for every employee belonging to each connected legal entity's DATEV client (Mandant). It isn't possible to retrieve payslips for a single, specific employee.
DATEV Lohnergebnisdatenservice:
- Import into an existing regular payroll run: Factorial doesn't create a payroll run during the import. A regular payroll run must already exist for the month before you import your DATEV results.
- All payroll run employees are imported at once: the import covers every employee in the payroll run who belongs to a legal entity connected to the DATEV Lohnergebnisdatenservice. It isn't possible to import a single legal entity or an individual employee. Employees from unconnected legal entities are excluded, and the import summary tells you how many were left out.
- One import at a time: while a payroll results import is in progress, you can't start another one.
- Only employees with a DATEV personnel number are imported: any employee without a DATEV personnel number, or with no payroll results in DATEV for the selected month, is skipped. If the same personnel number is assigned to more than one employee within a single DATEV client, those employees are skipped as well.
- Unmapped wage types: wage types that aren't mapped in DATEV Lohnaustauschdatenservice (LAUDS) are only imported if you map them in this integration's mapping step (see Mapping wage types in Factorial). Wage types left unmapped or set to Not mapped aren't imported and are listed under Wage types with no mapping in the report email sent once the import finishes.
- No amounts can be imported into Base salary, disabled concepts or non-monetary concepts: Factorial rejects these targets, so any lines mapped to them are skipped while the rest of the import proceeds normally. Wage types that DATEV LAUDS maps only to concepts measured in hours, days or kilometres are listed under Wage types for concepts that are not money in the report email.
- German payroll runs only: imports are supported only for regular German payroll runs. Off-cycle runs, payroll runs without an assigned payroll cycle, and payroll runs for other countries aren't supported.
Troubleshooting
Who is responsible:
- Factorial admin: anyone in your company with the Manage integrations permission.
- DATEV admin: the person who manages your DATEV services and access (for example, someone who can order DATEV SmartIDs).
- Tax advisor: your tax advisory firm, or whoever manages your payroll, who often also acts as your DATEV admin.
- Factorial Support: contact Factorial Support if you see a message that isn't listed here or if an issue persists.
For both data services
| Message in Factorial | What to do | Who is responsible |
|---|---|---|
| DATEV LAUDS is not installed | Install and connect DATEV LAUDS, then open the screen again. | Factorial admin |
| Not connected to DATEV | Connect the legal entity in Connections and tick the data service you need. | Factorial admin/ DATEV admin |
| No legal entity connected for payslips / … for payroll results / … for reports | No legal entity is connected for the data service. In Connections, connect the legal entities and select Lohnauswertungsdatenservice (payslips and reports) or Lohnergebnisdatenservice (payroll results). | Factorial admin/ DATEV admin |
| DATEV has not confirmed the connection yet | Click Connect and finish the DATEV sign-in in the window that opens. | Factorial admin/ DATEV admin |
| DATEV: … (shown after the DATEV sign-in) | DATEV refused the sign-in, or it was cancelled. Check that the person signing in has the DATEV right for this client, then connect again. | Factorial admin/ DATEV admin |
| DATEV sent no authorisation code / The DATEV token exchange failed | Connect again. If it keeps failing, contact Factorial Support. | Factorial admin/ DATEV admin Factorial Support |
| DATEV granted the connection, but the permissions for … could not be verified | Immediately after sign-in, DATEV rejected access to this client for the listed data services, so the connection wasn't completed. Check with your tax advisor or DATEV admin to confirm that the DATEV login used has permission to access this client for those data services, then try connecting again. | Factorial admin/ DATEV admin Tax advisor/ DATEV admin |
| DATEV confirmed only … for this legal entity | Ask your tax advisor/ DATEV admin whether the missing data service is set up for this client in DATEV, then click Connect again. | Factorial admin/ DATEV admin Tax advisor/ DATEV admin |
| DATEV authorisation is missing this service | Reconnect the legal entity in Connections and select the data service you need. | Factorial admin/ DATEV admin |
| A legal entity is missing from Connections | Only German legal entities paired with a Mandantennummer in DATEV LAUDS are listed. Check the legal entity's country and its pairing in DATEV LAUDS, then reload Connections. | Factorial admin/ DATEV admin |
| No German legal entity is paired with a DATEV Mandant | Pair your German legal entities with their Mandantennummern in DATEV LAUDS, then reload Connections. | Factorial admin/ DATEV admin Tax advisor |
| No DATEV consultant number (Beraternummer) is configured / Your DATEV consultant (Beraternummer) is not configured yet | Add the Beraternummer in DATEV LAUDS, then reload Connections or start the import again. | Factorial admin/ DATEV admin Tax advisor |
| Datenservice not activated in DATEV | Ask your tax advisor to activate the data service for this client. | Tax advisor/ DATEV admin |
| DATEV client number not recognised | Check the Mandantennummer in DATEV LAUDS. Your tax advisor can confirm it. | Factorial admin/ DATEV admin Tax advisor |
| DATEV denied access to this client | The DATEV login used to connect isn't authorised for this client. Ask your tax advisor/ DATEV admin to grant the DATEV right, or reconnect with a DATEV login that has access. | Tax advisor/ DATEV admin |
| DATEV rejected the authorisation | DATEV refused the connection for this data service. Reconnect the legal entity in Connections with a DATEV login that has access to this client. If it keeps failing, contact Factorial Support and quote the reference in the message. | Factorial admin/ DATEV admin Factorial Support |
| DATEV subscription missing | RZ-Kommunikation isn't set up for this client. Ask your tax advisor/ DATEV admin to set it up. | Tax advisor/ DATEV admin |
| DATEV connection ended / Expired — reconnecting needed / Needs reconnecting — DATEV revoked the connection / Legal entities need reconnecting | Reconnect the legal entity in Connections: select it, click Reconnect and sign in to DATEV again. | Factorial admin/ DATEV admin |
| Renewal failing since … (in Connections) | DATEV didn't renew the connection on the last attempt. Factorial tries again on the next import. If that fails again, reconnect the legal entity in Connections. | Factorial admin |
| DATEV rejected Factorial's app credentials | Don't reconnect: your DATEV connections are still valid. Contact Factorial Support. | Factorial Support |
| DATEV payroll program not set | Factorial doesn't know whether the legal entity runs on DATEV LODAS or DATEV Lohn und Gehalt, so it can't check which months it may request. Contact Factorial Support. | Factorial Support |
| Nothing to import yet | The month isn't closed in DATEV yet. That usually happens in the first days of the following month. Try again later. | Tax advisor (closes the month)/ person doing your payroll |
| DATEV request limit reached / This could not be completed right now. Try again after … (German time). / in the report email: This employee could not be read right now. Run the import again after … (German time). | DATEV's hourly request limit was reached. Wait until the time shown (German time), then start the import again. | Factorial admin/ DATEV admin |
| DATEV could not be reached / DATEV is temporarily unavailable | Try again in a few minutes. If it persists, contact Factorial Support. | Factorial Support, if it persists |
| Unreadable answer from DATEV / DATEV rejected the request / The DATEV request failed | Contact Factorial Support and quote the reference given in the message. | Factorial Support |
DATEV Lohnauswertungsdatenservice
| Message in Factorial | What to do | Who is responsible |
|---|---|---|
| No reports chosen yet | Select the employer reports to import on the Lohnauswertungsdatenservice Documents tab of the integration's page. | Factorial admin |
| Not released by your tax advisor (report import) | Your tax advisor hasn't released these reports in DATEV. Ask them to release the ones you need. | Tax advisor |
| Not available yet (report import) | DATEV hasn't provided these reports for the month yet. | Tax advisor/ Factorial admin |
DATEV Lohnergebnisdatenservice
| Message in Factorial | What to do | Who is responsible |
|---|---|---|
| DATEV returned no payroll results for … | DATEV has nothing for this client and month yet. Make sure the month is closed in DATEV, then start the import again. | Tax advisor |
| No regular Compensations payroll run exists for … | Create the payroll run for the month in Compensations, then start the import again. | Factorial admin |
| Not included: … None of its … employee(s) in this payroll run has a DATEV personnel number in Factorial / … employee(s) have no DATEV personnel number in Factorial, so they are not imported | Sync the personnel numbers through DATEV LAUDS, then start the import again. | Factorial admin |
| … employee(s) of this payroll run are not in a legal entity connected to DATEV | Connect their legal entities in Connections with the Lohnergebnisdatenservice, then start the import again. | Factorial admin/ DATEV admin |
| There is no one to import from DATEV in this payroll run | None of the run's employees is in a connected legal entity with a DATEV personnel number. Check the legal entities in Connections and the personnel numbers in DATEV LAUDS. | Factorial admin |
| Another import is already running. Please try again later. | Wait for the running import to finish. | Factorial admin |
| DATEV has payroll results for …, but none for the DATEV personnel numbers of these employees | The personnel numbers in Factorial don't match DATEV's. Sync them through DATEV LAUDS, then start the import again. | Factorial admin, with the tax advisor |
| Personnel number … belongs to more than one employee of this DATEV client | Nothing was imported for that personnel number. Add for each employee their own DATEV personnel number in Factorial, then import again. | Factorial admin |
| DATEV payroll-concept mappings are not readable for this legal entity | Check the Wage Types step of the DATEV LAUDS settings, then try again. If it persists, contact Factorial Support. | Factorial admin Factorial Support |
| DATEV provided wage types that are not yet mapped | Not an error: map the new wage types, or leave them Not mapped, then click Start import. | Factorial admin |
| Some previously mapped payroll concepts were deleted or deactivated in Factorial | Choose another concept for the affected wage types, or enable the concept again. | Factorial admin |
| DATEV LAUDS settings have changed | A Factorial concept you previously mapped is now linked to a wage type in your DATEV LAUDS settings, which automatically overrides your Factorial mapping. Review your mapping settings and select a different concept for the affected wage types, or update your configuration in DATEV LAUDS. | Factorial admin |
| Concepts with a non-monetary unit | DATEV LAUDS maps these wage types to concepts measured in hours, days, or kilometres, so no amounts are imported for them. To import these wage types, select a monetary concept (value type Money) in their row during the mapping step. | Factorial admin |
| The mapping session timed out, so the import was not started | Click Read from DATEV again. | Factorial admin |
| Another import was started for this company in the meantime | Another user retrieved data for a different payroll run from DATEV while you were working. Restart the process by clicking Import from DATEV inside the payroll run. | Factorial admin |
| Factorial's payroll concepts could not be retrieved | Try again in a moment. If it persists, contact Factorial Support. | Factorial admin Factorial Support |
| This payroll run is not a German payroll run / Off-cycle payroll runs are not supported | Open the import from a regular payroll run of your German payroll cycle. | Factorial admin |
| This payroll run does not belong to a payroll cycle | Open the import from a payroll run of your German payroll cycle. | Factorial admin |
| Could not read the payroll cycle of this payroll run to check its country | Try again in a moment. If it persists, contact Factorial Support. | Factorial admin Factorial Support |
| Wage types with no mapping (report email) | Their amounts weren't imported. Map gross wage types in the Wage Types step of the DATEV LAUDS settings, and any wage type LAUDS leaves out in Payroll results wage types mapping, then import the payroll run again. | Factorial admin |
| Wage types for concepts that are not money (report email) | DATEV LAUDS maps these wage types to concepts measured in hours, days, or kilometres. Because DATEV payroll results are always reported in euros, their amounts couldn't be imported. To fix this, map these wage types to a monetary concept in Payroll results wage types mapping, then run the payroll import again. | Factorial admin |
| Not imported: data to review / Not imported: error (report email) | Follow the next steps outlined in the report email: review the affected employees in DATEV and Factorial, or try importing the payroll run again. If the error persists, contact Factorial Support. | Factorial admin Factorial Support |
Contact and support
- Questions about the integration in Factorial (for customers and tax advisory firms): Factorial Support
- Questions about ordering, activation, DATEV rights and DATEV logins (SmartLogin, SmartCard, mIDentity): your tax advisor or DATEV Partner Onboarding