Tenant and assistant
What a tenant is, the five-step assistant and when you need several.
Setting it up takes a few minutes. Have your tax firm's advisor and client number ready, and the accounts your tax advisor specifies.
Install the plugin from the Shopware Store and open Orders › DATEV export in the administration. The entry point is the dashboard: for each tenant it shows whether it is ready, what was exported last and what is waiting for the next run.
your-shop.com/admin
Tenants
Most urgent first. Clicking a row shows that tenant in the cards below.
| Tenant | Readiness | Last export | Waiting | Schedule |
|---|---|---|---|---|
| Muster Retail GmbHTenant no. 55002 | Notices · 1 | none yet | 72all documents | Dailynext: 15.09.2026 |
| Muster Handels GmbHTenant no. 55001 | Ready | 15.09.202601.08.2026 - 31.08.2026 | 0since 01.09.2026 | Monthlynothing due |
| Muster Digital UGTenant no. 55003 | Ready | none yet | 0all documents | Offruns by hand only |
Open Orders › DATEV export in the administration.
Check in the Readiness column of the Tenants card whether a tenant is ready.
A tenant corresponds to one client at DATEV. The assistant asks for what DATEV needs in five steps: the tax firm with advisor and client number, the sales channels, bookkeeping with chart of accounts, fiscal year, account length and country, the revenue accounts and the booking method. Below every field it says what it does and what is usual; everything can be changed later.
your-shop.com/admin
Create tenant×
✓Tax advisor
✓Sales channels
3Bookkeeping
4Revenue accounts
5Booking
Chart of accounts & fiscal year
The chart of accounts is the numbering system of your bookkeeping - it decides which account numbers the bookings get, and the number of digits follows from it. Plus: when your business year starts and where your company sits, which decides how the export cuts periods and what counts as domestic.
Chart of accounts *SKR03In Germany SKR03 and SKR04 are common. Both are equivalent in substance - they just arrange the same accounts differently, the bookkeeping result does not change. Best pick the one your practice uses.
Account length4How many digits your ledger accounts have. Comes from the chart of accounts - usually 4.
Fiscal year start01-01The first day of your business year as MM-DD (month first). For most it's 1 January, i.e. 01-01.
Company seat countryDEThe country your company is based in (country code, e.g. DE).
LaterBackNext
Click "Set up with assistant" under Master data › Tenants.
Fill in the step and click "Next".
In the fifth step you create the tenant with "Save".
On the Accounts tab you set the revenue accounts per tax rate, the cash accounts per payment method and the debtor account. For the revenue accounts DATEV's standard accounts for SKR03 or SKR04 are suggested; debtor and cash accounts come from your tax firm.
your-shop.com/admin
Orders › DATEV export › Tenants
Muster Handels GmbH
CancelSave
Master dataBookingAccountsTax & OSSExportSales channels
No revenue account for the tax rate 7 %. Documents with that rate cannot be booked - your tax advisor knows which account is right.
Revenue accounts per tax rate
1 openWhere your sales are posted - mandatory for your shop’s own rates
Your tax rates
Revenue 19 %
8400
Revenue 7 %Without an account the export blocks documents carrying this rate. Adopt standard 8300
standard 8300
Deviating accounts per sales channel
Money accounts per payment method
Where the money lands - only with the payment export on
Prepayment
1200
Invoice
1200
PayPalWithout an account the payment is not booked.
e.g. 1200 (bank) or 1000 (cash)
On the Accounts tab enter a revenue account for every tax rate or adopt the standard.
Enter the cash accounts in the Money accounts per payment method card.
Enter the account your tax firm specifies in the Debtor account card.
If you use the One-Stop-Shop scheme, you switch on "OSS procedure active" on the Tax & OSS tab and enter one revenue account per destination country, or you use a collective account with a tax key. Both ways exist separately for goods and for electronic services. The tax rates come from your tax rules in Shopware. Without OSS the export books EU sales to private customers at the German rate like domestic sales.
your-shop.com/admin
Orders › DATEV export › Tenants
Muster Handels GmbH
CancelSave
Master dataBookingAccountsTax & OSSExportSales channels
Small business scheme
Whether this tenant charges VAT
Small business under §19 UStG?
OSS booking method
Two posting methods for OSS sales to EU consumers
OSS procedure active
Method
Collective account + tax key 240All OSS revenue on one account, separated per country via the tax key. Default: 8320.
Revenue account per destination country (recommended)A separate revenue account per EU country - maintained in the Tax & OSS tab.
The exported tax rate is the rate actually charged in the shop. That is only the correct destination-country rate when destination-based taxation (OSS) is active in the shop. Tax rates come from Shopware and are not maintained here.
Revenue accounts per EU destination country
Shopware keeps the tax rates per country. This table belongs to the "revenue account per destination country" method: there every EU country gets its own DATEV revenue account - one for goods, optionally a second one for electronic services (downloads).
2 countries have a revenue account. If an OSS sale has no matching account for its destination country and supply type, the entire export run is blocked. Countries with no such sales need no account. Add more countries via "…" at the end of the row.
| Country | ISO | Tax rate | DATEV revenue account | Digital account |
|---|---|---|---|---|
| France | FR | 20 % | 8401 | no account |
| Netherlands | NL | 21 % | no account | no account |
| Austria | AT | 20 % | 8402 | no account |
Switch on "OSS procedure active" on the Tax & OSS tab.
Under Method choose the revenue account per destination country or the collective account.
Enter the account per country in the Revenue accounts per EU destination country card.
You picked the channels in the assistant; the Sales channels tab is where you change them later. A tenant exports exactly the sales channels that belong to it, and a channel belongs to exactly one tenant. Several companies in one shop each get a tenant of their own.
your-shop.com/admin
Orders › DATEV export › Tenants
Muster Handels GmbH
CancelSave
Master dataBookingAccountsTax & OSSExportSales channels
The assignment is in place: at least one sales channel belongs to this tenant, and no channel carrying orders is left without a tenant.
Sales channels
Which sales channels belong to this tenant? A channel can belong to exactly one tenant - already assigned channels are not offered.
Assigned sales channelsStorefrontB2B-Shop
Not selectable, assigned to another tenant: Marketplace (Muster Retail GmbH)
Check the assigned channels on the Sales channels tab.
Channels that already belong to another tenant are listed below with its name.
The readiness card on the dashboard lists what is still missing before the first export (an advisor number, a revenue account, a channel) and links straight to the place where you add it.
your-shop.com/admin
Readiness · Muster Handels GmbH
Blockers: 1 · hints: 0What the next export needs - every line links to the fix.
Tenant configuredConsultant no. 12345
Sales channel assignedChannels: 2
No revenue account for the tax rate 7 %. Documents with that rate cannot be booked - your tax advisor knows which account is right.Open tenant
Click "Open tenant" on an open line.
On the Export page you pick the period (last month, current month or custom) and run the preview: documents, bookings and totals without a file being created. Then the test export: a real, complete file that locks nothing and can be repeated as often as needed.
your-shop.com/admin
Orders1,204
Bookings1,311
Debit total€321,090.25
Credit total€321,090.25
Validation
No findings - the export would run without blocking errors.
Booking rows
| Document date | Account | Contra account | D/C | Amount | Tax key | Document field 1 | Posting text |
|---|---|---|---|---|---|---|---|
| 0108 | 10000 | 8400 | D | 119.00 | RE-10041 | Beleg RE-10041 | |
| 0108 | 10000 | 8300 | D | 53.50 | RE-10042 | Beleg RE-10042 | |
| 0208 | 10000 | 8125 | D | 840.00 | RE-10043 | Beleg RE-10043 | |
| 0308 | 10000 | 8400 | C | 119.00 | GS-1007 | Beleg GS-1007 |
In the Period card choose the previous month, the current month or "Custom period".
Click "Create preview".
Read the key figures and booking rows of the preview below the page.
Click "Create test export".
Give the tax firm the booking batch of the test export and the handout; the Advisor info sheet (PDF) link is on the Export page. The firm imports on a trial basis and reconciles; the handout (in German, like the DATEV files) explains every convention of the file, from the header to the order of the import. The document packages come with the first binding export.
your-shop.com/admin
Orders › DATEV export › History
Export of 01.09.2026
Back
FinishedSuccessfulMuster Handels GmbH01.08.2026 - 31.08.2026ScheduleInterface v700
OverviewReportReconciliationProtocolEmail
Orders1,204
Bookings1,311
Booking volume (debit+credit)€642,180.50
Errors and findings0
File
EXTF_Buchungsstapel_55001_20260801-20260831.csvSHA-256 a3f1 9c2e …Download
EXTF_Div-Adressen_55001_20260801-20260831.csvSHA-256 7b0d 41aa …Download
DATEV_Belege_55001_20260801-20260831.zipSHA-256 e58c 0f13 …Download
All files of this run go to the tax firm together - every booking points at exactly one document image through its Beleglink.
Re-export lock & audit chain
Locked documents are not booked again when the same period is exported twice. The run's fingerprint covers ALL files of this run and chains to its predecessor's, proving that no file was changed or removed afterwards. This is not the DATEV Festschreibung, which lives in the file header and is set on the tenant.
Download the booking batch in the test export's run with "Download".
Download the Advisor info sheet (PDF) on the Export page.
Once the test is agreed, you switch on the automatic export on the Export tab and set rhythm and hour (daily, weekly or monthly, in the tenant's time zone), plus the tax firm's email address. From then on the handover runs by itself; the history shows every run with its files.
your-shop.com/admin
Orders › DATEV export › Tenants
Muster Handels GmbH
CancelSave
Master dataBookingAccountsTax & OSSExportSales channels
Scheduled export
Whether this tenant exports on its own, in which cadence and in which hour
Automatic scheduled export?
Export interval?Monthly (on the 1st, for the previous month)
Export time?6:00 - 6:59
Due next: 01.09.2026 - 30.09.2026.Last exported: 01.08.2026 - 31.08.2026.
Mail after the scheduled export
Whether and to whom the export mail goes. Each address gets its own mail with the same content.
Send the mail?
Advisor email?post@kanzlei.example
Second advisor address?team@kanzlei.example
Your own address?office@muster.example
Switch on "Automatic scheduled export" on the Export tab.
Choose Export interval and Export time.
Enter the tax firm's address under Advisor email.
What a tenant is, the five-step assistant and when you need several.
Revenue, cash, shipping and voucher accounts, the four ways to the debtor and the cost centres.
Period, preview, test export and export, the running run and the history.
Errors that stop, notices that do not, and the way to fix each one.
Every setting on the tenant and the global switches, with default and effect.
Booking batch, general reversal, freeze and the other words from DATEV and Shopware.