¶ Allgemein Informationen
¶ Hier gehts zur App
https://kanuracer.eu/tools/csv/
¶ Hier gehts zum Changelog
https://wiki.kanuracer.eu/de/dokumentationen/ledgerflow-csv-converter/changelog
¶ Zweck
Diese Anwendung wandelt Marketplace-Exportdaten in ein CSV-Format für die Weiterverarbeitung in einer Buchhaltungssoftware (z. B. SevDesk) um. Sie verknüpft Verkäufe mit Kundennamen, gruppiert Gebühren/Marketingkosten, addiert Steuern und erzeugt die Importdatei sevdesk_import_MM_JJJJ_{$version}.csv.
¶ Benötigte Dateien & Namenskonventionen
-
Etsy Statement (monatliche Transaktionen), z. B. etsy_statement_2025_9.csv diese findest du hier: https://www.etsy.com/your/account/payments/monthly-statement?ref=seller-platform-mcnav
-
Etsy Sold Orders (Bestellungen mit Namen), z. B. EtsySoldOrders2025-9.csv diese findest du hier: https://www.etsy.com/your/shops/me/download
Achtung: Die Dateinamen dürfen nicht umbenannt werden. Monat/Jahr werden aus dem Dateinamen ausgelesen und zwischen beiden Dateien abgeglichen. Abweichungen führen zu einem Fehler.
- Die maximal zulässige Dateigröße wird direkt im Formular angezeigt (Serverlimit).
¶ So arbeitet die App
- Verarbeitung erfolgt ausschließlich serverseitig.
- Verknüpfung Verkäufe: „Payment for Order #…“ aus dem Statement wird mit „Order ID“ aus den Sold Orders gematcht (Kundenname = „Full Name“).
- Gebühren werden gesammelt und nach Typen gruppiert (Listing/Transaction/Renew/Processing, Marketing: Offsite Ads). Umsatzsteuer auf Etsy-Gebühren wird separat ausgewiesen.
- Datumsformate werden robust nach dd.mm.yyyy normalisiert.
- Export-Dateiname: sevdesk_import_MM_JJJJ_{$version}.csv (Monat zweistellig).
¶ Speicherung & Verarbeitung (Datenschutz / DSGVO)
- Datei-Uploads: CSVs werden von PHP im temporären Upload-Verzeichnis abgelegt und im Skript direkt gelesen. Temporäre Upload-Dateien werden gemäß PHP- und Serverkonfiguration automatisch entfernt.
- Keine dauerhafte Speicherung: Es werden keine hochgeladenen Dateien persistiert, keine Datenbanken verwendet und keine Inhalte an Dritte übermittelt.
- Session-Zwischenspeicher: Das erzeugte CSV wird zur Bereitstellung des Downloads kurzzeitig in der Session abgelegt. Beim Klick auf CSV herunterladen werden die zwischengespeicherten Daten bereinigt (Session-Einträge gelöscht; evtl. temporäre Datei entfernt).
- Protokolle: Übliche Webserver-Access-Logs (IP/Datum/URL/HTTP-Status) können anfallen; CSV-Inhalte werden nicht geloggt.
¶ Aufbewahrungsdauer
- Session-Inhalt: bis zum Ende der Session bzw. bis zum Download (dann Bereinigung). Serverseitig werden Sessions zusätzlich durch die PHP-Garbage-Collection gemäß session.gc_maxlifetime aufgeräumt.
- Temporäre Uploads: durch PHP/OS automatisch entfernt (konfigurationsabhängig, i. d. R. zeitnah).
¶ Cookies
- PHPSESSID – technisch notwendig. Zweck: Zuordnung deiner Session (z. B. für den Download). Laufzeit: i. d. R. bis zum Schließen des Browsers oder gemäß Serverkonfiguration. Typ: First-Party. Kein Tracking.
- ppd_sid_v2 – kann ggf. zusätzlich von deiner Hosting-/Proxy-Umgebung gesetzt werden (nicht von der Anwendung selbst). Zweck: technische Sitzung/Lastverteilung. Laufzeit: i. d. R. sitzungsbasiert bzw. hosterabhängig.
- Weitere Cookies werden von dieser Anwendung nicht gesetzt.
¶ Sicherheit & Empfehlungen
- Auslieferung über HTTPS verwenden.
- Exportdateien vertraulich behandeln und bei Bedarf lokal löschen.
- Browser schließen, um die Session zu beenden.
¶ Haftungsausschluss
Die Nutzung erfolgt auf eigenes Risiko. Es wird keine Gewähr für die Richtigkeit, Vollständigkeit oder Eignung der erzeugten CSV-Datei für deinen konkreten Anwendungsfall übernommen. Prüfe die Ergebnisse vor dem Import in SevDesk. Für mittelbare oder unmittelbare Schäden, die aus der Nutzung entstehen, wird – soweit gesetzlich zulässig – keine Haftung übernommen.
Hinweis: Diese Anwendung steht in keinerlei Verbindung zu Etsy oder SevDesk. Es besteht keine Kooperation, Partnerschaft oder sonstige geschäftliche Beziehung zu diesen Unternehmen. Die Marken- und Produktnamen „Etsy“ und „SevDesk“ werden ausschließlich zur eindeutigen Beschreibung der Dateiformate bzw. Kompatibilität verwendet.
¶ Fehlerbehebung
- „Unterschiedliche Zeiträume“: Stelle sicher, dass beide Dateien aus demselben Monat/Jahr stammen und nicht umbenannt wurden.
- „Spalten nicht gefunden“: Nutze die unveränderten Etsy-Exporte. Erwartete Header beinhalten u. a. Order ID, Full Name (Sold Orders) sowie Art/Titel/Info/Betrag/Netto (Statement) bzw. deren englische Pendants.
¶ Selber Hosten
SOON