Perfect Day'i diğer mağazalarla bağlayın.

Minimum gereksinimler

1. Dükkanınız üç şeyi yapabilmelidir.

   • Tetikleme siparişi webhook'u "Sipariş ödendiğinde"„
   • Basic-Auth başlığı içeren HTTP POST Göndermek
   • JSON yükü formatımızda oluşturun

   Mağazanız yalnızca sipariş e-postaları gönderebiliyor, başka hiçbir şey gönderemiyor mu? O zaman sipariş e-postasını ayrıştırıp HTTP çağrısını yapan Zapier veya Make.com gibi bir köprü hizmeti kullanın.

Gerekli JSON gövdesi

Verilerin nereden geldiği önemli değil; sonuçta bu JSON gövdesi webhook'a gönderilmelidir.

1. Veri yükü formatı

   Zorunlu alanlar: mağaza_sipariş_kimliği, mağaza_türü, mağaza_alanı, müşteri.e-posta, ürünler[].kupon_kimliği Ve öğeler[].say. İsteğe bağlıdır. müşteri.adı, müşteri.yerel, sipariş_toplam_sent, para birimi Ve yerleştirildi.

   JSON · Webhook gövdesi

   { "shop_order_id": "1042", "shop_type": "custom", "shop_domain": "shop.example.com", "customer": { "email": "kunde@example.com", "name": "Max Mustermann", "locale": "de" }, "items": [ { "coupon_id": 15114, "count": 1 } ], "order_total_cents": 5000, "currency": "EUR", "placed_at": "2026-05-14T10:42:00Z" }

2. Yetki Başlığı

   Standart HTTP Temel Kimlik Doğrulama. Değeri kullanıcı adı ve uygulama şifresinden hesaplarsınız.

   HTTP başlıkları

   Yetkilendirme: Temel İçerik Türü: application/json

3. Base64 değeri oluştur

   Mac/Linux'ta terminalde sonuç şu komuttan sonra görünür: temel :

   Bash

   echo -n "your-name:xxxx xxxx xxxx xxxx xxxx xxxx" | base64

Yerel webhook işlevselliği olmayan mağazalar için köprü seçenekleri

1. Seçenek 1 — Zapier veya Make.com

   Her ikisi de birçok mağaza sistemi için tetikleyiciler ve POST istekleri için bir HTTP eylemi sunar. Örnek iş akışı (Make.com): Tetikleyici „Yeni siparişleri takip edin", isteğe bağlı işlem „"Ürün detaylarını inceleyin"" kupon kimliği sorgulaması için, daha sonra „"HTTP → İstek gönder"" Webhook URL'sine. Ücretsiz Make.com planı ayda yaklaşık 1.000 sipariş için yeterlidir.

2. Seçenek 2 — IFTTT, n8n, Pipedream

   Aynı iş akışı, farklı arayüz. n8n Kendi sunucunuzda barındırılabildiği için GDPR'ye daha uygundur. IFTTT ise daha sınırlıdır (karmaşık JSON eşleştirmesi yok).

3. Seçenek 3 — Özel Köprü Sunucusu

   Özel bir webhook URL'si için: Cloudflare Workers (günde 100.000 isteğe kadar ücretsiz), Vercel Serverless Functions, AWS Lambda veya kendi Node/PHP sunucunuz. Cloudflare Workers için örnek kod:

   Kodun tamamını görüntüle — TypeScript · Cloudflare Worker

   TypeScript · Cloudflare Worker

   export default {
     async fetch(req: Request): Promise<Response> {
       if (req.method !== 'POST') return new Response('Method not allowed', { status: 405 });
   
       const shopPayload = await req.json();
       const pfdPayload = mapToPerfectDay(shopPayload);
   
       const auth = btoa('DEIN-USER:DEIN APP PWD');
       const res = await fetch(
         'https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order',
         {
           method: 'POST',
           headers: {
             'Content-Type': 'application/json',
             'Authorization': 'Basic ' + auth,
           },
           body: JSON.stringify(pfdPayload),
         }
       );
       return new Response(await res.text(), { status: res.status });
     },
   };
   
   function mapToPerfectDay(shopPayload: any) {
     return {
       shop_order_id: shopPayload.orderNumber,
       shop_type:     'custom',
       shop_domain:   shopPayload.shop?.domain,
       customer: {
         email:  shopPayload.customer?.email,
         name:   shopPayload.customer?.name,
         locale: 'de',
       },
       items: shopPayload.lineItems.map((li: any) => ({
         coupon_id: parseInt(li.metadata?.pfd_coupon_id, 10),
         count:     li.quantity,
       })).filter((it: any) => it.coupon_id > 0),
       order_total_cents: Math.round(shopPayload.totalAmount * 100),
       currency:          shopPayload.currency,
       placed_at:         shopPayload.paidAt,
     };
   }

Özel alanları olmayan mağazalar için kupon kimliği eşleştirmesi

1. Köprüdeki haritalamayı sürdürün.

   Eğer mağazanız ürün başına özel alanları desteklemiyorsa (bazı çok temel mağaza oluşturucuları desteklemez), eşleştirmeyi doğrudan köprü üzerinden yönetirsiniz. Ön koşul: Mağaza ürününüzün slug'ı benzersiz ve sabit olmalıdır.

   TypeScript

   const COUPON_MAPPING: Kayıt = { 'gutschein-25-eur': 15114, 'gutschein-50-eur': 15115, 'gutschein-100-eur': 15116, }; // MapToPerfectDay()'da: const kuponId = COUPON_MAPPING[li.productSlug];

Test siparişi

1. Sipariş verin ve kontrol edin.

   Köprü varyantından bağımsız olarak: Bir test siparişi verin ve aşağıdaki bağlantıdan platformun arka ofisine erişin. Mükemmel Gün → Mağaza siparişleri girişte ile mağaza_türü=özel Lütfen bekleyin. Markaya ait e-postayı müşteri posta kutunuzda kontrol edin.