Perfect Day in Shopify anbinden.

Schritt 1 — Produkt im Shopify-Admin anlegen

1. Pro Coupon ein Shopify-Produkt

   Shopify-Admin → Products → Add product. Titel, Beschreibung, Preis und Bilder eintragen — wie bei jedem anderen Produkt. „Save" klicken.

Schritt 2 — Coupon-ID als Metafield ans Produkt hängen

Damit Shopify weiß, welcher Plattform-Coupon zu diesem Produkt gehört, hinterlegst du die Coupon-ID als Metafield.

1. Metafield-Definition einmalig anlegen

   Shopify-Admin → Settings → Custom data → Products → „Add definition". Felder:

   • Name: Perfect Day Coupon-ID
   • Namespace and key: perfectday.coupon_id
   • Type: Integer (one value)

   Speichern — diese Definition gilt jetzt für alle Produkte.

2. Coupon-ID pro Produkt eintragen

   Im Produkt-Editor runterscrollen zum Block „Metafields" → „Perfect Day Coupon-ID" → Wert eintragen (z. B. 15114) → „Save". Das Produkt ist jetzt mit dem Plattform-Coupon verknüpft.

Schritt 3 — Bridge einrichten (eine von drei Optionen)

Hier kommt der Punkt, an dem Shopify allein nicht reicht. Wähle die Option, die zu deinem Shopify-Plan passt.

1. Option A — Shopify Flow (Plus / Advanced Plan)

   Wenn du Shopify Plus oder Advanced hast, ist Shopify Flow bereits dabei. Shopify-Admin → Apps → Shopify Flow → „Create workflow" → Template „Order paid". Füge eine „Run code"-Action mit folgendem Skript hinzu:

   Vollständigen Code anzeigen — JavaScript · Flow „Run code"

   JavaScript · Flow „Run code"

   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. Option A — HTTP-Request-Action anhängen

   Danach eine „Send HTTP request"-Action: Method POST, URL https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Body {{ steps.code.payload | json }}. Header:

   HTTP-Header

   Content-Type: application/json
   Authorization: Basic <DEINE_BASE64_AUTH>

3. Base64-Auth erzeugen

   Den Authorization-Wert generierst du auf Mac/Linux im Terminal — das Ergebnis kommt hinter Basic in den Header. Danach den Workflow aktivieren.

   Bash

   echo -n "DEIN_USERNAME:DEIN APP PASSWORD" | base64

4. Option B — Bridge via Make.com / Zapier (jeder Plan)

   Nutzt du Shopify Basic/Starter ohne Flow: Erstelle bei make.com oder Zapier einen Workflow — Trigger „Watch Orders (Paid)", Action 1 „Get a Product" (holt das Metafield), Action 2 „HTTP → Make a request" mit Basic-Auth an die Webhook-URL. Ein ausführliches Screen-Recording bekommst du auf Support-Anfrage.

5. Option C — Custom Cloud Function

   Für technik-affine Anbieter: eine eigene Cloud Function (Vercel / Cloudflare Workers / AWS Lambda), die den Shopify-Webhook empfängt, das Metafield abruft und ans Perfect-Day-Webhook weitergibt. Ein vollständiges Code-Template senden wir auf Support-Anfrage.

Schritt 4 — Test-Bestellung

1. Bestellung auslösen und prüfen

   Mach eine Test-Bestellung im Shopify-Shop (Bogus-Gateway nutzen, falls du keine echte Zahlung auslösen willst) und markiere sie als „bezahlt". Dann prüfen:

   • Plattform-Backoffice → Perfect Day → Shop-Bestellungen: neue Bestellung mit shop_type=shopify?
   • Test-Kunden-Mailbox: Brand-Mail mit Coupon-Codes + Druck-Button angekommen?