PayPal 
Przelew El módulo amplía Magento 2 con un sistema de afiliación completo que funciona directamente dentro de la tienda. Esto significa que el propietario de la tienda gestiona partners, comisiones, liquidaciones y materiales promocionales desde su propio panel de administración, mientras que los partners utilizan su propio dashboard en la cuenta de cliente.
En la práctica, el módulo permite implementar varios modelos de colaboración al mismo tiempo:
El mayor valor del módulo es la combinación de ventas, atribución, liquidaciones y gestión de partners en un único lugar. La tienda no necesita mantener un sistema de afiliación externo, exportar pedidos manualmente ni liquidar a los partners en hojas de cálculo.
El módulo proporciona al propietario de la tienda:
El partner recibe:
El módulo es adecuado para tiendas que quieren crear una red de partners de ventas sin recurrir a plataformas de afiliación externas o que desean conservar el control total sobre los datos y el proceso de liquidación.
Funciona especialmente bien en proyectos en los que el programa de afiliación debe ser gestionado por:
El módulo ofrece un formulario de solicitud para el programa de afiliación. El cliente puede solicitar por sí mismo participar en el programa indicando datos básicos de contacto, la dirección de su sitio o canal y una breve información sobre la promoción prevista.
Tras enviar el formulario:
WhatsApp
+48608012047
referral_code único,Pending,El administrador puede aprobar al afiliado desde el panel de Magento. Tras la aceptación:
Active,Cada afiliado recibe su propio enlace de afiliación basado en referral_code. El enlace funciona mediante un controlador de seguimiento y registra la atribución de la visita. Tras hacer clic, el sistema puede:
El módulo también admite un modelo en el que referral_code puede funcionar como código descuento en el carrito.
El administrador puede configurar en la cuenta del afiliado el campo:
Affiliate Coupon Discount (%)Si el valor es superior a cero, el sistema:
Cart Price Rule de Magento,referral_code,Gracias a ello, el afiliado puede promocionar:
Esta es una de las funciones comerciales más prácticas del módulo, ya que muchos propietarios de tiendas esperan que el partner no solo dirija tráfico, sino que también ofrezca al cliente una ventaja de precio concreta.
El módulo puede asignar un pedido a un afiliado en función de:
A nivel de pedido se guardan los datos:
affiliate_id,affiliate_attribution_id,affiliate_referral_code,is_affiliate_order,affiliate_commission_amount,affiliate_commission_status.Esto permite informar sobre la fuente de venta directamente en quote y sales_order.
La comisión se crea automáticamente para un pedido de afiliación. En el modelo actual:
Los estados de comisión admitidos incluyen, entre otros:
pending,approved,ready_for_payout,paid,rejected,cancelled,charged_back.El módulo admite un periodo de retención de comisiones. Esto significa que la comisión no tiene que estar lista para el pago de inmediato. Puede permanecer en estado pendiente durante un tiempo determinado y, solo una vez transcurrido el periodo establecido, ser aprobada automáticamente por cron.
Esta solución es especialmente importante en casos de:
El partner puede presentar una solicitud de pago si se ha alcanzado el umbral mínimo y dispone de saldo aprobado suficiente.
El workflow de payouts incluye:
ready_for_payout,paid.Gracias a ello, el propietario de la tienda puede gestionar los pagos de forma ordenada y auditable.
El módulo dispone de una capa antifraude básica que ayuda a eliminar los abusos más evidentes.
Incluye, entre otros:
Además, el módulo admite:
creditmemo,El módulo cuenta con su propio sistema de encolado y procesamiento de notificaciones. Puede registrar eventos operativos y enviar mensajes de correo electrónico.
Los casos admitidos incluyen, entre otros:
El partner utiliza un dashboard avanzado en la cuenta de cliente de Magento. El dashboard no es solo una lista de comisiones, sino un panel operativo completo.
En el panel del afiliado están disponibles:
El módulo incluye una función asistida por AI que permite al afiliado preparar un banner promocional listo a partir de un brief.
El usuario puede indicar:
El sistema envía a la capa AI:
El HTML generado del banner puede guardarse en la cuenta del afiliado y ser utilizado por el partner como material promocional listo.
El módulo admite informes y exportaciones CSV para las áreas clave del programa:
Esto facilita tanto la gestión diaria del programa como el análisis del rendimiento de los partners.
El módulo amplía el panel de administración de Magento con configuración y gestión del programa de afiliación.
El administrador tiene acceso a:
Además, en el panel están disponibles las secciones operativas:
Affiliate Commissions,Affiliate Payouts,Affiliate Fraud Cases,Affiliate Reports.En la lista de clientes y en la edición de cliente se muestran datos de afiliación como:
El cliente puede entrar primero en la tienda mediante un enlace de afiliación y después utilizar el código descuento del afiliado. Este modelo permite combinar el tracking clásico con beneficios para el cliente final.
El módulo se ha preparado pensando en una implementación en producción, por lo que contempla:
La capa AI del módulo es opcional y no bloquea el funcionamiento del programa de afiliación básico. Puede utilizarse para:
vector_store_id.El módulo no necesita mantener su propia base de productos para AI si la tienda ya utiliza un módulo externo que gestiona el conocimiento de producto y Vector Store.
El módulo puede venderse como solución para varios tipos de proyectos:
Argumentos comerciales especialmente sólidos son:
Las principales ventajas de esta solución son:
El módulo está destinado a:
Requiere módulos Magento compatibles relacionados con:
Customer,Quote,Sales,SalesRule,Cms,Email,Backend,Store.El módulo puede implementarse por fases:
Esto significa que es adecuado tanto para implementaciones MVP como para el desarrollo a largo plazo de un programa de partners.
Kowal_Affiliate es un módulo de afiliación maduro para Magento 2 que permite vender y lanzar un programa de partners completo dentro de la propia tienda. Combina enlaces de afiliación clásicos, códigos de recomendación, cupones descuento, comisiones, payouts, fraud prevention básico, informes y un panel de partner moderno.
Desde una perspectiva comercial, no es solo un complemento para enlaces de recomendación, sino una capa completa de partners para Magento 2 que puede ofrecerse como:
En la práctica, es una solución que responde a necesidades reales de tiendas que preguntan por:
Este documento describe cómo instalar, activar y realizar la primera configuración del módulo Kowal_Affiliate para Magento 2. La guía incluye tanto los requisitos técnicos como los pasos prácticos necesarios para lanzar el programa de afiliación en la tienda.
El módulo está destinado a:
En el proyecto Magento deberían estar disponibles al menos los módulos:
Magento_StoreMagento_CmsMagento_CustomerMagento_EmailMagento_QuoteMagento_SalesMagento_SalesRuleMagento_BackendEl módulo puede implementarse de forma estándar como paquete Composer.
El módulo se distribuye como paquete Composer, y un proceso de ejemplo es el siguiente:
composer require kowal/module-affiliatebin/magento module:enable Kowal_Affiliatebin/magento setup:upgradebin/magento setup:di:compilebin/magento cache:flushSi la tienda funciona en production mode, tras la instalación también conviene ejecutar:
bin/magento setup:static-content:deployDurante la instalación, el módulo:
quote y sales_order con campos de afiliación,Tras la instalación se crea una página de ejemplo del programa de partners:
identifier: affiliate-programtitle: Affiliate Partnership ProgramLa página tiene un carácter universal y puede utilizarse en producción tras una ligera personalización del contenido.
El patch es idempotente:
identifier, el módulo no la sobrescribirá.El panel de configuración se encuentra en:
Stores -> Configuration -> Affiliate ProgramSecciones principales:
GeneralCommissionPayoutsAffiliate PortalNotificationsFraudAIReportingTras activar el módulo se recomienda el siguiente orden de configuración:
Interruptor global del módulo.
Si el ajuste está desactivado:
Recomendación:
Yes en el entorno de producción tras finalizar las pruebas,No solo durante la desactivación del programa.Activa el formulario de solicitud del programa de afiliación en el frontend de la tienda.
Si la opción está desactivada:
Define la vida útil de la atribución basada en cookie tras hacer clic en un enlace de afiliación.
Ejemplos:
30 para un programa de afiliación estándar,7 para campañas cortas,60 o 90 solo cuando las condiciones del programa lo contemplen.Ruta de respaldo utilizada cuando el tracking link no contiene un target válido.
Ejemplos:
/promotionscatalog/category/view/id/12Activa el cálculo de comisiones para pedidos de afiliación.
Si el campo está desactivado:
Tarifa predeterminada de comisión porcentual.
Ejemplo:
10 significa una comisión del 10% sobre la base de cálculo actual.Número de días durante los cuales la comisión permanece en estado pendiente.
Una vez transcurrido este periodo, cron puede aprobar automáticamente la comisión.
Recomendación:
14 como valor predeterminado seguro,0 solo en un programa muy sencillo sin riesgo de devoluciones.Activa el workflow de pagos para afiliados.
Si la opción está desactivada:
Saldo mínimo necesario para solicitar un pago.
Ejemplos:
100250500Esta sección controla los contenidos mostrados en el dashboard del afiliado.
Breve descripción en la parte superior del dashboard del afiliado.
Debe explicar al partner:
Reglas de colaboración visibles para el afiliado.
Lo mejor es introducir:
Título predeterminado del material promocional de ejemplo.
Breve descripción bajo el título del banner.
Ruta de destino predeterminada para enlaces de afiliación y banners.
Ejemplos:
/promotions/springcatalog/category/view/id/24Activa el sistema interno de notificaciones y la cola de notificaciones.
Dirección de correo electrónico del administrador que debe recibir los mensajes operativos más importantes.
Si el campo queda vacío:
general de Magento como fallback en determinados flows.Define durante cuánto tiempo deben conservarse las entradas del log de notificaciones antes del cleanup.
Activa los controles antifraude básicos.
Bloquea la comisión cuando el cliente que realiza el pedido es al mismo tiempo el afiliado vinculado a ese pedido.
La sección AI es opcional y no es necesaria para el funcionamiento básico del programa de afiliación.
Interruptor principal de las funciones AI.
Clave API para la comunicación con OpenAI.
El campo se almacena en configuración cifrada.
Modelo utilizado para las funciones AI.
La lista de modelos puede descargarse de OpenAI tras guardar correctamente la clave API.
Tiempo máximo de espera para la respuesta de OpenAI.
Recomendación práctica:
60 segundos para un funcionamiento más estable en producción.Activa el log diagnóstico de requests y respuestas AI.
Útil en:
Longitud máxima del preview del payload registrado.
Activa el asistente del afiliado si la tienda quiere utilizar esta función.
Permite generar resúmenes AI cíclicos.
Permite utilizar conocimiento de producto desde Vector Store.
Permite utilizar conocimiento sobre el programa de afiliación, FAQ y documentación.
Define cómo se resuelve product_vector_store_id.
Identificador de Vector Store si la tienda utiliza retrieval.
Elimina o enmascara datos personales antes de enviar el prompt a la capa AI.
Activa la generación de informes y exportaciones CSV.
Ruta del directorio en el que deben guardarse las exportaciones generadas.
Ejemplo:
var/export/affiliateTras la instalación, el módulo amplía la edición de cliente de Magento con campos de afiliación.
En la edición de cliente se pueden gestionar, entre otros:
Affiliate ParticipantAffiliate StatusAffiliate Referral CodeAffiliate Website URLAffiliate NotesAffiliate BalanceAffiliate Coupon Discount (%)Indica si el cliente pertenece al programa de afiliación.
Estados principales:
PendingActiveSuspendedRejectedBlockedEl saldo se calcula automáticamente a partir de comisiones aprobadas y listas para el pago.
El campo:
Este campo permite asignar al afiliado un porcentaje de descuento que funcionará sobre su referral_code.
Si introduces un valor superior a 0, el módulo:
coupon_code.Ejemplo:
FMX1FBXXY35FMX1FBXXY3 como cupón descuentoEl módulo utiliza crons en el grupo default.
job: kowal_affiliate_auto_approve_commissionsschedule: */15 * * * *La tarea:
pending,approved.job: kowal_affiliate_process_notificationsschedule: */10 * * * *La tarea:
job: kowal_affiliate_cleanup_notification_logschedule: 30 2 * * *La tarea:
job: kowal_affiliate_generate_weekly_ai_insightsschedule: 0 6 * * 1La tarea:
El módulo proporciona comandos de servicio:
bin/magento kowal:affiliate:auto-approvebin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:cleanup-notificationsbin/magento kowal:affiliate:generate-ai-insightsbin/magento kowal:affiliate:export-reportLos más útiles en el primer arranque son:
bin/magento kowal:affiliate:process-notificationsbin/magento kowal:affiliate:auto-approveTras configurar el módulo se recomienda una prueba end-to-end sencilla.
Pending.Active o utiliza la acción de aprobación.affiliate_idaffiliate_referral_codeis_affiliate_order = 1Affiliate Coupon Discount (%), por ejemplo 5.Active.Referral Code como cupón.Comprueba:
affiliate_id,kowal_affiliate_commission.Comprueba:
customer_grid se ha actualizado,reindexRow,Si es necesario, ejecuta:
bin/magento indexer:reindex customer_gridComprueba:
Enable AI está activado,OpenAI API Key correcta,var/log no muestra errores de request a OpenAI.Comprueba:
Enable Notifications está activo,kowal_affiliate_notification_log,bin/magento kowal:affiliate:process-notificationsPara la primera implementación en producción se recomienda el siguiente conjunto:
Enable Module = YesEnable Affiliate Registration = YesTracking Cookie Lifetime = 30Enable Commissions = YesDefault Commission Rate = 10Commission Hold Period = 14Enable Payouts = YesMinimum Payout Amount = 100Enable Notifications = YesBlock Self Referral = YesEnable AI = No al inicio, si la tienda no necesita AI desde el primer díaTras una instalación y configuración correctas, Kowal_Affiliate permite lanzar en Magento 2 un programa de partners completo que incluye:
