Etsy
Diese Integration ist in Frihet verfügbar. Konfiguriere sie unter Einstellungen → Integrationen → Etsy.
Verbinde deinen Etsy-Shop mit Frihet, um Bestellungen, Produkte und Käuferdaten automatisch zu importieren. Etsy ist der führende Marktplatz für handgemachte, Vintage- und kreative Produkte mit über 90 Millionen aktiven Käufern. Mit dieser Integration wird jeder Verkauf in deinem Etsy-Shop als Einnahme in Frihet erfasst, Etsy-Provisionen werden als Ausgaben verbucht und internationale Verkäufe werden mit automatischer Währungsumrechnung verwaltet.
Wofür ist es gut?
- Bestellungen importieren — Jeder Verkauf auf Etsy wird automatisch zu einer in Frihet registrierten Einnahme mit allen Bestelldetails.
- Provisionen und Gebühren als Ausgaben — Etsy-Einstell-, Transaktions- und Bearbeitungsgebühren werden automatisch als Ausgaben erfasst.
- Synchronisierter Katalog — Deine Etsy-Produkte spiegeln sich im Frihet-Katalog wider.
- Mehrwährung — Internationale Verkäufe werden mit ihrer ursprünglichen Währung und dem Wechselkurs importiert.
- Importierte Kunden — Etsy-Käufer werden als Kunden in Frihet mit ihren Versanddaten hinzugefügt.
Voraussetzungen
- Aktives Verkäuferkonto bei Etsy
- Frihet Pro oder Business Plan
- Etsy API-Schlüssel (erhältlich über das Etsy Developer Portal)
Wie man verbindet
Schritt 1: Eine Anwendung in Etsy erstellen
- Gehe zum Etsy Developer Portal
- Melde dich mit deinem Verkäuferkonto an
- Klicke auf Create a New App
- Gib den Namen ("Frihet ERP") und die Beschreibung ein
- Sobald die Anwendung genehmigt wurde, kopiere den API-Schlüssel (Keystring)
Schritt 2: In Frihet konfigurieren
- Gehe in Frihet zu Einstellungen → Integrationen
- Suche Etsy und klicke auf die Karte
- Füge deinen API-Schlüssel in das entsprechende Feld ein
- Klicke auf Mit Etsy verbinden, um den Zugriff per OAuth zu autorisieren
- Akzeptiere die angeforderten Berechtigungen im Etsy-Fenster
- Klicke auf Speichern
Schritt 3: Erstimport
- Nach der Verbindung klicke auf Bestellungen importieren, um den Verkaufsverlauf abzurufen
- Wähle den Datumsbereich aus, den du importieren möchtest
- Überprüfe die importierten Bestellungen und stelle sicher, dass die Daten korrekt sind
Synchronisierte Daten
| Datenpunkt | Richtung | Details |
|---|---|---|
| Bestellungen | Etsy → Frihet | ID, Betrag, Datum, Produkte, Lieferadresse |
| Produkte | Etsy → Frihet | Name, Preis, Menge, Varianten |
| Kunden | Etsy → Frihet | Käufername, E-Mail (falls verfügbar), Adresse |
| Provisionen | Etsy → Frihet | Listing fees, Transaktionsgebühren, Zahlungsbearbeitungsgebühren als Ausgaben |
| Währung | Etsy → Frihet | Ursprüngliche Verkaufswährung mit Wechselkurs |
| Bestellstatus | Etsy → Frihet | Bezahlt, versendet, abgeschlossen, erstattet |
Anwendungsfälle
Handwerker mit internationalen Verkäufen
Du verkaufst handgemachten Schmuck auf Etsy an Käufer weltweit. Jeder Verkauf wird mit der ursprünglichen Währung (USD, GBP, EUR) und dem tatsächlichen Wechselkurs in Frihet importiert. Etsy-Provisionen werden automatisch als Ausgaben erfasst, wodurch du eine klare Übersicht über die tatsächliche Marge jedes Verkaufs erhältst. Am Ende des Quartals hast du alle Daten für deine Steuererklärung.
Verkäufer von Vintage-Produkten
Du verwaltest einen großen Katalog von Vintage-Produkten auf Etsy. Jeder Verkauf aktualisiert deinen Katalog in Frihet und erfasst die Einnahme. Du kannst Rentabilitätsberichte pro Produkt erstellen und sehen, welche Produktkategorien nach Abzug der Etsy-Provisionen die beste Marge aufweisen.
Digitaler Künstler mit Downloads
Du verkaufst Vorlagen, Illustrationen oder digitale Ressourcen auf Etsy. Die Verkäufe werden automatisch ohne manuelles Eingreifen importiert. Da es bei digitalen Produkten keine Versandkosten gibt, kannst du die Nettomarge genau verfolgen: Verkaufspreis abzüglich Etsy-Provisionen.
Fehlerbehebung
Verbindungsfehler
- Überprüfe, ob der API-Schlüssel korrekt ist und die Anwendung im Etsy Developer Portal aktiv ist
- Überprüfe, ob die OAuth-Autorisierung nicht abgelaufen ist — verbinde dich bei Bedarf über die Einstellungen erneut
- Stelle sicher, dass dein Etsy-Konto in gutem Zustand ist (nicht gesperrt oder eingeschränkt)
Bestellungen werden nicht importiert
- Bestätige, dass du Verkäufe im ausgewählten Datumsbereich hast
- Es werden nur Bestellungen mit abgeschlossener Zahlung importiert — ausstehende Zahlungen werden ausgeschlossen
- Wenn du viele Bestellungen hast, kann der Import einige Minuten dauern — warte, bis er abgeschlossen ist
Provisionen nicht erfasst
- Die Provisionen werden als separate Ausgaben importiert, die der entsprechenden Bestellung zugeordnet sind
- Überprüfe, ob der Provisionsimport in den Integrationseinstellungen aktiviert ist
- Die Werbeprovisionen von Etsy (Etsy Ads) werden separat importiert
Falsche Währung
- Frihet verwendet die ursprüngliche Transaktionswährung auf Etsy
- Wenn deine Buchhaltung in EUR ist und der Verkauf in USD erfolgte, wendet Frihet den Wechselkurs des Transaktionstages an
- Du kannst den Wechselkurs manuell in den Details der Ausgabe/Einnahme anpassen