Conecta Perfect Day con otras tiendas.

Los requisitos mínimos

1. Tu tienda debe poder hacer tres cosas.

   • Webhook de orden de activación cuando "pedido pagado"„
   • POST HTTP con encabezado Basic-Auth enviar
   • Carga útil JSON construir en nuestro formato

   ¿Tu tienda solo envía correos electrónicos de confirmación de pedidos y nada más? Entonces usa un servicio de intermediación como Zapier o Make.com, que analiza el correo electrónico del pedido y realiza la llamada HTTP.

El cuerpo JSON requerido

No importa de dónde provengan los datos; al final, este cuerpo JSON debe ir al webhook.

1. Formato de carga útil

   Campos obligatorios: ID_de_pedido_de_tienda, tipo_de_tienda, dominio de la tienda, correo electrónico del cliente, artículos[].cupón_id y elementos[].contador. Opcional es nombre.del.cliente, cliente.local, total_del_pedido_centavos, divisa y colocado_en.

   JSON · Cuerpo del webhook

   { "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. Encabezado de autenticación

   Autenticación básica HTTP estándar. El valor se calcula a partir del nombre de usuario y la contraseña de la aplicación.

   encabezados HTTP

   Autorización: Básica Tipo de contenido: aplicación/json

3. Generar valor Base64

   En Mac/Linux en la terminal, el resultado aparece después básico :

   Intento

   echo -n "tu-nombre:xxxx xxxx xxxx xxxx xxxx xxxx" | base64

Opciones de puente para tiendas sin funcionalidad nativa de webhook.

1. Opción 1: Zapier o Make.com

   Ambos ofrecen activadores para muchos sistemas de tienda, además de una acción HTTP para solicitudes POST. Ejemplo de flujo de trabajo (Make.com): Activador „Estén atentos a los nuevos pedidos", acción opcional „"Obtener detalles del producto"" para la búsqueda del ID del cupón, entonces „"HTTP → Realizar una solicitud"" a la URL del webhook. El plan gratuito de Make.com es suficiente para aproximadamente 1000 pedidos al mes.

2. Opción 2: IFTTT, n8n, Pipedream

   El mismo flujo de trabajo, diferente interfaz. n8n Es autoalojable y, por lo tanto, más compatible con el RGPD. IFTTT es más limitado (no permite el mapeo JSON complejo).

3. Opción 3: Servidor puente dedicado

   Para una URL de webhook personalizada: Cloudflare Workers (gratis hasta 100 000 solicitudes al día), Vercel Serverless Functions, AWS Lambda o su propio servidor Node/PHP. Código de ejemplo para Cloudflare Workers:

   Ver código completo — 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,
     };
   }

Mapeo de ID de cupones para tiendas sin campos personalizados

1. Mantener el mapeo en el puente

   Si tu tienda no admite campos personalizados por producto (algunos creadores de tiendas muy básicos no lo permiten), gestiona la asignación directamente en el puente. Requisito previo: el identificador único y estable del producto en tu tienda debe ser de un solo uso.

   Mecanografiado

   const COUPON_MAPPING: Registro = { 'gutschein-25-eur': 15114, 'gutschein-50-eur': 15115, 'gutschein-100-eur': 15116, }; // En mapToPerfectDay(): const couponId = COUPON_MAPPING[li.productSlug];

Orden de prueba

1. Realizar y verificar el pedido

   Independientemente de la variante del puente: realice un pedido de prueba y acceda al panel de administración de la plataforma en Día perfecto → Pedidos de la tienda en la entrada con tipo_tienda=personalizado Por favor, espere. Revise su bandeja de entrada de correo electrónico para ver el correo de la marca.