Connect myenergi zappi with ChargeDoc

What ChargeDoc records

The app polls the myenergi cloud in the background roughly every 15 minutes, plus whenever you open it. For each zappi it remembers the plug-in cycle: when you plugged in and when you unplugged again.

After you unplug, ChargeDoc fetches the minute data for that period from the myenergi cloud and combines it into one charging session — even if the zappi paused in between. Documented per session:

• Energy charged in kWh
• Start and end time (first and last minute with energy)
• Solar share, as reported by myenergi
• Electricity costs based on your configured rate
• Current charging power in the live status while charging

If the myenergi cloud still delivers no minute data for a finished charge two hours after unplugging, ChargeDoc books the charge from the zappi's energy value — with the observed plug-in time as start, then without a solar share. Very small energy blocks up to 0.1 kWh are not booked.

The automatic history reaches back 7 days. If the app did not observe the plug-in — for example because it was not opened for a long time and background refresh is off — a charge with long pauses can appear as several entries. For earlier periods, the myenergi export is the reliable source.

The connection is read-only: ChargeDoc does not control your zappi and changes no settings.

Solar share: reported, not guessed

The myenergi cloud's minute data contains, per minute, how much energy came from solar surplus and how much from the grid. ChargeDoc takes those values unchanged and labels the solar share that way: as reported (myenergi), not detected or measured.

The grid share is priced with your electricity rate, the solar share with the optional "Own solar (PV)" price from the price settings. Set that price to 0 and the feature is off — everything is then priced at the grid rate.

For charges older than 7 days, get the figures from the myenergi export:

1. In the myenergi portal (myaccount.myenergi.com) go to Energy Use → Charging Sessions → Export. The CSV contains one row per plug-in cycle, including the green energy in kWh.
2. In the app, tap "Import myenergi export" on the zappi detail screen — or reach it via More → Imports.

ChargeDoc shows a preview before anything is saved and detects duplicates as well as overlaps with sessions already recorded automatically. You decide once per file whether the existing entries are replaced or kept. The CSV itself is parsed in memory and never stored.

ECO, ECO+ and Fast

The zappi offers three charging modes — and it is worth knowing what of that is visible in the app:

• ChargeDoc records the total energy per plug-in cycle regardless of mode. The app does not read the selected charging mode.
• The solar share of a charge is part of the booking, as myenergi reports it.
• Waiting for sun is not a fault: while the zappi waits for solar surplus, the app does not warn about an unusually long wait. "Charging started" arrives once per charge, even if the zappi pauses and resumes several times.

In practice: an ECO+ charge on a sunny day appears in your reports with its green share — a Fast charge overnight appears entirely as grid energy.

Setting up step by step

1. Get your hub serial number and API key

You need two things: the serial number of your myenergi hub (not the zappi's) and an API key. Create the key in your myenergi account at myaccount.myenergi.com or in the myenergi app under Menu → Location → myenergi products → key icon next to the hub.

2. Add the wallbox

Open More → My Wallboxes → Add Wallbox and select "myenergi Zappi". Enter the hub serial number and API key, then pick a location, default vehicle and maximum power.

3. Test the connection and save

Tap "Test connection". If it succeeds, tap Save. If it fails, enter your myenergi account's server in the "Server URL (optional)" field — usually https://s18.myenergi.net — and test again. Normally the app determines the server by itself and the field stays empty.

4. Done: live status

The wallbox now appears in your list — with the status "Charging" while a session is running.

Tap it to open the live status with current charging power, energy charged so far, and maximum power — this is also where the "Sync now" and "Import myenergi export" buttons sit. "Server source" shows how the app determined the myenergi server: default, remembered, found by the director, or set manually.

While a charge is running, the home screen shows a live banner with the wallbox and its current power.

5. Add older charges

To record charges older than 7 days, download the CSV export from the myenergi portal and import it via "Import myenergi export" on the zappi detail screen.

Before you save, the preview shows what the file contains: row count and period, total kWh, the solar share myenergi reports, how many rows are marked as business, and whether the serial number matches this wallbox. Every charge with energy is pre-selected — you can deselect individual rows before importing.

Documentation for tax purposes

With the zappi, ChargeDoc also creates tax-ready records:

• PDF reports for your employer
• DATEV export for your tax advisor
• CSV export of all charges for your own spreadsheets
• Audit-proof records with audit log
• Monthly summaries with costs and energy amounts

Imported sessions are stored as locked records and the import is written to the audit log — so it stays traceable where every row came from.

For company-car reimbursement in Germany, the metered amount is what counts: solar power from your own roof may be valued at your supplier's household tariff or at the electricity price flat rate (BMF letter of 11 Nov 2025, paras. 29 and 30). For your own cost picture, the solar share shows what a charge actually cost you.