Skip to Content
Seguridad SocialDocumentos y duplicadosObtener ficheros FIE

Obtener ficheros FIE

Añade test=1 para realizar pruebas sin efectos reales. En producción, omite este parámetro.

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • opcionesBusqueda opcional (número entero) : Tipo de búsqueda. Si se omite, se usa 0. Determina qué campos son obligatorios. Posibles valores:
    • 0 (por defecto) : Empresa. Requiere regimen y ccc.
    • 1 : Autónomo. Requiere naf.
    • 2 : Autorizado RED. No requiere regimen, ccc ni naf; solo el rango de fechas.
  • regimen (número entero) : Régimen, 4 dígitos. Obligatorio solo cuando opcionesBusqueda=0 (Empresa). Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos. Obligatorio solo cuando opcionesBusqueda=0 (Empresa).
  • naf (número entero) : Número de afiliación (NAF), 12 dígitos. Obligatorio solo cuando opcionesBusqueda=1 (Autónomo).
  • startDate (date) : Fecha de inicio de parte, formato YYYY-MM-DD.
  • endDate (date) : Fecha de fin de parte, formato YYYY-MM-DD.
  • format opcional (texto) : Formato de la respuesta. Posibles valores:
    • excel (por defecto) : Devuelve el informe como fichero Excel (data.file).
    • json : Devuelve el informe ya parseado, una fila por trabajador (data.list).

El rango entre startDate y endDate no puede superar los 28 días (la TGSS rechaza 29 o más).

Ejemplo: Empresa (por defecto)

GET /excel-fie
{
  "test": 1,
  "regimen": "0111",
  "ccc":"13991977999",
  "startDate": "2026-01-15",
  "endDate": "2026-01-22",
  "format": "json"
}

Ejemplo: Autónomo

GET /excel-fie
{
  "test": 1,
  "opcionesBusqueda": 1,
  "naf": "281000000001",
  "startDate": "2026-01-15",
  "endDate": "2026-01-22"
}

Ejemplo: Autorizado RED

GET /excel-fie
{
  "test": 1,
  "opcionesBusqueda": 2,
  "startDate": "2026-01-15",
  "endDate": "2026-01-22"
}

Respuesta OK (format=excel, por defecto)

Si omites el parámetro format o envías format=excel, la respuesta contiene el fichero Excel en base64:

Respuesta (excel)
{
    "success": true,
    "message": "3408* OPERACION REALIZADA CORRECTAMENTE",
    "status": 200,
    "data": {
      "file": {
        "contentType": "application/vnd.ms-excel",
        "name": "document.xls",
        "content": "base64"
      }
    }
}

Respuesta OK (format=json)

Con format=json el informe se devuelve parseado en data.list, con un objeto por trabajador. Las claves son las cabeceras de columna del informe FIE (identificación de empresa, trabajador, datos de afiliación y datos de incapacidad temporal, entre otros) y salen del propio fichero de la TGSS: si añade una columna, aparece sola. Algunas cabeceras se repiten en varias secciones del informe; la primera conserva el nombre y las siguientes llevan entre paréntesis el código de su sección: Entidad Responsable (IT), Entidad Responsable (DIP) (incapacidad permanente), Entidad Responsable (DOP) (otras prestaciones), Fecha Baja IT y Fecha Baja IT (DIP).

Los valores de este ejemplo son ficticios. En la respuesta real, cada fila incluye todas las columnas del informe FIE (muchas de ellas pueden llegar vacías según el caso).

Respuesta (json)
{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "list": [
            {
                "Fecha Registro": "20260115",
                "C.C.C. Principal": "011113991977999",
                "Razón Social": "EMPRESA DEMO SL",
                "N.A.F.": "281000000001",
                "IPF": "00000001R",
                "Primer Apellido": "PEREZ",
                "Segundo Apellido": "GOMEZ",
                "Nombre": "JUAN",
                "Fecha Inicio Relación Laboral": "20250101",
                "Fecha Extinción Relación Laboral": "",
                "Entidad Responsable": "0",
                "Fecha Baja IT": "20260110",
                "Indicador Recaida": "N",
                "Días Acumulados": "0",
                "Contingencia": "1",
                "Tipo Proceso": "1",
                "Duración Estimada": "5",
                "Fecha Fin IT": "20260114",
                "Causa Fin IT": "06",
                "Base reguladora INSS": "40.00"
            },
            {
                "Fecha Registro": "20260118",
                "C.C.C. Principal": "011113991977999",
                "Razón Social": "EMPRESA DEMO SL",
                "N.A.F.": "281000000002",
                "IPF": "00000002W",
                "Primer Apellido": "LOPEZ",
                "Segundo Apellido": "MARTIN",
                "Nombre": "MARIA",
                "Fecha Inicio Relación Laboral": "20240301",
                "Fecha Extinción Relación Laboral": "",
                "Entidad Responsable": "0",
                "Fecha Baja IT": "20260112",
                "Indicador Recaida": "S",
                "Días Acumulados": "22",
                "Contingencia": "1",
                "Tipo Proceso": "1",
                "Duración Estimada": "15",
                "Fecha Fin IT": "",
                "Causa Fin IT": "",
                "Base reguladora INSS": "38.50"
            }
        ]
    }
}
Actualizado el