sigo-package 1.2.177 → 1.2.179

package/dist/index.d.mts

@@ -210,6 +210,129 @@ interface ILineaValidacion {
 declare function ValidarRelacionMOHijasAL04(moUo: MoUoType$2[], manoObraDB: any): IResultadoValidacionMOHijas[];
 declare function FormatearErrorValidacionMOHijas(violaciones: IResultadoValidacionMOHijas[]): string | null;
 
+/**
+ * Reglas de Preliquidar AL04 compartidas por la PWA (formulario) y pex-procesos (motor en el servidor).
+ * Legacy: sigo-pwa-mobile TrabajosDEAL04/Preliquidar y TrabajosDEAL04/DocHP; sic-backend TrabajosService/UpdateTrabajo.js.
+ * Son reglas propias de AL04: no se mezclan con las de AL02.
+ */
+/** Tipo de preliquidación: troncal o por HomePass (Clientes = Residential, No Clientes = Business) */
+type TipoPreliquidacionAL04 = 'Troncal' | 'Residential' | 'Business';
+/** Material consumido del almacén (todo lo que no es ducto) */
+declare const motivoConsumoAlmacenAL04 = "CONSUMO_MATERIAL_AUTOMATICO_DUCTOS";
+declare const estadoRechazadaPorMetrajeAL04 = "RECHAZADA POR METRAJE";
+/** Asignaciones que no se preliquidan (getDataAsignaciones: UseCasePreLiquidationProcesses.ts L28) */
+declare const codMONoPreliquidablesAL04: string[];
+/** Baliza: una por AddressID entre los trabajos de la GOM (verificarUnaBalizaXDireccion.js) */
+declare const codBalizaPreliquidarAL04 = "HP01";
+/** Baremo único por DP: solo una valorización activa entre los trabajos de la GOM (verificarBaremoUnicoXDP.js) */
+declare const codBaremoUnicoDPAL04: string[];
+/** AP02 y ExtraWide no pueden superar lo preliquidado de AP01 en la obra (UpdateTrabajo.js L10-29, L330-347) */
+declare const codMOAsfaltoMadreAL04 = "AP01";
+declare const codMOAsfaltoHijasAL04: string[];
+/** MO que se puede preliquidar en troncal (Preliquidar/Components/View.tsx L143) */
+declare const codMOPreliquidarTroncalAL04: string[];
+/** MO permitida por HomePass: No Clientes codMOFTTFAL04 (HP01); Clientes codMODROPAL04 (DocHP/Components/Documentacion.tsx L179-187) */
+declare function obtenerCodMOHomePassAL04(tipo: Exclude<TipoPreliquidacionAL04, 'Troncal'>): string[];
+type EstadoCierreAL04 = {
+    Estado: unknown;
+    Especialidad: string;
+} | undefined;
+/** Cierres OC / ASPH / SOP del trabajo (Ultima_PreLiquidacion) o del HomePass */
+interface CierresPreliquidarAL04 {
+    Asfaltado?: EstadoCierreAL04;
+    OC?: EstadoCierreAL04;
+    Soplado?: EstadoCierreAL04;
+}
+/** Especialidades ocultas tras un cierre: solo si OC está cerrada (filtro `arr[1]`, Preliquidar/Components/View.tsx L144-151) */
+declare function obtenerEspecialidadesCerradasAL04(cierres: CierresPreliquidarAL04): string[];
+/**
+ * La asignación se puede preliquidar en ese tipo: MO troncal o permitida para el HomePass y sin especialidad cerrada.
+ * El estado de la asignación y codMONoPreliquidablesAL04 se comprueban aparte (getDataAsignaciones del legacy).
+ */
+declare function esAsignacionPreliquidableAL04(asignacion: {
+    ManoObra: {
+        Codigo: string;
+    };
+    Especialidad: {
+        Codigo: string;
+    };
+}, tipo: TipoPreliquidacionAL04, especialidadesCerradas: string[]): boolean;
+/** Ductos: se consumen del stock personal (técnico); el resto, del almacén */
+declare const esMaterialDuctoAL04: (codigo: string) => boolean;
+/** Materiales que no se muestran en el stock personal porque se añaden como hijos de un ducto (generarDataMaterial.ts L15) */
+declare const codMaterialesOcultosAL04: string[];
+/**
+ * Cómo se informan los materiales de la MO:
+ * - automatico: el mapa fija los materiales (GD01, HP01, NVT01) y se añaden solos
+ * - elegir: solo se pueden elegir los materiales del mapa (ductos de obra civil y soplado)
+ * - sinMaterial: la MO no lleva materiales (AP02, EXTRA01, PP01…)
+ * - libre: la MO no está en el mapa; se puede elegir cualquier material (p. ej. ExtraWide AP02_*)
+ */
+type ModoMaterialesAL04 = 'automatico' | 'elegir' | 'sinMaterial' | 'libre';
+declare function modoMaterialesAL04(codMO: string): ModoMaterialesAL04;
+/** Cantidad fija de la MO (HP01, NVT01 = 1): el campo queda deshabilitado (FormAdd.tsx L366-367, L474-479) */
+declare function cantidadFijaMOAL04(codMO: string): number | undefined;
+interface MaterialRequeridoAL04 {
+    Codigo: string;
+    Cantidad: number;
+    /** Ducto: stock personal; si no, stock de almacén */
+    StockPersonal: boolean;
+}
+/** Materiales automáticos: (CantidadFija ? Cantidad : cantidad de MO) × Factor (verificarReglas, FormAdd.tsx L255-297) */
+declare function materialesAutomaticosAL04(codMO: string, cantidadMO: number): MaterialRequeridoAL04[];
+/** Códigos que se pueden elegir; undefined si la MO no restringe los materiales (AddedMaterial.tsx L263-271) */
+declare function materialesSeleccionablesAL04(codMO: string): string[] | undefined;
+interface CantidadMaterialAL04 {
+    /** Cantidad que se fija al elegir el material; undefined si la informa el usuario */
+    Cantidad?: number;
+    Bloqueada: boolean;
+    /** El material lleva hijos (conectores / empalmes) cuya cantidad son los empalmes × Factor */
+    PideEmpalmes: boolean;
+}
+/**
+ * Cantidad del material elegido (AddedMaterial.tsx L194-219): CantidadPadre = cantidad de MO × Factor;
+ * CantidadFija = Cantidad × Factor. Si sus hijos no tienen cantidad fija, se piden los empalmes.
+ */
+declare function cantidadMaterialAL04(codMO: string, codMaterial: string, cantidadMO: number): CantidadMaterialAL04;
+/**
+ * Hijos del material elegido (agregarSubMateriales, AddedMaterial.tsx L113-156):
+ * (CantidadFija ? Cantidad : CantidadPadre ? cantidad del material : empalmes) × Factor.
+ * Sin empalmes no se añaden; si no hay forma de obtener la cantidad es error.
+ */
+declare function subMaterialesAL04(codMO: string, codMaterial: string, cantidadMaterial: number, empalmes: number): MaterialRequeridoAL04[];
+/**
+ * División por exceso (UseCasePreliquidar.ts L438-469): los ductos se reparten entre la valorización padre y la hija
+ * según la cantidad de cada una; el resto de materiales queda en el padre.
+ * Decisión 2026-10-14: el padre se redondea a 2 decimales y la hija lleva el total menos el padre.
+ */
+declare function prorratearMaterialesAL04<T extends {
+    Codigo: string;
+    Cantidad: number;
+    CantidadInformada: number;
+}>(materiales: T[], cantidadPadre: number, cantidadTotal: number): {
+    padre: T[];
+    hija: T[];
+};
+/**
+ * Lo preliquidado en la obra de AP02 + ExtraWide no puede superar a AP01 (tolerancia 0.001). Solo se valida si
+ * la preliquidación incluye alguno de esos códigos. Devuelve el mensaje de error o null.
+ * @param moUo resumen de todos los trabajos de la obra (CalcularResumenValorizacionesAlemania)
+ * @param manoObra ManoObra de la GOM: diccionario LineaCodigoCub → código de la MO
+ * @param codigosNuevos códigos de MO de las valorizaciones nuevas
+ */
+declare function validarAsfaltoAL04(moUo: {
+    LineaCodigoCub: string;
+    Cantidad: number;
+}[], manoObra: {
+    Valorizacion: {
+        Codigo: string;
+        Descripcion?: string;
+        DetalleChile?: {
+            LineaCodigoCub?: string;
+        };
+    }[];
+}, codigosNuevos: string[]): string | null;
+
 declare const codMOTroncalAL02OC: never[];
 declare const codMOTroncalAL02Soplado: never[];
 declare const codMOTroncalAL02Asfaltado: never[];
@@ -268,6 +391,54 @@ declare const codIssueByPeriodoAL02: {
     codPeriodo: string;
 }[];
 
+/**
+ * Reglas de Preliquidar AL02 compartidas por la PWA (formulario) y pex-procesos (motor en el servidor).
+ * Legacy: sigo-pwa-mobile TrabajosDE/Preliquidar y TrabajosDE/DocHP.
+ */
+/** Tipo de preliquidación: troncal o por HomePass (Clientes = Residential, No Clientes = Business) */
+type TipoPreliquidacionAL02 = 'Troncal' | 'Residential' | 'Business';
+/** MO que no se preliquida ni en troncal ni por HomePass */
+declare const codMOExcluidos: string[];
+/** Baliza: una por AddressID y cantidad fija 1 */
+declare const codBalizaAL02 = "073006000";
+/** Baremos de subcontrata: en troncal piden el tipo (Asphalt / Trenching), que se guarda en DetalleChile.CodigoBarra */
+declare const codigosBaremosSubcontrataAL02: string[];
+/** Motivo del material consumido del almacén (UGG) o del conector de un ducto */
+declare const motivoConsumoMaterialAutomaticoDuctos = "CONSUMO_MATERIAL_AUTOMATICO_DUCTOS";
+declare const estadoRechazadaPorMetraje = "RECHAZADA POR METRAJE";
+/** Códigos de soplado (addCodigosSoplado del legacy): por HomePass su disponible es 0 (HPListMO nunca se cargaba) */
+declare const codigosSopladoHP: string[];
+/** MO que se puede preliquidar en troncal (filtro de Preliquidar/Components/View.tsx) */
+declare const codMOPreliquidarTroncalAL02: string[];
+/** MO permitida por HomePass: No Clientes codNoCliente; Clientes codClientes + codSopladoRD (DocHP/Components/View.tsx L390-393) */
+declare function obtenerCodMOHomePass(tipo: Exclude<TipoPreliquidacionAL02, 'Troncal'>): string[];
+type EstadoCierre = {
+    Estado: unknown;
+    Especialidad: string;
+} | undefined;
+/** Cierres OC / ASPH / SOP del trabajo (Ultima_PreLiquidacion) o del HomePass */
+interface CierresPreliquidarAL02 {
+    Asfaltado?: EstadoCierre;
+    OC?: EstadoCierre;
+    Soplado?: EstadoCierre;
+}
+/** Especialidades ocultas tras un cierre: solo si OC está cerrada (filtro `arr[1]` del legacy) */
+declare function obtenerEspecialidadesCerradas(cierres: CierresPreliquidarAL02): string[];
+/**
+ * La asignación se puede preliquidar en ese tipo: MO troncal o permitida para el HomePass, sin codMOExcluidos
+ * y sin especialidad cerrada. Las especialidades cerradas salen de obtenerEspecialidadesCerradas con los cierres
+ * del trabajo (troncal) o del HomePass.
+ * El estado de la asignación y codigosMOT1_F2 se comprueban aparte (getDataAsignaciones del legacy).
+ */
+declare function esAsignacionPreliquidableAL02(asignacion: {
+    ManoObra: {
+        Codigo: string;
+    };
+    Especialidad: {
+        Codigo: string;
+    };
+}, tipo: TipoPreliquidacionAL02, especialidadesCerradas: string[]): boolean;
+
 interface typeHPMOUtilizado {
     ID_HPListMO: number;
     CantidadUtilizado: number;
@@ -925,4 +1096,4 @@ declare function getCookieToken(req: Request<any>, webOrigins: string[]): string
 
 declare function validateUUIDv4Param(BadRequestException: ClassConstructor<Error>, req: Request<any>, _res: Response, next: NextFunction): Promise<void>;
 
-export { ActualizarDataManoObra, ActualizarDataReserva, ActualizarDataResumenLiquidaciones, ActualizarDataResumenLiquidacionesColombia, ActualizarDataResumenValorizacionesAlemania, ActualizarDataTrabajos, AsignacionHelper, BuscarZonaContratista, CalcularResumenHPMOLiquidado, CalcularResumenLiquidaciones, CalcularResumenLiquidacionesColombia, CalcularResumenValorizacionesAlemania, CodigosMaterialDuctosAL02, CodigosMaterialDuctosAL04, CodigosMaterialSoplado, CodsMapeoMOMaterial, CodsMapeoMOMaterialNVT01, CodsMapeoMOMaterialSopladoClientes, CodsMapeoMOMaterialSopladoTroncal, CodsMapeoMO_Material_Arquertas, CompararFechas, CurrencyFormat, DocumentacionReplanteo, EstadoEspecialidad9612, FormatearErrorValidacionMOHijas, GemeindeChangeNomenclatura, GetCodigoFechaActual, type IDPContrato, type IDocumentacion, type ILineaValidacion, type IMOAndMaterialsRules, type IMORules, type IMateriales, type IResultadoValidacionMOHijas, MOCantidadNVT01, MOHijasAL04, MOHijasDEPTH, MapeoEspecialidades9612, MapeoMOBOMAL04, MapeoMatBOMAL04, type MatRetiradosType, type MatStockAlmacenType, type MatStockPersonalType$2 as MatStockPersonalType, type MatUtilizadosType$2 as MatUtilizadosType, type MoUoType$2 as MoUoType, ModelDataFlujosDocumentacionReplanteo, ObtenerMONoReservada, ObtenerPrecioContratistaVigente, ObtenerZonaAsignada, type ResumenLiquidacionesType, type ResumenLiquidacionesTypeChile, type ResumenLiquidacionesTypeColombia, SEGMENT_TY, SOMACYL_CODIGO_CONTADOR_RETIRADO, SOMACYL_PHOTO_POSITIONS, type SomacylPhotoKey, type TARGET, UpdateNodosDocDP, ValidarRelacionMOHijasAL04, ValorizacionHelper, builSystemOption, buildDataMOFromMaterialRules, buildDataMaterialsRule, buildKeyMO, buildMenu, buildReservaMOJobMajorProjectsAlemaniaAL02, buildReservaMOJobMajorProjectsAlemaniaAL04, buildTenantCollectionName, calcularTotalMaterialValorizacionPeru9112, checkAndBuildMaterialsFromStock, checkMaterialAvailability, codBalizaAL04, codClientes, codIssueByPeriodoAL02, codMOClientesAL02, codMOClientesAL02Asfaltado, codMOClientesAL02OC, codMOClientesAL02Soplado, codMOClientes_ReglaLiquidacion1, codMODROPAL04, codMODROPAL04OC, codMODROPAL04Soplado, codMOFTTFAL04, codMONoClientesAL02, codMONoClientesAL02Asfaltado, codMONoClientesAL02OC, codMONoClientesAL02Soplado, codMONoClientes_ReglaLiquidacion1, codMOOcultosAL04, codMOPublico, codMOTroncalAL02, codMOTroncalAL02Asfaltado, codMOTroncalAL02OC, codMOTroncalAL02Soplado, codMOTroncalAL04, codMOTroncalAL04Asfaltado, codMOTroncalAL04Issue, codMOTroncalAL04OC, codMOTroncalAL04Soplado, codMOTroncalHistoricoAL02, codMOTroncal_ReglaLiquidacion1, codNoCliente, codSopladoRD, codigosMOT1_F2, codigosMaterialDuctos, codigosMaterialUGG, collections, consumirStockPersonal, convertDates, dataFlujosHomePass, db_default, db_root, documentRequirementAltasNVT, empresas, esCadenaFechaISOValida, esObjetoFecha, formatCurrencyV1, formatNumberSmart, formatNumberV1, formatPercentageV1, generateUniqueNumber, generateUniqueNumberArray, getCaptureDateSomacyl, getChannelName, getContainerName, getCookieToken, getDBName, getDateInTimeZone, getKeyRedisSortedSet, getModelDataAdicional, getNextID_Amap, getNextID_AsignacionValorizacion, getNextID_Valorizacion, getPrecioContratista, getPriceMaterial, getQueueName, getQueueNameSaveOneNotification, getRequestOrigin, hashCode, isValidDate, isValidPartialEntity, logTiempoProceso, mapaDPContratoPrecioFullAL02, mapaEstadoObraFaseAL02, mapaMOMaterialAL02, mapaMOMaterialAL04, mapaReglaSopladoClientes, mapaReglaSopladoTroncal, mapeoZonasSimilares, newCodMOTroncalReglaLiquidacion1, obtenerDocumentacionClientes, obtenerDocumentacionNoClientes, obtenerPrecioContratistaMaterial, obtenerPrecioManoObraAL02, obtenerPrecioManoObraAL04, obtenerTipoYCodigoMO, paisMap, parseDuplicateKeyError, roundNumber, searchCurrentContractorSpecialtyPrice, setColModels, setContext, throwSomacylError, updatePriceContractorMOAL02, updatePriceContractorMOAL04, updatePriceMOAL02, updatePriceMOAL04, updatePricePBBudgetAlemaniaAL02, updatePricePBBudgetAlemaniaAL04, uuidRegex, validateNoLookup, validateUUIDv4Param, verifyDetailsFinalizeSomacyl, verifyFiles, verifyInventoryFinalize, verifyInventoryFinalizeSomacyl, verifyInventoryLimitsSomacyl, verifyPhotosFinalizeSomacyl, verifyPhotosNotFinalizedSomacyl };
+export { ActualizarDataManoObra, ActualizarDataReserva, ActualizarDataResumenLiquidaciones, ActualizarDataResumenLiquidacionesColombia, ActualizarDataResumenValorizacionesAlemania, ActualizarDataTrabajos, AsignacionHelper, BuscarZonaContratista, CalcularResumenHPMOLiquidado, CalcularResumenLiquidaciones, CalcularResumenLiquidacionesColombia, CalcularResumenValorizacionesAlemania, type CantidadMaterialAL04, type CierresPreliquidarAL02, type CierresPreliquidarAL04, CodigosMaterialDuctosAL02, CodigosMaterialDuctosAL04, CodigosMaterialSoplado, CodsMapeoMOMaterial, CodsMapeoMOMaterialNVT01, CodsMapeoMOMaterialSopladoClientes, CodsMapeoMOMaterialSopladoTroncal, CodsMapeoMO_Material_Arquertas, CompararFechas, CurrencyFormat, DocumentacionReplanteo, EstadoEspecialidad9612, FormatearErrorValidacionMOHijas, GemeindeChangeNomenclatura, GetCodigoFechaActual, type IDPContrato, type IDocumentacion, type ILineaValidacion, type IMOAndMaterialsRules, type IMORules, type IMateriales, type IResultadoValidacionMOHijas, MOCantidadNVT01, MOHijasAL04, MOHijasDEPTH, MapeoEspecialidades9612, MapeoMOBOMAL04, MapeoMatBOMAL04, type MatRetiradosType, type MatStockAlmacenType, type MatStockPersonalType$2 as MatStockPersonalType, type MatUtilizadosType$2 as MatUtilizadosType, type MaterialRequeridoAL04, type MoUoType$2 as MoUoType, ModelDataFlujosDocumentacionReplanteo, type ModoMaterialesAL04, ObtenerMONoReservada, ObtenerPrecioContratistaVigente, ObtenerZonaAsignada, type ResumenLiquidacionesType, type ResumenLiquidacionesTypeChile, type ResumenLiquidacionesTypeColombia, SEGMENT_TY, SOMACYL_CODIGO_CONTADOR_RETIRADO, SOMACYL_PHOTO_POSITIONS, type SomacylPhotoKey, type TARGET, type TipoPreliquidacionAL02, type TipoPreliquidacionAL04, UpdateNodosDocDP, ValidarRelacionMOHijasAL04, ValorizacionHelper, builSystemOption, buildDataMOFromMaterialRules, buildDataMaterialsRule, buildKeyMO, buildMenu, buildReservaMOJobMajorProjectsAlemaniaAL02, buildReservaMOJobMajorProjectsAlemaniaAL04, buildTenantCollectionName, calcularTotalMaterialValorizacionPeru9112, cantidadFijaMOAL04, cantidadMaterialAL04, checkAndBuildMaterialsFromStock, checkMaterialAvailability, codBalizaAL02, codBalizaAL04, codBalizaPreliquidarAL04, codBaremoUnicoDPAL04, codClientes, codIssueByPeriodoAL02, codMOAsfaltoHijasAL04, codMOAsfaltoMadreAL04, codMOClientesAL02, codMOClientesAL02Asfaltado, codMOClientesAL02OC, codMOClientesAL02Soplado, codMOClientes_ReglaLiquidacion1, codMODROPAL04, codMODROPAL04OC, codMODROPAL04Soplado, codMOExcluidos, codMOFTTFAL04, codMONoClientesAL02, codMONoClientesAL02Asfaltado, codMONoClientesAL02OC, codMONoClientesAL02Soplado, codMONoClientes_ReglaLiquidacion1, codMONoPreliquidablesAL04, codMOOcultosAL04, codMOPreliquidarTroncalAL02, codMOPreliquidarTroncalAL04, codMOPublico, codMOTroncalAL02, codMOTroncalAL02Asfaltado, codMOTroncalAL02OC, codMOTroncalAL02Soplado, codMOTroncalAL04, codMOTroncalAL04Asfaltado, codMOTroncalAL04Issue, codMOTroncalAL04OC, codMOTroncalAL04Soplado, codMOTroncalHistoricoAL02, codMOTroncal_ReglaLiquidacion1, codMaterialesOcultosAL04, codNoCliente, codSopladoRD, codigosBaremosSubcontrataAL02, codigosMOT1_F2, codigosMaterialDuctos, codigosMaterialUGG, codigosSopladoHP, collections, consumirStockPersonal, convertDates, dataFlujosHomePass, db_default, db_root, documentRequirementAltasNVT, empresas, esAsignacionPreliquidableAL02, esAsignacionPreliquidableAL04, esCadenaFechaISOValida, esMaterialDuctoAL04, esObjetoFecha, estadoRechazadaPorMetraje, estadoRechazadaPorMetrajeAL04, formatCurrencyV1, formatNumberSmart, formatNumberV1, formatPercentageV1, generateUniqueNumber, generateUniqueNumberArray, getCaptureDateSomacyl, getChannelName, getContainerName, getCookieToken, getDBName, getDateInTimeZone, getKeyRedisSortedSet, getModelDataAdicional, getNextID_Amap, getNextID_AsignacionValorizacion, getNextID_Valorizacion, getPrecioContratista, getPriceMaterial, getQueueName, getQueueNameSaveOneNotification, getRequestOrigin, hashCode, isValidDate, isValidPartialEntity, logTiempoProceso, mapaDPContratoPrecioFullAL02, mapaEstadoObraFaseAL02, mapaMOMaterialAL02, mapaMOMaterialAL04, mapaReglaSopladoClientes, mapaReglaSopladoTroncal, mapeoZonasSimilares, materialesAutomaticosAL04, materialesSeleccionablesAL04, modoMaterialesAL04, motivoConsumoAlmacenAL04, motivoConsumoMaterialAutomaticoDuctos, newCodMOTroncalReglaLiquidacion1, obtenerCodMOHomePass, obtenerCodMOHomePassAL04, obtenerDocumentacionClientes, obtenerDocumentacionNoClientes, obtenerEspecialidadesCerradas, obtenerEspecialidadesCerradasAL04, obtenerPrecioContratistaMaterial, obtenerPrecioManoObraAL02, obtenerPrecioManoObraAL04, obtenerTipoYCodigoMO, paisMap, parseDuplicateKeyError, prorratearMaterialesAL04, roundNumber, searchCurrentContractorSpecialtyPrice, setColModels, setContext, subMaterialesAL04, throwSomacylError, updatePriceContractorMOAL02, updatePriceContractorMOAL04, updatePriceMOAL02, updatePriceMOAL04, updatePricePBBudgetAlemaniaAL02, updatePricePBBudgetAlemaniaAL04, uuidRegex, validarAsfaltoAL04, validateNoLookup, validateUUIDv4Param, verifyDetailsFinalizeSomacyl, verifyFiles, verifyInventoryFinalize, verifyInventoryFinalizeSomacyl, verifyInventoryLimitsSomacyl, verifyPhotosFinalizeSomacyl, verifyPhotosNotFinalizedSomacyl };

package/dist/index.d.ts

@@ -210,6 +210,129 @@ interface ILineaValidacion {
 declare function ValidarRelacionMOHijasAL04(moUo: MoUoType$2[], manoObraDB: any): IResultadoValidacionMOHijas[];
 declare function FormatearErrorValidacionMOHijas(violaciones: IResultadoValidacionMOHijas[]): string | null;
 
+/**
+ * Reglas de Preliquidar AL04 compartidas por la PWA (formulario) y pex-procesos (motor en el servidor).
+ * Legacy: sigo-pwa-mobile TrabajosDEAL04/Preliquidar y TrabajosDEAL04/DocHP; sic-backend TrabajosService/UpdateTrabajo.js.
+ * Son reglas propias de AL04: no se mezclan con las de AL02.
+ */
+/** Tipo de preliquidación: troncal o por HomePass (Clientes = Residential, No Clientes = Business) */
+type TipoPreliquidacionAL04 = 'Troncal' | 'Residential' | 'Business';
+/** Material consumido del almacén (todo lo que no es ducto) */
+declare const motivoConsumoAlmacenAL04 = "CONSUMO_MATERIAL_AUTOMATICO_DUCTOS";
+declare const estadoRechazadaPorMetrajeAL04 = "RECHAZADA POR METRAJE";
+/** Asignaciones que no se preliquidan (getDataAsignaciones: UseCasePreLiquidationProcesses.ts L28) */
+declare const codMONoPreliquidablesAL04: string[];
+/** Baliza: una por AddressID entre los trabajos de la GOM (verificarUnaBalizaXDireccion.js) */
+declare const codBalizaPreliquidarAL04 = "HP01";
+/** Baremo único por DP: solo una valorización activa entre los trabajos de la GOM (verificarBaremoUnicoXDP.js) */
+declare const codBaremoUnicoDPAL04: string[];
+/** AP02 y ExtraWide no pueden superar lo preliquidado de AP01 en la obra (UpdateTrabajo.js L10-29, L330-347) */
+declare const codMOAsfaltoMadreAL04 = "AP01";
+declare const codMOAsfaltoHijasAL04: string[];
+/** MO que se puede preliquidar en troncal (Preliquidar/Components/View.tsx L143) */
+declare const codMOPreliquidarTroncalAL04: string[];
+/** MO permitida por HomePass: No Clientes codMOFTTFAL04 (HP01); Clientes codMODROPAL04 (DocHP/Components/Documentacion.tsx L179-187) */
+declare function obtenerCodMOHomePassAL04(tipo: Exclude<TipoPreliquidacionAL04, 'Troncal'>): string[];
+type EstadoCierreAL04 = {
+    Estado: unknown;
+    Especialidad: string;
+} | undefined;
+/** Cierres OC / ASPH / SOP del trabajo (Ultima_PreLiquidacion) o del HomePass */
+interface CierresPreliquidarAL04 {
+    Asfaltado?: EstadoCierreAL04;
+    OC?: EstadoCierreAL04;
+    Soplado?: EstadoCierreAL04;
+}
+/** Especialidades ocultas tras un cierre: solo si OC está cerrada (filtro `arr[1]`, Preliquidar/Components/View.tsx L144-151) */
+declare function obtenerEspecialidadesCerradasAL04(cierres: CierresPreliquidarAL04): string[];
+/**
+ * La asignación se puede preliquidar en ese tipo: MO troncal o permitida para el HomePass y sin especialidad cerrada.
+ * El estado de la asignación y codMONoPreliquidablesAL04 se comprueban aparte (getDataAsignaciones del legacy).
+ */
+declare function esAsignacionPreliquidableAL04(asignacion: {
+    ManoObra: {
+        Codigo: string;
+    };
+    Especialidad: {
+        Codigo: string;
+    };
+}, tipo: TipoPreliquidacionAL04, especialidadesCerradas: string[]): boolean;
+/** Ductos: se consumen del stock personal (técnico); el resto, del almacén */
+declare const esMaterialDuctoAL04: (codigo: string) => boolean;
+/** Materiales que no se muestran en el stock personal porque se añaden como hijos de un ducto (generarDataMaterial.ts L15) */
+declare const codMaterialesOcultosAL04: string[];
+/**
+ * Cómo se informan los materiales de la MO:
+ * - automatico: el mapa fija los materiales (GD01, HP01, NVT01) y se añaden solos
+ * - elegir: solo se pueden elegir los materiales del mapa (ductos de obra civil y soplado)
+ * - sinMaterial: la MO no lleva materiales (AP02, EXTRA01, PP01…)
+ * - libre: la MO no está en el mapa; se puede elegir cualquier material (p. ej. ExtraWide AP02_*)
+ */
+type ModoMaterialesAL04 = 'automatico' | 'elegir' | 'sinMaterial' | 'libre';
+declare function modoMaterialesAL04(codMO: string): ModoMaterialesAL04;
+/** Cantidad fija de la MO (HP01, NVT01 = 1): el campo queda deshabilitado (FormAdd.tsx L366-367, L474-479) */
+declare function cantidadFijaMOAL04(codMO: string): number | undefined;
+interface MaterialRequeridoAL04 {
+    Codigo: string;
+    Cantidad: number;
+    /** Ducto: stock personal; si no, stock de almacén */
+    StockPersonal: boolean;
+}
+/** Materiales automáticos: (CantidadFija ? Cantidad : cantidad de MO) × Factor (verificarReglas, FormAdd.tsx L255-297) */
+declare function materialesAutomaticosAL04(codMO: string, cantidadMO: number): MaterialRequeridoAL04[];
+/** Códigos que se pueden elegir; undefined si la MO no restringe los materiales (AddedMaterial.tsx L263-271) */
+declare function materialesSeleccionablesAL04(codMO: string): string[] | undefined;
+interface CantidadMaterialAL04 {
+    /** Cantidad que se fija al elegir el material; undefined si la informa el usuario */
+    Cantidad?: number;
+    Bloqueada: boolean;
+    /** El material lleva hijos (conectores / empalmes) cuya cantidad son los empalmes × Factor */
+    PideEmpalmes: boolean;
+}
+/**
+ * Cantidad del material elegido (AddedMaterial.tsx L194-219): CantidadPadre = cantidad de MO × Factor;
+ * CantidadFija = Cantidad × Factor. Si sus hijos no tienen cantidad fija, se piden los empalmes.
+ */
+declare function cantidadMaterialAL04(codMO: string, codMaterial: string, cantidadMO: number): CantidadMaterialAL04;
+/**
+ * Hijos del material elegido (agregarSubMateriales, AddedMaterial.tsx L113-156):
+ * (CantidadFija ? Cantidad : CantidadPadre ? cantidad del material : empalmes) × Factor.
+ * Sin empalmes no se añaden; si no hay forma de obtener la cantidad es error.
+ */
+declare function subMaterialesAL04(codMO: string, codMaterial: string, cantidadMaterial: number, empalmes: number): MaterialRequeridoAL04[];
+/**
+ * División por exceso (UseCasePreliquidar.ts L438-469): los ductos se reparten entre la valorización padre y la hija
+ * según la cantidad de cada una; el resto de materiales queda en el padre.
+ * Decisión 2026-10-14: el padre se redondea a 2 decimales y la hija lleva el total menos el padre.
+ */
+declare function prorratearMaterialesAL04<T extends {
+    Codigo: string;
+    Cantidad: number;
+    CantidadInformada: number;
+}>(materiales: T[], cantidadPadre: number, cantidadTotal: number): {
+    padre: T[];
+    hija: T[];
+};
+/**
+ * Lo preliquidado en la obra de AP02 + ExtraWide no puede superar a AP01 (tolerancia 0.001). Solo se valida si
+ * la preliquidación incluye alguno de esos códigos. Devuelve el mensaje de error o null.
+ * @param moUo resumen de todos los trabajos de la obra (CalcularResumenValorizacionesAlemania)
+ * @param manoObra ManoObra de la GOM: diccionario LineaCodigoCub → código de la MO
+ * @param codigosNuevos códigos de MO de las valorizaciones nuevas
+ */
+declare function validarAsfaltoAL04(moUo: {
+    LineaCodigoCub: string;
+    Cantidad: number;
+}[], manoObra: {
+    Valorizacion: {
+        Codigo: string;
+        Descripcion?: string;
+        DetalleChile?: {
+            LineaCodigoCub?: string;
+        };
+    }[];
+}, codigosNuevos: string[]): string | null;
+
 declare const codMOTroncalAL02OC: never[];
 declare const codMOTroncalAL02Soplado: never[];
 declare const codMOTroncalAL02Asfaltado: never[];
@@ -268,6 +391,54 @@ declare const codIssueByPeriodoAL02: {
     codPeriodo: string;
 }[];
 
+/**
+ * Reglas de Preliquidar AL02 compartidas por la PWA (formulario) y pex-procesos (motor en el servidor).
+ * Legacy: sigo-pwa-mobile TrabajosDE/Preliquidar y TrabajosDE/DocHP.
+ */
+/** Tipo de preliquidación: troncal o por HomePass (Clientes = Residential, No Clientes = Business) */
+type TipoPreliquidacionAL02 = 'Troncal' | 'Residential' | 'Business';
+/** MO que no se preliquida ni en troncal ni por HomePass */
+declare const codMOExcluidos: string[];
+/** Baliza: una por AddressID y cantidad fija 1 */
+declare const codBalizaAL02 = "073006000";
+/** Baremos de subcontrata: en troncal piden el tipo (Asphalt / Trenching), que se guarda en DetalleChile.CodigoBarra */
+declare const codigosBaremosSubcontrataAL02: string[];
+/** Motivo del material consumido del almacén (UGG) o del conector de un ducto */
+declare const motivoConsumoMaterialAutomaticoDuctos = "CONSUMO_MATERIAL_AUTOMATICO_DUCTOS";
+declare const estadoRechazadaPorMetraje = "RECHAZADA POR METRAJE";
+/** Códigos de soplado (addCodigosSoplado del legacy): por HomePass su disponible es 0 (HPListMO nunca se cargaba) */
+declare const codigosSopladoHP: string[];
+/** MO que se puede preliquidar en troncal (filtro de Preliquidar/Components/View.tsx) */
+declare const codMOPreliquidarTroncalAL02: string[];
+/** MO permitida por HomePass: No Clientes codNoCliente; Clientes codClientes + codSopladoRD (DocHP/Components/View.tsx L390-393) */
+declare function obtenerCodMOHomePass(tipo: Exclude<TipoPreliquidacionAL02, 'Troncal'>): string[];
+type EstadoCierre = {
+    Estado: unknown;
+    Especialidad: string;
+} | undefined;
+/** Cierres OC / ASPH / SOP del trabajo (Ultima_PreLiquidacion) o del HomePass */
+interface CierresPreliquidarAL02 {
+    Asfaltado?: EstadoCierre;
+    OC?: EstadoCierre;
+    Soplado?: EstadoCierre;
+}
+/** Especialidades ocultas tras un cierre: solo si OC está cerrada (filtro `arr[1]` del legacy) */
+declare function obtenerEspecialidadesCerradas(cierres: CierresPreliquidarAL02): string[];
+/**
+ * La asignación se puede preliquidar en ese tipo: MO troncal o permitida para el HomePass, sin codMOExcluidos
+ * y sin especialidad cerrada. Las especialidades cerradas salen de obtenerEspecialidadesCerradas con los cierres
+ * del trabajo (troncal) o del HomePass.
+ * El estado de la asignación y codigosMOT1_F2 se comprueban aparte (getDataAsignaciones del legacy).
+ */
+declare function esAsignacionPreliquidableAL02(asignacion: {
+    ManoObra: {
+        Codigo: string;
+    };
+    Especialidad: {
+        Codigo: string;
+    };
+}, tipo: TipoPreliquidacionAL02, especialidadesCerradas: string[]): boolean;
+
 interface typeHPMOUtilizado {
     ID_HPListMO: number;
     CantidadUtilizado: number;
@@ -925,4 +1096,4 @@ declare function getCookieToken(req: Request<any>, webOrigins: string[]): string
 
 declare function validateUUIDv4Param(BadRequestException: ClassConstructor<Error>, req: Request<any>, _res: Response, next: NextFunction): Promise<void>;
 
-export { ActualizarDataManoObra, ActualizarDataReserva, ActualizarDataResumenLiquidaciones, ActualizarDataResumenLiquidacionesColombia, ActualizarDataResumenValorizacionesAlemania, ActualizarDataTrabajos, AsignacionHelper, BuscarZonaContratista, CalcularResumenHPMOLiquidado, CalcularResumenLiquidaciones, CalcularResumenLiquidacionesColombia, CalcularResumenValorizacionesAlemania, CodigosMaterialDuctosAL02, CodigosMaterialDuctosAL04, CodigosMaterialSoplado, CodsMapeoMOMaterial, CodsMapeoMOMaterialNVT01, CodsMapeoMOMaterialSopladoClientes, CodsMapeoMOMaterialSopladoTroncal, CodsMapeoMO_Material_Arquertas, CompararFechas, CurrencyFormat, DocumentacionReplanteo, EstadoEspecialidad9612, FormatearErrorValidacionMOHijas, GemeindeChangeNomenclatura, GetCodigoFechaActual, type IDPContrato, type IDocumentacion, type ILineaValidacion, type IMOAndMaterialsRules, type IMORules, type IMateriales, type IResultadoValidacionMOHijas, MOCantidadNVT01, MOHijasAL04, MOHijasDEPTH, MapeoEspecialidades9612, MapeoMOBOMAL04, MapeoMatBOMAL04, type MatRetiradosType, type MatStockAlmacenType, type MatStockPersonalType$2 as MatStockPersonalType, type MatUtilizadosType$2 as MatUtilizadosType, type MoUoType$2 as MoUoType, ModelDataFlujosDocumentacionReplanteo, ObtenerMONoReservada, ObtenerPrecioContratistaVigente, ObtenerZonaAsignada, type ResumenLiquidacionesType, type ResumenLiquidacionesTypeChile, type ResumenLiquidacionesTypeColombia, SEGMENT_TY, SOMACYL_CODIGO_CONTADOR_RETIRADO, SOMACYL_PHOTO_POSITIONS, type SomacylPhotoKey, type TARGET, UpdateNodosDocDP, ValidarRelacionMOHijasAL04, ValorizacionHelper, builSystemOption, buildDataMOFromMaterialRules, buildDataMaterialsRule, buildKeyMO, buildMenu, buildReservaMOJobMajorProjectsAlemaniaAL02, buildReservaMOJobMajorProjectsAlemaniaAL04, buildTenantCollectionName, calcularTotalMaterialValorizacionPeru9112, checkAndBuildMaterialsFromStock, checkMaterialAvailability, codBalizaAL04, codClientes, codIssueByPeriodoAL02, codMOClientesAL02, codMOClientesAL02Asfaltado, codMOClientesAL02OC, codMOClientesAL02Soplado, codMOClientes_ReglaLiquidacion1, codMODROPAL04, codMODROPAL04OC, codMODROPAL04Soplado, codMOFTTFAL04, codMONoClientesAL02, codMONoClientesAL02Asfaltado, codMONoClientesAL02OC, codMONoClientesAL02Soplado, codMONoClientes_ReglaLiquidacion1, codMOOcultosAL04, codMOPublico, codMOTroncalAL02, codMOTroncalAL02Asfaltado, codMOTroncalAL02OC, codMOTroncalAL02Soplado, codMOTroncalAL04, codMOTroncalAL04Asfaltado, codMOTroncalAL04Issue, codMOTroncalAL04OC, codMOTroncalAL04Soplado, codMOTroncalHistoricoAL02, codMOTroncal_ReglaLiquidacion1, codNoCliente, codSopladoRD, codigosMOT1_F2, codigosMaterialDuctos, codigosMaterialUGG, collections, consumirStockPersonal, convertDates, dataFlujosHomePass, db_default, db_root, documentRequirementAltasNVT, empresas, esCadenaFechaISOValida, esObjetoFecha, formatCurrencyV1, formatNumberSmart, formatNumberV1, formatPercentageV1, generateUniqueNumber, generateUniqueNumberArray, getCaptureDateSomacyl, getChannelName, getContainerName, getCookieToken, getDBName, getDateInTimeZone, getKeyRedisSortedSet, getModelDataAdicional, getNextID_Amap, getNextID_AsignacionValorizacion, getNextID_Valorizacion, getPrecioContratista, getPriceMaterial, getQueueName, getQueueNameSaveOneNotification, getRequestOrigin, hashCode, isValidDate, isValidPartialEntity, logTiempoProceso, mapaDPContratoPrecioFullAL02, mapaEstadoObraFaseAL02, mapaMOMaterialAL02, mapaMOMaterialAL04, mapaReglaSopladoClientes, mapaReglaSopladoTroncal, mapeoZonasSimilares, newCodMOTroncalReglaLiquidacion1, obtenerDocumentacionClientes, obtenerDocumentacionNoClientes, obtenerPrecioContratistaMaterial, obtenerPrecioManoObraAL02, obtenerPrecioManoObraAL04, obtenerTipoYCodigoMO, paisMap, parseDuplicateKeyError, roundNumber, searchCurrentContractorSpecialtyPrice, setColModels, setContext, throwSomacylError, updatePriceContractorMOAL02, updatePriceContractorMOAL04, updatePriceMOAL02, updatePriceMOAL04, updatePricePBBudgetAlemaniaAL02, updatePricePBBudgetAlemaniaAL04, uuidRegex, validateNoLookup, validateUUIDv4Param, verifyDetailsFinalizeSomacyl, verifyFiles, verifyInventoryFinalize, verifyInventoryFinalizeSomacyl, verifyInventoryLimitsSomacyl, verifyPhotosFinalizeSomacyl, verifyPhotosNotFinalizedSomacyl };
+export { ActualizarDataManoObra, ActualizarDataReserva, ActualizarDataResumenLiquidaciones, ActualizarDataResumenLiquidacionesColombia, ActualizarDataResumenValorizacionesAlemania, ActualizarDataTrabajos, AsignacionHelper, BuscarZonaContratista, CalcularResumenHPMOLiquidado, CalcularResumenLiquidaciones, CalcularResumenLiquidacionesColombia, CalcularResumenValorizacionesAlemania, type CantidadMaterialAL04, type CierresPreliquidarAL02, type CierresPreliquidarAL04, CodigosMaterialDuctosAL02, CodigosMaterialDuctosAL04, CodigosMaterialSoplado, CodsMapeoMOMaterial, CodsMapeoMOMaterialNVT01, CodsMapeoMOMaterialSopladoClientes, CodsMapeoMOMaterialSopladoTroncal, CodsMapeoMO_Material_Arquertas, CompararFechas, CurrencyFormat, DocumentacionReplanteo, EstadoEspecialidad9612, FormatearErrorValidacionMOHijas, GemeindeChangeNomenclatura, GetCodigoFechaActual, type IDPContrato, type IDocumentacion, type ILineaValidacion, type IMOAndMaterialsRules, type IMORules, type IMateriales, type IResultadoValidacionMOHijas, MOCantidadNVT01, MOHijasAL04, MOHijasDEPTH, MapeoEspecialidades9612, MapeoMOBOMAL04, MapeoMatBOMAL04, type MatRetiradosType, type MatStockAlmacenType, type MatStockPersonalType$2 as MatStockPersonalType, type MatUtilizadosType$2 as MatUtilizadosType, type MaterialRequeridoAL04, type MoUoType$2 as MoUoType, ModelDataFlujosDocumentacionReplanteo, type ModoMaterialesAL04, ObtenerMONoReservada, ObtenerPrecioContratistaVigente, ObtenerZonaAsignada, type ResumenLiquidacionesType, type ResumenLiquidacionesTypeChile, type ResumenLiquidacionesTypeColombia, SEGMENT_TY, SOMACYL_CODIGO_CONTADOR_RETIRADO, SOMACYL_PHOTO_POSITIONS, type SomacylPhotoKey, type TARGET, type TipoPreliquidacionAL02, type TipoPreliquidacionAL04, UpdateNodosDocDP, ValidarRelacionMOHijasAL04, ValorizacionHelper, builSystemOption, buildDataMOFromMaterialRules, buildDataMaterialsRule, buildKeyMO, buildMenu, buildReservaMOJobMajorProjectsAlemaniaAL02, buildReservaMOJobMajorProjectsAlemaniaAL04, buildTenantCollectionName, calcularTotalMaterialValorizacionPeru9112, cantidadFijaMOAL04, cantidadMaterialAL04, checkAndBuildMaterialsFromStock, checkMaterialAvailability, codBalizaAL02, codBalizaAL04, codBalizaPreliquidarAL04, codBaremoUnicoDPAL04, codClientes, codIssueByPeriodoAL02, codMOAsfaltoHijasAL04, codMOAsfaltoMadreAL04, codMOClientesAL02, codMOClientesAL02Asfaltado, codMOClientesAL02OC, codMOClientesAL02Soplado, codMOClientes_ReglaLiquidacion1, codMODROPAL04, codMODROPAL04OC, codMODROPAL04Soplado, codMOExcluidos, codMOFTTFAL04, codMONoClientesAL02, codMONoClientesAL02Asfaltado, codMONoClientesAL02OC, codMONoClientesAL02Soplado, codMONoClientes_ReglaLiquidacion1, codMONoPreliquidablesAL04, codMOOcultosAL04, codMOPreliquidarTroncalAL02, codMOPreliquidarTroncalAL04, codMOPublico, codMOTroncalAL02, codMOTroncalAL02Asfaltado, codMOTroncalAL02OC, codMOTroncalAL02Soplado, codMOTroncalAL04, codMOTroncalAL04Asfaltado, codMOTroncalAL04Issue, codMOTroncalAL04OC, codMOTroncalAL04Soplado, codMOTroncalHistoricoAL02, codMOTroncal_ReglaLiquidacion1, codMaterialesOcultosAL04, codNoCliente, codSopladoRD, codigosBaremosSubcontrataAL02, codigosMOT1_F2, codigosMaterialDuctos, codigosMaterialUGG, codigosSopladoHP, collections, consumirStockPersonal, convertDates, dataFlujosHomePass, db_default, db_root, documentRequirementAltasNVT, empresas, esAsignacionPreliquidableAL02, esAsignacionPreliquidableAL04, esCadenaFechaISOValida, esMaterialDuctoAL04, esObjetoFecha, estadoRechazadaPorMetraje, estadoRechazadaPorMetrajeAL04, formatCurrencyV1, formatNumberSmart, formatNumberV1, formatPercentageV1, generateUniqueNumber, generateUniqueNumberArray, getCaptureDateSomacyl, getChannelName, getContainerName, getCookieToken, getDBName, getDateInTimeZone, getKeyRedisSortedSet, getModelDataAdicional, getNextID_Amap, getNextID_AsignacionValorizacion, getNextID_Valorizacion, getPrecioContratista, getPriceMaterial, getQueueName, getQueueNameSaveOneNotification, getRequestOrigin, hashCode, isValidDate, isValidPartialEntity, logTiempoProceso, mapaDPContratoPrecioFullAL02, mapaEstadoObraFaseAL02, mapaMOMaterialAL02, mapaMOMaterialAL04, mapaReglaSopladoClientes, mapaReglaSopladoTroncal, mapeoZonasSimilares, materialesAutomaticosAL04, materialesSeleccionablesAL04, modoMaterialesAL04, motivoConsumoAlmacenAL04, motivoConsumoMaterialAutomaticoDuctos, newCodMOTroncalReglaLiquidacion1, obtenerCodMOHomePass, obtenerCodMOHomePassAL04, obtenerDocumentacionClientes, obtenerDocumentacionNoClientes, obtenerEspecialidadesCerradas, obtenerEspecialidadesCerradasAL04, obtenerPrecioContratistaMaterial, obtenerPrecioManoObraAL02, obtenerPrecioManoObraAL04, obtenerTipoYCodigoMO, paisMap, parseDuplicateKeyError, prorratearMaterialesAL04, roundNumber, searchCurrentContractorSpecialtyPrice, setColModels, setContext, subMaterialesAL04, throwSomacylError, updatePriceContractorMOAL02, updatePriceContractorMOAL04, updatePriceMOAL02, updatePriceMOAL04, updatePricePBBudgetAlemaniaAL02, updatePricePBBudgetAlemaniaAL04, uuidRegex, validarAsfaltoAL04, validateNoLookup, validateUUIDv4Param, verifyDetailsFinalizeSomacyl, verifyFiles, verifyInventoryFinalize, verifyInventoryFinalizeSomacyl, verifyInventoryLimitsSomacyl, verifyPhotosFinalizeSomacyl, verifyPhotosNotFinalizedSomacyl };