Etsy → SevDesk CSV Bridge · Beta

Zweck: Diese Anwendung wandelt Etsy-Exportdaten in ein SevDesk-kompatibles CSV-Format um. Sie verknüpft Verkäufe mit Kundennamen, gruppiert Gebühren/Marketingkosten, addiert Steuern und erzeugt die Importdatei sevdesk_import_MM_JJJJ_v1.0.11.csv.

Benötigte Dateien & Namenskonventionen

• Etsy Statement (monatliche Transaktionen), z. B. etsy_statement_2025_9.csv
• Etsy Sold Orders (Bestellungen mit Namen), z. B. EtsySoldOrders2025-9.csv
• Wichtig: 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

1. Verarbeitung erfolgt ausschließlich serverseitig.
2. Verknüpfung Verkäufe: „Payment for Order #…“ aus dem Statement wird mit „Order ID“ aus den Sold Orders gematcht (Kundenname = „Full Name“).
3. Gebühren werden gesammelt und nach Typen gruppiert (Listing/Transaction/Renew/Processing, Marketing: Offsite Ads). Umsatzsteuer auf Etsy-Gebühren wird separat ausgewiesen.
4. Datumsformate werden robust nach dd.mm.yyyy normalisiert.
5. Export-Dateiname: sevdesk_import_MM_JJJJ_v1.0.11.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 durch PHP/OS automatisch gemäß Serverkonfiguration 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.

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.