Sistema RED: Consulta de cálculos (liquidaciones, cálculos y Consulta Masiva)

21/10/2026

Tres endpoints nuevos bajo /api/v4/seg-social/ para el servicio «Cotización SLD Remesas > Consulta de cálculos» del Sistema RED:

• GET /contribution-calculations: lista las liquidaciones de una cuenta de cotización en un periodo. Herramienta MCP tgss_list_contribution_calculations. Documentación.
• GET /contribution-calculations/detail: cálculos de una liquidación por conceptos y lista de trabajadores; con naf, el detalle del trabajador con sus tramos. Herramienta MCP tgss_get_contribution_calculations_detail. Documentación.
• POST /contribution-calculations/siltra: pide la Consulta Masiva de los cálculos de todos los trabajadores de una liquidación; la TGSS la entrega en diferido en el buzón SILTRA. Es una escritura (409 si la comunicación con la TGSS está desactivada). Herramienta MCP tgss_request_contribution_calculations_siltra. Documentación.

detail devuelve siempre workers_list_available: en liquidaciones con muchos trabajadores la TGSS no da su lista, workers es null y warnings indica que se consulte cada trabajador con naf (que funciona en ambos casos; un naf ajeno a la liquidación da 404). siltra funciona también en esas liquidaciones. ccc es siempre de 11 dígitos y liquidation_number de 17.

Todos los objetos de la respuesta llevan un campo extra, con los campos de la TGSS sin clave traducida (nombre original del XML, valor sin convertir; {} si no hay). Si la TGSS añade un campo nuevo aparece ahí sin cambios en la API; si más adelante se traduce, pasa a su clave en inglés.

liquidation_number es opcional en detail y siltra: si se omite, se busca con ccc, regimen, start_date, end_date, liquid_type y liquid_origin; con una sola liquidación se usa esa, con varias responde 422 con data.liquidations para elegir (en la masiva, sin enviar nada a la TGSS) y sin ninguna, 404. Se obtiene con GET /contribution-calculations (data.list[].liquidation_number).

Los parámetros van en snake_case (regimen, ccc, start_date, end_date, liquid_type, liquid_origin, liquidation_number, naf, authorized_num, test). Es un cambio aditivo: no cambia nada para las integraciones existentes.