Saltar al contenido
 Shopify · 15–20 min · medio

Integra Perfect Day en Shopify.

Vende tus cupones de Perfect Day a través de tu tienda Shopify. La única pequeña dificultad reside en que el webhook nativo de Shopify no incluye metafields; necesitarás un pequeño puente para ello. Te mostraremos tres maneras, desde la más sencilla hasta la más flexible.

Requisitos previos: Ve una vez que preparación general Esto implica crear un cupón, obtener la contraseña de la aplicación y proporcionar la URL del webhook. El proceso dura aproximadamente cinco minutos y se aplica a todos los sistemas de la tienda.

Paso 1: Crea el producto en el panel de administración de Shopify.

  1. Un producto de Shopify por cupón

    Administrador de Shopify → Productos → Agregar producto. Introduce el título, la descripción, el precio y las imágenes, igual que con cualquier otro producto. „"Ahorrar"" hacer clic.

Paso 2: Adjunte el ID del cupón al producto como un campo meta.

Para garantizar que Shopify sepa a qué plataforma pertenece este cupón, debes almacenar el ID del cupón como un campo meta.

  1. Cree la definición del metacampo una vez

    Administrador de Shopify → Configuración → Datos personalizados → Productos„Añadir definición". Campos:

    • Nombre: ID de cupón de Perfect Day
    • Espacio de nombres y clave: día perfecto.cupón_id
    • Tipo: Entero (un valor)

    Ahorro: esta definición ahora se aplica a todos los productos.

  2. Ingrese el ID del cupón para cada producto.

    En el editor de productos, desplácese hacia abajo hasta el bloque. „"Metacampos""„"ID de cupón de día perfecto"" → Introduzca el valor (p. ej. 15114) → „Guardar". El producto ahora está vinculado al cupón de la plataforma.

Paso 3: Configurar Bridge (una de tres opciones)

Aquí es donde Shopify por sí solo no es suficiente. Elige la opción que mejor se adapte a tu plan de Shopify.

  1. Opción A — Shopify Flow (Plan Plus/Avanzado)

    Si tienes Shopify Plus o Advanced, Flujo de Shopify Ya estamos a bordo. Administrador de Shopify → Aplicaciones → Flujo de Shopify„Crear flujo de trabajo" → Plantilla „"Pedido pagado"". Agregar un „"Ejecutar código""-Acción añadida con el siguiente script:

    Ver código completo — JavaScript · Flow „Ejecutar código"
    Flujo de JavaScript „Ejecutar código"
    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. Opción A: Agregar acción de solicitud HTTP

    Entonces un „"Enviar solicitud HTTP""-Acción: Método CORREO, URL https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Cuerpo {{ steps.code.payload | json }}. Encabezamiento:

    encabezados HTTP
    Tipo de contenido: application/json Autorización: Básica
  3. Crear autenticación Base64

    Usted genera el valor de autorización en Mac/Linux en la terminal; el resultado aparece después básico en el encabezado. Luego el flujo de trabajo activar.

    Intento
    echo -n "TU_NOMBRE_DE_USUARIO:TU_CONTRASEÑA_DE_LA_APLICACIÓN" | base64
  4. Opción B — Puente a través de Make.com / Zapier (cualquier plan)

    ¿Estás usando Shopify Basic/Starter sin Flow? Crea en make.com o Zapier un flujo de trabajo: activador „"Órdenes de vigilancia (pagadas)"", Acción 1 „"Consigue un producto"" (recupera el metacampo), Acción 2 „"HTTP → Realizar una solicitud"" Se utiliza la autenticación básica para la URL del webhook. Si lo solicita al servicio de asistencia, podrá obtener una grabación de pantalla detallada.

  5. Opción C: Función en la nube personalizada

    Para proveedores con conocimientos técnicos: una función en la nube personalizada (Vercel / Cloudflare Workers / AWS Lambda) que recibe el webhook de Shopify, recupera el campo meta y lo pasa al webhook de Perfect-Day. Enviaremos una plantilla de código completa si lo solicita.

Paso 4: Pedido de prueba

  1. Realizar y verificar el pedido

    Realiza un pedido de prueba en tu tienda Shopify (usa la pasarela de pago ficticia si no quieres que se active un pago real) y márcalo como "pagado". Luego, comprueba:

    • Oficina administrativa de la plataforma → Día perfecto → Pedidos de la tienda: nuevo pedido con tipo_tienda=shopify?
    • Prueba de buzón de correo electrónico del cliente: ¿Recibió el correo electrónico de la marca con los códigos de cupón y un botón para imprimir?
Si algo está atascado

Solución de problemas.

El webhook devuelve un error 401: se requiere autenticación.

Nombre de usuario incorrecto: es el nombre de usuario de WordPress (inicio_de_sesión_de_usuario), no el correo electrónico. O la contraseña de la aplicación fue revocada o copiada incorrectamente. En caso de duda, genere una nueva.

El webhook devuelve 403 — cupón prohibido

El ID del cupón El metacampo no existe en el panel de administración de su plataforma o pertenece a otro proveedor. Verifique en cupones, si la identificación aparece allí.

El webhook devuelve 400 — validación

Campos faltantes o no válidos en el cuerpo JSON. Común: correo electrónico del cliente Esto falta porque el cliente realizó el pedido como invitado. Esto debe detectarse en el flujo de trabajo.

El pedido se procesa correctamente, pero el cliente no recibe ningún correo electrónico.

En el panel de administración de la plataforma, abra los detalles del pedido y verifique el estado del correo electrónico. El color rojo indica un problema con el servidor SMTP; por favor, póngase en contacto con el servicio de asistencia. De lo contrario, revise la carpeta de correo no deseado del cliente.

El pedido se procesará dos veces.

No hay problema: el webhook tiene protección contra la idempotencia. Lo verás en el segundo intento. duplicado: verdadero En la respuesta, no se generan códigos duplicados ni se envían correos electrónicos duplicados.

Servicio de configuración

¿Prefiere que lo configuremos por usted?

La configuración de Bridge es la parte más complicada con Shopify. Configuraremos tu flujo de trabajo de Shopify Flow o Make.com por completo; solo tienes que darnos acceso temporal y nosotros nos encargaremos del resto.

Preguntas frecuentes

¿Aún tienes preguntas?

¿Para qué necesito un puente?
El webhook de pedidos nativo de Shopify no proporciona automáticamente los campos meta del producto. El puente (Flow, Make.com o Cloud Functions) recupera el campo meta que contiene el ID del cupón y lo utiliza para construir el cuerpo correcto del webhook.
¿Cuál opción es la más sencilla?
Opción A (Shopify Flow): si tienes Plus o Advanced, todo se gestiona dentro de Shopify. De lo contrario, Opción B (Make.com): el plan gratuito es suficiente para la mayoría de las tiendas y no requiere código.
¿La contraseña de la aplicación está a salvo en Bridge?
Nunca lo compartas públicamente (ni en GitHub ni con capturas de pantalla). Usa una contraseña de aplicación diferente para cada tienda, de modo que puedas bloquear selectivamente las conexiones individuales. Si bien la URL del webhook es de acceso público, rechaza cualquier solicitud sin autenticación válida con un error 401.

Compra conectada, ¿y ahora qué?

Una vez que el webhook esté funcionando, todos los pedidos aparecerán automáticamente en tu panel de administración. Si necesitas otra conexión, puedes configurar cada tienda adicional en tan solo unos minutos.

Ir a la descripción general de la tienda