Módulo PrestaShop de dropshipping BTSWHOLESALER
💄 ✨ 🧴
Módulo BTSWholesaler Dropshipping
El módulo que automatiza de la A a la Z tu dropshipping de cosméticos, perfumes & parafarmacia en PrestaShop
PrestaShop 1.7 → 9.x · 5 idiomas · CRON 24/7 · Marcas premium
¿Vendes cosmética, perfumes o parafarmacia en dropshipping? ¿Pasas tus días importando manualmente productos Vichy, La Roche-Posay, Nuxe, copiando las fichas INCI, gestionando las variantes por capacidad (75ml, 100ml, 200ml), transfiriendo cada pedido al portal BTS, comprobando los seguimientos, enviando los emails de envío a tus clientes?
Con el Módulo BTSWholesaler dropshipping, todo se vuelve automático. Lo configuras 1 vez y te olvidas. El módulo trabaja 24/7 en segundo plano.
⚡ Antes vs Después del Módulo BTSWholesaler
| Tarea |
❌ Sin el módulo |
✅ Con el módulo |
| Importar 1 000 productos perfumes + cosméticos |
10h+ manual, copiar y pegar |
1 clic, ~45 min en segundo plano |
| Variantes por capacidad |
Creación manual ml/g uno a uno |
Agrupación automática 75ml/100ml/200ml |
| Actualización de stocks & precios |
Verificación diaria en el portal BTS |
Delta sync CRON cada 2h |
| Procesamiento de un pedido |
Re-introducción en el portal BTS, elección de transportista |
Forward automático con transportista mapeado |
| Email de seguimiento al cliente |
Copiar y pegar el número |
Enviado automáticamente por PS |
| Multilingüe (5 idiomas UE) |
Traducción manual / DeepL de pago |
Textos nativos BTS recuperados en paralelo |
| Márgenes & precios de venta |
Cálculo Excel producto por producto |
10 tramos % automáticos por escalón |
| SEO & meta-descripciones |
Redacción manual |
Plantillas con variables automáticas |
👤 ¿A quién va dirigido este módulo?
💄
Parafarmacia online
Vendes productos de cuidado (Vichy, La Roche-Posay, Avène, Bioderma) y quieres multiplicar tu catálogo sin gestionar stock físico.
🌸
Perfumería e-commerce
Quieres referenciar Dior, Chanel, Calvin Klein, Hugo Boss, YSL con sus variantes EDT/EDP 50ml/100ml en pocos clics.
📈
E-commerciante en crecimiento
Gestionas más de 5 000 referencias cosméticas manualmente y pierdes el tiempo en lo operativo en lugar del marketing.
🎯 Funcionalidades completas del Módulo BTSWholesaler
📦 Importación del catálogo BTS — En masa, sin timeout
- Autenticación JWT Bearer en API BTS v2.1 (seguridad bancaria)
- Importación unitaria por EAN o ID BTS para test o recuperación
- Importación en masa: 50, 100, 500, 1 000 productos o todo el catálogo
- Filtros avanzados: por marca, por categoría BTS, modo limitado o completo
- Modo ligero (light update): si un producto ya está importado, solo se actualiza el precio/stock/disponibilidad. Sin reescritura de descripciones, categorías o etiquetas.
- Recuperación ante error: relanzamiento asíncrono automático en caso de timeout
- Adaptado a hosting modesto: time-budget 60s, retry en 429 rate-limit
🧴 Agrupación inteligente por capacidad
BTSWholesaler suele listar un mismo perfume en varios SKUs distintos para cada capacidad. El módulo detecta automáticamente los grupos y crea 1 producto PrestaShop con sus variantes:
| SKU BTS |
Nombre BTS |
Resultado en PrestaShop |
3349668010615 |
Dior Sauvage EDT 60ml |
1 producto "Dior Sauvage EDT"
con 3 variantes:
· 60ml · 100ml · 200ml |
3349668010622 |
Dior Sauvage EDT 100ml |
3349668010639 |
Dior Sauvage EDT 200ml |
- Detección automática de capacidades: ml, g, oz, cl, l, kg, gr
- Switch on/off en los ajustes: si prefieres 1 producto PS por SKU, el modo se puede desactivar
- Stock individual por variante
- Referencia PS única por combinación (se conserva el EAN BTS)
🌐 Multilingüe 5 idiomas — Mercados europeos
| ?? Francés |
?? Español |
?? Inglés |
?? Italiano |
?? Alemán |
- Llamadas paralelas vía cURL multi: 1 round-trip para recuperar todos los idiomas de una página
- Detección automática de los idiomas PS activos que tienen equivalente BTS
- Auto-generación de descripciones formateadas en HTML cuando la API no proporciona ninguna para un idioma
- Reformateo inteligente de la descripción: cada frase se convierte en un <p> para la legibilidad y el SEO
- Mini-descripción automática por idioma (description_short PS)
- Slug limpio (link_rewrite) sin acentos ni caracteres especiales
🚚 Mapeo de transportistas PS ↔ BTS — Precisión máxima
Para cada transportista de tu tienda PrestaShop, asocias el carrier_code BTSWholesaler correspondiente mediante una tabla de mapeo dedicada:
| Transportista PS |
Código BTS asociado |
País |
| Colissimo Domicilio |
colissimo_fr |
?? Francia |
| Mondial Relay |
mondial_relay_fr |
?? Francia |
| Chronopost |
chronopost_fr |
?? Francia |
| DHL Express |
dhl_express |
?? Europa |
| DPD |
dpd_fr |
?? Francia |
- Recuperación automática de los precios vía
getShippingPrices() según el país de entrega
- Fallback elegante: si un transportista no está mapeado, el módulo usa el transportista por defecto configurado
- Retry en 429 rate-limit durante el forward del pedido
💰 Márgenes configurables — 10 tramos por defecto
| Modo |
Descripción |
¿Para quién? |
| Tramos |
% diferente según la franja de precio de compra (ej.: +100% por debajo de 10€, +50% por encima de 100€) |
⭐ Recomendado — maximiza el margen en precios pequeños |
| Markup fijo |
Un único % en todos los productos |
Estrategia simple, margen constante |
| Autónomo |
Modo de impuesto simplificado (IVA no aplicable) |
Autónomos con franquicia de IVA |
🔍 SEO & Plantillas personalizables
- Meta title / meta description con variables:
{name}, {brand}, {ean}, {capacity}
- Generación automática de meta_keywords a partir del título, marca y capacidad
- Filtro stop-words FR/EN integrado (le, la, les, the, of...)
- Etiquetas PS automáticas: marca, género (Mujer/Hombre/Mixto), capacidad
- Imagen insertada en la descripción larga (al inicio o al final) — boost SEO on-page
- Auto-desactivación por rotura de stock u opción "mantener visible para el SEO"
✏️ Reemplazos de texto — Personaliza con tu marca
Reglas de sustitución aplicadas a los nombres y descripciones importados. Varios scopes:
| Texto fuente |
Texto destino |
Campo |
Envío rápido |
Expedición rápida |
Descripción |
BTSWholesaler |
Mi Tienda |
Todos |
en stock |
entrega en 24h |
Descripción |
🛒 Pipeline de pedidos 100% automático
El escenario que lo cambia todo:
- 👤 Un cliente pide un perfume en tu tienda PrestaShop
- 💳 Paga → el pedido pasa al estado "Pago aceptado"
- ⚡ El módulo reenvía automáticamente el pedido a BTS (con el transportista mapeado según el país)
- 📨 BTS prepara y envía el paquete directamente a tu cliente (en marca blanca)
- 🚚 El CRON del módulo recupera el número de seguimiento cuando está disponible
- 📧 PrestaShop envía automáticamente el email de envío al cliente con su seguimiento
→ No has tocado NADA. El pedido se ha procesado de principio a fin.
- Hook nativo PS
actionOrderStatusUpdate — activación instantánea al cambio de estado
- 3 modos de pago BTS compatibles: transferencia bancaria, PayPal, tarjeta bancaria
- Dirección del cliente convertida al formato BTS (firstname, lastname, address, postcode, city, country, phone)
- Idempotente: no rehace el forward de un pedido ya transmitido
- Panel de control: ver todos tus pedidos PS y su estado BTS de un vistazo
- Cancelación propagada (opcional): si cancelas el pedido PS, el módulo llama a
setCancelOrder en BTS
⏰ CRON 24/7 — 4 acciones automatizadas
| Acción CRON |
Función |
Frecuencia recomendada |
full_import |
Importación completa del catálogo (creación o actualización) |
1×/día |
delta_sync |
Sincronización incremental (solo los productos modificados) |
cada 2h |
stock_check |
Actualización de stock + disponibilidad de los productos ya importados |
cada hora |
tracking |
Recupera seguimientos + email cliente de envío |
cada hora |
- Clave segura de 32 caracteres generada en la instalación — tus URLs CRON no se pueden adivinar
- Regeneración con 1 clic de la clave en caso de filtración
- Auto-relanzamiento asíncrono: el módulo se vuelve a llamar a sí mismo en segundo plano si se alcanza el time-budget (60s) — sin timeout Apache
- Reanudación precisa: retoma exactamente en la página donde se detuvo
- Retry automático en rate-limit / error 429 / timeout de red
- Estado en tiempo real en el BO: página actual, creados, actualizados, errores
- Botón stop: detiene limpiamente el CRON en curso
- Límite de productos configurable: importar solo N productos por "job"
📊 Pestaña Analytics — Pilotaje de tu dropshipping
- Histórico de importaciones: quién, cuándo, cuántos, éxitos/fallos
- Registro de errores detallado: errores de descarga de imagen, variantes rechazadas, timeout API…
- Lista de productos importados con filtros (por marca, por categoría, por estado)
- Exportación CSV de la lista de productos BTS importados (para análisis externo)
- Paginación: 20, 50, 100, 500 productos por página
- Búsqueda por EAN, nombre, marca
🏷️️ El catálogo BTSWholesaler — Marcas premium accesibles
BTS Wholesaler es uno de los mayores mayoristas B2B europeos (con sede en España) especializado en cosméticos de grandes marcas, perfumes de nicho y marcas de lujo, parafarmacia e higiene & belleza. Vista no exhaustiva de las marcas disponibles:
Vichy La Roche-Posay Avène Bioderma Nuxe Caudalie Eucerin L'Oréal Dior Chanel Calvin Klein Hugo Boss YSL Versace Dolce & Gabbana Garnier Nivea Sanex Yves Rocher + cientos más
Categorías cubiertas: perfumería hombre/mujer, cuidado facial, cuidado corporal, maquillaje, capilar, solar, higiene, parafarmacia, complementos alimenticios, bebé & niño.
⭐ 10 razones para elegir el Módulo BTSWholesaler
- 🚀 Instalación en 5 minutos: pega tu token JWT, prueba la conexión, ¡listo!
- 🤖 100% AJAX, cero recargas: interfaz fluida, moderna, agradable
- 📚 Documentación integrada en 12 secciones: no se necesita conexión a internet para consultarla
- 🛡️️ Compatible PS 1.7 → 9.x: capa de compatibilidad
BtsCompat que gestiona todas las versiones
- ⚡ Optimizado para hosting modesto: importación por chunks, throttle, time-budget 60s
- 🔐 Seguridad máxima: token JWT Bearer, hash_equals en clave CRON, validación del lado del servidor
- 🎨 Diseño personalizado: header con gradiente azul, pestañas estilizadas, paleta coherente
- 🧹 Mantenimiento fácil: eliminación selectiva con opciones, limpieza de huérfanos
- 💎 Sin AdminController, sin Tab: no contamina tu menú BO, configuración únicamente en la ficha del módulo
- 🌟 Autor francés: soporte en francés, actualizaciones regulares, código limpio & comentado
🎬 Cómo funciona en 4 pasos
1
Instala el módulo
Descarga el ZIP, instala desde el BO. Auto-creación de 10 tablas, 1 proveedor, 4 URLs CRON seguras.
2
Conecta tu cuenta
Pega tu token JWT BTSWholesaler, elige tu idioma principal, prueba la conexión (1 clic).
3
Configura tus márgenes
10 tramos por defecto. Plantillas SEO, mapeo de transportistas, multi-imágenes, multilingüe: todo es parametrizable.
4
Lanza la importación
Filtra por marcas + categorías, elige la cantidad, pulsa "Iniciar". El CRON toma el relevo 24/7.
🔧 Compatibilidad técnica
| PrestaShop |
1.7.x → 9.x (probado en PS 9.0) |
| PHP |
7.4 mínimo, recomendado 8.1+ |
| MySQL / MariaDB |
5.7+ / 10.3+ |
| Multi-shop |
Compatible (utiliza la tienda actual) |
| Hooks utilizados |
actionOrderStatusUpdate |
| Override de clase |
Ninguno (preserva tus otros módulos) |
| AdminController |
Ninguno |
| Pestaña sidebar BO |
Ninguna (no contamina tu menú) |
| Cuenta BTSWholesaler |
Cuenta B2B requerida (en btswholesaler.com) |
| Token JWT API |
Solicitar a tu comercial BTS |
❓ Preguntas frecuentes
P: ¿El módulo BTSWholesaler dropshipping funciona en PrestaShop 9?
R: Sí, totalmente compatible con PS 9.x. La capa de compatibilidad interna BtsCompat también gestiona las versiones 1.7 y 8 sin modificación del código.
P: ¿Cuántos productos puedo importar?
R: Sin límite por parte del módulo. El catálogo BTSWholesaler completo contiene decenas de miles de referencias. Puedes importarlo todo o segmentar por marcas (Vichy, La Roche-Posay…) o categorías (perfumería, cuidado facial…).
P: ¿Aguantará mi hosting compartido de 9 €/mes?
R: Sí, el módulo está especialmente optimizado para los hostings modestos. CRON por chunks, time-budget 60s, auto-relanzamiento asíncrono. Sin riesgo de timeout Apache 5xx.
P: ¿Cómo funciona el modo de variante por capacidad?
R: El módulo detecta los SKUs que comparten el mismo nombre base y agrupa las capacidades en variantes de un único producto PS. Switch on/off en los ajustes si prefieres 1 producto por SKU.
P: ¿Los pedidos se pagan automáticamente en BTS?
R: El módulo soporta 3 modos de pago (banktransfer, paypal, tarjeta). Según tu acuerdo con BTS, el pago puede ser automático (cuenta prepago) o requerir tu validación desde tu portal. El módulo recupera después el seguimiento + email cliente automáticamente.
P: ¿Qué pasa si una imagen BTS está dañada?
R: El módulo valida cada imagen con getimagesize() antes de la importación. Los archivos corruptos (TIFF disfrazado de JPEG, etc.) se rechazan limpiamente. El producto se crea sin imagen en lugar de bloquear la importación.
P: ¿Qué pasa si BTS no está disponible temporalmente?
R: El módulo detecta los errores de red y HTTP 429 (rate-limit), hace retry automáticamente con backoff y retoma donde se había detenido en la siguiente ejecución CRON.
P: ¿Puedo desinstalar limpiamente?
R: Sí, pero la desinstalación conserva voluntariamente tus productos importados (se evita la pérdida irreversible). Una zona "Eliminación selectiva" en la pestaña Mantenimiento permite una limpieza granular con confirmación.
🎯 ¿Listo para automatizar tu dropshipping?
El Módulo BTSWholesaler dropshipping es la herramienta más completa para vender las marcas premium de cosméticos, perfumes y parafarmacia en PrestaShop. Una vez configurado, trabaja para ti 24/7.
⚡ INSTALACIÓN 5 MIN · 📚 DOCUMENTACIÓN INTEGRADA · 🛡️ COMPATIBLE PS 1.7 → 9 · 🇫🇷 SOPORTE EN FRANCÉS
📋 Detalles técnicos para desarrolladores
Tablas BDD creadas (10): wp_btswholesaler_margins, wp_btswholesaler_history, wp_btswholesaler_category_mapping, wp_btswholesaler_product_meta, wp_btswholesaler_combination_meta, wp_btswholesaler_text_replacements, wp_btswholesaler_seo_templates, wp_btswholesaler_import_errors, wp_btswholesaler_carrier_mapping, wp_btswholesaler_orders
Configuraciones PS: WPBTS_SETTINGS (JSON), WPBTS_CRON_KEY, WPBTS_SUPPLIER_ID, WPBTS_DESCRIPTIONS, WPBTS_IMPORT_PROGRESS, WPBTS_DELTA_PROGRESS
API BTS utilizadas: getListProducts, getListProductsMultilang (cURL multi paralelo), getCategoriesList, getProductCategories, getDictionnary, getCarriers, getShippingPrices, setOrder, setCancelOrder, getOrders, getOrder, getOrderTracking
Arquitectura: 4 clases PHP limpias (BtsCompat, BtsApiClient, BtsCategoryMapper, BtsProductImporter) + módulo principal. Sin override de clase core PrestaShop. Código comentado en francés.
Seguridad: autenticación JWT Bearer, hash_equals() en la clave CRON, pSQL() en todas partes, token CSRF nativo PS en AJAX, throttle anti DoS, validación de formato de imágenes.
📦 Módulo desarrollado por WebPoint · webpoint.fr · Actualizaciones regulares · Código limpio & comentado
