¿De dónde salen los datos?
Solo de fuentes oficiales públicas por CCAA y territorio: portales institucionales, datos abiertos y
listados oficiales. Cada registro conserva su trazabilidad con
official_source_name, official_source_url y fecha observada.
¿Cada cuánto se actualiza?
La ingesta corre cada 24 horas. Si una fuente no cambia, no enviamos ruido. Si una fuente oficial falla,
mantenemos el último estado válido y reintentamos sin vaciar tu base de datos.
¿Qué eventos de negocio ofrece?
Aperturas, cierres, reaperturas, traslados y cambio de titular. Esto permite detectar nuevas farmacias,
cierres efectivos y movimientos relevantes para tasación, scouting, CRM o analítica comercial.
¿Cómo funciona el scope por territorios?
Cada API key sale con una lista exacta de territorios permitidos (ES-XX). Si integras una sola
comunidad, no pagas ni recibes el resto. Si intentas pedir una fuera de scope, la API responde
403.
¿Cómo empiezo una integración?
La forma recomendada es simple: 1) carga inicial con snapshot, 2) sincronización incremental
con changes, 3) si quieres automatizar más, activar webhooks para enterarte cuando termina cada
sync territorial.
¿Puedo descargar CSV o JSON?
Sí. Cada territorio puede descargarse en CSV o JSON. Es útil tanto para una
integración técnica como para equipos de negocio que prefieren trabajar con ficheros.
¿Qué campos incluye una farmacia?
Nombre, dirección normalizada, CP, ciudad, provincia, territorio, titular, CNN cuando existe, coordenadas,
origen de la coordenada y trazabilidad completa de la fuente oficial.
¿Las coordenadas son siempre oficiales?
Cuando la fuente las trae, se guardan como official. Si faltan, las resolvemos
automáticamente y quedan marcadas como geocoded. Si un caso requiere validación manual,
también queda trazado.
¿Qué pasa si una fuente oficial falla?
No se vacía el territorio. Mantenemos el último estado válido, bloqueamos cambios destructivos y reintentamos
la ingesta. La API sigue siendo honesta sobre el estado real del territorio.
¿Cómo funcionan los webhooks (callback)?
Registras solo el dominio/origin, por ejemplo https://tu-dominio.com. Nosotros entregamos siempre en
/.well-known/farmaapi/webhook, con firma y reintentos.
¿Hay límites de uso (rate limit)?
Sí. Aplicamos rate limit por API key para proteger la plataforma. Si lo superas recibes 429 y
la recomendación es usar backoff exponencial y reintentos controlados.
¿Sirve para software de tasación, compraventa o consultoría?
Sí. Está pensado para herramientas que necesitan catálogo oficial actualizado, cambios incrementales,
cierres, traslados y mapas operativos: tasación, scouting comercial, consultoría, CRM o analítica.
¿Puedo empezar con una sola comunidad y ampliar después?
Sí. Puedes arrancar con una comunidad autónoma, pasar a un pack de 3 o ampliar a cobertura nacional sin
rehacer la integración. Solo cambiamos el scope de tu API key.
¿Puedo probar antes de contratar?
Sí. Puedes pedir una API key gratuita de prueba limitada a ES-CE (Ceuta) para validar el
formato, la autenticación y el flujo completo de integración antes de comprar cobertura adicional.
¿Qué pasa si aún no tengo una base de datos propia?
No pasa nada. Puedes empezar descargando CSV o JSON por territorio y después evolucionar a una integración
incremental cuando tu producto lo necesite.
¿Desde cuándo hay histórico de eventos?
El bloque de eventos operativos del producto arranca desde febrero de 2026. A partir de ahí, las altas,
cierres y traslados se van acumulando de forma incremental por territorio.