Skip to content
Documentación API

Version 4.3.3

Novedades versión4.3.3

Esta versión incorpora importantes mejoras en la gestión de fabricación, nuevos endpoints para operaciones clave como recibir pedidos de compra y facturar múltiples albaranes, así como un sistema de búsqueda avanzada mucho más flexible. Los antiguos endpoints de búsqueda han sido marcados como obsoletos y serán reemplazados por los nuevos.

Módulo de Fabricación

  • Se ha incorporado el módulo de Fabricación con sus endpoints auxiliares. Ahora es posible gestionar órdenes de fabricación, consultar estructuras de productos (listas de materiales) y obtener información de los centros de trabajo.

  • Nuevos endpoints destacados:

    • GET /api/common/fabricacion/ordenes – Listado de órdenes de fabricación.
    • GET /api/common/fabricacion/ordenes/{id} – Detalle de una orden.
    • POST /api/common/fabricacion/ordenes – Crear una nueva orden.
    • GET /api/common/fabricacion/listasmateriales – Consulta de listas de materiales (BOM).
    • GET /api/common/fabricacion/centrostrabajo – Centros de trabajo disponibles.

  • Todos los endpoints de fabricación incluyen soporte multiempresa mediante el parámetro codigoEmpresa.

Recepción de pedidos de compra

  • Nuevo endpoint POST /api/common/documentos/recibirpedido/{ejercicioPedido}/{numeroPedido} que permite generar un albarán a partir de un pedido de compra.

  • Funciona en dos modos:

    • Sin body – Recepción completa del pedido.
    • Con body – Recepción parcial por líneas, indicando artículo, unidades y fecha.

  • Soporta recepción de menos unidades de las pendientes, e incluso más de las esperadas (con aviso en la respuesta).

  • Para líneas con el mismo artículo, es obligatorio utilizar idLinea (corresponde a LineasPosicion).

Facturación múltiple de albaranes

  • Endpoint POST /api/common/documentos/facturaralbaranes para facturar varios albaranes (de venta o compra) en una sola operación.

  • Acepta un listado de albaranes identificados por ejercicio, número y serie.

  • Si los albaranes están agrupados, se genera una única factura; de lo contrario, se generan varias.

  • Para albaranes de compra es necesario incluir los datos de IVA en el body.

  • Parámetros opcionales: tipoAlbaran (Venta/Compra) y tipoFecha (FechaProceso, FechaPrimerAlbaran, FechaUltimoAlbaran).

Cálculo de descuentos automático

  • Nuevo endpoint POST /api/common/tarifas/obtenerdescuento que calcula el descuento aplicable a un artículo en función del cliente, tarifa y unidades.

  • Parámetros de entrada: codigoCliente, codigoArticulo, tarifa, codigoTipoClienteLc (opcional) y unidades.

  • Ideal para integraciones en tiempo real antes de confirmar un pedido o presupuesto.

Nuevos buscadores avanzados (flexibles)

  • Se han añadido endpoints de búsqueda que permiten filtrar por cualquier campo de forma dinámica, utilizando los parámetros columnaBusqueda, valorBusqueda y tipoBusqueda (Completa, Parcial, DistintosDe).

  • Ejemplos disponibles:

    • GET /api/common/ventas/clientes/buscarcliente – Búsqueda avanzada de clientes.
    • GET /api/common/ventas/proveedores/buscarproveedor – Búsqueda avanzada de proveedores.
    • GET /api/common/articulos/buscararticulo – Búsqueda avanzada de artículos.
    • GET /api/common/documentos/buscardocumento – Búsqueda personalizada en documentos de compra/venta.

  • Todos soportan paginación (page, pageSize) y selección de campos a devolver mediante campos.

  • Los antiguos endpoints de búsqueda (ej. GET /api/common/ventas/clientes/buscar) quedan obsoletos y serán eliminados en versiones futuras. Se recomienda migrar a los nuevos buscadores.