Docs / Shopify

Was Pico braucht

Pico nutzt die GraphQL Admin API von Shopify für den Katalog-Sync und ein Theme-App-Embed für das Storefront-Widget. Admin-API-Tokens erscheinen nie im Browser.

In Pico installieren und autorisieren

1. 1
   Integrationen öffnen

   Im Pico-Dashboard unter Integrationen auf Shopify verbinden klicken.

2. 2
   Shop-Domain eingeben

   Verwenden Sie die kanonische *.myshopify.com-Domain (z. B. acme.myshopify.com).

3. 3
   Scopes in Shopify freigeben

   Shopify fragt nach Katalog-Lesezugriff. Pico speichert das Token verschlüsselt und zeigt es nicht erneut.

4. 4
   Zurück zum Onboarding

   Nach der Freigabe landen Sie in Pico mit Verbindungsstatus und Setup-Schritten. Verbunden bedeutet nicht, dass der Katalog-Sync fertig ist.

Katalog-Sync

1. 1
   Erster Sync startet automatisch

   Nach erfolgreicher Installation stellt Pico einen Katalog-Sync in die Warteschlange. Fortschritt unter Katalog verfolgen.

2. 2
   Produkte prüfen

   Prüfen Sie Titel, Bilder, Preise, Varianten und URLs anhand einer Stichprobe mit Shopify.

3. 3
   Bei Bedarf erneut versuchen

   Fehlgeschlagene Syncs können unter Katalog wiederholt werden. Temporäre Rate-Limits werden mit Backoff erneut versucht.

Theme-App-Embed aktivieren

Pico kommt als Shopify-Theme-App-Embed (schwebender Assistent). Händler aktivieren es im Theme-Editor—ohne manuelle Liquid-Änderungen.

1. In Pico-Integrationen den Theme-Editor-Deep-Link öffnen (oder Theme-Editor → App-Einbettungen).
2. Pico Assistant aktivieren.
3. Public Widget-ID (beginnt mit pw_) und Pico-API-Basis-URL in die Embed-Einstellungen eintragen.
4. Speichern, Storefront öffnen und prüfen, dass das Widget einmal geladen wird.

<script
  src="https://YOUR_PICO_API_HOST/pico-widget.js"
  data-public-widget-id="pw_..."
  data-api-url="https://YOUR_PICO_API_HOST/api/v1"
  defer
></script>

Im Online Store nutzt Add-to-Cart die Shopify-Ajax-Cart, damit die Warenkorb-Ansicht synchron bleibt. Bevorzugen Sie das Theme-App-Embed statt dieses Skript manuell einzufügen.

Sprachen dieses Guides

Dieser Händler-Setup-Guide ist in allen Pico-Site-Sprachen verfügbar. Nutzen Sie den Sprachumschalter in der Kopfzeile.

Assistenten-Widget-Sprachen

Das shopper-seitige Pico-Assistenten-Widget liefert derzeit diese Sprachpakete. Standard in den Assistenten-Einstellungen setzen.

API (headless)

Shopify-Stores entstehen über OAuth, nicht über POST /stores mit Credentials. Typischer Ablauf:

POST /api/v1/integrations/shopify/install
{ "shop": "your-store.myshopify.com" }

# Follow authorize_url, then Shopify redirects to the Pico callback.
GET /api/v1/integrations/shopify/{storeId}/status
POST /api/v1/stores/{storeId}/test
POST /api/v1/catalog/{storeId}/sync

MVP-Grenzen

• Katalog-Sync, fundierte Produktsuche, Variantenwahl und Add-to-Cart werden unterstützt.
• Keine Checkout-Extensions, Rabatte oder Order-/Customer-APIs in diesem Leitfaden.
• Pico schreibt keine Produktdaten zurück nach Shopify.
• App-Store-Listing und Shopify Billing sind separate Launch-Schritte.

Offizielle Shopify-Referenzen

Prüfen Sie Auth, Scopes und Theme-Extension-Schritte in den Shopify-Docs:

• Authorization code grant (Standalone-Apps)
• Theme-App-Extensions
• GraphQL Admin API

← Zurück zur Docs-Übersicht