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, responden405 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 antiguaPOST /Login/loginse sigue admitiendo por compatibilidad, pero ya no aparece en Swagger.Token: el token ya no incluye emisor (
iss), destinatario (aud) nitipo_credencial. Ahora lleva los claimsusuario,uidyempresa_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) o405(losPUT, porque la ruta sigue existiendo para otros métodos). Usa sus sustitutos:GET /api/common/ventas/clientes/buscar→GET /api/common/ventas/clientes/buscarclienteGET /api/common/ventas/clientespotenciales/buscar→GET /api/common/ventas/clientespotenciales/buscarclientepotencialesGET /api/common/ventas/comisionistas/buscar→GET /api/common/ventas/comisionistas/buscarcomisionistaGET /api/common/compras/proveedores/buscar→GET /api/common/compras/proveedores/buscarproveedorPUT /api/common/ventas/clientes→PUT /api/common/ventas/clientes/actualizarPUT /api/common/ventas/clientespotenciales→PUT /api/common/ventas/clientespotenciales/actualizarPUT /api/common/compras/proveedores→PUT /api/common/compras/proveedores/actualizarGET /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,CreacionoTotal. Si el nivel no basta para el método HTTP (GET,PUT,POSToDELETE), la petición responde403 Forbiddeny 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
requestIdpara localizar el detalle en el log.
Estado de la API
GET /api/pingresponde200si todo está bien y503si falla algo. Devuelve el estado de SQL Server (sqlServer) y del servicio de configuración (configuracion), cada uno comoOKoError, sin dar más detalles. Si todo está bien, también devuelve la versión instalada (version).La versión que devuelven
GET /api/estadoyGET /api/pingse lee de la propia DLL instalada (por ejemplo,v5.0.2).