Pico
Pico DocsSandbox

DocsShopware 6

Οδηγός ενσωμάτωσης

Ρύθμιση εμπόρου Shopware 6

Συνδέστε ένα τυπικό κατάστημα Shopware 6 στο Pico με διαπιστευτήρια Admin API και Store API. Δεν απαιτείται προσαρμοσμένο plugin ή πρόσβαση στη βάση.

Δοκιμασμένο σε 6.6.xΧωρίς plugin

Τι χρειάζεται το Pico

ΔιαπιστευτήριοΠού στο ShopwareΧρήση
Base URL καταστήματοςDomain sales channelΠρόθεμα για /api και /store-api
Access key ID + secret ενσωμάτωσηςSettings → System → IntegrationsAdmin API OAuth (client_credentials)
Access key sales channelSettings → Sales Channels → κανάλι → API accessHeader Store API sw-access-key

Δημιουργία ενσωμάτωσης Admin API

  1. Συνδεθείτε στο Shopware Admin (/admin).
  2. Ανοίξτε Settings → System → Integrations.
  3. Δημιουργήστε ενσωμάτωση (συνιστάται admin access για ανάγνωση καταλόγου).
  4. Αντιγράψτε αμέσως Access key ID και Secret access key. Το secret εμφανίζεται μία φορά.
Shopware Admin: διάλογος δημιουργίας ενσωμάτωσης
Δημιουργία ενσωμάτωσης. Ονομάστε την εφαρμογή, δώστε Administrator (ή ρόλο) και αντιγράψτε και τα δύο κλειδιά πριν την αποθήκευση. Έγγραφα Shopware
Shopware Admin: λίστα ενσωματώσεων
Επισκόπηση ενσωματώσεων. Ανοίξτε μια εγγραφή για επεξεργασία ή χρησιμοποιήστε το μενού περιβάλλοντος. Έγγραφα Shopware
Shopware Admin: επεξεργασία ενσωμάτωσης
Επεξεργασία ενσωμάτωσης. Το secret κρύβεται μετά την αποθήκευση. Χρησιμοποιήστε Regenerate API access key αν χρειάζεστε νέα διαπιστευτήρια. Έγγραφα Shopware

Αντιγραφή access key sales channel

  1. Ανοίξτε Settings → Sales Channels (ή το στοιχείο στην πλαϊνή γραμμή).
  2. Επιλέξτε το storefront κανάλι που θα χρησιμοποιεί το Pico.
  3. Αντιγράψτε το Access key από την ενότητα API access.
  4. Επιβεβαιώστε ότι ένα domain του καναλιού ταιριάζει με το base URL στο Pico.
Shopware Admin: πρόσβαση API sales channel
Πρόσβαση API sales channel. Αντιγράψτε το API access key για κλήσεις Store API. Νέο κλειδί ακυρώνει το προηγούμενο. Έγγραφα Shopware
Shopware Admin: domains sales channel
Domains sales channel. Το URL στο Pico πρέπει να ταιριάζει με domain αυτού του καναλιού. Έγγραφα Shopware

Σύνδεση στο Pico

  1. Ανοίξτε Integrations

    Dashboard → Integrations → πλατφόρμα Shopware 6.

  2. Εισάγετε διαπιστευτήρια

    Base URL, Admin key ID/secret και προαιρετικό κλειδί sales channel.

  3. Δοκιμή σύνδεσης

    Το Pico ελέγχει Admin OAuth + έκδοση και μετά το Store API context όταν υπάρχει κλειδί sales channel.

  4. Συγχρονισμός καταλόγου

    Catalog → Sync εισάγει γονικά προϊόντα (παραλλαγές, τιμές, απόθεμα, media, κατηγορίες) μέσω Admin API.

  5. Ενσωμάτωση widget

    Χρησιμοποιήστε το public_widget_id του καταστήματος στο storefront (παρακάτω).

Ενσωμάτωση widget

Το Pico δεν απαιτεί Shopware plugin για το πιλοτικό. Προσθέστε το δημόσιο script στο ενεργό storefront theme (το compiled path μπορεί να είναι Composer package κάτω από vendor/…, όχι μόνο custom/static-plugins).

Theme embed
<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>

Προσθέστε το origin του καταστήματος στο Pico API FRONTEND_URLS. Καθαρίστε την cache Shopware/HTTP μετά από αλλαγές theme.

API (headless)

Δημιουργία store + sync
POST /api/v1/stores
{
  "name": "My Shop",
  "platform": "shopware6",
  "credentials": {
    "base_url": "https://shop.example.com",
    "access_key_id": "SWIA...",
    "secret_access_key": "...",
    "sales_channel_access_key": "SWSC...",
    "storefront_url": "https://shop.example.com"
  }
}

POST /api/v1/stores/{storeId}/test
POST /api/v1/catalog/{storeId}/sync

Ενημερώστε διαπιστευτήρια αργότερα με PATCH /api/v1/stores/{storeId}.

Όρια ορόσημου

  • Υποστηρίζονται σύνδεση καταλόγου, sync και ανακάλυψη προϊόντων.
  • Οι εγγραφές add to cart / παραγγελιών είναι απενεργοποιημένες ακόμη και με κλειδί sales channel.
  • Το Pico δεν απαιτεί custom fields ή plugins συγκεκριμένου εμπόρου για τη βασική ενσωμάτωση.
  • Οι αποτυχίες εμφανίζονται ως σφάλματα σύνδεσης/sync. Ρυθμισμένα καταστήματα Shopware δεν πέφτουν σιωπηλά σε mock δεδομένα καταλόγου.

Πηγές στιγμιοτύπων

Τα στιγμιότυπα Admin UI προέρχονται από την επίσημη τεκμηρίωση Shopware:

← Επιστροφή στην επισκόπηση docs