Pico
Pico DocsSandbox

DocsShopware 6

دليل التكامل

إعداد تاجر Shopware 6

اربط متجر Shopware 6 قياسياً بـ Pico عبر بيانات اعتماد Admin API و Store API. لا يلزم إضافة مخصصة أو وصول لقاعدة البيانات.

مُختبر على 6.6.xبدون إضافة

ما يحتاجه Pico

بيانات الاعتمادالمكان في Shopwareالاستخدام
عنوان المتجر الأساسينطاق قناة المبيعاتبادئة لـ /api و /store-api
معرّف مفتاح التكامل + السرالإعدادات → النظام → التكاملاتAdmin API OAuth (client_credentials)
مفتاح وصول قناة المبيعاتالإعدادات → قنوات المبيعات → قناتك → وصول APIترويسة Store API sw-access-key

إنشاء تكامل Admin API

  1. سجّل الدخول إلى إدارة Shopware (/admin).
  2. افتح الإعدادات → النظام → التكاملات.
  3. أنشئ تكاملاً (يُفضَّل وصول المسؤول لقراءة الكتالوج).
  4. انسخ Access key ID و Secret access key فوراً. يُعرض السر مرة واحدة فقط.
إدارة Shopware: نافذة إنشاء تكامل
إنشاء تكامل. سمِّ التطبيق، امنح صلاحية المسؤول (أو دوراً)، ثم انسخ كلا المفتاحين قبل الحفظ. وثائق Shopware
إدارة Shopware: قائمة التكاملات
نظرة عامة على التكاملات. افتح عنصراً للتعديل أو استخدم قائمة السياق. وثائق Shopware
إدارة Shopware: تعديل التكامل
تعديل التكامل. يُخفى السر بعد الحفظ. استخدم إعادة توليد مفتاح API إذا احتجت بيانات جديدة. وثائق Shopware

نسخ مفتاح وصول قناة المبيعات

  1. افتح الإعدادات → قنوات المبيعات (أو عنصر قنوات المبيعات في الشريط الجانبي).
  2. اختر قناة الواجهة التي يجب أن يستخدمها Pico.
  3. انسخ Access key من قسم وصول API.
  4. تأكد أن نطاقاً على تلك القناة يطابق العنوان الأساسي الذي ستدخله في Pico.
إدارة Shopware: وصول API لقناة المبيعات
وصول API لقناة المبيعات. انسخ مفتاح API لاستدعاءات Store API. إنشاء مفتاح جديد يُبطل السابق. وثائق Shopware
إدارة Shopware: نطاقات قناة المبيعات
نطاقات قناة المبيعات. يجب أن يطابق العنوان في Pico نطاقاً مضبوطاً على هذه القناة. وثائق Shopware

الاتصال في Pico

  1. افتح التكاملات

    لوحة التحكم → التكاملات → المنصة Shopware 6.

  2. أدخل بيانات الاعتماد

    العنوان الأساسي، معرّف/سر مفتاح المسؤول، ومفتاح قناة المبيعات اختياري.

  3. اختبر الاتصال

    يتحقق Pico من Admin OAuth والإصدار، ثم سياق Store API عند وجود مفتاح قناة المبيعات.

  4. زامن الكتالوج

    الكتالوج → المزامنة يستورد المنتجات الأب (المتغيرات والأسعار والمخزون والوسائط والفئات) عبر Admin API.

  5. ضمّن الـ widget

    استخدم public_widget_id للمتجر في الواجهة الأمامية (أدناه).

تضمين الـ widget

لا يتطلب Pico إضافة Shopware للمرحلة التجريبية. أضف السكربت العام إلى ثيم الواجهة النشط (قد يكون مسار الثيم المُجمَّع حزمة Composer تحت 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>

أضف أصل المتجر إلى Pico API FRONTEND_URLS. امسح ذاكرة تخزين Shopware/HTTP بعد تغييرات الثيم.

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}.

حدود المرحلة

  • اتصال الكتالوج والمزامنة واكتشاف المنتجات مدعومة.
  • عمليات الإضافة إلى السلة / كتابة الطلبات معطّلة حتى مع مفتاح قناة المبيعات.
  • لا يتطلب Pico حقولاً مخصصة أو إضافات خاصة بالتاجر للتكامل الأساسي.
  • تظهر الإخفاقات كأخطاء اتصال/مزامنة. متاجر Shopware المضبوطة لا تسقط بصمت إلى بيانات كتالوج تجريبية.

مصادر لقطات الشاشة

لقطات واجهة الإدارة من التوثيق الرسمي لـ Shopware:

→ العودة إلى نظرة الوثائق