Recibo de Liquidación de Cotizaciones (RLC)

Obtiene el Recibo de Liquidación de Cotizaciones de una cuenta de cotización para un tipo de liquidación y el periodo de esa liquidación, en PDF (por defecto) o como datos estructurados (format=json). El documento es el que emite el Sistema RED tras la liquidación de cada mes. Con format=siltra pide en su lugar el duplicado de la Relación Nominal de Trabajadores, que llega por SILTRA.

Parámetros

• regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • 0111: Régimen general
  • Tabla con los códigos de régimen 
• ccc (número entero) : Cuenta de cotización, 11 dígitos.
• liquidType (caracteres) : Tipo de liquidación. Posibles valores:
  • L00: Normal
  • L02: Complementaria por salarios de tramitación (normal)
  • L03: Complementaria por abono de salarios con carácter retroactivo
  • L13: Vacaciones retribuidas y no disfrutadas
  • L90: Complementaria por incremento de bases
  • L91: Complementaria por nuevos trabajadores y/o tramos
  • L92: Complementaria por salarios de tramitación de oficio
  • L93: Complementaria por vacaciones retribuidas y no disfrutadas de oficio
  • C00: Ordinaria de salarios no concertados
  • C02: Complementaria por salarios de tramitación no concertados
  • C03: Complementaria por salarios retroactivos no concertados
  • C13: Complementaria por vacaciones retribuidas no concertados
  • C90: Complementaria por incremento de bases no concertados
  • C91: Complementaria por nuevos trabajadores y/o tramos no concertados
  • V03: Complementaria por abono de salarios retroactivos de L13
  • V90: Complementaria por incremento de bases de L13
• startDate (date) : Primer periodo de liquidación, formato YYYY-MM-DD. Solo se tienen en cuenta el mes y el año.
• endDate (date) : Último periodo de liquidación, formato YYYY-MM-DD. Solo se tienen en cuenta el mes y el año.
• controlDate opcional (date) : Fecha de control, formato YYYY-MM-DD. Solo aplica a las liquidaciones L03, que requieren un mes y año de control. Si se omite se usa endDate. Solo se tienen en cuenta el mes y el año.
• numAutorizado opcional (caracteres) : Número de autorizado RED con el que consultar. Solo es necesario cuando el certificado tiene varios autorizados. Si se omite se prueba con cada uno hasta encontrar el que tiene asignada la cuenta de cotización. Si el certificado tiene varios autorizados y el indicado no tiene asignada la cuenta de cotización, se devuelve el error CM05 de la TGSS.
• format opcional (caracteres) : Formato de la respuesta. Posibles valores:
  • pdf (por defecto): el PDF del RLC en data.file (base64).
  • json: los datos de cada recibo de la liquidación, leídos del Sistema RED, sin el PDF. Útil cuando solo se necesitan las bases y cuotas, y mientras la TGSS no entregue el PDF de algunos periodos.
  • siltra: no es una consulta: pide a la TGSS el duplicado de la Relación Nominal de Trabajadores (RNT) de todos los trabajadores de la liquidación. La TGSS lo entrega en diferido en el buzón SILTRA del autorizado RED; la respuesta no trae ningún fichero. Ver Duplicado de la RNT por SILTRA.

{
  "regimen": "0111",
  "ccc": "12345678901",
  "liquidType": "L00",
  "startDate": "2023-01-01",
  "endDate": "2023-03-01",
  "format": "pdf"
}

Para una liquidación L03, añadiendo la fecha de control:

{
  "regimen": "0111",
  "ccc": "12345678901",
  "liquidType": "L03",
  "startDate": "2023-01-01",
  "endDate": "2023-03-01",
  "controlDate": "2023-04-01"
}

Respuesta

Con format=pdf (por defecto):

{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Petición con format=json:

{
  "regimen": "0111",
  "ccc": "12345678901",
  "liquidType": "L00",
  "startDate": "2026-08-01",
  "endDate": "2026-08-01",
  "format": "json"
}

Respuesta con format=json: un elemento por recibo de la liquidación en data.list, sin PDF:

{
  "success": true,
  "message": "OK",
  "data": {
    "list": [
      {
        "liquidation_number": "28202600601234567",
        "regimen": "0111",
        "ccc": "12345678901",
        "company_name": "EMPRESA EJEMPLO SL",
        "period_from": "08/2026",
        "period_to": "08/2026",
        "liquid_type": "L00",
        "liquid_type_description": "L00 - NORMAL",
        "payment_type": "Total",
        "payment_mode": "Cargo en Cuenta",
        "issued_at": "2026-09-19 11:11",
        "workers": 12,
        "at_ep_entity": "61",
        "total": 6250.40,
        "concepts": [
          { "code": "500", "description": "CONTINGENCIAS COMUNES", "base": 15200.00, "amount": 4301.60 },
          { "code": "998", "description": "LIQUIDO DE TOTALES", "base": 0, "amount": 6250.40 }
        ]
      }
    ]
  }
}

Campos de cada elemento (importes en euros, con decimales; un campo no disponible se devuelve como null):

• liquidation_number (caracteres) : Número de liquidación del recibo.
• regimen (caracteres) : Régimen, 4 dígitos.
• ccc (caracteres) : Cuenta de cotización, 11 dígitos.
• company_name (caracteres) : Razón social de la empresa.
• period_from, period_to (caracteres) : Primer y último periodo de liquidación, formato MM/YYYY.
• liquid_type (caracteres) : Tipo de liquidación (L00, L03…).
• liquid_type_description (caracteres) : Código y descripción del tipo de liquidación.
• payment_type (caracteres) : Tipo de ingreso o cuota liquidada, tal como lo da la TGSS (por ejemplo Total).
• payment_mode (caracteres) : Modalidad de pago (por ejemplo Cargo en Cuenta).
• issued_at (caracteres) : Fecha y hora de emisión del recibo, formato YYYY-MM-DD HH:mm.
• workers (número entero) : Número de trabajadores de la liquidación.
• at_ep_entity (caracteres) : Código de la entidad que cubre accidentes de trabajo y enfermedades profesionales (AT/EP) de la cuenta de cotización.
• total (decimal) : Importe total del recibo, en euros.
• concepts (arreglo) : Conceptos del recibo, cada uno con code, description, base y amount (euros).

Duplicado de la RNT por SILTRA

Con format=siltra la petición tramita en la TGSS la solicitud del duplicado de la Relación Nominal de Trabajadores (RNT) de todos los trabajadores de la liquidación (no hay paso de confirmación). La TGSS no la devuelve en la respuesta: la remite en diferido al buzón SILTRA del autorizado RED. Desde ahí se puede importar en Saltra con el conector local (SILTRA).

{
  "regimen": "0111",
  "ccc": "12345678901",
  "liquidType": "L00",
  "startDate": "2026-08-01",
  "endDate": "2026-08-01",
  "format": "siltra"
}

Respuesta cuando la petición se ha tramitado:

{
  "success": true,
  "message": "Petición del duplicado de la RNT tramitada: la TGSS la enviará en diferido al buzón SILTRA del autorizado.",
  "data": {
    "status": "requested",
    "delivery": "siltra",
    "liquidation_number": "28202600601234567",
    "regimen": "0111",
    "ccc": "12345678901",
    "company_name": "EMPRESA EJEMPLO SL",
    "liquid_type": "L00",
    "period_from": "08/2026",
    "period_to": "08/2026",
    "messages": [
      "Su petición de duplicado de la Relación Nominal de Trabajadores se ha tramitado correctamente.",
      "El resultado de la solicitud será remitido en diferido, para su recepción mediante la aplicación SILTRA."
    ]
  }
}

Si ya había una petición pendiente para esa liquidación, la TGSS no crea otra y la respuesta sigue siendo success: true:

{
  "success": true,
  "message": "Ya hay una petición del duplicado de la RNT en curso para esta liquidación: la TGSS la enviará en diferido al buzón SILTRA del autorizado.",
  "data": {
    "status": "already_in_progress",
    "delivery": "siltra",
    "liquidation_number": "28202600601234567",
    "regimen": "0111",
    "ccc": "12345678901",
    "company_name": "EMPRESA EJEMPLO SL",
    "liquid_type": "L00",
    "period_from": "08/2026",
    "period_to": "08/2026",
    "messages": ["CUPL(7131) Envío mensaje en tramite. 1"]
  }
}

Campos de data:

• status (caracteres) : requested (petición tramitada ahora) o already_in_progress (ya había una pendiente de envío; la TGSS devuelve CUPL(7131) Envío mensaje en tramite.).
• delivery (caracteres) : Canal de entrega; siempre siltra.
• liquidation_number, regimen, ccc, company_name, liquid_type, period_from, period_to (caracteres) : Datos de la liquidación, con el mismo significado que en format=json.
• messages (arreglo) : Texto de la TGSS (líneas no vacías de la pantalla final, o el mensaje CUPL).

Errores habituales de la TGSS

• CM20 (9439): «La TGSS no tiene disponible el PDF del RLC de esta liquidación (no devuelve su identificación). Es un fallo del Sistema RED; prueba más tarde o descárgalo desde SILTRA.» Con format=json se pueden obtener igualmente los datos.
• CESO (9473): «La liquidación está bloqueada por otra consulta en curso en el Sistema RED; la TGSS la libera sola al cabo de un rato (hasta una hora); vuelve a intentarlo más tarde.»
• CM05: el certificado tiene varios autorizados y numAutorizado no tiene asignada la cuenta de cotización.