SEPE

SEPE

Conecta tus aplicaciones con funciones del SEPE.

Parámetros en la cabecera HTTP

  • Authorization (caracteres): Autorización de la API. Ejemplo: Bearer {token}
  • X-Cert-Secret (caracteres) : Clave secreta asociada al certificado del cliente.

URL base

https://api.saltra.es/api/v4/sepe

Errores

Los errores recibidos en la API del SEPE o errores de validación.

  • success (booleano) : La respuesta "true" cuando todo esta correcto, y "false" cuando hay errores.
  • message (caracteres) : El mensaje de la respuesta.
  • errors (arreglo) : Los errores capturados en la API, ya sea del SEPE o errores de validación.
    • sepe: Errores relacionados con el SEPE.
    • regimen: Errores de validación.
  • maintenance (booleano) : Cuando el SEPE se encuentra en mantenimiento.

Respuesta

Respuesta
{
  "success": false,
  "message": "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500",
  "status": 500,
  "data": [],
  "errors": {
    "sepe": [
      "Página no operativa, inténtelo de nuevo más tarde. StatusCode: 500"
    ],
    "regimen": ["El campo regimen es obligatorio."]
  },
  "maintenance": true
}

Contrat@

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.

  • cif (caracteres) : CIF de la empresa.

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:

  • ccc (número entero) : Cuenta de cotización, 11 dígitos.

  • docType (caracteres) : Posibles valores:

    • D: NIF/DNI,
    • E: NIE,
    • U: Ciudadano UE,
    • W: Pasaporte.

  • dni (caracteres) : Documento Nacional de Identidad.

  • name (caracteres) : Nombre del empleado.

  • surname (caracteres) : Primer apellido del empleado.

  • lastSurname (caracteres) : Opcional. Segundo apellido del empleado, obligatorio si es NIF/DNI.

  • sex (número entero) : 1 si es hombre y 2 si es mujer

  • dateOfBirth (date) : Fecha de nacimiento, formato YYYY-MM-DD.

  • nationality (número entero) : Nacionalidad del empleado. Posibles valores:

  • municipality (número entero) : Municipio del empleado. Posibles valores:

  • PAIS_RESIDENCIA (número entero) : Pais de residencia del empleado. Posibles valores:

  • nss (número entero) : Número de Seguridad Social, 12 dígitos.

  • nivelFormativo (número entero) : Nivel formativo, 2 dígitos.

  • occupation (número entero) : Clasificación Nacional de Ocupacion (CNO), 4 dígitos. Posibles valores:

  • nationalityContract (número entero) : País del centro de trabajo. Posibles valores:

  • IND_CONTRATO_ESCRITO (boolean) : Opcional. Si el contrato es escrito. Posibles valores:

    • 1: Si.

  • municipalityContract (número entero) : Municipio del centro de trabajo. Posibles valores:

  • IND_CONVENIO_COLECTIVO (caracteres) : Indicador de convenio colectivo, posibles valores (S, N, C, D). Obligatorio para:

    • Contratos de códigos 402 y 502 cuando su duración está entre 6 y 12 meses.
    • Contrato de código 404 cuando su duración sea inferior a un año, si el trabajador ha tenido un contrato predoctoral anterior. Refleja la existencia ("S") o no existencia ("N") de un contrato predoctoral.
    • Contrato de código 412 cuando su duración sea inferior a tres años, si el trabajador ha tenido un contrato anterior de este tipo. Refleja la existencia ("S") o no existencia ("N") de un contrato de este tipo.
    • Contratos de código 421 cuando su duración está entre 24 y 36 meses, y la fecha de inicio sea anterior al 30-03-2022. Refleja la existencia ("S") o no existencia ("N") de un convenio colectivo que autorice estas duraciones.
    • Para los contratos de códigos 402 y 502 y sus modalidades 450-402 y 550-502 cuando su duración sea igual o inferior a 90 días, situación previsible: Respuesta Si ("C") o Respuesta No ("D").

    Para el resto de contratos que no se encuentran en uno de los casos anteriores, este elemento no debe aparecer en el fichero a enviar.

  • codContract (número entero) : Tipo de contrato, 3 dígitos. Posibles valores:

  • startDate (date) : Fecha de inicio, formato YYYY-MM-DD.

  • endDate (date) : Opcional. Fecha de finalización, formato YYYY-MM-DD.

  • jornadaType (caracteres) : Tipo de jornada, posibles valores:

    • A: Anual
    • B: Diaria
    • M: Mensual
    • S: semanal
    • Nota: Es obligatorio Para los contratos parciales.
    • jornadaHour (número entero) : Hora de jornada, 4 dígitos. Nota: Es obligatorio Para los contratos parciales.
    • jornadaMin (número entero) : Minutos de jornada, 2 dígitos. Nota: Es obligatorio Para los contratos parciales.

  • REAL_DECRETO_1435_1985 (caracteres) : Indicar si el contrato se acoge al RD 1435/1985. Obligatorio para los contratos de códigos (402, 407, 502, 507), posibles valores:

  • INDICATIVO_PRTR (caracteres) : Indicar si se acoge al Plan de Recuperación, Transformación y Resiliencia. Next Generation EU. Obligatorio para todos los contratos. (Opcional para los contratos (405,505)). Posibles valores:

    • S: Si
    • N: No

  • IND_DISCAPACIDAD (caracteres) : Opcional. Indicador de discapacidad. Posibles valores:

  • TEMPORAL_MINUSV_BONIFICADO (caracteres) : Obligatorio para los contratos 430 y 530 salvo que sean minusválidos en Centros Especiales de Empleo (IND_DISCAPACIDAD=C) . Indica si el contrato temporal para personas con discapacidad es bonificado o no, posibles valores:

    • S: Si.
    • N: No

  • CODIGO_COLECTIVO_BONIF (número entero) : Código del colectivo de bonificación, no es necesario especificar su valor en contratos de Centros Especiales de Empleo (IND_DISCAPACIDAD=C), 2 o 3 dígitos. posibles valores:

  • CAUSA_SUSTITUCION (caracteres) : Opcional. Código de la causa objeto de la sustitución de interinidad. Posibles valores:

  • IND_ERE (número entero) : Tiene la empresa un ERE autorizado en el momento de la contratación. posibles valores:

    • S: Si
    • N: No

  • IND_CONVENIO_COLECTIVO (caracteres) : Opcional. Indicador de convenio colectivo. Posibles valores:

    • S: Si
    • N: No
    • Para los contratos de códigos 402 y 502 y sus modalidades 450-402 y 550-502 cuando su duración sea igual o inferior a 90 días, situación previsible:
      • C: Si
      • D: No

  • TITULACION_ACADEMICA (número entero) : Opcional. Titulación académica, 12 dígitos . posibles valores:

  • ID_OFERTA (caracteres) : Opcional. Identificador de la oferta.

  • DATOS_COPIA_BASICA (objeto): Opcional. Datos de la copia básica.

    • TIPO_FIRMA (número entero) :Tipo de firma, posibles valores:
      • 1: FIRMADA POR LOS REPRESENTANTES LEGALES.
      • 2: NO EXISTE REPRESENTACIÓN LEGAL.
      • 3: NO SE HA FACILITADO LA COPIA.
      • 4: REHÚSAN FIRMAR.
    • TEXTO_COPIABASICA (caracteres) : Texto de la copia básica.
    • DOMIC_CENTRO_TRABAJO (caracteres) : Opcional. Centro de trabajo.

  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.

POST /contrata
{
  "test": 1,
  "cif": "A12345678",
  "regimen": "0111",
  "ccc": 12345678901,
  "docType": "D",
  "dni": "12345678A",
  "name": "Pepito",
  "surname": "Pérez",
  "lastSurname": "Pérez",
  "sex": 1,
  "dateOfBirth": "1990-01-01",
  "nationality": 123,
  "municipality": 123,
  "country": 123,
  "nss": 123456789012,
  "nivelFormativo": 12,
  "occupation": 1234,
  "nationalityContract": 123,
  "municipalityContract": 123,
  "IND_CONVENIO_COLECTIVO": "S",
  "codContract": 123,
  "startDate": "2023-11-01",
  "endDate": "2024-11-01",
  "jornadaType": "A",
  "jornadaHour": 8,
  "jornadaMin": 0,
  "REAL_DECRETO_1435_1985": "A",
  "INDICATIVO_PRTR": "S",
  "DATOS_COPIA_BASICA": {
      "TIPO_FIRMA": 2,
      "TEXTO_COPIABASICA": "S/C",
      "DOMIC_CENTRO_TRABAJO": ""
  },
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "doc": "00000000A",
    "RESPONSE_COPIA_BASICA":{
      "success":true,
      "message":"La comunicación de la Copia Básica se ha realizado correctamente"
    },
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Datos de Contrat@ y huella

Parámetros

  • dni (caracteres) : Documento nacional de identidad.
  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • startDate (date) : Fecha de inicio del contrato, formato YYYY-MM-DD.
GET /contrata/data
{
  "dni": "01234567A",
  "ccc": "12345678901",
  "startDate": "2025-01-01"
}

Respuesta

  • id (caracteres) : Huella del contrat@ y con formato E-##-####-#######.
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "enterprise_data": [
      {
        "cif": "B99999999"
      },
      {
        "name": "COMPANY NAME"
      },
      {
        "residence": "CL CALLE 1"
      },
      {
        "pais": "ESPAÑA"
      },
      {
        "municipio": "MADRID"
      },
      {
        "postal_code": "99999"
      }
    ],
    "account_data": [
      {
        "ccc_full": "011128199969999"
      },
      {
        "economic_activity": "ACTIVIDADES DEPORTIVAS"
      }
    ],
    "working_center": [
      {
        "pais": "ESPAÑA"
      },
      {
        "municipio": "MADRID"
      }
    ],
    "employee_data": [
      {
        "nif": "09929999L"
      },
      {
        "name": "NAME EMPLOYEE"
      },
      {
        "sexo": "HOMBRE"
      },
      {
        "fecha_de_nacimiento": "DD/MM/YYYY"
      },
      {
        "nivel_formativo": "PRIMERA ETAPA DE EDUCACIÓN SECUNDARIA CON TÍTULO DE GRADUADO ESCOLAR O EQUIVALENTE."
      },
      {
        "nss": "999999999999"
      },
      {
        "nacionalidad": "ESPAÑA"
      },
      {
        "municipio_de_domicilio": "MADRID"
      },
      {
        "pais_de_domicilio": "ESPAÑA"
      }
    ],
    "contract_data": [
      {
        "cno": "ORGANIZADORES DE CONFERENCIAS"
      },
      {
        "startDate": "DD/MM/YYYY"
      },
      {
        "communicateDate": "DD/MM/YYYY"
      },
      {
        "tipo_de_jornada": "JORNADA ANUAL"
      },
      {
        "duración_jornada": "Horas :0072"
      }
    ],
    "contract_data_other": [],
    "copy_basic_data": [
      {
        "signatureText": "NO EXISTE REPRESENTACIÓN LEGAL"
      }
    ]
  }
}

Listado de Contrat@ con huellas

Parámetros

  • cif (caracteres) : CIF de la empresa.
  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • startDate (date) : Desde, formato YYYY-MM-DD.
  • endDate (date) : Hasta, formato: YYYY-MM-DD.
  • communications_by (número entero) : Tipo de filtro, posibles valores:
    • 1: Por Fecha de inicio del contrato.
    • 2: Por Fecha de comunicación del contrato.
GET /contrata/data/list
{
  "cif": "01234567A",
  "regimen": "0111",
  "ccc": "12345678901",
  "startDate": "2023-01-01",
  "endDate": "2025-01-01",
  "communications_by": 1
}

Respuesta

  • id (caracteres) : Huella del contrat@ y con formato E-##-####-#######.
Respuesta
{
  "success": true,
  "message": "OK",
  "data": [
    {
      "tipo": "C",
      "id": "E-13-2023-0011999",
      "nif_nie_trabajador": "91771127T",
      "codigo_cuenta_cotizacion": "0111131119999",
      "codigo_contrato": "200",
      "fecha_inicio": "2023-01-16",
      "fecha_fin": "",
      "fecha_comunicacion": "2023-02-01"
    },
    {
      "tipo": "C",
      "id": "E-13-2023-0011999",
      "nif_nie_trabajador": "Z0924018K",
      "codigo_cuenta_cotizacion": "0111131119999",
      "codigo_contrato": "100",
      "fecha_inicio": "2023-02-01",
      "fecha_fin": "2023-03-01",
      "fecha_comunicacion": "2023-02-02"
    }
  ]
}

Duplicado de Contrat@

Parámetros

  • cif (caracteres) : CIF de la empresa.
  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • dni (caracteres) : Documento Nacional de Identidad.
  • startDate (date) : Fecha de inicio del contrato, formato YYYY-MM-DD.
GET /contrata
{
  "cif": "A12345678",
  "ccc": "12345678901",
  "dni": "12345678A",
  "startDate": "2023-11-01"
}

Respuesta

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

Anular Contrat@

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • sepeId (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
DELETE /contrata
{
  "test": 1,
  "sepeId": "E-28-2023-9999999"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Enviar Contrat@ por XML

Parámetros

  • file(file): XML de Contrat@.
POST /contrata/xml
{
  "file": {
    "content": "data:...",
    "contentType": "application/xml",
    "name": "document.xml",
    "size": 1024
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Enviar datos de Contrat@ mediante transformación XML

Parámetros

  • file(file): XML de transformación.
POST /contrata/transformation/xml
{
  "file": {
    "content": "data:...",
    "contentType": "application/xml",
    "name": "document.xml",
    "size": 1024
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Copia básica

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
  • docType (caracteres) : D=NIF/DNI, E=NIE, U=Ciudadano UE, W=Pasaporte.
  • dni (caracteres) : Documento nacional de identidad.
  • sepeId (caracteres) : Opcional. Identificador contrato en el SEPE, formato E-99-9999-9999999.
  • TIPO_FIRMA (número entero) :Tipo de firma, posibles valores:
    • 1: FIRMADA POR LOS REPRESENTANTES LEGALES.
    • 2: NO EXISTE REPRESENTACIÓN LEGAL.
    • 3: NO SE HA FACILITADO LA COPIA.
    • 4: REHÚSAN FIRMAR.
  • startDate (date) : Fecha del contrato, formato YYYY-MM-DD.
  • TEXTO_COPIABASICA (caracteres) : Texto de la copia básica.
  • DOMIC_CENTRO_TRABAJO (caracteres) : Centro de trabajo.
  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.
POST /copy-basic
{
  "test": 1,
  "cif": "B12312333",
  "docType": "D",
  "dni": "12345678A",
  "sepeId": "E-99-9999-9999999",
  "TIPO_FIRMA": 1,
  "startDate": "2023-11-01",
  "TEXTO_COPIABASICA": "Texto de la copia básica (Este es un ejemplo ficticio).",
  "DOMIC_CENTRO_TRABAJO": "CENTRO DE TRABAJO",
  "duplicate": 1
}

Respuesta

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

Duplicado de la copia básica

Parámetros

  • cif (caracteres) : CIF de la empresa.
  • dni (caracteres) : Documento nacional de identidad.
  • startDate (date) : Fecha de inicio del contrato, formato YYYY-MM-DD.
GET /copy-basic
{
  "cif": "A12345678",
  "dni": "12345678A",
  "startDate": "2023-11-01"
}

Respuesta

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

Enviar la copia básica por XML

Parámetros

  • file(file): XML de copia básica.
POST /copy-basic/xml
{
  "file": {
    "content": "data:...",
    "contentType": "application/xml",
    "name": "document.xml",
    "size": 1024
  }
}

Respuesta

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

Duplicado de CERTIFIC@2

Parámetros

  • dni (caracteres) : Documento Nacional de Identidad.
  • startDate (date) : Fecha de baja o finalización del contrato, formato YYYY-MM-DD.
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
GET /certifica
{
  "dni": "12345678A",
  "startDate": "2025-01-01",
  "ccc": "12345678900"
}

Respuesta

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

Datos de Certific@2

Parámetros

  • dni (caracteres) : Documento Nacional de Identidad.
GET /certifica/data
{
  "dni": "99999999T"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "status": 200,
  "data": {
    "enterprise": {
      "name": "NOMBRE EMPRESA",
      "regimen": "0112",
      "cif": "B99999999",
      "cnae": "59",
      "postal_code": "28016",
      "ccc": "88888888888"
    },
    "employee": {
      "name": "NOMBRE",
      "surname": "PRIMER APELLIDO",
      "lastSurname": "SEGUNDO APELLIDO",
      "nif": "99999999T",
      "nss": "9999999999",
      "causa_susp": "11",
      "cno": "3831"
    },
    "certificates": [
      {
        "fecha_entrada": "20/12/2024",
        "fecha_recepcion": "20/12/2024",
        "fecha_reconocimiento": "--",
        "cif": "B70999999",
        "codigo": "999999999999",
        "fecha_susp": "17/11/2024",
        "anexado": "SI",
        "origen": "Fichero XML"
      },
      {
        "fecha_entrada": "19/12/2023",
        "fecha_recepcion": "19/12/2023",
        "fecha_reconocimiento": "19/12/2023",
        "cif": "B70999999",
        "codigo": "999999999999",
        "fecha_susp": "12/12/2023",
        "anexado": "NO",
        "origen": "Fichero XML"
      },
      {
        "fecha_entrada": "12/12/2023",
        "fecha_recepcion": "12/12/2023",
        "fecha_reconocimiento": "--",
        "cif": "B70999999",
        "codigo": "999999999999",
        "fecha_susp": "12/12/2023",
        "anexado": "NO",
        "origen": "Fichero XML"
      }
    ]
  }
}

Enviar CERTIFIC@2 por XML

Parámetros

  • file(file): XML de CERTIFIC@2.
POST /certifica/xml
{
  "file": {
    "content": "data:...",
    "contentType": "application/xml",
    "name": "document.xml",
    "size": 1024
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Enviar CERTIFIC@2 (Certificado de empresa)

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.

  • Datos_Representante (objeto) : Datos del representante de la empresa o una gestoría o habilitado profesional.

    • CIF_NIF (caracteres) : Identificador de persona física o jurídica del representante de la empresa.
    • Nombre (caracteres) : Nombre.
    • Apellido1 (caracteres) : Primer apellido.
    • Apellido2 (caracteres) : Segundo apellido (si lo tiene).
    • Cargo (caracteres) : Cargo que ocupa en la empresa.

  • Datos_Empresa (objeto) : Cuenta de cotización, 11 dígitos.

    • CIF_NIF (caracteres) : Identificador de persona física o jurídica de la empresa.
    • CCC (caracteres) : Régimen y Cuenta de cotización, 15 dígitos. Ejemplo: 011112345678901.

  • Datos_Trabajador (objeto) : Datos del trabajador.

    • DNI_NIE (caracteres) : Identificador de persona física o jurídica del representante de la empresa.
    • Nombre (caracteres) : Nombre.
    • Apellido1 (caracteres) : Primer apellido.
    • Apellido2 (caracteres) : Segundo apellido (si lo tiene).
    • NumSS (caracteres) : Número de Seguridad Social, 12 dígitos.
    • GrupoCotizacion (número entero) : Grupo de cotización, 2 dígitos. Posibles valores:
    • TipoContrato (número entero) : Tipo de contrato, 3 dígitos. Posibles valores:
    • DuracionContrato (números entero) : Opcional. Tiempo en que el trabajador estuvo de alta en la empresa.
    • IndicadorDuracionContrato (caracteres) : Opcional. Describe las unidades en las que se mide el tiempo indicado contractPeriod. Posibles valores:
      • D = Diaria.
      • M = Mensual.
      • A = Anual.
    • CodProfesion (número entero) : Clasificación Nacional de Ocupaciones (CNO), 4 dígitos. Posibles valores:
    • FechaAltaEmpresa (date) : Fecha de alta del trabajador, formato YYYY-MM-DD.
    • CodCausaSuspension (número entero) : Código de la causa de suspensión o extinción de la relación laboral del trabajador con la empresa, 2 dígitos.
    • FechaSuspensionExtincion (date) : Fecha de la causa de suspensión o extinción de la relación laboral del trabajador con la empresa, formato YYYY-MM-DD.
    • DiasSalarioTramitacion (número entero) : Opcional. Número de días naturales habidos entre la fecha de inicio de salarios de tramitación y la fecha final de salarios de tramitación.
    • Datos_Cotizacion (arreglo) : Datos de cotización de por contingencias comunes y de desempleo.
      • Ano (caracteres) : Año de cotización, 4 dígitos.
      • Mes (caracteres) : Mes de cotización, 2 dígitos.
      • NumDiasCotizados (número entero) : Número de días naturales que efectivamente se haya cotizado.
      • BaseCotizacionContingenciasComunes (decimal) : Cantidad cotizada correspondiente a las Contingencias Comunes.
      • BaseCotizacionDesempleo (decimal) : Cantidad cotizada correspondiente a Desempleo.
    • Datos_VacacionesCotizadas (objeto) : Opcional. Datos de cotización correspondientes a las vacaciones.
      • NumDiasCotizados (número entero) : Número de días naturales correspondientes a vacaciones que efectivamente hayan sido cotizado.
      • BaseCotizacionContingenciasComunes (decimal) : Base de cotización de contingencias comunes.
      • BaseCotizacionDesempleo (decimal) : Base de cotización a la Seguridad Social.
POST /certifica
{
  "test": 1,
  "Datos_Representante": {
    "CIF_NIF": "9999999B",
    "Nombre": "nombre",
    "Apellido1": "apellido1",
    "Apellido2": "apellido2",
    "Cargo": "ADMINISTRADOR"
  },
  "Datos_Empresa": {
    "CIF_NIF": "9999999B",
    "CCC": "011127770999999"
  },
  "Datos_Trabajador": {
    "DNI_NIE": "9999999B",
    "Nombre": "nombre",
    "Apellido1": "apellido1",
    "Apellido2": "apellido2",
    "NumSS": "187774444999",
    "GrupoCotizacion": "05",
    "TipoContrato": "407",
    "DuracionContrato": 154,
    "IndicadorDuracionContrato": "D",
    "CodProfesion": "3831",
    "FechaAltaEmpresa": "2023-06-05",
    "CodCausaSuspension": "11",
    "FechaSuspensionExtincion": "2023-11-05",
    "DiasSalarioTramitacion": 0,
    "Datos_Cotizacion": [
      {
        "Ano": "2023",
        "Mes": "06",
        "NumDiasCotizados": 26,
        "BaseCotizacionContingenciasComunes": 1000.5,
        "BaseCotizacionDesempleo": 1000.5
      },
      {
        "Ano": "2023",
        "Mes": "07",
        "NumDiasCotizados": 31,
        "BaseCotizacionContingenciasComunes": 1000.5,
        "BaseCotizacionDesempleo": 1000.5
      }
    ]
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Comunicar llamamientos

Parámetros

  • cif (caracteres) : CIF de la empresa.
  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.
  • employees (arreglo) : Datos del trabajador.
    • doc (caracteres) : Identificador de persona física.
    • docType (caracteres) : Tipo de documento. Posibles valores:
      • D: NIF/DNI,
      • E: NIE,
      • U: Ciudadano UE,
      • W: Pasaporte.
    • name (caracteres) : Nombre del empleado.
    • surname (caracteres) : Primer apellido del empleado.
    • lastSurname (caracteres) : Segundo apellido del empleado, obligatorio si es NIF/DNI.
    • nss (número entero) : Número de Seguridad Social, 12 dígitos.
    • sex (número entero) : posibles valores:
      • 1 = Hombre
      • 2 = Mujer
    • dateOfBirth (date) : Fecha de nacimiento, formato YYYY-MM-DD.
    • nationality (número entero) : Nacionalidad del empleado. Posibles valores:
    • municipality (número entero) : Municipio del empleado. Posibles valores:
    • country (número entero) : Pais de domicilio del empleado. Posibles valores:
    • nss (número entero) : Número de Seguridad Social, 12 dígitos.
    • startDate (date) : Fecha inicio, formato YYYY-MM-DD.
    • endDate (date) : Opcional. Fecha fin, formato YYYY-MM-DD.
    • nivelFormativo (número entero) : Nivel formativo, 2 dígitos.
    • question (caracteres) : Opcional. Se incorpora a la actividad. Posibles valores:
      • S = Si.
      • N = No.
    • sepeId (caracteres) : Opcional. Identificador contrato en el SEPE, formato E-99-9999-9999999.
POST /llamamientos
{
  "cif": "9999999B",
  "regimen": "0112",
  "ccc": "27770999999",
  "employees": [
    {
      "doc": "9999999B",
      "startDate": "2023-11-05",
      "endDate": "2023-11-05",
      "nivelFormativo": 12,
      "question": "S"
    }
  ]
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "send": 1,
    "not_send": 0,
    "data": [
      {
        "success": true,
        "doc": "9999999B",
        "id": " E-28-2024-9906993",
        "file": {
          "contentType": "application/pdf",
          "name": "document.pdf",
          "content": "base64"
        }
      }
    ]
  }
}

Anular llamamiento

Parámetros

  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • sepeId (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
DELETE /llamamientos
{
  "ccc": "27770999999",
  "sepeId": "E-99-9999-9999999"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Duplicado de llamamiento

Parámetros

  • cif (caracteres) : CIF de la empresa.
  • ccc (caracteres) : Cuenta de cotización, 11 dígitos.
  • startDate (date) : Fecha inicio, formato YYYY-MM-DD.
  • dni (caracteres) : Documento nacional de identidad.
  • id (caracteres) : Opcional. Huella del contrat@ y con formato E-##-####-#######.
GET /llamamiento
{
  "cif": "9999999B",
  "ccc": "12345678911",
  "dni": "9999999B",
  "startDate": "2023-11-05"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "llamamientoId": "E-28-2026-0016999",
    "contrataId": "E-28-2023-9992999",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Prorroga

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • dni (caracteres) : Documento Nacional de Identidad.
  • old_startDate (date) : Fecha del contrato actual, formato YYYY-MM-DD.
  • startDate (date) : Fecha de inicio, formato YYYY-MM-DD.
  • endDate (date) : Fecha fin, formato YYYY-MM-DD.
  • discontinuidad (número entero) : Opcional. Ha existido un periodo de inactividad conforme a la normativa vigente, que justifique la discontinuidad. posibles valores:
    • S: Si
    • N: No
  • prorroga_exist_convenio (número entero) : Opcional. Existe Convenio Colectivo. posibles valores:
    • S: Si
    • N: No
  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.
POST /prorroga
{
  "test": 1,
  "cif": "A12345678",
  "regimen": "0111",
  "ccc": 12345678901,
  "dni": "12345678A",
  "old_startDate": "2024-01-01",
  "startDate": "2025-01-01",
  "endDate": "2025-01-10",
  "discontinuidad": "N",
  "prorroga_exist_convenio": "S",
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "doc": "00000000A",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Anular Prorroga

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • id (caracteres) : Huella del contrat@ y con formato E-##-####-#######.
DELETE /prorroga
{
  "test": 1,
  "cif": "A12345678",
  "regimen": "0111",
  "ccc": "12345678901",
  "id": "E-28-2023-9999999",
}

Respuesta

Respuesta
{
  "success": true,
  "message": "La comunicación se ha realizado correctamente."
}

Duplicado Prorroga

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • id (caracteres) : Huella del contrat@ y con formato E-##-####-#######.
GET /prorroga
{
  "test": 1,
  "cif": "A12345678",
  "regimen": "0111",
  "ccc": "12345678901",
  "id": "E-28-2023-9999999",
}

Respuesta

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

Transformación a Indefinido

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.

  • TIPO_CONTRATO (número entero) : Tipo de contrato, 3 dígitos. Posibles valores:

    • 109: Transformación Tiempo Completo Bonificado
    • 189: Transformación Tiempo Completo No Bonificado
    • 209: Transformación Tiempo Parcial Bonificado
    • 309: Transformación Fijo Discontinuo Bonificado
    • 289: Transformación Tiempo Parcial No Bonificado
    • 389: Transformación Fijo Discontinuo No Bonificado
    • 139: Transformación Tiempo Completo Discapacitados
    • 239: Transformación Tiempo Parcial Discapacitados
    • 339: Transformación Fijo Discontinuo Discapacitados

  • DATOS_EMPRESA (objeto): Datos de empresa.

    • CODIGO_CUENTA_COTIZACION (número entero) : Regimen + Cuenta de cotización.

  • DATOS_CONTRATO (objeto): Datos del contrato.

    • FECHA_INICIO_CTO (date) : Fecha de inicio del contrato, formato Y-m-d.
    • IDENTIFICADORPFISICA (caracteres): Tipo de documento + Documento.
    • CLAVE_CONTRATO (caracteres): Huella del sepe del contrato.

  • DATOS_GENERALES_TRANSFORMACION (objeto): Datos de la transformación.

    • FECHA_INICIO (date) : Fecha de inicio de la transformación, formato Y-m-d.
    • *CODIGO_OCUPACION+ (número entero) : Clasificación Nacional de Ocupacion (CNO), 4 dígitos. Posibles valores:

  • DATOS_COMUNICA_COPIA_BASICA (objeto): Datos de la copia básica.

    • TIPO_FIRMA (número entero) :Tipo de firma, posibles valores:
      • 1: FIRMADA POR LOS REPRESENTANTES LEGALES.
      • 2: NO EXISTE REPRESENTACIÓN LEGAL.
      • 3: NO SE HA FACILITADO LA COPIA.
      • 4: REHÚSAN FIRMAR.
    • TEXTO_COPIABASICA (caracteres) : Texto de la copia básica.
    • DOMIC_CENTRO_TRABAJO (caracteres) : Centro de trabajo.

  • DATOS_CONTRATO_TIEMPO_PARCIAL (objeto): Opcional, para contrato parciales.

    • TIPO_JORNADA (caracteres) : Tipo de jornada, posibles valores:
      • A: Anual
      • B: Diaria
      • M: Mensual
      • S: semanal
    • HORAS_JORNADA (caracteres) : Horas + minutos, formato : HHHHMM.

  • DATOS_ADICIONALES_TRANSFORMACION (objeto): Opcional. Datos adicionales.

    • IND_DISCAPACIDAD (caracteres) : Indicador de discapacidad. Obligatorio con "S" para transformaciones de contratos de minusválidos. Obligatorio con "C" para transformaciones de contratos de minusválidos en centros especiales de empleo, posibles valores:
    • CODIGO_COLECTIVO_REDUCCION (caracteres) : Colectivo de reducción. posibles valores:

  • DATOS_BONIFICACION (objeto): Opcional. Datos de bonificación.

  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.

POST /transformation
{
  "test": 1,
  "TIPO_CONTRATO": "198",
  "DATOS_EMPRESA": {
    "CODIGO_CUENTA_COTIZACION":"011112345678901"
  },
  "DATOS_CONTRATO":{
      "FECHA_INICIO_CTO":"2026-01-26",
      "IDENTIFICADORPFISICA": "D009665999X",
      "CLAVE_CONTRATO":"E-10-2026-0009999"
  },
  "DATOS_GENERALES_TRANSFORMACION":{
      "FECHA_INICIO":"2026-01-27",
      "CODIGO_OCUPACION":"5120"
  },
  "DATOS_COMUNICA_COPIA_BASICA":{
      "TIPO_FIRMA":2,
      "TEXTO_COPIABASICA":"S/C",
      "DOMIC_CENTRO_TRABAJO":"Calle"
  },
  "DATOS_CONTRATO_TIEMPO_PARCIAL":{
      "TIPO_JORNADA":"S",
      "HORAS_JORNADA":"003600"
  },
  "duplicate": 1
}

Respuesta

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

Anular Transformación

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • id (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
DELETE /transformation
{
  "test": 1,
  "id": "E-28-2023-9999999"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Consultar Duplicado de transformación

Parámetros

  • id (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
GET /transformation
{
  "id": "E-28-2023-9999999"
}

Respuesta

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

Horas complementarias

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.

  • DATOS_IDENTIFICACION (objeto): Datos del contrato.

    • FECHA_INICIO_CTO (date) : Fecha de inicio del contrato, formato Y-m-d.
    • IDENTIFICADORPFISICA (caracteres): Tipo de documento + Documento.
    • CLAVE_CONTRATO (caracteres): Huella del sepe del contrato.

  • DATOS_HORAS (objeto): Datos de la transformación.

    • HORAS_TOTAL (caracteres) : Número total de horas complementarias. Hora y minutos, formato: HHHHMM.
    • PORCENTAJE_HORAS (caracteres) : Porcentaje de horas complementarias, formato EEDD. Ejemplo: 1230 = 12,30%

  • duplicate (número entero) : Opcional. Obtener el PDF en base64 y en formato JSON en la respuesta, posibles valores 1 o null.

POST /horas-complementarias
{
  "test": 1,
  "DATOS_IDENTIFICACION":{
      "FECHA_INICIO_CTO":"2026-01-26",
      "IDENTIFICADORPFISICA": "D009665999X",
      "CLAVE_CONTRATO":"E-10-2026-0009999"
  },
  "DATOS_HORAS":{
      "HORAS_TOTAL":"020050",
      "PORCENTAJE_HORAS":"1230"
  },
  "duplicate": 1
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-10-2026-0009999-1",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Anular Horas complementarias

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • id (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999-1, especificar el "1" o el número que corresponda a la comunicación de horas complementarias.
DELETE /horas-complementarias
{
  "test": 1,
  "id": "E-28-2023-9999999-1"
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK"
}

Consultar Duplicado de Horas complementarias

Parámetros

  • id (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
GET /horas-complementarias
{
  "id": "E-28-2023-9999999"
}

Respuesta

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

Consulta de Empresas Autorizadas

Parámetros

GET /authorization-management/enterprises
{
 
}

Respuesta

Respuesta
{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "cif": "880817295A",
        "list": [
            {
                "cif": "234206682A",
                "ccc_full": "016380869726836",
                "razon_social": "Ruelas y Millán",
                "fecha_alta": "2025-02-22",
                "fecha_baja": null
            },
            {
                "cif": "790241550A",
                "ccc_full": "011271766499451",
                "razon_social": "Velázquez de Saucedo e Hijo",
                "fecha_alta": "2025-08-19",
                "fecha_baja": null
            }
        ]
    }
}

Modificacion de Datos de Empresa

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
  • razon_social (caracteres) : Razón social.
  • domicilio (objeto): Domicilio.
    • via_publica (caracteres) : Nombre de la via.
    • municipio: Fuente el Fresno
    • Tabla con los códigos de municipio (opens in a new tab).
    • codigo_postal (caracteres) : Código postal.
    • tipo_via (caracteres) : Tipo de via:
      • CM: Camino
      • CL: Calle.
      • AV: Avenida.
      • etc.
    • numero (caracteres) : Opcional, número.
    • piso (caracteres) : Opcional, piso.
    • letra (caracteres) : Opcional, letra.
    • portal (caracteres) : Opcional, portal:
      • PA: Portal A.
      • PB: Portal B.
      • B: Bis.
      • P1: Portal 1.
      • etc.
PUT /authorization-management/enterprise-data
{
    "cif":"B19912999",
    "razon_social":"NOMBRE DE LA EMPRESA",
    "domicilio":{
        "via_publica":"FUENTE EL FRESNO",
        "municipio":"13044",
        "codigo_postal":"13680",
        "tipo_via":"CM",
        "numero":"",
        "piso":"",
        "letra":"",
        "portal":""
    }
}

Respuesta

Respuesta
{
    "success": true,
    "message": "OK",
    "status": 200,
}

Consultar Datos de Empresa

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • cif (caracteres) : CIF de la empresa.
GET /authorization-management/enterprise-data
{
    "cif":"B19912999"
}

Respuesta

Respuesta
{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "cif": "141961419A",
        "razon_social": "Valdés de Jaramillo",
        "domicilio": {
            "via_publica": "Travesía Joel",
            "tipo_via": "AV",
            "numero": "17",
            "piso": null,
            "portal": "B",
            "escalera": "g",
            "letra": null,
            "codigo_postal": "97357",
            "municipio": "09304",
            "municipio_text": "Rabé de las Calzadas"
        }
    }
}
Anotación de convenios colectivos múltiples por trabajadorErrores