Documentación para desarrolladores

Integra el cálculo de plazos en tu aplicación.

Endpoints principales para calcular vencimientos y contar días hábiles por municipio.

Autenticación

Las llamadas se realizan contra https://api.toddle.es usando la API key técnica del cliente.

Authorization: Bearer TU_API_KEY
Content-Type: application/json

Calcular vencimiento

Devuelve la fecha de vencimiento al sumar un número de días hábiles desde una fecha inicial.

Formato de fechas: la API recibe y devuelve fechas en formato técnico ISO YYYY-MM-DD. Las pantallas orientadas a usuario pueden mostrarlas como DD-MM-YYYY.

POST /api/v1/plazos/vencimiento

{
  "codigoIne": "41091",
  "fechaInicio": "2026-04-03",
  "diasHabiles": 10,
  "incluirFechaInicio": false
}

{
  "codigoIne": "41091",
  "fechaInicio": "2026-04-03",
  "diasHabilesSolicitados": 10,
  "incluirFechaInicio": false,
  "fechaVencimiento": "2026-04-20",
  "diasNaturalesRecorridos": 17,
  "diasExcluidos": [
    {"fecha":"2026-04-04","habil":false,"motivos":["FIN_SEMANA"],"festivos":[]}
  ],
  "coberturas": []
}

Contar días hábiles entre dos fechas

Devuelve el número de días hábiles dentro de un intervalo.

POST /api/v1/plazos/contar

{
  "codigoIne": "41091",
  "fechaDesde": "2026-04-03",
  "fechaHasta": "2026-04-20",
  "incluirDesde": true,
  "incluirHasta": true
}

{
  "codigoIne": "41091",
  "fechaDesde": "2026-04-03",
  "fechaHasta": "2026-04-20",
  "incluirDesde": true,
  "incluirHasta": true,
  "diasHabiles": 10,
  "diasNaturalesEvaluados": 18,
  "diasExcluidos": [],
  "coberturas": []
}

Evaluar un día concreto

Permite saber si una fecha es hábil o inhábil para un municipio.

GET /api/v1/calendarios/41091/2026-04-03

Cobertura de datos

La respuesta puede incluir información de cobertura anual: festivos nacionales, autonómicos, locales, nivel de cobertura y observaciones.

Tipo	Descripción
Fuente oficial	Datos publicados por diario oficial o administración competente.
Fuente complementaria	Datos obtenidos por canales adicionales cuando no existe publicación centralizada suficiente.
Observaciones	Notas de cobertura cuando el dato local requiere revisión o confirmación.

Opciones de cómputo

Opciones actualmente expuestas:

incluirFechaInicio: computa la fecha inicial si es hábil en el cálculo de vencimiento.
incluirDesde / incluirHasta: controla los extremos del intervalo al contar días hábiles.

Opciones adicionales, como el tratamiento de agosto en determinados escenarios, se incorporarán como parámetros de cálculo específicos antes de la apertura comercial definitiva.