Saltar al contenido principal

Módulo de Presupuestos (/budgets)

El módulo de Presupuestos permite consultar y crear presupuestos técnicos y comerciales en BaseGes ERP.

Permite representar presupuestos sencillos (artículos planos) o estructuras jerárquicas complejas compuestas por Capítulos, Partidas, Subpartidas anidadas, Unidades de Obra con escandallos, Artículos y Textos descriptivos.

Operaciones Disponibles​

MétodoEndpointAcción
GET/budgetsConsulta paginada con filtros por cliente, obra, estado y búsqueda de texto.
GET/budgets/{number}Detalle completo de un presupuesto, incluyendo su árbol de líneas y totales.
POST/budgetsCreación de un nuevo presupuesto técnico con deducción automática de tipos.

Consulta y Filtros (GET /budgets)​

El listado soporta los siguientes parámetros de consulta:

  • Paginación: page (número de página) y pageSize (registros por página).
  • Filtros de Negocio:
    • customerCode: Filtrar por el código del cliente.
    • projectCode: Filtrar por código de obra/proyecto.
    • status: Filtrar por el estado del presupuesto (Aceptado, Pendiente, Rechazado, etc.).
  • Búsqueda global (search): Realiza una búsqueda parcial en:
    • Número de presupuesto (Number / tPresupuestos2) y serie (Series / tPresupuestos1).
    • Código de cliente (Customer.Code / tPresupuestos4) y nombre de cliente (Customer.Name / tPresupuestos5).
    • Nombre de cliente en el maestro de contactos (tClientes2).
    • Nombre de obra o proyecto en el maestro de obras (tObras2).
    • Observaciones del presupuesto (Notes / tPresupuestos17).
Sandbox

Puedes probar la consulta y validación de presupuestos en tiempo real desde el Scalar Sandbox.

Contenido de la Guía​

Para aprender a construir presupuestos completos mediante la API, consulta los siguientes apartados:

  1. Estructura Jerárquica y Deducción de Líneas: Cómo estructurar partidas, subpartidas, unidades de obra y la deducción automática del campo type.
  2. Artículos y Unidades de Obra Genéricas: Cómo dar de alta líneas con referencias fuera de catálogo o unidades de obra ad-hoc.
  3. Resolución de Precios, Descuentos y Costes: Cómo la API resuelve automáticamente precios de tarifas, descuentos y costes unitarios (PUC/PMP) cuando se omiten en el payload.