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.
-
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.
-
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.
- Nombre:
-
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.
-
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"
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 } }; } -
Opción A: Agregar acción de solicitud HTTP
Entonces un „"Enviar solicitud HTTP""-Acción: Método
CORREO, URLhttps://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Cuerpo{{ steps.code.payload | json }}. Encabezamiento:Tipo de contenido: application/json Autorización: Básica -
Crear autenticación Base64
Usted genera el valor de autorización en Mac/Linux en la terminal; el resultado aparece después
básicoen el encabezado. Luego el flujo de trabajo activar.echo -n "TU_NOMBRE_DE_USUARIO:TU_CONTRASEÑA_DE_LA_APLICACIÓN" | base64 -
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.
-
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
-
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?
- Oficina administrativa de la plataforma → Día perfecto → Pedidos de la tienda: nuevo pedido con
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.
¿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.
¿Aún tienes preguntas?
¿Para qué necesito un puente?
¿Cuál opción es la más sencilla?
¿La contraseña de la aplicación está a salvo en Bridge?
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