🔗 Integrationen

Shopify

Viele Geschäfte nutzen Circle-Hand zusammen mit Shopify – für den Onlineshop und als Kassensystem. Als offizieller Shopify-Partner bieten wir eine direkte Integration, damit deine Abläufe und Artikeldaten zuverlässig ineinandergreifen.

29. September 2026

  1. Shopify-Konto erstellen

  1. Erstelle ein Shopify-Konto. Für viele Geschäfte reicht Shopify Basic mit POS Lite aus.

  2. Lade Shopify POS für dein Smartphone oder Tablet herunter (Apple / Android).

  3. Optional: Besorge dir ein Shopify-Kartenlesegerät oder nutze einen anderen Anbieter, etwa SumUp oder deine Hausbank. Alternativ kannst du Tap to Pay verwenden.

Hier findest du eine Videoanleitung für die erste Einrichtung von Shopify POS mit Circle-Hand.


  1. Shopify verbinden

  1. Gehe zu Einstellungen > Shopify und klicke auf „Verbinden“.

  2. Nach der Installation von Circle-Hand erscheint in Shopify die Kalenderansicht. Du kannst anschließend hier zu Circle-Hand zurückkehren: https://next.app.circle-hand.com/


  1. Artikeldaten synchronisieren

Sobald die Circle-Hand-App in deinem Shopify-Shop installiert ist, werden alle Artikel an Shopify übertragen.

  • Artikel, die du in Shopify verkaufst, werden in Circle-Hand automatisch als „Verkauft (Auszahlung ausstehend)“ markiert.

  • Auch Änderungen an bestehenden Artikeln in Circle-Hand werden an Shopify übertragen. Wenn du ein Attribut bearbeitest, werden sofort alle Attribute und Tags des Artikels aktualisiert.

  • Preis, Vergleichspreis, Rabatte und Titel werden auch von Shopify zurück an Circle-Hand übertragen. Wir empfehlen trotzdem, Artikel grundsätzlich in Circle-Hand zu bearbeiten.

So überträgst du Metafelder und Tags an Shopify:


Zuordnung der Datenfelder

Die Artikeldaten werden wie folgt zugeordnet:

  • Titel: Wird als Produkttitel in Shopify verwendet.

  • Bilder: Werden als Produktbilder in Shopify übernommen.

  • Preis: Wird mit dem Preisfeld in Shopify abgeglichen.

  • Marke: Wird im Shopify-Feld „Anbieter“ (Vendor) gespeichert.

  • Kategorie: Wird als Produkttyp in Shopify übernommen.

  • Kategorie (Shopify): Wird mit der Shopify-Produktkategorie abgeglichen.

  • Beschreibung: Wird mitsamt der Textformatierung als Produktbeschreibung in Shopify übernommen.

  • Barcode: Wird in das Barcode-Feld in Shopify übertragen. Du kannst zusätzlich aktivieren, dass der Barcode auch als Shopify-SKU verwendet wird.

  • SKU: Wird in das SKU-Feld in Shopify übertragen.

  • Veröffentlichungsstatus: „Nur im Laden“ überträgt den Artikel an Shopify POS. „Laden + Onlineshop“ veröffentlicht ihn zusätzlich im Shopify-Onlineshop.

    Hinweis: Wenn du einen Artikel in Circle-Hand auf „Ausstehend“, „An Lieferkund:in zurückgegeben“, „Abgeholt“, „Gespendet“ oder „Entsorgt“ setzt, wird der Vertriebskanal automatisch auf „Nur POS“ geändert.

  • Vergleichspreis: Wird als Vergleichspreis in Shopify übernommen. Viele Geschäfte tragen hier den ursprünglichen Neupreis ein.

  • Artikel löschen: Wenn du einen Artikel in Circle-Hand löschst, wird er auch in Shopify gelöscht.


Tags verwenden

Unter Einstellungen → Shopify → „Attribute als Tags senden“ kannst du die Übertragung von Artikelattributen als Tags ein- oder ausschalten. Ist die Funktion aktiv, werden alle ausgefüllten Felder im Format CH-Attribut-Wert übertragen. Zum Beispiel:

  • CH-color-[eingetragene Farbe] – bei „green“ lautet der Shopify-Tag also „CH-color-green“.

  • Unter Einstellungen > Shopify kannst du das Präfix „CH-“ deaktivieren. Dann wird zum Beispiel „Green“ statt „CH-color-green“ übertragen.


Eigene Metafelder und Tags

Aktiviere unter Einstellungen > Geschäft > Attribute die Option „Eigene Tags/Metafelder“. Anschließend kannst du pro Artikel eigene Tags wie „Archiv“ oder „Frühling2026“ ergänzen.

Unter Einstellungen > Geschäft > Eigene Attribute kannst du außerdem eigene Metafelder anlegen. Ein Attribut namens „Origin“ wird in Shopify zum Beispiel als custom.origin gespeichert. So kannst du deine bereits vorhandenen Metafelder in Shopify weiterverwenden. Definiere sie dort als einzeiligen Text.


Mehr Flexibilität mit Metafeldern

Am einfachsten legst du zunächst in Circle-Hand einen Artikel mit allen gewünschten Attributen an. Anschließend kannst du die dazugehörigen Metafelder in Shopify definieren.

Die folgenden Metafelder kannst du als einzeiligen Text definieren:

  • circle-hand.color

  • circle-hand.size

  • circle-hand.material

  • circle-hand.condition

  • circle-hand.gender

  • circle-hand.brand

  • circle-hand.location

  • circle-hand.age_group

  • circle-hand.seasons (mit „s“ am Ende)

Die folgenden Metafelder kannst du als mehrzeiligen Text definieren:

  • circle-hand.measurements

  • circle-hand.season (ohne „s“ am Ende)


  1. Rückerstattungen aus Shopify

Bearbeite Rückerstattungen direkt in Shopify POS oder im Onlineshop. Sie werden automatisch mit Circle-Hand abgeglichen. Aktiviere dabei unbedingt das Kontrollkästchen „Artikel wieder einlagern“, damit die Rückerstattung korrekt übertragen wird.


  1. Mehrere Standorte

Unter Circle-Hand > Einstellungen > Geschäft > Standorte kannst du deine Standorte den entsprechenden Shopify-Standorten zuordnen.

Aktiviere unter Einstellungen > Geschäft > Attribute das Feld „Geschäftsstandort“. Dann kannst du den Standort pro Artikel festlegen. Zum Ändern hast du zwei Möglichkeiten:

  1. Mehrere Artikel auf einmal: Nutze die Barcode-Scan-Funktion in Circle-Hand und wähle Verwalten > Sammelbearbeitung > Geschäftsstandort.

  2. Einzelnen Artikel bearbeiten: Ändere den Standort direkt im jeweiligen Artikel.

Wichtig bei der Nutzung mehrerer Shopify-POS-Standorte

Wenn du einen Artikel an einen anderen Shopify-POS-Standort bringst, aktualisiere den Standort auch in Circle-Hand. Verkaufst du ihn, ohne vorher den Standort zu ändern, zeigt Shopify anschließend
−1 am neuen Standort, an dem der Verkauf tatsächlich stattgefunden hat, und +1 am ursprünglichen Standort, an dem der Artikel gar nicht mehr liegt. Dadurch kann der Artikel im Onlineshop weiterhin als verfügbar erscheinen, obwohl er bereits verkauft wurde.

Wenn du an verschiedenen Shopify-POS-Standorten verkaufen möchtest, ohne den Standort jedes Mal zu ändern, gibt es zwei Möglichkeiten: (1) Ergänze bei deinen Shopify-Kollektionen die Bedingung „Lagerbestand ist größer als 0“. Kollektionen berechnen den Bestand standortübergreifend: +1 − 1 = 0. So wird der Artikel online nicht mehr angezeigt. (2) Nutze Shopify Flow, um Artikel mit einem Bestand von −1 automatisch aus dem Onlineshop zu entfernen.


  1. Häufige Fragen zu Shopify

Beim Anmelden wird mir der Buchungskalender angezeigt

Du kannst Circle-Hand jederzeit direkt über den persönlichen Anmeldelink aus deiner E-Mail öffnen: https://next.app.circle-hand.com/


Wie verwende ich Shopify-Kategorien?

Die meisten Geschäfte verwenden den Shopify-Produkttyp als Kategorie. Das bietet mehr Flexibilität als die Shopify-Produktkategorien, etwa für automatische Kollektionen oder den Abgleich mit Marktplätzen.

Wenn du lieber die nativen Shopify-Kategorien nutzen möchtest, zum Beispiel aus steuerlichen Gründen, aktiviere in Circle-Hand unter Einstellungen > Store > Attribute das Feld „Kategorie (Shopify)“.


Wie füge ich eigene Zahlungsmethoden wie SumUp in Shopify POS hinzu?

1. Füge SumUp in Shopify POS als benutzerdefinierte Zahlungsmethode hinzu. Hier findest du die Anleitung.

So läuft ein Verkauf ab:

  1. Öffne Shopify POS auf deinem Smartphone oder Tablet.

  2. Scanne den Barcode in Shopify POS.

  3. Wähle bei Barzahlung „Bar“ und bei Kartenzahlung „SumUp“.

  4. Bei Kartenzahlung gibst du den Betrag anschließend in dein SumUp-Kartenlesegerät ein.

So bleiben Circle-Hand und Shopify in Echtzeit synchron. Falls es bei dir nicht klappt, melde dich bei uns. Wir können dir den Ablauf in einem kurzen Video Schritt für Schritt zeigen.


Wie lege ich Shopify-Varianten an?

Du kannst Varianten in Shopify anlegen; sie werden anschließend an Circle-Hand übertragen. Für Eigenschaften wie Größe oder Material nutzt Circle-Hand allerdings Tags und Metafelder. Varianten eignen sich vor allem für viele gleichartige Artikel, etwa 100 T-Shirts in Größe M.

Für Einzelstücke sind Tags und Metafelder flexibler, besonders bei Kollektionen oder Google Shopping. Deshalb arbeiten die meisten Geschäfte damit.

Zukünftig werden wir auch Varianten einbauen.


Shopify ist verbunden, aber bei den Artikeln steht „In Shopify erstellen“

Möglicherweise hast du den falschen Shop verbunden. Prüfe, ob die Shopify-URL unter Circle-Hand > Einstellungen > Shopify genau mit der URL deines tatsächlichen Shops übereinstimmt. Falls nicht, deinstalliere Circle-Hand im falschen Shopify-Shop und installiere die App im richtigen Shop neu.

Eine andere mögliche Ursache sind Metafeld-Definitionen in Shopify mit Bedingungen oder Namen, die Circle-Hand nicht erkennt. Lösche diese Definitionen in Shopify. Lege anschließend einen neuen Artikel in Circle-Hand an und definiere die Felder in Shopify über die nicht strukturierten Metafelder neu.

Wenn es weiterhin nicht funktioniert, schreib uns an max@circle-hand.com. Wir sehen uns das gerne an.


Wie übertrage ich Ladenguthaben an Shopify?

Damit deine Lieferkund:innen ihr Ladenguthaben in Shopify nutzen können – online oder an der Kasse –, gehe so vor:

  1. Wähle bei der Auszahlung „Ladenguthaben“ aus.

  2. Öffne das Profil der Lieferkund:in in Circle-Hand.

  3. Klicke auf „Ladenguthaben an Shopify übertragen“.

  4. Anschließend kannst du in Shopify POS „Ladenguthaben“ als Zahlungsmethode auswählen. Deine Lieferkund:innen können ihr Guthaben auch im Onlineshop einlösen.

*Unter Einstellungen > Store > Standardbonus für Ladenguthaben (%) kannst du einen Bonus festlegen, wenn Lieferkund:innen statt einer anderen Auszahlungsmethode Ladenguthaben wählen.

Wir arbeiten mit Shopify an einer automatischen Übertragung und einem beidseitigen Abgleich, damit der Guthabenstand in beiden Systemen aktuell bleibt. Diese Funktion ist in Vorbereitung.


Wie ordne ich Artikel Shopify-Kollektionen zu?

Die meisten Geschäfte nutzen automatische Kollektionen in Shopify.

Aktiviere unter Circle-Hand > Einstellungen > Shopify die Option „Attribute als Tags senden“. Dann werden alle Attribute als Tags übertragen. Wenn du zum Beispiel als Marke „Nike“ einträgst, kannst du in Shopify eine automatische Kollektion für alle Artikel mit dem entsprechenden Nike-Tag erstellen.

Du kannst auch eigene Tags aus Circle-Hand übertragen. Aktiviere dazu unter Einstellungen > Geschäft das Attribut „Eigener Tag“. So kannst du zusätzliche Tags wie „Archivverkauf“ oder „Winter“ vergeben und darauf basierend automatische Kollektionen in Shopify anlegen.


Wie blende ich verkaufte Artikel aus, statt „Nicht vorrätig“ anzuzeigen?

Wenn du Kollektionen verwendest, lässt sich das am einfachsten direkt in Shopify einstellen:

  1. Gehe zu Produkte > Kollektionen.

  2. Öffne die gewünschte Kollektion oder erstelle eine neue Kollektion „Alle Produkte“.

  3. Wähle als Kollektionstyp „Automatisch“.

  4. Füge folgende Bedingung hinzu:

  5. Lagerbestand — ist größer als — 0

  6. Wähle „Alle Bedingungen“, wenn du weitere Regeln hinterlegt hast.


Alternativ kannst du Shopify Flow nutzen: Erstelle eine Automatisierung, die den Vertriebskanal auf „Nur Point of Sale“ setzt, sobald der Bestand 0 erreicht.


Wie installiere ich die Shopify-App neu?

1. Öffne deine Shopify-Einstellungen und gehe zu Apps und Vertriebskanäle.

2. Deinstalliere Circle-Hand.

3. Installiere Circle-Hand erneut. Wenn die Kalenderansicht erscheint, ist die Verbindung hergestellt.

4. Öffne https://next.app.circle-hand.com/



Hast du weitere Fragen? Schreib uns jederzeit max@circle-hand.com