Version 4.3.2

Novedades versión4.3.2

Esta versión introduce mejoras significativas en la búsqueda y consulta de información. Se han añadido nuevos endpoints para proveedores, estadísticas con desglose mensual, y se ha reorganizado el sistema de agrupaciones para mejorar la coherencia de la API. También se amplía el soporte de facturación a albaranes de compras.

Nuevos endpoints para Proveedores

• Se han añadido dos nuevos endpoints para facilitar la búsqueda de proveedores:

  • GET /api/common/ventas/proveedores/buscar – Permite buscar proveedores por nombre de forma parcial. Por ejemplo, si se busca “pru”, devolverá todos los proveedores que contengan ese texto en su razón social.

  • GET /api/common/ventas/proveedores/cifdni – Permite buscar un proveedor específico por su CIF o DNI, devolviendo únicamente el registro que coincida exactamente con el identificador proporcionado.

• Ambos endpoints incluyen paginación mediante los parámetros page y pageSize, y son compatibles con el parámetro codigoEmpresa para entornos multiempresa.

Top ventas por cliente

• Nuevo endpoint GET /api/common/ventas/clientes/topventas que permite obtener los artículos más vendidos de un cliente en un período específico.

• Parámetros principales:

  • numeroTop – Número máximo de artículos a devolver (por ejemplo, Top 10).
  • fechaDesde y fechaHasta – Rango de fechas para el análisis.
  • codigoCliente – Código del cliente del que se desean obtener los datos.

• La respuesta incluye el código y descripción de cada artículo, junto con las unidades totales vendidas en el período indicado, ordenadas de mayor a menor.

• Ideal para análisis comerciales, recomendaciones de productos y estrategias de venta.

Reubicación del endpoint de Agrupaciones

• El endpoint de agrupaciones ha sido movido de su ubicación anterior a la sección de Auxiliares - Otros.

• Nueva ruta: GET /api/common/auxiliares/agrupaciones/{page}/{pagesize}

• Este cambio mejora la organización lógica de los endpoints, agrupando las funcionalidades auxiliares en un mismo lugar.

• El comportamiento del endpoint permanece sin cambios: devuelve las agrupaciones de artículos con sus unidades, precios y descuentos asociados.

Búsqueda avanzada de documentos

• Nuevo endpoint GET /api/common/documentos/buscardocumento que permite realizar búsquedas personalizadas en documentos de compra y venta.

• Parámetros destacados:

  • tipoDocumento – Tipo de documento a buscar: FacturaVenta, PedidoVenta, AlbaranVenta, OfertaVenta, ContratoVenta, FacturaCompra, PedidoCompra, AlbaranCompra, etc.

  • columnaBusqueda – Nombre de la columna por la que se desea filtrar (por ejemplo, cifEuropeo, codigoCliente, razonSocial, etc.).

  • valorBusqueda – Valor específico a buscar en la columna indicada.

  • campos – Lista de campos a devolver, separados por comas. Si no se especifica, se devuelven todos los campos disponibles.

• Este endpoint ofrece una gran flexibilidad para integrar sistemas externos que necesiten consultar documentos por criterios personalizados, sin depender de búsquedas predefinidas.

Facturación de albaranes de compras

• Los endpoints de facturación de albaranes ahora soportan tanto albaranes de ventas como albaranes de compras.

• Anteriormente, solo se podían facturar albaranes de ventas. Con esta actualización, se puede generar una factura de compra a partir de uno o varios albaranes de compra.

• Endpoints actualizados:

  • POST /api/common/documentos/facturar/albaranes – Para ventas.
  • POST /api/common/documentos/facturar/albaranescompra – Para compras.

• Esto permite una gestión completa del ciclo de facturación tanto en ventas como en compras, mejorando la automatización de procesos contables.

Nuevas estadísticas de ventas

• Se han añadido dos nuevos endpoints para obtener estadísticas de ventas con desglose mensual:

  • GET /api/common/estadisticas/familias – Devuelve estadísticas agrupadas por familia y subfamilia de productos.

  • GET /api/common/estadisticas/articulos – Devuelve estadísticas detalladas por artículo individual.

• Ambos endpoints incluyen:

  • Desglose mensual de importes y unidades vendidas (enero a diciembre).

  • Información del cliente, familia, subfamilia y artículo según corresponda.

  • Soporte para valores negativos que indican devoluciones o notas de crédito.

• Parámetros comunes:

  • ejercicio – Año del ejercicio fiscal a analizar.
  • codigoCliente, codigoFamilia, codigoSubfamilia, codigoArticulo – Filtros opcionales para acotar los resultados.
  • page y pageSize – Paginación de resultados.

• Estos endpoints son ideales para generar informes de rendimiento comercial, análisis de tendencias de venta y toma de decisiones estratégicas basadas en datos históricos.

Nuevo endpoint para consultar empresas

• Se ha añadido un nuevo endpoint GET /api/common/auxiliares/empresas que permite obtener el listado completo de empresas registradas en el sistema.

• Características principales:

  • Devuelve información básica de cada empresa: código, CIF/DNI y razón social.

  • Permite filtrar por cifDni de forma opcional para buscar una empresa específica por su identificador fiscal.

  • No incluye paginación, ya que el número de empresas suele ser limitado y manejable en una sola consulta.

• Este endpoint se ha ubicado en la sección de Auxiliares - Otros, junto con agrupaciones y otros datos auxiliares del sistema.

• Ideal para:

  • Poblar selectores de empresas en aplicaciones cliente
  • Validar códigos de empresa en procesos de integración
  • Verificar la existencia de empresas por su CIF/DNI