Zum Hauptinhalt springen

Square

Verfügbar

Diese Integration ist in Frihet verfügbar. Konfigurieren Sie sie unter Settings → Integrationen → Square.

Verbinden Sie Ihr Square-Konto mit Frihet, um Transaktionen und Zahlungen von Ihrem Point-of-Sale automatisch zu importieren. Square ist eine Zahlungsplattform, die POS-Terminals, Online-Zahlungen und Bestandsverwaltung umfasst. Mit dieser Integration wird jeder in Square registrierte Verkauf als Einnahme in Frihet importiert, wodurch die manuelle Eingabe entfällt und Ihre Buchhaltung mit Präsenz- und Online-Verkäufen synchronisiert bleibt.

Wofür ist das nützlich?​

  • Transaktionen importieren — Jede in Square verarbeitete Zahlung (TPV, online, Rechnung) wird als Einnahme mit allen Details in Frihet importiert.
  • Automatische Abstimmung — Gleichen Sie Square-Zahlungen mühelos mit Ihren Rechnungen in Frihet ab.
  • Synchronisierte Kunden — In Square registrierte Kunden werden in Ihre Kontaktdatenbank in Frihet importiert.
  • Gebühren als Ausgaben — Die von Square für jede Transaktion erhobenen Gebühren werden automatisch als Ausgaben in Frihet erfasst.
  • Vollständiger Verlauf — Importieren Sie vergangene Transaktionen, um einen vollständigen Überblick über Ihre Geschäftsaktivitäten zu erhalten.

Anforderungen​

  • Aktives Konto bei Square
  • Frihet Pro- oder Business-Plan
  • Square API Access Token (wird über das Square Developer Dashboard bezogen)

Verbindung herstellen​

Schritt 1: Ihren Access Token in Square erhalten​

  1. Melden Sie sich bei developer.squareup.com an.
  2. Erstellen Sie eine neue Anwendung oder wählen Sie eine bestehende aus.
  3. Navigieren Sie im Anwendungs-Dashboard zu Credentials.
  4. Kopieren Sie den Production Access Token (verwenden Sie nicht den Sandbox-Token für reale Daten).
  5. Stellen Sie sicher, dass der Token Leseberechtigungen für Payments, Orders und Customers hat.

Schritt 2: In Frihet konfigurieren​

  1. Gehen Sie in Frihet zu Settings → Integrationen.
  2. Suchen Sie nach Square und klicken Sie auf die Karte.
  3. Fügen Sie Ihren Access Token in das entsprechende Feld ein.
  4. Klicken Sie auf Verbindung testen, um zu überprüfen, ob die Anmeldeinformationen korrekt sind.
  5. Wählen Sie den Square-Standort (location) aus, den Sie synchronisieren möchten.
  6. Klicken Sie auf Speichern.

Synchronisierte Daten​

DatenRichtungDetails
Transaktionen/ZahlungenSquare → FrihetBetrag, Datum, Zahlungsmethode, Referenz
KundenSquare → FrihetName, E-Mail, Telefon des Käufers
GebührenSquare → FrihetAls Ausgaben registrierte Square-Gebühren
Verkaufte ProdukteSquare → FrihetDetailpositionen jeder Transaktion
ZahlungsstatusSquare → FrihetAbgeschlossen, erstattet, ausstehend

Anwendungsfälle​

Physisches Geschäft mit digitaler Buchhaltung​

Sie betreiben ein Geschäft und kassieren mit dem Square-Terminal. Jeder Tagesverkauf wird nachts automatisch in Frihet importiert. Ihre Buchhaltung spiegelt alle Präsenzverkäufe wider, ohne dass Sie etwas manuell kopieren müssen. Die Square-Gebühren erscheinen als Ausgaben, damit Sie Ihre reale Marge sehen können.

Unternehmen mit Präsenz- und Online-Verkäufen​

Sie verkaufen sowohl im Geschäft mit Square als auch über Ihre Website. Frihet konsolidiert die Square-Transaktionen mit Ihren Online-Rechnungen, um Ihnen eine einheitliche Ansicht aller Ihrer Einnahmen zu bieten. Sie können Steuerberichte mit allen zentralisierten Einnahmequellen erstellen.

Freiberufler mit mobiler Zahlungsabwicklung​

Sie sind Freiberufler und kassieren Ihre Kunden mit Square auf dem Handy (Veranstaltungen, Heimdienste, Märkte). Jede Zahlung wird automatisch in Frihet mit den Details der Dienstleistung erfasst, damit Ihre Buchhaltung auf dem neuesten Stand ist, ohne zusätzliche Zeit aufwenden zu müssen.

Fehlerbehebung​

Verbindungsfehler​

  • Vergewissern Sie sich, dass Sie den Production Access Token und nicht den Sandbox-Token verwenden.
  • Überprüfen Sie, ob der Token im Developer Dashboard nicht abgelaufen oder widerrufen wurde.
  • Stellen Sie sicher, dass die Square-Anwendung die erforderlichen Berechtigungen hat (Payments Read, Orders Read, Customers Read).

Transaktionen werden nicht importiert​

  • Bestätigen Sie, dass Sie Transaktionen im ausgewählten Datumsbereich haben.
  • Es werden nur Transaktionen mit dem Status abgeschlossen importiert — ausstehende oder stornierte Transaktionen sind ausgeschlossen.
  • Überprüfen Sie, ob Sie den korrekten Square-Standort (location) ausgewählt haben.

Doppelte Transaktionen​

  • Frihet dedupliziert anhand der Square-Transaktions-ID. Duplikate sollten nicht auftreten.
  • Wenn Sie Duplikate sehen, trennen Sie die Integration und verbinden Sie sie erneut.
  • Bereits in Frihet importierte Transaktionen sind von der erneuten Verbindung nicht betroffen.

Nicht erfasste Gebühren​

  • Gebühren werden als separate Ausgaben erfasst und nicht vom Transaktionsbetrag abgezogen.
  • Überprüfen Sie, ob der Gebührenimport in den Integrationseinstellungen aktiviert ist.

Nächste Schritte​