Zum Hauptinhalt springen

Square mit XPRIO verbinden

Erstellen Sie Ihr Square-Zugriffstoken, fügen Sie es in XPRIO ein, wählen Sie Ihren Standort: Ihre XPRIO-Bestellungen kommen bezahlt in Square an, mit dem Abholmodus oder der Lieferadresse, und ausverkaufte Artikel bei Square werden in Ihrer App übernomme

Verfasst von XPRIO

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, auf Ihrem Square-Entwicklerkonto, nicht an XPRIO. Das ist der Square-Tarif für jede von einer Drittanwendung angelegte und anderswo bezahlte Bestellung. XPRIO nimmt nichts.

  • Square zeigt eine Bestellung erst an, wenn sie bezahlt ist. Eine online bezahlte Bestellung kommt daher als bezahlt markiert an. Eine Bar- oder Kartenzahlung-bei-Lieferung-Bestellung kommt beim Senden bereits als bezahlt markiert an, mit einem Hinweis auf die Zahlungsart: Sie kassieren den Kunden, ohne sie erneut einzugeben. Die Einstellung „Von der Kasse kassieren lassen" 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 reserviert seinen Typ „Lieferung" zertifizierten Partnern; die Information ist dieselbe, nur die Bezeichnung ändert sich.

  • Rückerstattungen werden übernommen. Eine vollständige oder teilweise, in XPRIO vorgenommene Rückerstattung wird in Square für genau denselben Betrag verzeichnet.

  • Ausverkauft-Markierungen gehen von Square zu XPRIO, nicht umgekehrt: „Ausverkauft" wird auf 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

  1. Melden Sie sich auf developer.squareup.com mit Ihrem gewohnten Square-Konto an.

  2. Klicken Sie auf + New application (oder öffnen Sie eine bestehende Anwendung). Der Name ist frei wählbar, zum Beispiel „XPRIO".

  3. Öffnen Sie in der Anwendung Credentials. Oben auf der Seite schaltet ein Schalter zwischen Sandbox und Production um: Wählen Sie Production für Ihre echte Kasse.

  4. 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 in developer.squareup.com, Bereich Sandbox test accounts.

Schritt 2: in XPRIO verbinden

  1. Menü App-Konfiguration, Kasse (POS), wählen Sie das Geschäft, dann Verbinden auf der Square-Karte.

  2. Aktivieren Sie Testmodus (Sandbox), wenn Sie ein Sandbox-Token einfügen; lassen Sie ihn für Ihre echte Kasse deaktiviert.

  3. Fügen Sie das Token in Produktions-Zugriffstoken ein und klicken Sie auf Speichern und testen.

  4. Wählen Sie den Standort (Square Location) dieses Geschäfts, 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 dort 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 ist unter den Bestellungen, bezahlt, 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 Bargeld bei einer Barzahlungsbestellung;

  • 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 liegt es an einem ohne Testmodus eingefügten Sandbox-Token oder umgekehrt, oder an einem mit einem Leerzeichen kopierten Token. 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 Tresenverkä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? Schaltfläche Trennen auf der Karte. Die Artikelverknüpfungen werden auf XPRIO-Seite entfernt; in Square wird nichts gelöscht.

Verwandte Artikel

Hat dies deine Frage beantwortet?