Added

Nuevo servicio de consulta de períodos disponibles por empresa

Se agregó un nuevo endpoint que permite obtener conjuntos de períodos asociados a una empresa.
Este recurso centraliza la información de períodos de nómina, nómina electrónica, seguridad social, prestaciones sociales y rangos de fechas, facilitando la generación de reportes y filtros de fechas en las integraciones.

💥 Impacto del cambio

  • Centraliza la obtención de información de períodos en un único endpoint.
  • No modifica endpoints existentes ni rompe compatibilidad con integraciones previas.

⚙️ Detalles técnicos

  • Endpoint: GET /v1/{company_id}/report_datasets/{dataset_key}

  • Tipos de conjuntos disponibles:

    ClaveDescripción
    payroll_periodsPeríodos de nómina
    electronic_payroll_periodsPeríodos de nómina electrónica
    social_security_periodsPeríodos de seguridad social
    service_bonus_periodsPeríodos de prima de servicios
    severance_periodsPeríodos de cesantías
    severance_interests_periodsPeríodos de intereses sobre cesantías
    date_rangeRangos de fechas disponibles
  • Ejemplo de respuesta:

{
  "data": {
    "dataset": "payroll_periods",
    "details": "",
    "items": [
      {
        "period_id": "632d42ac-6dfa-5bbb-ae5a-cc72cc8e1111",
        "initial_day": "2024-01-01",
        "end_day": "2024-01-31",
        "label": "01–31-Ene-2024"
      }
    ]
  }
}

💡 Recomendación

No se requieren ajustes en las integraciones actuales.


🧾 Notas adicionales

Documentación completa: Especificación técnica del endpoint