Docs / Shopware 6

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

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

1. Συνδεθείτε στο Shopware Admin (/admin).
2. Ανοίξτε Settings → System → Integrations.
3. Δημιουργήστε ενσωμάτωση (συνιστάται admin access για ανάγνωση καταλόγου).
4. Αντιγράψτε αμέσως Access key ID και Secret access key. Το secret εμφανίζεται μία φορά.

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

1. Ανοίξτε Settings → Sales Channels (ή το στοιχείο στην πλαϊνή γραμμή).
2. Επιλέξτε το storefront κανάλι που θα χρησιμοποιεί το Pico.
3. Αντιγράψτε το Access key από την ενότητα API access.
4. Επιβεβαιώστε ότι ένα domain του καναλιού ταιριάζει με το base URL στο Pico.

Σύνδεση στο Pico

1. 1
   Ανοίξτε Integrations

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

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

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

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

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

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

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

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

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

Ενσωμάτωση widget

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

<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)

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:

• Settings → Integrations
• Settings → Sales channel
• Developer API quick start

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