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).

Proyectos: empleados y asignaciones

Nuevo endpoint GET /api/common/proyectos/proyectos/empleados/porproyecto/{codigoProyecto} que devuelve los empleados asignados a un proyecto.
Nuevo endpoint GET /api/common/proyectos/proyectos/porempleado/{codigoEmpleado} que devuelve los proyectos asignados a un empleado concreto.

Contabilidad: asientos de facturas emitidas y recibidas

Los endpoints POST /api/common/contabilidad/asientoscontables/emitidas y POST /api/common/contabilidad/asientosconbables/recibidas han sido completamente documentados con ejemplos reales y cuadres contables.
Casuísticas cubiertas: factura básica de cliente/proveedor, distribución por canales analíticos, suplidos y facturas con múltiples tipos de IVA.

Documentos: campo `suFacturaNo` y payload simplificado

Los endpoints de facturación de albaranes (facturaralbaranes y facturaralbaranesforzarnumeracion) aceptan ahora el campo suFacturaNo para indicar el número de factura del proveedor en compras.
El endpoint POST /api/common/documentos simplifica el payload: las líneas ya no necesitan repetir codigoDocumentoLc, ejercicioDocumento, serieDocumento ni fechaDocumento, que se heredan de la cabecera.

Auxiliares: parámetro `campos` en agrupaciones

Los endpoints de agrupaciones aceptan ahora el parámetro opcional campos (separado por comas) para devolver únicamente los campos deseados, reduciendo el volumen de datos en la respuesta.

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.