Calendario de festivos — API de impacto empresarial Online
Impacto empresarial de los festivos estimado por modelo para comercio minorista, logística y planificación de la demanda (Pro y superiores). insights puntúa cada festivo de 0 a 100 con la probabilidad de que las tiendas estén cerradas, las categorías de demanda que aumentan antes del festivo, la posición de fin de semana largo y puente y nuestro multiplicador de tráfico fronterizo, además de un resumen por país. demand-surge devuelve las ventanas con fecha alrededor de los festivos no laborables (pre-holiday, holiday, post-holiday), cada una con una intensidad. Las puntuaciones son estimaciones basadas en el tipo de festivo, el estado de día no laborable, el alcance, la posición en el calendario, las prohibiciones de camiones y nuestros multiplicadores de tráfico — no son datos de ventas observados.
GET https://nakordoni.eu/api/v2/data/holiday-calendar/impact
— clase de cuota: heavy
| Parámetro | Descripción |
|---|---|
op | insights (por defecto) | demand-surge |
country | Código de país ISO-2, o lista separada por comas de hasta 10 (obligatorio) |
year | YYYY, 2020-2035 (por defecto: año actual) |
from | Inicio del rango YYYY-MM-DD (con to; máximo 731 días) |
to | Fin del rango YYYY-MM-DD |
region | Región ISO 3166-2, p. ej. DE-BY (opcional) |
lang | Códigos de idioma para los nombres (por defecto: todos los disponibles) |
min_impact | Solo festivos con un impact_score igual o superior a este valor (0-100) |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
data.holidays[].id | ID estable del festivo, p. ej. hol_de_christmas_day_2026 — el valor que acepta ?id=. Los días observados (trasladados) terminan en _obs. |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=lunes..7=domingo), day_name, is_weekend (fin de semana del país). |
data.holidays[].name | en, local (en local_lang) y translations {lang: name}. |
data.holidays[].location | country_code, scope NATIONAL o REGIONAL, regions_affected (códigos ISO 3166-2). |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (fecha calculada del calendario islámico), note (suspended_martial_law, transferred_by_decree o null). |
data.holidays[].floating_logic | is_floating, rule (regla de la fecha en lenguaje natural), shifted_from (fecha original cuando un festivo en fin de semana se trasladó). |
data.holidays[].truck_ban | Prohibición de circulación de camiones en festivos en ese país: applies, time_from, time_until (hora local), min_weight_tons, eve_rule {date,time_from,time_until} para una prohibición en la víspera, scope_note. |
data.holidays[].business_intelligence | impact_score 0-100, retail_closure_probability 0-1, demand_surge_categories[], long_weekend, bridge_opportunity, holiday_family, border_traffic_multiplier (null si no hay), basis model_estimated, model. |
data.summary[] | op=insights, por país: holidays, weekday_days_off, long_weekends, average_impact_score, top_holidays[3]. |
data.windows[] | op=demand-surge: date, phase (pre_holiday | holiday | post_holiday), intensity 0-100, demand_surge_categories, retail_closure_probability (fase holiday), holiday_id, holiday_name, country_code, regions_affected. |
data.impact_model | ID del modelo y la nota de que se trata de estimaciones. |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/impact?op=insights&country=DE,PL&year=2026" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizado