Novedades versión4.4.3
Esta versión añade la aprobación de varios pedidos en una sola petición, el cálculo de descuentos por lote, la consulta de unidades de medida de un artículo, un endpoint público de estado de la API, el alta de canales, departamentos y secciones y el servicio de ofertas a pedido. También amplía la gestión de cobros y pagos, añade filtros nuevos y protege el login frente a intentos fallidos repetidos.
Estado de la API
Nuevo endpoint público
GET /api/estado, que no necesita login. Devuelve la versión de la API instalada y si conecta con la base de datos de Sage.
Login: bloqueo por intentos fallidos
Tras varios intentos de login fallidos con el mismo usuario, el login se bloquea temporalmente y responde
429 Too Many Requests. La cabeceraRetry-Afterindica los segundos que hay que esperar.
Documentos: aprobar varios pedidos
Nuevo endpoint
POST /api/common/documentos/aprobarpedidospara aprobar varios pedidos de venta o de compra a la vez. Devuelve el resultado de cada pedido e indica si no existe o si ya estaba aprobado.En
POST /api/common/documentos, cuando algún documento del lote falla, la respuesta indica cuántos son correctos y cuántos tienen error, y devuelve el resultado de todos los documentos (antes solo devolvía los que tenían error).
Contabilidad: cobros y pagos
Los endpoints
gestioncobrosygestionpagosaceptan tres campos opcionales nuevos:comentario: el comentario del asiento.fechaCobro: la fecha del cobro o pago. Se comprueba que su periodo contable esté abierto.generarAsiento: confalse, el efecto se da de baja sin generar asiento.
Se corrige que el cobro o pago no llegara a generar el asiento contable. Ahora, si el asiento no se crea, el efecto vuelve a su estado anterior y se devuelve un error.
Tarifas: descuentos por lote
Nuevo endpoint
POST /api/common/tarifas/obtenerdescuentos, que devuelve el precio y los descuentos de varios artículos (hasta 200) de un mismo cliente en una sola llamada.
Auxiliares: unidades de medida
Nuevo endpoint
GET /api/common/auxiliares/unidadesmedida/{codigoArticulo}, que devuelve la unidad básica de un artículo y sus unidades de medida de venta con el factor de conversión.
Ventas: filtros nuevos
GET /api/common/ventas/clientes/topventasadmite filtrar por un campo de la ficha del artículo concolumnaArticuloyvalorArticulo.GET /api/common/ventas/clientespotenciales/buscarclientepotencialesadmite filtrar por uno o varios comisionistas concodigoComisionista.
Auxiliares: canales, departamentos y secciones
Nuevos endpoints
GETyPOSTen/api/common/auxiliares/canales,/api/common/auxiliares/departamentosy/api/common/auxiliares/seccionespara consultar (con filtro opcional por código exacto) y dar de alta canales, departamentos y secciones de la empresa.
Documentos: servir ofertas
Nuevo endpoint
POST /api/common/documentos/servirofertaque crea un pedido de cliente a partir de una oferta. Permite servir todas las líneas pendientes o solo algunas, y servir unidades parciales dejando la línea de la oferta pendiente.
Endpoints eliminados
Se elimina
POST /api/common/b2b/logincliente.