Connect myenergi zappi with ChargeDoc

What ChargeDoc records live

The app polls the myenergi cloud in the background roughly every 15 minutes, plus whenever you open it. For every plug-in cycle — from plugging in to unplugging — ChargeDoc records one charging session. That is the same logic myenergi uses to count a session.

Documented per session:

• Energy charged in kWh
• Start and end time of the plug-in cycle
• Electricity costs based on your configured rate
• Current charging power in the live status while charging

The zappi has no lifetime energy meter the app could read. That's why ChargeDoc derives sessions from the plug-in cycle instead of from a meter reading.

During setup the app also reconstructs the last 7 days from myenergi's minute-by-minute data, so you don't start from zero. That data carries no plug status: a charge with long pauses can therefore appear as several entries, and two charges directly after each other can merge into one. For exact plug-in cycles, and for periods further back, 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 live connection reports no solar share for an individual session. Sessions recorded automatically are therefore booked entirely as grid energy — conservative rather than estimated.

You add the solar share 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 solar kilowatt-hours myenergi reports are taken over unchanged and labelled that way: as reported, 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.

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:

• Live, 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 added from the myenergi export. Only there do you see how many kilowatt-hours came from your PV surplus.

In practice: after the import, 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 and default vehicle.

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.

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

5. Add the solar share

After a few charges, download the CSV export from the myenergi portal and import it via "Import myenergi export" on the zappi detail screen. From then on your reports show which share came from your own roof.

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
• 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. Especially for solar households with a company car, the clean split between grid and self-generated energy is the heart of the evidence: what gets reimbursed is what actually cost you money.