Skip to content

Version 5.0.0

Novedades versión5.0.0

La versión 5 refuerza la seguridad de la API. Añade permisos por módulo para cada usuario, cambia la ruta del login, elimina los endpoints obsoletos y pasa a POST los endpoints que modificaban datos con GET. Además, los errores dejan de mostrar detalles internos. Incluye también todas las novedades de la versión 4.4.3.

Cambios que pueden afectar a las integraciones

  • Endpoints que pasan de GET a POST (misma ruta y parámetros). Si se llaman con GET, responden 405 Method Not Allowed:

    • POST /api/common/documentos/servirpedido/{ejercicioPedido}/{numeroPedido}
    • POST /api/common/documentos/facturaralbaran/{ejercicioAlbaran}/{numeroAlbaran}
  • Login: la ruta oficial pasa a ser POST /login. La ruta antigua POST /Login/login se sigue admitiendo por compatibilidad, pero ya no aparece en Swagger.

  • Token: el token ya no incluye emisor (iss), destinatario (aud) ni tipo_credencial. Ahora lleva los claims usuario, uid y empresa_id. Su duración depende de cada usuario: si no tiene una configurada, dura 60 minutos. El cuerpo de la respuesta del login no cambia.

Endpoints obsoletos eliminados

  • Se eliminan los endpoints que en la versión 4 estaban marcados como obsoletos. Si se llaman, responden 404 (las búsquedas) o 405 (los PUT, porque la ruta sigue existiendo para otros métodos). Usa sus sustitutos:

    • GET /api/common/ventas/clientes/buscar → GET /api/common/ventas/clientes/buscarcliente
    • GET /api/common/ventas/clientespotenciales/buscar → GET /api/common/ventas/clientespotenciales/buscarclientepotenciales
    • GET /api/common/ventas/comisionistas/buscar → GET /api/common/ventas/comisionistas/buscarcomisionista
    • GET /api/common/compras/proveedores/buscar → GET /api/common/compras/proveedores/buscarproveedor
    • PUT /api/common/ventas/clientes → PUT /api/common/ventas/clientes/actualizar
    • PUT /api/common/ventas/clientespotenciales → PUT /api/common/ventas/clientespotenciales/actualizar
    • PUT /api/common/compras/proveedores → PUT /api/common/compras/proveedores/actualizar
    • GET /api/common/stock/stockarticulos/{codigoArticulo}/{codigoAlmacen} → GET /api/common/stock/stockdisponible

Estadísticas

  • Los endpoints de estadísticas de familias, artículos y comisiones tienen ahora una descripción detallada de lo que devuelven y de cómo se filtran.

Permisos por módulo

  • Cada usuario tiene un nivel de permiso por módulo: Lectura, Modificacion, Creacion o Total. Si el nivel no basta para el método HTTP (GET, PUT, POST o DELETE), la petición responde 403 Forbidden y se indica el módulo y el nivel que se necesita.

Respuestas de error

  • Los errores internos ya no devuelven el mensaje técnico de la excepción. Responden con un mensaje genérico y un requestId para localizar el detalle en el log.

Estado de la API

  • GET /api/ping responde 200 si todo está bien y 503 si falla algo. Devuelve el estado de SQL Server (sqlServer) y del servicio de configuración (configuracion), cada uno como OK o Error, sin dar más detalles. Si todo está bien, también devuelve la versión instalada (version).

  • La versión que devuelven GET /api/estado y GET /api/ping se lee de la propia DLL instalada (por ejemplo, v5.0.2).