Módulo Catálogo
El módulo Catálogo (ERP.Catalog) gestiona todo el inventario maestro de productos, descompuestos técnicos, tarifas comerciales y estructura de familias de BaseGes ERP.
Recursos del Módulo
| Recurso | Endpoint Base | Descripción |
|---|---|---|
| Artículos | /products | Catálogo de artículos simples, materiales, consumibles y mano de obra unitaria con precios de compra, venta y códigos de barras. |
| Tarifas y Precios | /prices | Motor de cálculo dinámico de precios netos por cliente, aplicando tarifas especiales, descuentos pactados y promociones. |
| Precios y Costes en Documentos | Transversal | Reglas de negocio para la resolución automática de precios, descuentos y costes (PUC/PMP) en presupuestos, pedidos, albaranes y partes. |
| Unidades de Obra | /workunits | Partidas y escandallos compuestos por múltiples líneas de materiales y operarios con cálculo automático de costes. |
| Familias y Grupos | /families, /subfamilies, /groups | Árbol de categorización de artículos a tres niveles para estadísticas, márgenes y filtrado en compras/ventas. |
Conceptos Clave de Catálogo
- Artículos Simples vs. Unidades de Obra:
- Un Artículo (
/products) representa un material individual o servicio básico (un tubo, un cable, una hora de oficial). - Una Unidad de Obra (
/workunits) es una partida compleja o escandallo compuesta por varios artículos y horas de mano de obra (por ejemplo: "Instalación de cuadro eléctrico secundario" que incluye interruptores, cableado, caja estanca y 3 horas de técnico).
- Un Artículo (
- Cálculo de Precios y Márgenes:
- La API permite fijar precios brutos de compra, descuentos de proveedor, margen porcentual y precio de venta al público (PVP) con y sin impuestos.
- Precios Personalizados por Cliente:
- Mediante el endpoint
/prices?customerId={code}la API evalúa al vuelo qué precio final debe aplicarse a un cliente determinado para un artículo concreto.
- Mediante el endpoint