Documentación API Sage 200 - Tandem Software

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.