Перейти к содержимому
 Shopify · 15–20 мин · средний

Интегрируйте Perfect Day в Shopify.

Продавайте купоны Perfect Day через свой магазин Shopify. Единственная небольшая сложность: встроенный веб-хук Shopify не включает метаполя — для этого вам понадобится небольшой мост. Мы покажем вам три способа, от самого простого до самого гибкого.

Необходимо сделать заранее: Сходите как раз общая подготовка Это включает в себя создание купона, получение пароля приложения и указание URL-адреса веб-перехватчика. Процедура занимает приблизительно пять минут и применима ко всем системам интернет-магазинов.

Шаг 1 — Создайте товар в административной панели Shopify.

  1. Один товар Shopify на один купон

    Административная панель Shopify → Товары → Добавить товар. Введите название, описание, цену и изображения — как и для любого другого товара. „"Сохранять"" клик.

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

Чтобы Shopify мог определить, к какой платформе относится данный товар, идентификатор купона следует сохранить в качестве метаполя.

  1. Создайте определение метаполя один раз.

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

    • Имя: Идентификатор купона Perfect Day
    • Пространство имен и ключ: perfectday.coupon_id
    • Тип: Целое число (одно значение)

    Экономия — это определение теперь применяется ко всем товарам.

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

    В редакторе товаров прокрутите вниз до соответствующего блока. „Метаполя"„Идентификатор купона Perfect Day" → Введите значение (например,. 15114) → „Сохранить". Теперь товар привязан к купону платформы.

Шаг 3 — Настройка Bridge (один из трех вариантов)

В этом случае одного Shopify недостаточно. Выберите вариант, соответствующий вашему тарифному плану Shopify.

  1. Вариант A — Shopify Flow (план Plus/Advanced)

    Если у вас Shopify Plus или Advanced, Shopify Flow Уже в деле. Администратор Shopify → Приложения → Shopify Flow„Создать рабочий процесс" → Шаблон „"Заказ оплачен"". Добавить „"Выполнить код""— Действие добавлено с помощью следующего скрипта:

    Просмотреть полный код — JavaScript · Flow „Запустить код"
    JavaScript-процесс „Выполнить код"
    export default function transform(input) {
      const order = input.order;
      const items = order.lineItems.nodes
        .filter(li => li.product?.metafield?.value)
        .map(li => ({
          coupon_id: parseInt(li.product.metafield.value, 10),
          count:     li.quantity
        }));
      if (items.length === 0) return { skip: true };
      return {
        payload: {
          shop_order_id: String(order.name),
          shop_type:     "shopify",
          shop_domain:   order.shop?.myshopifyDomain || "shop",
          customer: {
            email:  order.customer?.email || order.email,
            name:   `${order.customer?.firstName || ''} ${order.customer?.lastName || ''}`.trim(),
            locale: order.customerLocale || "de"
          },
          items,
          order_total_cents: Math.round(parseFloat(order.totalPriceSet.shopMoney.amount) * 100),
          currency:          order.totalPriceSet.shopMoney.currencyCode,
          placed_at:         order.processedAt
        }
      };
    }
  2. Вариант A — Добавить действие HTTP-запроса

    Затем а „"Отправить HTTP-запрос""-Действие: Метод ПОЧТА, URL https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Тело {{ steps.code.payload | json }}. Заголовок:

    HTTP-заголовки
    Тип содержимого: application/json Авторизация: Базовая
  3. Создание аутентификации по Base64

    В Mac/Linux значение авторизации генерируется в терминале — результат отображается после ввода в систему. базовый в заголовке. Затем рабочий процесс. активировать.

    Баш
    echo -n "ВАШЕ ИМЯ_ПОЛЬЗОВАТЕЛЯ:ВАШ ПАРОЛЬ ПРИЛОЖЕНИЯ" | base64
  4. Вариант Б — Мост через Make.com / Zapier (любой тарифный план)

    Вы используете Shopify Basic/Starter без Flow? Создайте заявку на сайте... make.com или Zapier — запуск рабочего процесса „Заказы на часы (оплаченные)", Действие 1 „"Получить товар"" (получает метаполе), Действие 2 „"HTTP → Отправить запрос"" Используется базовая аутентификация для URL-адреса веб-перехватчика. Подробную запись экрана можно получить по запросу в службу поддержки.

  5. Вариант C — Пользовательская облачная функция

    Для технически подкованных поставщиков: пользовательская облачная функция (Vercel / Cloudflare Workers / AWS Lambda), которая принимает веб-хук Shopify, извлекает метаполе и передает его веб-хуку Perfect-Day. Полный шаблон кода будет выслан по запросу в службу поддержки.

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

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

    Создайте тестовый заказ в своем магазине Shopify (используйте фиктивный платежный шлюз, если не хотите инициировать реальный платеж) и отметьте его как „оплачено". Затем проверьте:

    • Административная панель платформы → Идеальный день → Заказы в магазине: новый заказ с shop_type=shopify?
    • Проверьте почтовый ящик клиента: Вы получили фирменное электронное письмо с купонами и кнопкой для печати?
Если что-то застряло

Поиск неисправностей.

Веб-хук выдает ошибку 401 — требуется аутентификация.

Неверное имя пользователя — это имя пользователя WordPress (пользователь_вход), а не адрес электронной почты. Или пароль приложения был аннулирован или скопирован неправильно. В случае сомнений сгенерируйте новый.

Веб-хук возвращает ошибку 403 — forbidden_coupon

Он coupon_id Метаполе отсутствует в административной панели вашей платформы или принадлежит другому провайдеру. Проверьте в соответствующем разделе. Ваучеры, отображается ли там идентификатор.

Веб-хук возвращает код ошибки 400 — проверка

Отсутствующие или некорректные поля в теле JSON. Распространенные случаи: клиент.электронная почта Эта информация отсутствует, потому что клиент оформил заказ как гость. Это необходимо учесть в процессе/рабочем процессе.

Заказ оформлен, но клиент не получил электронное письмо.

В административной панели платформы откройте сведения о заказе и проверьте статус электронного письма. Красный цвет указывает на проблему с SMTP на нашей стороне; пожалуйста, свяжитесь со службой поддержки. В противном случае проверьте папку «Спам» клиента.

Заказ будет обработан дважды.

Нет проблем — веб-хук имеет защиту от идемпотентности. Вы увидите его со второй попытки. дубликат: true В ответе не генерируются повторяющиеся коды и не отправляются повторяющиеся электронные письма.

Настройка службы

Вы бы предпочли, чтобы мы это для вас настроили?

Настройка Bridge — самая сложная часть работы с Shopify. Мы полностью настроим для вас рабочий процесс Shopify Flow или Make.com — вы просто предоставите нам временный доступ, а мы позаботимся обо всем остальном.

Часто задаваемые вопросы

Остались вопросы?

Зачем мне вообще нужен мост?
Встроенный веб-хук Shopify для обработки заказов не предоставляет метаполя товара автоматически. Мост (Flow, Make.com или Cloud Function) получает метаполе, содержащее идентификатор купона, и использует его для формирования правильного тела веб-хука.
Какой вариант проще?
Вариант А (Shopify Flow): если у вас тариф Plus или Advanced, то все функции доступны непосредственно в Shopify. В противном случае, вариант Б (Make.com): бесплатного плана достаточно для большинства магазинов, код не требуется.
Насколько безопасен пароль приложения в Bridge?
Никогда не публикуйте его публично (никаких GitHub, никаких скриншотов). Используйте отдельный пароль для каждого магазина, чтобы можно было выборочно блокировать отдельные подключения. Хотя URL-адрес веб-перехватчика общедоступн, он отклоняет любой запрос без действительной аутентификации с ошибкой 401.

Магазин подключен к сети — и что дальше?

После запуска веб-хука все заказы автоматически отобразятся в вашей административной панели. Если вам потребуется дополнительное подключение, каждый дополнительный магазин можно настроить всего за несколько минут.

Перейти к обзору магазина