Documentación API Sage 200 - Tandem Software

Novedades versión4.4.0

Esta versión añade nuevos módulos de Tallas, Custom (tablas personalizadas con escritura) y Divisas, incorpora asientos contables de rectificativas y el QR Verifactu, y amplía varios endpoints de Proyectos, Clientes y Contabilidad con nuevos campos y funcionalidades.

Tallas: nuevo módulo de grupos de tallas

Nuevo módulo Tallas bajo /api/common/ventas/tallas con tres endpoints:
- GET /api/common/ventas/tallas – Listado paginado de grupos de tallas.
- GET /api/common/ventas/tallas/{grupoTalla} – Detalle de un grupo.
- GET /api/common/ventas/tallas/buscartalla – Búsqueda flexible con columnaBusqueda, valorBusqueda y tipoBusqueda.

Documentos: QR Verifactu, aprobar pedido y nuevos parámetros de detalle

Nuevo endpoint GET /api/common/documentos/verifactuqr/{ejercicioFactura}/{numeroFactura} que devuelve el código QR Verifactu de una factura de venta en Base64.
Nuevo endpoint POST /api/common/documentos/aprobarpedido para aprobar un pedido de venta o de compra.
El endpoint de detalle de documento acepta dos nuevos parámetros opcionales: generarVerifactuQR (incluye el QR en la respuesta) y mostrarInformacionLote (oculta las líneas de componente de lote).

Contabilidad: rectificativas emitidas y nuevos campos

Nuevo endpoint POST /api/common/contabilidad/asientoscontables/rectificativas para generar asientos contables a partir de facturas rectificativas (abonos) emitidas.
Los endpoints de asientos contables (emitidas y recibidas) admiten ahora serieFactura y numeroFacturaForzado (forzar el número de factura contable).
Emitidas incorpora permitirCuentasNoEstandar para casos donde el cobro anticipado no sigue la contabilidad estándar (p. ej. agencias de viaje). Recibidas incorpora codigoCuentaIVARepercutido para la autorrepercusión de IVA en operaciones intracomunitarias o de inversión del sujeto pasivo.

Módulo Custom: tablas personalizadas con escritura

El antiguo endpoint de consulta de tablas personalizadas se traslada de /api/common/auxiliares/tablaspersonalizadas a un nuevo módulo Custom en /api/common/custom/tablas.
Además de la consulta paginada, ahora soporta escritura:
- POST /api/common/custom/tablas – Alta de un registro.
- PUT /api/common/custom/tablas – Actualización de un registro identificado por su clave primaria.
- PUT /api/common/custom/tablas/masivo – Actualización transaccional de varios registros a la vez.
El acceso está limitado a una lista blanca de tablas configurada por cliente; solicitar una tabla no permitida devuelve 403.

Nuevo módulo de Divisas

Nuevo módulo Divisas bajo /api/common/divisas con dos endpoints:
- GET /api/common/divisas – Cotizaciones paginadas, con filtro por divisa y rango de fechas.
- POST /api/common/divisas – Alta de una o varias cotizaciones (moneda base fija a EUR).

Proyectos: estados disponibles

Nuevo endpoint GET /api/common/proyectos/proyectos/estadosproyecto que devuelve el catálogo de estados posibles de un proyecto (En Construcción, Aprobado, Retenido, Finalizado) con su valor numérico correspondiente.

Clientes: búsqueda por CIF/DNI devuelve lista

El endpoint GET /api/common/ventas/clientes/cifdni/{cifdni} ahora devuelve una lista de clientes en lugar de un único objeto, para cubrir el caso en que varios clientes compartan el mismo CIF/DNI.

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.

Contabilidad: consulta de movimientos

Nuevo endpoint GET /api/common/contabilidad/movimientos/{page}/{pageSize} que devuelve movimientos contables paginados, con filtros opcionales por rangos de fecha de asiento, número de asiento, cuenta, canal y diario.

Estadísticas: comisiones por artículo

Nuevo endpoint GET /api/common/estadisticas/articulos/comisiones que devuelve el desglose mensual de base imponible y unidades por artículo, filtrable por ejercicio, cliente, artículo, familia y subfamilia.