Integrating Perfect Day into Shopware 6.

Step 1 — Create a custom field for the coupon ID

1. Create custom field set

   Shopware admin → Settings → System → Additional fields → „Create sets". Set name: Perfect Day. Under Assignments the option „"Product"" choose.

2. Add field

   New field with these values:

   • Technical name: pfd_coupon_id
   • Type: Number (Integer)
   • Display name: Perfect Day Coupon ID

   Save.

Step 2 — Enter coupon ID for each product

1. Enter in the product editor

   Shopware admin → Catalogues → Products → Open product → Tabs „Specifications" → Block „"Additional fields"". Set „"Perfect Day Coupon ID"" on the value from the platform back office (e.g. 15114) and save.

Step 3 — Install the Bridge app

Shopware doesn't include a webhook with custom field content. You'll need a small Shopware app to handle that. We've prepared an app skeleton—you can get the finished product upon request from our support team. Or you can build it yourself using this template.

1. App manifest (manifest.xml)

   The manifest registers the app and the order-paid webhook. Enter your bridge domain in the manifest. URL-attribute.

   View full code — XML · manifest.xml

   XML · manifest.xml

   PerfectDayConnector Perfect Day Connector Send order data with Perfect Day coupon IDs to the platform. DigElite (c) DigElite 1.0.0 WITH

2. Bridge endpoint (own server)

   The bridge receives the Shopware webhook, retrieves the custom field for each item, transforms it into the Perfect Day format, and forwards it. Example in PHP:

   View full code — 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. Unzip the app and install it.

   Manifest and bridge URL in one app.zip packing (see Shopware DocsThen Shopware Admin → Extensions → Upload your own extensions → Insert ZIP file → activate.

Easier: Use Cloud Bridge

If setting up your own bridge is too complex, it's also possible without your own server.

1. Make.com, Zapier or n8n

   Make.com: Module „Webhooks → Custom webhook" as trigger, „Shopware → Get a Product" for enrichment, „HTTP → Make a request" as output — setup takes about 15 minutes. n8n It's self-hostable and therefore more GDPR-compliant. Send us a support request with your preferred tool, and we'll provide a pre-configured workflow.

Step 4 — Test order

1. Place and check order

   Place a test order and mark the payment as "Paid". The bridge should be automatically called by Shopware. Check: Platform back office → Perfect Day → Shop orders (Entry with shop_type=shopware?) and the customer mailbox to the brand email with print button.