Hepsiburada Marketplace Sync - Actualiza stock y precios por API o CSV

Tu tienda es la fuente de la verdad. El marketplace debe seguirla.

Vender en Hepsiburada significa mantener actualizadas tres cosas en cada anuncio: el precio, el stock disponible y el plazo de envío. Si lo haces a mano, acabas reexportando una hoja de cálculo cada mañana; si lo olvidas un día, o vendes existencias que ya no tienes o te quedas con un precio que no querías ofrecer. Este módulo convierte tu catálogo de PrestaShop en la única fuente y traslada los cambios al otro lado.

Dos formas de entregar, un solo generador de filas

• Exportación CSV — descarga un archivo con las columnas exactas, en el orden exacto, que espera el cargador masivo de Hepsiburada, y súbelo tú mismo en el portal del vendedor.
• Listing API — introduce tus credenciales y el módulo se comunica directamente con Hepsiburada. Apunta un cron a la dirección facilitada y los cambios de stock y precio se entregan solos.

Ambas vías pasan por el mismo generador de filas, así que el archivo que descargas y los datos que envía la API siempre coinciden. Si alguna vez necesitas comprobar qué está haciendo la API, descarga el archivo.

Qué envía, y qué deja intacto

El equipo de catálogo de Hepsiburada es el propietario del anuncio en sí, por lo que este módulo nunca toca los nombres de tus productos, ni las descripciones, imágenes, categorías o atributos. Envía los campos que pertenecen al vendedor: precio sin impuestos, stock disponible, plazo de envío, etiquetas de transportista y de dirección, cantidad máxima de compra, y el tipo y la longitud de la personalización. No se sobrescribe nada que pertenezca a su catálogo.

Protecciones, porque un precio equivocado sale caro

• Reservar stock ("Hold back") — resta un margen de seguridad a cada cantidad antes de enviarla. Configúralo en 2 y un producto con 5 unidades se ofrece con 3, de modo que un pedido del marketplace no pueda vender lo que tu tienda acaba de vender.
• Multiplicador de precio — envía el precio de la tienda sin cambios, o añade un margen para cubrir la comisión del marketplace. Los valores superiores a 10 se rechazan por considerarse una errata en lugar de publicarse.
• "Never send a price below" (nunca enviar un precio inferior a) — un suelo de seguridad. Las filas por debajo se retienen y se notifican en lugar de publicarse con la cifra equivocada.
• "Never offer more than" (nunca ofrecer más de) — limita la cantidad mostrada en el marketplace independientemente de lo que haya en el almacén.

Los productos desactivados o no disponibles para pedido se envían con stock cero en lugar de descartarse, de modo que dejan de venderse en el marketplace en vez de quedarse ahí obsoletos sin que nadie se entere.

Te dice qué no se puede enviar, y por qué

El panel de estado de la pestaña Getting started nombra los productos afectados en lugar de dejarte adivinando: sin SKU ni código de stock, un precio que resulta ser cero, un precio por debajo de tu suelo, un nombre que falta en el idioma de exportación. Los SKU duplicados se detectan antes de enviar: Hepsiburada rechaza un lote entero si uno aparece dos veces, así que detectarlo de antemano te ahorra volver a subirlo todo. El campo de transportista se valida contra los transportistas que publica Hepsiburada y avisa si el nombre no se reconoce, algo que por su parte se ignora en silencio.

Sincronización programada que informa con honestidad

La pestaña Send muestra una dirección de cron con token. Apunta el cron de tu alojamiento a ella —cada treinta minutos es lo habitual— y, por defecto, envía solo lo que ha cambiado desde la última ejecución correcta; al guardar productos y con los movimientos de stock, los anuncios se marcan como modificados automáticamente. Añade &mode=full para reenviarlo todo después de que Hepsiburada haya rechazado o perdido un lote. El endpoint responde en JSON, de modo que una herramienta de monitorización puede distinguir un fallo real de una ejecución sin novedades; las ejecuciones simultáneas se rechazan para que una lenta no se acumule, y regenerar la dirección invalida la anterior de inmediato si la URL llega a filtrarse.

Vincular productos, y combinaciones

Cada anuncio de Hepsiburada tiene un HepsiburadaSku. Pégalo en la pestaña Hepsiburada de la ficha de producto, o usa "Link products automatically" (vincular productos automáticamente) si tus referencias de PrestaShop ya coinciden con tus códigos de stock de vendedor en Hepsiburada. Las combinaciones son totalmente compatibles: cada una se vincula y se valora por separado, porque Hepsiburada trata cada variante como un anuncio propio.

Qué corrigió la versión 2.0

La versión 1.x calculaba siempre el precio a partir de wholesale_price, un campo que la mayoría de las tiendas deja vacío, por lo que todos los precios exportados salían a 0,00. La versión 2.0 usa por defecto el precio de venta, se niega a exportar un precio cero y avisa cuando se selecciona el precio de coste como origen en un catálogo sin precios de coste. La versión 1.x también escribía el SKU en cada actionProductUpdate, de modo que cualquier otra vía de guardado —un cambio de stock, el web service, otro módulo— lo borraba en silencio; la 2.0 solo escribe cuando el formulario de producto ha enviado realmente esos campos. Los vínculos ahora se guardan por tienda en lugar de un único SKU por producto a nivel global, y la 1.x guardaba las credenciales de la API pero nunca enviaba ninguna petición a ninguna parte, así que la actualización deja la API desactivada hasta que la habilitas de forma deliberada.

Compatibilidad

PrestaShop 1.7, 8 y 9, sin overrides, en ocho idiomas: alemán, español, francés, inglés, italiano, neerlandés, polaco y turco. Compatible con multitienda: los vínculos se guardan por tienda, así que el mismo producto puede tener distintos SKU de Hepsiburada en tiendas diferentes, y la página de configuración siempre te indica sobre qué tienda está actuando. Al desinstalarlo se eliminan las tablas y los ajustes del módulo; tus anuncios de Hepsiburada conservan los últimos valores recibidos y simplemente dejan de actualizarse.

Preguntas frecuentes

¿Necesito la API o me basta con un archivo?

Cualquiera de las dos. Descarga el CSV y súbelo en el portal del vendedor, o activa la API y deja que un cron entregue los cambios. Ambas producen datos idénticos.

¿Cambiará los títulos o las imágenes de mis productos en Hepsiburada?

No. Esos los gestiona su equipo de catálogo. El módulo solo envía precio, stock, plazo de envío, etiquetas de transportista y de dirección, cantidad máxima y ajustes de personalización.

¿Cómo evito vender de más?

Configura una cantidad reservada ("Hold back"). Cada cifra de stock se reduce en esa cantidad antes de enviarse, así que el marketplace nunca ve tus últimas unidades.

¿Qué credenciales necesita la API?

Las credenciales de la Listing API de Hepsiburada, que no son las de acceso al portal del vendedor: solicítalas a Hepsiburada. Un 401 significa que el usuario o la contraseña son incorrectos, un 403 que no tienen acceso a la Listing API y un 404 que el ID de vendedor es incorrecto. Hay un botón "Test connection" que muestra el mensaje exacto que devuelven.

¿Admite combinaciones?

Sí. Cada combinación se vincula y se valora por separado, porque Hepsiburada trata cada variante como un anuncio propio.

¿Por qué se rechazó toda mi subida?

Casi siempre por un SKU duplicado: Hepsiburada rechaza el lote entero si uno aparece dos veces. El panel de estado encuentra los duplicados antes de que envíes.

Todos mis precios de la 1.x se exportaron a cero. ¿Está arreglado?

Sí. Aquello se debía a que la 1.x calculaba el precio desde el campo de precio de coste, que la mayoría de las tiendas deja vacío. La versión 2.0 usa el precio de venta por defecto y se niega a exportar un precio cero.