Saltar a contenido

Business Events (aperturas, cierres, traslados, cambio de titular)

Estas rutas exponen eventos de negocio derivados del delta contra el estado anterior.

Listado

GET /v1/farmacias/business-events

Query params:

  • from (optional): datetime ISO UTC
  • days (optional): ventana en días si no envías from
  • to (optional): datetime ISO UTC
  • territories (optional): CSV ES-XX,ES-YY
  • event_types (optional): CSV de tipos
  • province (optional)
  • city (optional)
  • limit (default 500, max 5000)
  • cursor (optional)

Tipos soportados:

  • opened: alta (external_id nueva)
  • closed_hard: baja por desaparicion del dataset oficial (delete)
  • closed_soft: la fuente mantiene el registro pero marca is_active=false
  • reopened: is_active pasa de false a true
  • relocated: cambia address_line/postal_code/city/province
  • ownership_change: cambia owner_name (titular)
curl -sS "$FARMAAPI_BASE_URL/v1/farmacias/business-events?from=2026-01-01T00:00:00Z&event_types=relocated,ownership_change" \
  -H "X-API-Key: $FARMAAPI_API_KEY"

curl -sS "$FARMAAPI_BASE_URL/v1/farmacias/business-events?days=30&event_types=opened,relocated" \
  -H "X-API-Key: $FARMAAPI_API_KEY"

Summary (agregados)

GET /v1/farmacias/business-events/summary

Agrupa por:

  • group_by=event_type (default)
  • group_by=territory
  • from o days funcionan igual que en el listado
curl -sS "$FARMAAPI_BASE_URL/v1/farmacias/business-events/summary?from=2026-01-01T00:00:00Z&group_by=territory" \
  -H "X-API-Key: $FARMAAPI_API_KEY"

curl -sS "$FARMAAPI_BASE_URL/v1/farmacias/business-events/summary?days=30&group_by=territory" \
  -H "X-API-Key: $FARMAAPI_API_KEY"

Payload

Cada item incluye:

  • event_type
  • occurred_at
  • territory_code, external_id
  • old y new con los campos relevantes