Integración BigBuy¶
Este plugin conecta su tienda Shopware 6 con la plataforma BigBuy y permite dropshipping completamente automatizado: los productos, categorías, inventarios y precios se importan automáticamente del catálogo BigBuy, los nuevos pedidos se envían directamente a BigBuy y la información de seguimiento se devuelve a Shopware, todo sin esfuerzo manual.
Destacados
- 🛍️ Importación automática de productos, categorías e imágenes
- 📦 Sincronización en tiempo real de inventarios y precios
- 🚀 Transferencia automática de pedidos a BigBuy (Dropshipping)
- 🔍 Recuperación automática de números de seguimiento y estado de envío
- ⚙️ Cuatro tareas programadas configurables (Cronjobs)
- 💰 Margen de ganancia configurable (porcentaje y/o fijo)
❓ Preguntas frecuentes¶
¿Qué es BigBuy?
BigBuy es un distribuidor mayorista y proveedor de dropshipping europeo con más de 200,000 productos. A través de la API REST de BigBuy, los productos, precios, inventarios y pedidos se pueden sincronizar completamente de forma automática. Se requiere un paquete BigBuy Ecommerce activo.
¿Qué datos se importan de BigBuy?
El plugin importa categorías de productos, productos (incluidos nombres y descripciones multilingües, EAN, peso), imágenes de productos, inventarios y precios.
¿Cómo funciona la transferencia de pedidos?
Tan pronto como un pedido de Shopware alcanza el estado « En procesamiento », se transmite automáticamente a BigBuy. BigBuy luego se encarga de la preparación y el envío directo al cliente final. El ID del pedido de BigBuy se almacena en los campos personalizados del pedido de Shopware.
¿Cómo llegan los números de seguimiento a la tienda?
El cronjob de seguimiento recupera cada hora la información de envío actual de BigBuy y escribe automáticamente el número de seguimiento en el envío correspondiente de Shopware.
¿Puedo configurar un margen de ganancia?
Sí. En la sección de configuración del plugin, puede establecer un margen en porcentaje (por ejemplo, 20%) y/o un monto fijo (por ejemplo, 5,00 €). Ambos valores se aplican al precio de compra de BigBuy (precio mayorista) en cada actualización de precio, para determinar el precio de venta en la tienda.
¿Se admite el modo sandbox de BigBuy?
Sí, el modo sandbox se puede activar para probar la transferencia de pedidos y el seguimiento de envíos sin transacciones reales. Tenga en cuenta: el sandbox de BigBuy no proporciona datos del catálogo – por lo tanto, la sincronización de productos, categorías, inventarios y precios no se puede probar contra el sandbox. Se requiere una clave API de producción con el modo sandbox desactivado.
¿Qué paquete de Shopware se necesita?
El plugin requiere el plugin CNK Foundation y Shopware 6.7. Por parte de BigBuy, se necesita un paquete Ecommerce activo que desbloqueara el acceso a la API.
🔧 Instalación¶
- Requisito previo: Plugin CNK Foundation (a partir de la versión 3.0.4)
- Requisito previo: Paquete BigBuy Ecommerce con acceso a la API
- Instalación a través del gestor de complementos de Shopware o por Composer
- Activar el plugin:
bin/console plugin:install --activate CnkPlatformBigBuyIntegration - Registrar tareas programadas:
bin/console scheduled-task:register - Realizar la configuración en el área de administración de Shopware
⚙️ Configuración¶
Credenciales de acceso API¶
| Configuración | Descripción |
|---|---|
| Clave API | Token Bearer de su cuenta cliente de BigBuy |
| Modo Sandbox | Usar sandbox de BigBuy (api.sandbox.bigbuy.eu) en lugar del entorno de producción (api.bigbuy.eu). Sin transacciones reales |
| Probar conexión | Botón que verifica las credenciales ingresadas contra la API de BigBuy y muestra el resultado directamente en el admin |
Encontrará la clave API en su cuenta cliente de BigBuy en la configuración de API. Use el botón Probar conexión para verificar las credenciales antes de guardarlas.
Sincronización de productos¶
| Configuración | Descripción | Por defecto |
|---|---|---|
| Sincronización de productos habilitada | Habilitar/deshabilitar la importación de productos | Habilitado |
| Intervalo de sincronización | Frecuencia de importación de productos en segundos | 86400 (24 h) |
| Idioma del producto | Idioma de los datos del producto (de, en, fr, es, it …) | de |
| Canal de ventas | Lista de selección del canal de ventas donde estarán visibles los productos importados | – |
| Categoría predeterminada | Lista de selección de la categoría de entrada bajo la cual se crearán las categorías de BigBuy | – |
| Importar imágenes | Descargar imágenes de productos de BigBuy y establecer la imagen de portada | Habilitado |
| Tamaño de lote | Número de productos por llamada API | 100 |
Inventario & Precios¶
| Configuración | Descripción | Por defecto |
|---|---|---|
| Sincronización de inventario/precio habilitada | Habilitar/deshabilitar la sincronización | Habilitado |
| Intervalo de sincronización | Frecuencia de actualización en segundos | 3600 (1 h) |
| Margen de ganancia (%) | Margen en porcentaje en los precios de BigBuy | 0 |
| Margen de ganancia fijo (€) | Cantidad fija agregada a cada precio | 0 |
Transferencia de pedidos¶
| Configuración | Descripción | Por defecto |
|---|---|---|
| Transferencia de pedidos habilitada | Habilitar/deshabilitar la transferencia a BigBuy | Habilitado |
| Transferencia automática | Transferir el pedido inmediatamente al estado « En procesamiento » | Habilitado |
| Estado después de la transferencia | Lista de selección de estados de pedido de Shopware; el pedido se establecerá en este estado después de una transferencia exitosa | En procesamiento |
| Código del proveedor de envío | Código de transportista de BigBuy (por ejemplo, SEUR_STANDARD, DHL) | – |
Seguimiento de envíos¶
| Configuración | Descripción | Por defecto |
|---|---|---|
| Sincronización de seguimiento habilitada | Habilitar/deshabilitar la sincronización de números de seguimiento | Habilitado |
| Intervalo de sincronización | Frecuencia de consultas de seguimiento en segundos | 3600 (1 h) |
🔄 Sincronizaciones en detalle¶
Importación de productos¶
La importación de productos se ejecuta diariamente (por defecto: cada 24 horas) como una tarea programada en segundo plano:
- Las categorías de BigBuy se asignan a categorías de Shopware bajo la categoría de entrada configurada
- Los productos se importan con descripciones, EAN, peso e imágenes (la primera imagen se establece como imagen de portada)
- Los productos reciben la tasa de impuesto estándar de la tienda y se hacen visibles automáticamente allí – si se configura un canal de ventas
- Los productos ya importados se reconocen por el ID de producto de BigBuy y se actualizan (no hay importación duplicada); las imágenes descargadas se reutilizan en una sincronización posterior en lugar de ser recargadas
Inventario & Precios¶
Los inventarios y precios se actualizan cada hora. El margen de ganancia configurado se recalcula y se aplica en cada actualización:
El margen se aplica al precio de compra de BigBuy (precio mayorista). El valor calculado se guarda como precio bruto; el precio neto se deriva automáticamente de la tasa de impuesto estándar de la tienda.
Transferencia de pedidos¶
Los pedidos que contienen exclusivamente productos de BigBuy se transfieren automáticamente a BigBuy tan pronto como se establece el estado « En procesamiento ». El ID de pedido devuelto por BigBuy se almacena en el campo personalizado bigbuy_order_id del pedido de Shopware para evitar transferencias duplicadas. Después de una transferencia exitosa, el pedido se establece automáticamente en el estado de pedido elegido en Estado después de la transferencia (también se admiten estados de pedido personalizados).
Seguimiento de envíos¶
Cada hora, todos los pedidos de Shopware con el campo bigbuy_order_id configurado se consultan con BigBuy. Tan pronto como BigBuy devuelve un número de seguimiento, se ingresa en el envío correspondiente de Shopware y está disponible para correos electrónicos de clientes y detalles de pedidos.
⏱️ Tareas programadas (Cronjobs)¶
El plugin registra cuatro tareas programadas:
| Nombre de tarea | Tarea | Intervalo estándar |
|---|---|---|
cnk_bigbuy.product_sync | Importación de productos & categorías | 24 horas |
cnk_bigbuy.stock_price_sync | Inventario & precios | 1 hora |
cnk_bigbuy.order_transfer | Transferencia de pedidos pendientes | 15 minutos |
cnk_bigbuy.tracking_sync | Recuperación de números de seguimiento | 1 hora |
Los intervalos se pueden ajustar en el área de administración de Shopware en Configuración → Sistema → Tareas programadas. La ejecución requiere un servicio Shopware Message Worker activo:
Ejecutar una tarea manualmente (CLI)¶
Cada tarea se puede iniciar directamente en la terminal para pruebas o para una ejecución única. Los comandos ejecutan la misma lógica que las tareas programadas y producen un resumen de resultados:
bin/console cnk:bigbuy:product-sync # Importación de productos & categorías
bin/console cnk:bigbuy:stock-price-sync # Actualización de inventario & precios
bin/console cnk:bigbuy:order-transfer # Transferencia de pedidos pendientes
bin/console cnk:bigbuy:tracking-sync # Recuperación de números de seguimiento
🛒 Casos de uso típicos¶
Dropshipping puro¶
La tienda vende exclusivamente productos de BigBuy. Los productos, inventarios y precios se sincronizan completamente de forma automática. Los pedidos se transmiten inmediatamente a BigBuy, que envía directamente al cliente final.
Tienda híbrida¶
La tienda ofrece sus propios productos y productos de BigBuy en paralelo. El plugin solo sincroniza productos vinculados a un ID de producto de BigBuy. Sus propios productos permanecen sin cambios.
Precios con margen de ganancia¶
Usando el margen de ganancia configurable, los operadores de tiendas pueden gestionar su margen de forma específica sin necesidad de ajustar los precios manualmente.
⭐ Ventajas para los operadores de tiendas¶
- Sin esfuerzo manual de mantenimiento de productos – el catálogo de BigBuy permanece automáticamente actualizado
- Sin almacenamiento – BigBuy maneja el envío directo al cliente final
- Los datos de inventario en tiempo real reducen el sobrevendimiento
- Configuración centralizada de todos los parámetros de sincronización en el admin de Shopware
- Trazabilidad completa a través de los ID de pedido de BigBuy en Shopware
- Los números de seguimiento llegan automáticamente a Shopware – menos consultas de clientes
🧩 Alcance de funcionalidades¶
- Importación de categorías y productos de BigBuy incluidas imágenes y textos multilingües
- Sincronización en tiempo real de inventarios y precios
- Margen de ganancia configurable (porcentaje y/o fijo)
- Transferencia automática de pedidos a BigBuy al cambiar de estado
- Cronjob de respaldo para transferencias de pedidos pendientes
- Importación automática de números de seguimiento en envíos de Shopware
- Cuatro tareas programadas configurables independientemente
- Modo sandbox para pruebas sin riesgo
- Registro de errores a través del registro de Shopware
📚 Documentación¶
Se proporcionarán más contenidos de documentación y capturas de pantalla con las próximas versiones del plugin.
Documentación técnica de API de BigBuy: https://api.bigbuy.eu/rest/doc