@softdin/portal-admin 0.0.0-stage → 0.2.0

package/dist-lib/types/services/chat.service.d.ts

@@ -0,0 +1,279 @@
+/**
+ * Chat con RRHH del cliente de la sesión (softdin-portal-api, `routes/api.php`, grupo `rrhh`,
+ * `chat/*`; forma en app/Http/Resources/ChatJson.php). Diseño en softdin-portal-api/docs/chat-rrhh.md.
+ */
+export type EstadoConversacion = 'ia' | 'resuelta_ia' | 'sin_asignar' | 'asignada' | 'esperando_empleado' | 'resuelta' | 'cerrada';
+export type VistaBandeja = 'sin_asignar' | 'mias' | 'esperando' | 'resueltas' | 'todas';
+export interface TemaResumen {
+    id: number;
+    nombre: string;
+    descripcion: string | null;
+    confidencial: boolean;
+}
+/** Cliente interno (tercero cliente de SoftDIN) al que pertenece el empleado dentro del tenant. */
+export interface ClienteInternoChat {
+    id: number;
+    nit: string | null;
+    nombre: string;
+}
+export interface ConversacionResumen {
+    id: number;
+    empleado: string | null;
+    /** Desde qué cliente interno escribió el empleado; null si no se sabe. */
+    cliente_interno: ClienteInternoChat | null;
+    identificacion: string | null;
+    cargo: string | null;
+    tema: TemaResumen | null;
+    estado: EstadoConversacion;
+    asignada_a: {
+        id: number;
+        nombre: string;
+    } | null;
+    motivo_escalamiento: string | null;
+    prioridad: 'normal' | 'alta';
+    escalada_en: string | null;
+    vence_primera_respuesta_en: string | null;
+    primera_respuesta_en: string | null;
+    vence_resolucion_en: string | null;
+    resuelta_en: string | null;
+    vencida: boolean;
+    ultimo_mensaje_en: string | null;
+    ultimo_mensaje: {
+        autor: string;
+        interno: boolean;
+        extracto: string;
+    } | null;
+    no_leidos: number;
+    calificacion: number | null;
+}
+export interface MensajeChat {
+    id: number;
+    autor: 'empleado' | 'ia' | 'rrhh' | 'sistema';
+    autor_nombre: string | null;
+    interno: boolean;
+    cuerpo: string;
+    creado_en: string | null;
+    escrito_en: string | null;
+    /** Del asistente: los datos que consultó, ya formateados. */
+    tarjetas?: {
+        titulo: string;
+        filas: [string, string][];
+    }[];
+    /** «Me sirvió» / «No me sirvió» del empleado a una respuesta del asistente. */
+    util?: boolean | null;
+}
+export interface EventoChat {
+    tipo: string;
+    usuario: string | null;
+    detalle: string | null;
+    creado_en: string | null;
+}
+export interface ConversacionDetalle extends ConversacionResumen {
+    empleo: {
+        cargo: string | null;
+        tipo_contrato: string | null;
+        fecha_ingreso: string | null;
+        fecha_retiro: string | null;
+        dias_vacaciones: number | null;
+        vacaciones_corte: string | null;
+        solicitudes_abiertas: number;
+    };
+    mensajes: MensajeChat[];
+    eventos: EventoChat[];
+}
+export interface ResumenChat {
+    atiende: boolean;
+    /** El usuario está disponible para la asignación automática. */
+    disponible?: boolean;
+    es_admin: boolean;
+    sin_asignar: number;
+    mias: number;
+    vencidas: number;
+    no_leidas: number;
+}
+export interface HorarioChat {
+    dias: number[];
+    desde: string;
+    hasta: string;
+}
+/**
+ * Ajuste del chat para un cliente interno. Cada campo en null hereda el de todo el tenant;
+ * `activo: false` lo apaga solo para ese cliente (no lo enciende si el general está apagado).
+ */
+export interface AjusteClienteInternoChat {
+    cliente_interno_id: number;
+    activo: boolean | null;
+    horario: HorarioChat | null;
+    mensaje_fuera_horario: string | null;
+}
+export interface ConfiguracionChat {
+    activo: boolean;
+    horario: HorarioChat;
+    mensaje_fuera_horario: string | null;
+    dias_conservacion: number;
+    /** Solo los clientes con ajuste propio. Se cambian con `ajustarClienteInterno` y `heredarClienteInterno`. */
+    clientes_internos?: AjusteClienteInternoChat[];
+    /** Asistente de IA (fase 2): el cliente lo ofrece a sus empleados. */
+    ia_activa?: boolean;
+    tope_mensajes_ia_dia?: number;
+    /** Solo lectura: el servidor tiene la IA habilitada y con clave. */
+    ia_en_servidor?: boolean;
+    uso_ia_hoy?: {
+        mensajes: number;
+        llamadas: number;
+        tokens_entrada: number;
+        tokens_salida: number;
+    } | null;
+}
+export interface RespuestaGuardada {
+    id: number;
+    titulo: string;
+    /** `{nombre}` se reemplaza por el primer nombre del empleado al insertarla. */
+    cuerpo: string;
+    tema_id: number | null;
+    propia: boolean;
+    editable: boolean;
+}
+export interface TiemposChat {
+    /** Minutos hábiles. */
+    promedio: number | null;
+    mediana: number | null;
+    medidas: number;
+    /** Porcentaje dentro del plazo del tema. */
+    dentro_del_plazo: number | null;
+}
+export interface InformeChat {
+    desde: string;
+    hasta: string;
+    total: number;
+    por_estado: Partial<Record<EstadoConversacion, number>>;
+    resueltas_por_ia: number;
+    escaladas: number;
+    por_motivo: Record<string, number>;
+    primera_respuesta: TiemposChat;
+    sin_respuesta_vencidas: number;
+    resolucion: TiemposChat;
+    calificacion: {
+        promedio: number | null;
+        respuestas: number;
+        distribucion: Record<string, number>;
+    };
+    por_tema: {
+        tema: string;
+        total: number;
+        escaladas: number;
+        primera_respuesta_promedio: number | null;
+        calificacion_promedio: number | null;
+    }[];
+    uso_ia: {
+        mensajes: number;
+        llamadas: number;
+        tokens_entrada: number;
+        tokens_salida: number;
+    };
+    /** Solo para el admin del cliente. */
+    por_persona?: {
+        usuario: string;
+        atendidas: number;
+        resueltas: number;
+        primera_respuesta_promedio: number | null;
+        calificacion_promedio: number | null;
+    }[];
+}
+/** Minutos hábiles → «45 min», «3 h 20 min». */
+export declare function duracion(min: number | null): string;
+export interface ArticuloConocimiento {
+    id: number;
+    titulo: string;
+    contenido: string;
+    tema_id: number | null;
+    visible_en_faq: boolean;
+    orden: number;
+    activo: boolean;
+    version: number;
+    actualizado_en: string | null;
+    /** Null: general, para todo el tenant; si no, solo para los empleados de ese cliente interno. */
+    cliente_interno_id: number | null;
+}
+export interface TemaChat {
+    id: number;
+    nombre: string;
+    descripcion: string | null;
+    confidencial: boolean;
+    /** Lo que queda sin asignar va solo a la persona disponible con menos carga. */
+    asignacion_automatica?: boolean;
+    minutos_primera_respuesta: number;
+    minutos_resolucion: number;
+    orden: number;
+    activo: boolean;
+    /** Usuarios asignados; sin ninguno, lo atiende cualquiera que atienda el chat. */
+    personas: number[];
+}
+export interface PersonaChat {
+    id: number;
+    nombre: string;
+    email: string;
+    rol: 'rrhh' | 'admin';
+    es_superadmin: boolean;
+    atiende_chat: boolean;
+    disponible: boolean;
+    temas: number[];
+}
+export declare const chatService: {
+    resumen(): Promise<ResumenChat>;
+    conversaciones(vista: VistaBandeja, temaId: number | null, clienteInternoId?: number | null): Promise<ConversacionResumen[]>;
+    conversacion(id: number): Promise<ConversacionDetalle>;
+    responder(id: number, cuerpo: string, interno: boolean): Promise<ConversacionDetalle>;
+    tomar(id: number): Promise<ConversacionDetalle>;
+    asignar(id: number, usuarioId: number): Promise<ConversacionDetalle>;
+    /** Devuelve null si, tras pasarla a otro tema, el usuario ya no la ve. */
+    reasignar(id: number, cambio: {
+        usuario_id: number | null;
+        tema_id: number | null;
+        comentario: string;
+    }): Promise<ConversacionDetalle | null>;
+    esperando(id: number): Promise<ConversacionDetalle>;
+    resolver(id: number, comentario: string | null): Promise<ConversacionDetalle>;
+    configuracion(): Promise<ConfiguracionChat>;
+    guardarConfiguracion(c: ConfiguracionChat): Promise<ConfiguracionChat>;
+    /** Ajuste propio de un cliente interno (solo admin). Responde la configuración completa. */
+    ajustarClienteInterno(clienteInternoId: number, ajuste: Omit<AjusteClienteInternoChat, "cliente_interno_id">): Promise<ConfiguracionChat>;
+    /** Quita el ajuste: el cliente interno vuelve a lo general. */
+    heredarClienteInterno(clienteInternoId: number): Promise<ConfiguracionChat>;
+    temas(): Promise<TemaChat[]>;
+    crearTema(t: Partial<TemaChat>): Promise<TemaChat>;
+    actualizarTema(id: number, t: Partial<TemaChat>): Promise<TemaChat>;
+    personas(): Promise<PersonaChat[]>;
+    actualizarPersona(id: number, p: {
+        atiende_chat: boolean;
+        disponible?: boolean;
+        temas: number[];
+    }): Promise<PersonaChat[]>;
+    /** El propio usuario: disponible o no para la asignación automática. */
+    marcarDisponible(disponible: boolean): Promise<void>;
+    respuestas(): Promise<RespuestaGuardada[]>;
+    guardarRespuesta(r: Partial<RespuestaGuardada>): Promise<RespuestaGuardada>;
+    borrarRespuesta(id: number): Promise<void>;
+    /** Con `clienteInternoId`, solo las conversaciones de los empleados de ese cliente interno. */
+    informe(desde: string, hasta: string, clienteInternoId?: number | null): Promise<InformeChat>;
+    /** Con `clienteInternoId`, los generales más los de ese cliente; sin él, todos. */
+    conocimiento(clienteInternoId?: number | null): Promise<ArticuloConocimiento[]>;
+    guardarArticulo(a: Partial<ArticuloConocimiento>): Promise<ArticuloConocimiento>;
+    borrarArticulo(id: number): Promise<void>;
+};
+export declare const ESTADOS_CONVERSACION: Record<EstadoConversacion, {
+    texto: string;
+    clase: string;
+}>;
+export declare const MOTIVOS_ESCALAMIENTO: Record<string, string>;
+/** Días del horario de atención: 1 = lunes … 7 = domingo. */
+export declare const DIAS_SEMANA: {
+    n: number;
+    texto: string;
+}[];
+/** «Lun, Mar, Mié · 08:00–17:00». */
+export declare function textoHorario(h: HorarioChat): string;
+/** Fecha y hora cortas en la zona del navegador. */
+export declare function fechaHora(iso: string | null): string;
+/** «en 2 h», «hace 35 min»: para el plazo de respuesta. */
+export declare function relativo(iso: string | null, ahora?: number): string;

package/dist-lib/types/services/configuracion-cliente-interno.service.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Configuración del portal por cliente interno (softdin-portal-api, docs/integracion-softdin.md,
+ * «Configuración por cliente interno»): el carnet digital y los tipos de solicitud pueden tener
+ * un valor propio para los empleados de un cliente interno, que prevalece sobre el de todo el
+ * tenant. Sin valor propio, el cliente interno hereda el del tenant.
+ */
+export interface CarnetClienteInterno {
+    cliente_interno_id: number;
+    activo: boolean;
+}
+export interface ConfiguracionCarnet {
+    /** El valor de todo el tenant. */
+    carnet_activo: boolean;
+    /** Los clientes internos con valor propio. */
+    clientes_internos: CarnetClienteInterno[];
+}
+export declare const carnetClientesInternosService: {
+    config(): Promise<ConfiguracionCarnet>;
+    /** Valor propio de un cliente interno. */
+    fijar(clienteInternoId: number, activo: boolean): Promise<ConfiguracionCarnet>;
+    /** Quita el valor propio: vuelve a heredar el del tenant. */
+    heredar(clienteInternoId: number): Promise<ConfiguracionCarnet>;
+};

package/dist-lib/types/services/homologacion.service.d.ts

@@ -0,0 +1,105 @@
+import type { TipoSolicitudPortal } from './portal-empleado.service';
+/**
+ * Homologación de lo que radica el empleado en el portal con los conceptos de novedad de seguridad social de
+ * SoftDIN, y los tipos de solicitud y de permiso que crea el administrador del portal (softdin-portal-api, rutas
+ * `rrhh/homologacion`, `rrhh/tipos-solicitud` y `rrhh/tipos-permiso`). Todo vive en SoftDIN: el portal lo edita por
+ * la API firmada y SoftDIN guarda el historial con el actor. Diseño en softdin-api/docs/portal-empleado.md.
+ *
+ * `clienteInterno` es el elegido en la barra superior (null = todo el tenant).
+ */
+export type GrupoHomologacion = 'incapacidad' | 'licencia' | 'vacaciones' | 'permiso' | 'tipo';
+/** Concepto de novedad de seguridad social del cliente (los que se pueden elegir como homólogo). */
+export interface ConceptoSeguridadSocial {
+    id: number;
+    codigo: string;
+    nombre: string;
+    /** Variable del sistema con que se liquida y se reporta en la PILA (IGE 45, IRP 46, LMA 47…). */
+    variable: number | null;
+    variable_nombre: string | null;
+}
+export type UnidadPermiso = 'horas' | 'dias_habiles' | 'dias_calendario';
+export type PeriodoTopePermiso = 'evento' | 'dia' | 'semestre' | 'anio';
+export type LineaParentesco = 'consanguinidad' | 'afinidad' | 'civil';
+/** Grado máximo de cada línea que da derecho al permiso (el cónyuge siempre lo da); null = no pide parentesco. */
+export type ParentescoPermiso = Partial<Record<LineaParentesco, number>> | null;
+/** Tipo de permiso como lo publica SoftDIN (`TiposPermisoService`): la ley con los ajustes del cliente, o uno propio. */
+export interface TipoPermisoPortal {
+    codigo: string;
+    nombre: string;
+    norma?: string | null;
+    /** ley: la plantilla tal cual; ajustado: la ley mejorada por el cliente; propio: creado por el cliente o el portal. */
+    origen?: 'ley' | 'ajustado' | 'propio' | string;
+    unidad: UnidadPermiso;
+    tope: number | null;
+    /** Tope que da la ley: se puede ampliar, nunca bajar. */
+    tope_legal?: number | null;
+    tope_periodo: PeriodoTopePermiso;
+    remunerado: boolean;
+    legal?: boolean;
+    /** Lo exige la ley: no se puede desactivar. */
+    obligatorio?: boolean;
+    soporte_requerido: boolean;
+    plazo_soporte_dias: number | null;
+    parentesco?: ParentescoPermiso;
+    activo: boolean;
+}
+export interface FilaHomologacion {
+    /** `incapacidad_comun`, `licencia_maternidad`, `vacaciones`, `permiso:{codigo}`, `tipo:{clave}`… */
+    clave: string;
+    grupo: GrupoHomologacion;
+    nombre: string;
+    /** Tope, si es remunerado… (lo arma SoftDIN). */
+    detalle: string | null;
+    /** Variable que exige la PILA para lo del portal (null = cualquiera). */
+    variable_esperada: number | null;
+    idconceptonovedad: number | null;
+    /** Con un cliente elegido: la homologación viene de la de todo el tenant. */
+    heredado: boolean;
+    /** La variable del concepto no es la que exige la PILA (avisa, no bloquea). */
+    advertencia: string | null;
+    /** Si SoftDIN deja cambiar la homologación de esta fila. */
+    editable: boolean;
+    /** Permisos: el tipo completo, si SoftDIN lo manda (permite editarlo desde la fila). */
+    tipo_permiso?: TipoPermisoPortal | null;
+}
+export interface Homologacion {
+    conceptos: ConceptoSeguridadSocial[];
+    filas: FilaHomologacion[];
+}
+/** Tipo de solicitud con los datos del soporte (los tipos nuevos los traen; los predeterminados pueden no traerlos). */
+export type TipoSolicitudConSoporte = TipoSolicitudPortal & {
+    requiere_soporte?: boolean;
+    plazo_soporte_dias?: number | null;
+};
+export interface DatosTipoSolicitud {
+    nombre: string;
+    activo: boolean;
+    requiere_visto_bueno_nomina: boolean;
+    requiere_soporte: boolean;
+    plazo_soporte_dias: number | null;
+}
+/** Lo que se manda al crear un permiso o al cambiar uno propio. */
+export interface DatosPermisoPropio {
+    nombre: string;
+    unidad: UnidadPermiso;
+    tope: number | null;
+    tope_periodo: PeriodoTopePermiso;
+    remunerado: boolean;
+    soporte_requerido: boolean;
+    plazo_soporte_dias: number | null;
+    parentesco: ParentescoPermiso;
+    activo: boolean;
+}
+/** Lo único que se ajusta de un permiso de la ley (mejorarlo, nunca empeorarlo). */
+export type DatosAjustePermisoLey = Pick<DatosPermisoPropio, 'nombre' | 'tope' | 'soporte_requerido' | 'plazo_soporte_dias' | 'activo'>;
+export declare const homologacionService: {
+    obtener(clienteInterno: number | null): Promise<Homologacion>;
+    /** `idconceptonovedad` null: quita la homologación (con un cliente elegido, vuelve a la de todo el tenant). */
+    guardar(clave: string, idconceptonovedad: number | null, clienteInterno: number | null): Promise<FilaHomologacion>;
+    /** Primero se crea en SoftDIN y después en el portal: si SoftDIN falla, no se crea nada. */
+    crearTipoSolicitud(datos: DatosTipoSolicitud, clienteInterno: number | null): Promise<TipoSolicitudConSoporte>;
+    /** `id`: el del tipo del tenant (como en Tipos de solicitud). */
+    editarTipoSolicitud(id: number, datos: DatosTipoSolicitud, clienteInterno: number | null): Promise<TipoSolicitudConSoporte>;
+    crearPermiso(datos: DatosPermisoPropio, clienteInterno: number | null): Promise<TipoPermisoPortal>;
+    editarPermiso(codigo: string, datos: DatosPermisoPropio | DatosAjustePermisoLey, clienteInterno: number | null): Promise<TipoPermisoPortal>;
+};

package/dist-lib/types/services/portal-empleado.service.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Administración del portal del cliente de la sesión (softdin-portal-api,
+ * `routes/api.php`, grupo `rrhh`). Diseño en softdin-api/docs/portal-empleado.md.
+ */
+export type EstadoSolicitudPortal = 'recibida' | 'en_aprobacion' | 'pendiente_visto_bueno' | 'aprobada' | 'rechazada' | 'rechazada_nomina' | 'cancelada';
+export interface SolicitudPortal {
+    id: number;
+    empleado: string | null;
+    identificacion: string | null;
+    cargo: string | null;
+    tipo: string;
+    /** Concepto de SoftDIN que eligió el empleado (los de su grupo de nómina). */
+    concepto: string | null;
+    fecha_inicio: string;
+    fecha_fin: string;
+    motivo: string;
+    estado: EstadoSolicitudPortal;
+    nivel_actual: number | null;
+    niveles_total: number | null;
+    /** Aprobada, pero SoftDIN no pudo crear la novedad: nómina la registra a mano. */
+    novedad_manual: boolean;
+    radicada: string | null;
+    ultimo_comentario: string | null;
+    /** Incapacidad y licencias: el soporte ya está en el expediente del empleado en SoftDIN. */
+    tiene_soporte?: boolean;
+    /** El soporte llegó al portal y está en camino a SoftDIN. */
+    soporte_en_envio?: boolean;
+    /** Paternidad radicada sin soporte: días que quedan del plazo (negativo si venció). */
+    soporte_pendiente?: {
+        dias_restantes: number | null;
+        vence?: string | null;
+    } | null;
+    /** Datos no clínicos (el diagnóstico no llega al portal): origen y prórroga de la incapacidad. */
+    origen?: 'comun' | 'laboral' | null;
+    es_prorroga?: boolean | null;
+    /** Licencias: fecha del parto (Y-m-d). */
+    fecha_parto?: string | null;
+}
+export declare const portalSolicitudesService: {
+    /** Con `clienteInterno`, solo las de los empleados de ese cliente interno; sin él, todo el tenant. */
+    listar(estado?: EstadoSolicitudPortal, clienteInterno?: number | null): Promise<SolicitudPortal[]>;
+    /**
+     * Viaja firmado a SoftDIN, donde vive la novedad: al aprobar se activa; al no
+     * aprobar queda inactiva y el comentario le llega al empleado.
+     */
+    vistoBueno(id: number, aprueba: boolean, comentario: string | null): Promise<void>;
+};
+export interface TipoSolicitudPortal {
+    id: number;
+    tipo: string;
+    nombre: string;
+    requiere_visto_bueno_nomina: boolean;
+    activo: boolean;
+    /** El cliente interno pedido (null = todo el tenant). */
+    cliente_interno_id?: number | null;
+    /** El cliente interno tiene su propia configuración de este tipo (si no, hereda la del tenant). */
+    personalizado?: boolean;
+}
+/**
+ * `id` es siempre el del tipo del tenant. Con `clienteInterno`, se ve y se cambia lo de los
+ * empleados de ese cliente interno: cambiarlo le crea su propia configuración, que prevalece.
+ */
+export declare const portalTiposService: {
+    listar(clienteInterno?: number | null): Promise<TipoSolicitudPortal[]>;
+    actualizar(id: number, cambios: Partial<Pick<TipoSolicitudPortal, "requiere_visto_bueno_nomina" | "activo">>, clienteInterno?: number | null): Promise<TipoSolicitudPortal>;
+    /** El cliente interno vuelve a usar lo de todo el tenant para este tipo. */
+    heredar(id: number, clienteInterno: number): Promise<TipoSolicitudPortal>;
+};
+export interface EmpleadoPortal {
+    /** Id del empleo en el portal (no el contrato de SoftDIN). */
+    id: number;
+    empleado: string | null;
+    identificacion: string | null;
+    /** Tercero cliente de SoftDIN al que pertenece el contrato (no el tenant). */
+    cliente_interno?: string | null;
+    cargo: string | null;
+    fecha_ingreso: string | null;
+    retirado: boolean;
+    /** Hay correo registrado: la invitación por correo es posible. */
+    tiene_correo: boolean;
+    /** pendiente: aún no activa su cuenta; activa: ya entra a la app. */
+    cuenta: 'activa' | 'pendiente';
+}
+export interface ClienteInterno {
+    id: number;
+    nit: string | null;
+    nombre: string;
+    /**
+     * Si el usuario puede escribir en este cliente interno (alcance por cliente del SSO de ámbito
+     * tenant). Ausente = sin restricción (servidor anterior).
+     */
+    permitido?: boolean;
+}
+export type CanalInvitacion = 'qr' | 'correo';
+export type RespuestaInvitacion = {
+    estado: 'qr';
+    cuenta_activa: boolean;
+    url: string;
+    expira_en: string;
+} | {
+    estado: 'enviada';
+    correo: string;
+} | {
+    estado: 'activa';
+};
+export declare const portalEmpleadosService: {
+    /** Empleados que SoftDIN publicó al portal; busca por nombre o documento (máximo 100). */
+    buscar(buscar: string, clienteInterno?: number | null): Promise<EmpleadoPortal[]>;
+    /** Catálogo de clientes internos del tenant que envió SoftDIN (también los que aún no tienen empleados). */
+    clientesInternos(): Promise<ClienteInterno[]>;
+    invitar(empleoId: number, canal: CanalInvitacion): Promise<RespuestaInvitacion>;
+};

package/dist-lib/types/services/solicitudes-certificado.service.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Solicitudes de certificado que los empleados hacen desde su Portal de autogestión
+ * cuando el certificado no se puede generar solo (o necesitan uno distinto). La solicitud
+ * vive en el portal; al atenderla, el PDF se guarda en la gestión documental de SoftDIN
+ * (el portal no guarda copia) y el empleado lo ve en «Documentos» de la app. También se
+ * puede rechazar con un motivo. softdin-portal-api, grupo `rrhh`.
+ */
+export type TipoCertificadoSolicitado = 'laboral' | 'ingresos_retenciones' | 'otro';
+export type EstadoSolicitudCertificado = 'pendiente' | 'atendida' | 'rechazada';
+export interface SolicitudCertificadoRrhh {
+    id: number;
+    tipo: TipoCertificadoSolicitado;
+    /** Año gravable (solo ingresos y retenciones). */
+    anio: number | null;
+    /** Lo que el empleado necesita que el certificado contenga. */
+    informacion: string;
+    estado: EstadoSolicitudCertificado;
+    /** Respuesta de RRHH al atender, o motivo del rechazo. */
+    respuesta: string | null;
+    /** Documento de SoftDIN donde quedó guardado el PDF entregado (cuando fue atendida). */
+    documento_id: number | null;
+    creada_en: string;
+    atendida_en: string | null;
+    empleado: {
+        nombre: string | null;
+        documento: string | null;
+    };
+    cliente_interno: {
+        id: number;
+        nombre: string;
+    } | null;
+}
+export interface FiltrosSolicitudesCertificado {
+    estado?: EstadoSolicitudCertificado;
+    /** Se conectará al selector global de cliente interno. */
+    cliente_interno_id?: number | null;
+}
+export interface DatosAtencionCertificado {
+    pdf: File;
+    titulo?: string | null;
+    respuesta?: string | null;
+}
+export declare const TIPOS_CERTIFICADO: Record<TipoCertificadoSolicitado, string>;
+export declare const ESTADOS_SOLICITUD_CERTIFICADO: Record<EstadoSolicitudCertificado, {
+    texto: string;
+    clase: string;
+}>;
+/** Tamaño máximo del PDF que acepta el servidor (5 MB). */
+export declare const PDF_MAXIMO_BYTES: number;
+export declare const solicitudesCertificadoService: {
+    listar(filtros?: FiltrosSolicitudesCertificado): Promise<SolicitudCertificadoRrhh[]>;
+    /**
+     * Guarda el PDF en SoftDIN y marca la solicitud atendida. Si SoftDIN no responde, el
+     * portal contesta 503 con el mensaje y la solicitud sigue pendiente.
+     */
+    atender(id: number, datos: DatosAtencionCertificado): Promise<void>;
+    /** `respuesta` es el motivo que verá el empleado (5 a 1000 caracteres). */
+    rechazar(id: number, respuesta: string): Promise<void>;
+};