Интеграция Perfect Day в Shopware 6.

Шаг 1 — Создайте пользовательское поле для идентификатора купона.

1. Создать набор пользовательских полей

   Администратор Shopware → Настройки → Система → Дополнительные поля → „Создавайте наборы". Название набора: Идеальный день. Под Задания вариант „"Продукт"" выбирать.

2. Добавить поле

   Новое поле со следующими значениями:

   • Техническое название: pfd_coupon_id
   • Тип: Число (целое число)
   • Отображаемое имя: Идентификатор купона Perfect Day

   Сохранять.

Шаг 2 — Введите идентификатор купона для каждого товара.

1. Войдите в редактор товаров.

   Администратор Shopware → Каталоги → Товары → Открыть продукт → Вкладки „Технические характеристики" → Блок „"Дополнительные поля"". Набор „Идентификатор купона Perfect Day" на основе данных из бэк-офиса платформы (например,. 15114) и сохранить.

Шаг 3 — Установите приложение Bridge

Shopware не включает веб-хук для работы с пользовательским содержимым полей. Для этого вам потребуется небольшое приложение Shopware. Мы подготовили шаблон приложения — вы можете получить готовый продукт по запросу в нашей службе поддержки. Или вы можете создать его самостоятельно, используя этот шаблон.

1. Манифест приложения (manifest.xml)

   В манифесте регистрируется приложение и веб-хук для обработки заказов. Укажите свой домен-мост в манифесте. URL-атрибут.

   Просмотреть полный код — XML · manifest.xml

   XML · manifest.xml

   PerfectDayConnector Соединитель идеального дня Отправьте данные заказа с идентификаторами купонов Perfect Day на платформу. DigElite (c) DigElite 1.0.0 С

2. Конечная точка моста (собственный сервер)

   Мост принимает веб-хук Shopware, извлекает пользовательское поле для каждого товара, преобразует его в формат Perfect Day и пересылает дальше. Пример на PHP:

   Просмотреть полный код — PHP · bridge.php

   PHP · bridge.php

   <?php
   // bridge.php — empfängt Shopware-Webhook, ruft Shopware-API für
   // Produktdetails, leitet ans Perfect Day weiter.
   
   $rawPayload = file_get_contents('php://input');
   $payload = json_decode($rawPayload, true);
   $order = $payload['data']['payload']['order'] ?? null;
   if (!$order) { http_response_code(400); exit; }
   
   // Shopware-API-Token holen (Server-zu-Server, eigene Credentials)
   $swToken = sw_admin_token();
   
   $items = [];
   foreach ($order['lineItems'] as $li) {
       $product = sw_api_get('/api/product/' . $li['productId'], $swToken);
       $couponId = $product['customFields']['pfd_coupon_id'] ?? null;
       if (!$couponId) continue;
       $items[] = ['coupon_id' => (int)$couponId, 'count' => (int)$li['quantity']];
   }
   if (empty($items)) { http_response_code(200); exit; }
   
   $pfdPayload = [
       'shop_order_id' => $order['orderNumber'],
       'shop_type'     => 'shopware',
       'shop_domain'   => parse_url($order['salesChannel']['domains'][0]['url'], PHP_URL_HOST),
       'customer' => [
           'email'  => $order['orderCustomer']['email'],
           'name'   => trim($order['orderCustomer']['firstName'] . ' ' . $order['orderCustomer']['lastName']),
           'locale' => substr($order['language']['locale']['code'], 0, 2),
       ],
       'items'             => $items,
       'order_total_cents' => (int) round(($order['amountTotal'] ?? 0) * 100),
       'currency'          => $order['currency']['isoCode'] ?? 'EUR',
       'placed_at'         => $order['orderDateTime'] ?? gmdate('c'),
   ];
   
   $ch = curl_init('https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order');
   curl_setopt_array($ch, [
       CURLOPT_POST           => 1,
       CURLOPT_RETURNTRANSFER => 1,
       CURLOPT_HTTPHEADER     => [
           'Content-Type: application/json',
           'Authorization: Basic ' . base64_encode('DEIN-USER:DEIN APP PWD'),
       ],
       CURLOPT_POSTFIELDS => json_encode($pfdPayload),
       CURLOPT_TIMEOUT    => 15,
   ]);
   curl_exec($ch);
   curl_close($ch);
   
   http_response_code(200);

3. Распакуйте приложение и установите его.

   Манифест и URL-адрес моста в одном месте. app.zip упаковка (см. Документация ShopwareЗатем Shopware Admin → Расширения → Загрузите свои собственные расширения → Вставьте ZIP-файл → активируйте.

Проще: используйте Cloud Bridge.

Если настройка собственного моста кажется слишком сложной, это также возможно и без собственного сервера.

1. Make.com, Zapier или n8n

   Make.com: В качестве триггера используется модуль „Веб-хуки → Пользовательский веб-хук", для обогащения данных — „Shopware → Получить товар", в качестве выходных данных — „HTTP → Выполнить запрос" — настройка занимает около 15 минут. н8н Это решение позволяет размещать его на собственном сервере, что обеспечивает более полное соответствие требованиям GDPR. Отправьте нам запрос в службу поддержки с указанием предпочитаемого инструмента, и мы предоставим вам предварительно настроенный рабочий процесс.

Шаг 4 — Порядок проведения тестирования

1. Оформите и проверьте заказ

   Разместите тестовый заказ и отметьте платеж как „Оплачено". Shopware должен автоматически вызвать мост. Проверьте: Административная панель платформы → Идеальный день → Заказы в магазине (Запись с) shop_type=shopware?) и почтовый ящик клиента для отправки фирменного электронного письма с кнопкой печати.