FEDELiq: la boleta justa del minero.
Abril de 2026 · en producción
Una app que pone la Ley 535 en el celular del cooperativista minero de Oruro: calcula su liquidación en cuatro pasos, con la cotización oficial y el dólar del día, y le muestra cuánto le corresponde y de dónde sale cada boliviano.
Tecnología
Angular 21
Firebase- Cloud Functions
PWA- jsPDF
TypeScript- Firestore
- Gemini
- Vitest
Servicios
El proyecto
Cliente e idea
FEDECOMIN agrupa a las cooperativas mineras de Oruro. Junto con CISEP nos pidió una herramienta para que cada socio pueda calcular, por sí mismo, cuánto le corresponde por su carga según la Ley 535 antes de firmar con la comercializadora.
Reto y objetivos
Una boleta de liquidación mezcla pesos, humedad, merma, leyes, dos cotizaciones, dos tipos de cambio, la regalía minera y varios aportes. Para la mayoría de los socios es imposible verificarla, y lo que no se entiende no se puede negociar. Había que llevar ese cálculo al celular de cualquier socio, con datos oficiales al día y palabras simples.
Solución y resultado
Construimos un motor de cálculo de la Regalía Minera según el Art. 227 de la Ley 535 y el DS 29577, para nueve minerales, probado contra boletas reales y contra la planilla de la versión anterior del sistema. El socio lo recorre en cuatro pasos y ve el resultado con su desglose completo.
Las cotizaciones de SENARECOM y el dólar del BCB llegan solos desde la nube, la boleta se puede escanear con IA y cada cálculo queda en el historial del socio. Para FEDECOMIN armamos un panel con métricas de uso, usuarios y todas las boletas calculadas.
La Ley 535 en el celular
La liquidación del minero en cuatro pasos.
Cada boliviano explicado
De dónde sale cada monto de la boleta.
Cálculo verificado
Probado contra los casos reales de las cooperativas.
Resumen del proyecto
Funciones principales
El socio elige su cooperativa y la comercializadora, carga el peso y la ley de su mineral, revisa los descuentos y en segundos ve su líquido. Cada paso cabe en una pantalla y cada cifra se puede abrir para ver de dónde sale.
Paso 1: con quién y con qué números
Tres datos: cooperativa, comercializadora y fecha. Debajo, la app avisa con qué dólar y qué quincena de SENARECOM va a calcular; si la boleta es de otra fecha, usa los datos de esa fecha.
Paso 2: peso y ley, con la regalía en vivo
El socio escribe el peso húmedo, la humedad y la merma, elige sus minerales y anota la ley. Mientras escribe ve los kilos finos, la alícuota del Art. 227 y la regalía que le corresponde pagar al Estado.
Paso 3: cada descuento a la vista
Los aportes vienen precargados según la cooperativa: CNS, COMIBOL, FENCOMIN, FEDECOMIN. El socio los ajusta a su boleta y ve el total de retenciones de ley antes de calcular.
Paso 4: el líquido y un simulador para negociar
El resultado se lee como un recibo: valor de venta, regalía, descuentos y líquido a recibir. Debajo, un simulador muestra qué porcentaje del valor de su mineral le están pagando y cuánto recibiría con otro.
Desarrollo
Metodología
Construimos FEDELiq en Angular como una PWA instalable que guarda la sesión y las boletas en el teléfono. Firebase aloja los datos, y las funciones en la nube traen varias veces al día la cotización de SENARECOM y el dólar del BCB. El motor de cálculo está cubierto por pruebas automáticas, entre ellas boletas reales reproducidas al centavo.
Proceso
Mapa de la app
Dos puertas: la del socio, con el cotizador en cuatro pasos, su historial y el glosario, y la del panel de FEDECOMIN. Las fichas punteadas son plantillas: una misma pantalla muestra cada boleta guardada.
- Cotizar4 pasos
- Identificación
- Pesos y leyes
- Descuentos
- Resultado y PDF
- Escanear boletacon IA
- Historialboletas del socio
- Lista con filtros
- Detalle de boletaplantilla × cada boleta
- Glosario y perfil
- Glosario de términos
- Mi perfil
- Completar perfilprimer ingreso
- Guía de bienvenida
- Panel FEDECOMINadministradores
- Observatorio
- Usuarios
- Boletas
Proceso
El cálculo, paso a paso
Así se ve una liquidación completa en el celular, de la primera pregunta al PDF: una tonelada de concentrado de estaño al 45 %, con la cotización oficial de la quincena. Desliza para seguir el recorrido.
Interfaz
Todo lo demás, en el bolsillo
Alrededor del cálculo están el ingreso con Google, una guía de bienvenida, el escaneo de la boleta con IA, la cotización oficial a un toque, el glosario y el perfil del socio.
Proceso
La boleta queda guardada
Cada cálculo se guarda solo en el historial del socio y se puede abrir otra vez con su desglose según la Ley 535. El PDF reproduce el formato de liquidación que usan las comercializadoras, con la marca de agua «cotización» para que nadie lo confunda con un comprobante.
Interfaz
Claro y oscuro
La app tiene modo claro y modo oscuro con el mismo verde de la federación. Arrastra para comparar las mismas pantallas.
Proceso
Panel FEDECOMIN
Para la federación construimos un panel con el uso de la plataforma, los usuarios y sus roles, y todas las boletas calculadas, con filtros por mineral, resultado y periodo y exportación a CSV.
Marca
Tipografía
Una sans propia de seis estilos, con cursivas para destacar palabras clave en los títulos y cifras tabulares para que los montos se alineen en columna. La misma familia sirve para títulos, texto y números.
xSans
RegularMediumBold
Marca
Colores
El verde de la federación marca las acciones y todo lo que suma a favor del socio. El arena del fondo le da a la app un tono cálido de papel, y el dorado viene del centro del logo de FEDECOMIN.
Conclusión
FEDELiq convierte una ley complicada en una respuesta clara en el celular. El socio llega a la comercializadora sabiendo cuánto vale su carga y cuánto le corresponde, y la federación tiene datos para acompañarlo.
Casos
