Square mit XPRIO verbinden

Square ist die erste mit XPRIO verbundene Kasse. Die Verbindung nutzt Ihr eigenes Square-Konto, dauert wenige Minuten und läuft über keinen Marktplatz. Diese Anleitung setzt voraus, dass Sie das allgemeine Prinzip gelesen haben. Meine Kasse (POS) mit XPRIO verbinden

Was Sie wissen sollten

Square berechnet 1 % pro Bestellung, die außerhalb von Square bezahlt wird. Die Gebühr wird Ihrem Square-Entwicklerkonto belastet und geht nicht an XPRIO. Das ist der Square-Tarif für jede von einer Drittanwendung angelegte und anderswo bezahlte Bestellung. XPRIO erhebt nichts.
Square zeigt eine Bestellung erst an, wenn sie bezahlt ist. Eine online bezahlte Bestellung kommt daher als bezahlt markiert an. Eine Bestellung mit Bar- oder Kartenzahlung bei Lieferung kommt beim Senden ebenfalls als bezahlt markiert an, mit einem Hinweis auf die Zahlungsart: Sie kassieren beim Kunden, ohne die Zahlung erneut zu erfassen. Die Option „An der Kasse kassieren“ gibt es bei Square nicht.
Ihre Lieferungen erscheinen als „Versand“-Bestellungen mit der Adresse des Kunden, Ihre Abholungen als Abholungen mit der geplanten Uhrzeit. Square behält den Typ „Lieferung“ zertifizierten Partnern vor; die Information ist dieselbe, nur die Bezeichnung ändert sich.
Rückerstattungen werden übernommen. Eine in XPRIO vorgenommene vollständige oder teilweise Rückerstattung wird in Square mit genau demselben Betrag verbucht.
Ausverkauft-Markierungen gehen von Square zu XPRIO, nicht umgekehrt: „Ausverkauft“ wird an der Square-Kasse gesetzt, die API erlaubt das nicht von außen.
Es gibt eine Testumgebung: Square stellt ein kostenloses Sandbox-Konto bereit, um alles auszuprobieren, ohne Ihre echte Kasse zu berühren.

Schritt 1: Ihr Square-Zugriffstoken erstellen

Melden Sie sich auf developer.squareup.com mit Ihrem gewohnten Square-Konto an.
Klicken Sie auf + New application (oder öffnen Sie eine bestehende Anwendung). Der Name ist frei wählbar, zum Beispiel „XPRIO“.
Öffnen Sie in der Anwendung Credentials. Oben auf der Seite wechselt ein Schalter zwischen Sandbox und Production: Wählen Sie Production für Ihre echte Kasse.
Kopieren Sie das Production Access Token (Schaltfläche Show, dann kopieren). Teilen Sie es mit niemandem; XPRIO verschlüsselt es und zeigt es nie wieder an.

Für einen risikofreien Test bleiben Sie bei Sandbox: Das Sandbox Access Token wird mit aktiviertem Schalter Testmodus in XPRIO eingefügt, und das Testdashboard finden Sie auf developer.squareup.com, Bereich Sandbox test accounts.

Schritt 2: In XPRIO verbinden

Menü App-Konfiguration, Kasse (POS), wählen Sie den Betrieb, dann Verbinden auf der Square-Karte.
Aktivieren Sie Testmodus (Sandbox), wenn Sie ein Sandbox-Token einfügen; lassen Sie ihn für Ihre echte Kasse deaktiviert.
Fügen Sie das Token in Produktions-Zugriffstoken ein und klicken Sie auf Speichern und testen.
Wählen Sie den Standort (Square Location) dieses Betriebs, dann Aktivieren.

XPRIO legt in Square einmalig an, was es braucht, um Bestellungen als bezahlt zu markieren, und liest anschließend Ihren Square-Katalog: Artikel, Variationen, Modifikatorlisten, Kategorien.

Schritt 3: Die Artikel

Folgen Sie der Box Nächster Schritt der Karte: Import der Square-Artikel in XPRIO, wenn Ihre Speisekarte noch nicht in XPRIO ist, Senden Ihrer XPRIO-Speisekarte an Square, wenn Ihr Square-Katalog leer ist, oder Zuordnung. Bei Square erfolgt die Verknüpfung über den SKU jeder Variation: Setzen Sie diesen SKU als PLU Ihres XPRIO-Produkts, und alles verknüpft sich von selbst. Artikelzuordnung zwischen XPRIO und meiner Kasse

Zwei Square-Besonderheiten:

Jeder Square-Artikel hat mindestens eine Variation, auch ohne Größe oder Geschmacksrichtung: Ein einfaches XPRIO-Produkt verknüpft sich mit dieser einzigen Variation, das ist normal;
Square kennt keine Meal Deals: Ein XPRIO-Meal-Deal wird mit einem Square-Artikel „Menü“ Ihrer Wahl verknüpft, und seine Bestandteile erscheinen als Modifikatoren.

Schritt 4: Testbestellung, dann echte Bestellungen

Testbestellung senden legt in Square eine als Test markierte Bestellung namens „XPRIO“ an. Öffnen Sie Square (Dashboard oder Point-of-Sale-App): Sie erscheint unter den Bestellungen, als bezahlt markiert und mit ihrem Hinweis. Erscheint sie, folgen Ihre echten Bestellungen demselben Weg.

In Square trägt eine XPRIO-Bestellung:

den Ticketnamen XPRIO-Nummer und den Modus (Abholung, Lieferung, vor Ort);
die Positionen mit der verknüpften Variation, verknüpften oder freien Modifikatoren, Rabatten und Liefergebühren;
die Zahlung, verzeichnet als externe Zahlung „XPRIO“ bei einer online bezahlten Bestellung oder als Barzahlung bei einer bar bezahlten Bestellung;
bei einer Abholung die geplante Uhrzeit und den Namen des Kunden; bei einer Lieferung die vollständige Adresse.

Häufig gestellte Fragen

Der Verbindungstest schlägt fehl. Meist wurde ein Sandbox-Token ohne Testmodus eingefügt (oder umgekehrt) oder das Token mit einem Leerzeichen kopiert. Erzeugen Sie es im Zweifel in Credentials neu.

Die Testbestellung erscheint nicht in Square. Prüfen Sie, ob die Point-of-Sale-App am selben Standort angemeldet ist, der in XPRIO gewählt wurde, und ob die Bestellung nicht herausgefiltert wird: Square führt sie unter den offenen Bestellungen, nicht unter den Tagesverkäufen, bis sie abgeschlossen ist.

Kann ich meine Thekenverkäufe wie bisher behalten? Ja. XPRIO fügt nur Bestellungen hinzu und liest den Katalog. Für den Rest Ihrer Square-Aktivität ändert sich nichts.

Wie trenne ich die Verbindung? Über die Schaltfläche Trennen auf der Karte. Die Artikelverknüpfungen werden auf XPRIO-Seite entfernt; in Square wird nichts gelöscht.