🛍️ Promofarma
La integración con Promofarma está pensada específicamente para farmacias y parafarmacias que venden online a través del marketplace de Promofarma. TPVReady sincroniza tu catálogo con el de Promofarma, hace matching automático por EAN y CN (Código Nacional), y genera el CSV diario que Promofarma lee para mantener actualizados precio, stock y disponibilidad.
Todo el proceso es automático: una vez configurado, no tienes que tocar nada.
La integración Promofarma se activa por superadmin a nivel de empresa. Si no la ves en el menú, contacta con soporte@extremanet.com para que te la habiliten.
🚪 Cómo se accede
Dos pantallas principales:
- Configuración: menú → Integraciones → Promofarma.
- Listado de productos: menú → Productos → Promofarma.
⚙️ Configuración (pestaña Configuración)
Datos a rellenar
| Campo | Para qué sirve |
|---|---|
| API Key Promofarma | Tu clave de acceso al API de Promofarma. Te la dan al alta como vendor. |
| Tarifa de precios | Qué tarifa de TPVReady se usa para enviar precios a Promofarma. |
| Almacén | De qué almacén se lee el stock disponible para Promofarma. |
| Reglas de matching | Cómo se intenta enlazar tus productos con el catálogo Promofarma. |
| Activar sincronización | Toggle global. |
Reglas de matching
TPVReady intenta enlazar tus productos con los de Promofarma comparando:
- Por EAN — el código de barras EAN-13 (lo más fiable).
- Por CN — el Código Nacional español (típico en parafarmacia).
- Por referencia interna — si tu referencia coincide con la suya.
Puedes activar varias a la vez: TPVReady prueba en orden y se queda con la primera coincidencia.
📊 Estado (pestaña Estado)
Muestra el resumen de la sincronización:
- Productos sincronizados — cuántos de tu catálogo están enlazados con Promofarma.
- Sin matching — cuántos no han encontrado correspondencia (los puedes vincular manualmente).
- Última generación CSV — fecha y hora.
- Último envío Promofarma — fecha y hora del último scheduler.
- URL pública del CSV — el enlace que Promofarma lee. Botón Copiar enlace.
Acciones manuales
| Botón | Qué hace |
|---|---|
| Sincronizar IDs Promofarma | Descarga el catálogo de Promofarma y reintenta el matching de productos sin enlazar. |
| Generar CSV ahora | Regenera el feed inmediatamente, sin esperar al scheduler diario. |
📦 Listado de productos Promofarma
Menú → Productos → Promofarma.
Igual aspecto que tu catálogo normal, pero con columnas extra específicas:
- ID Promofarma — el ID interno del producto en Promofarma (si se ha enlazado).
- Sincronizar — toggle por producto para incluirlo o excluirlo del feed.
- Estado matching — Enlazado, Sin matching, Excluido.
Acciones por producto
- Editar ID Promofarma — botón del lápiz: pones manualmente el ID si quieres forzar un enlace.
- Toggle sincronizar — incluyes o excluyes ese producto del CSV diario.
⏰ Sincronización automática
Cada día a las 07:00, un scheduler en TPVReady:
- Descarga el catálogo más reciente de Promofarma vía FTP.
- Hace matching con tu catálogo (productos sin enlazar) según tus reglas.
- Genera el CSV con precio, stock y disponibilidad de los productos sincronizados.
- Lo sube a MinIO a una URL pública estable que Promofarma puede leer.
La URL del CSV tiene este formato:
https://cdn.tpvready.es/tpvready/{empresa_token}/promofarma/catalogo.csv
Esta URL es la que debes pasar a Promofarma, una vez, al activar la integración con ellos. A partir de ahí, ellos leen ese fichero todas las mañanas.
💡 Buenas prácticas
- Mantén los EAN al día. El matching automático funciona casi siempre por EAN. Productos sin EAN o con EAN inventado generan muchos Sin matching.
- Revisa la pestaña Estado una vez por semana. Detectas pronto si algún proceso ha fallado.
- Vincula manualmente los productos sin matching importantes. Si tu top 50 está sin enlazar, no estás vendiendo: edita el ID Promofarma a mano desde el listado.
- El stock que envías es el del almacén configurado. Si vendes desde varios almacenes, asegúrate de configurar el almacén que de verdad atiende los pedidos online.
❓ Preguntas frecuentes
¿Por qué algunos productos están "Sin matching"? Porque su EAN o CN no coinciden con ninguno del catálogo Promofarma. Causas habituales: EAN mal introducido en tu ficha, producto descatalogado por el laboratorio, o producto exclusivo de tu tienda.
El precio que envío no es el que aparece en Promofarma. Promofarma puede aplicar sus propios márgenes o promociones encima del precio que tú envías. El precio que tú facturas al cliente final cuando el pedido entra es el que tú decides (Promofarma te transfiere el importe acordado).
¿Cómo desactivo Promofarma temporalmente? En la pestaña Configuración, desactiva el toggle global "Activar sincronización". El CSV deja de regenerarse al instante. Para reactivar, vuelves a marcarlo.
¿Promofarma me envía los pedidos automáticamente a TPVReady? La integración actual es outbound (envío de catálogo desde TPVReady a Promofarma). Los pedidos que entran por Promofarma se ven en su panel; deberás importarlos manualmente a TPVReady o usar el endpoint de integración externa si lo automatizas con un script propio.
¿Funciona para cualquier farmacia?
Sí, siempre que tengas un acuerdo activo con Promofarma como vendor. Si aún no lo tienes, primero gestiónalo con ellos (partners.promofarma.com), y después activas la integración aquí.
¿Necesitas ayuda? Escríbenos a soporte@extremanet.com.