Sepe

SEPE

Conecta tus aplicaciones con funciones del SEPE.

Parámetros en el HEADERS

  • 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. En términos generales, para errores de validación se obtiene como se muestra con el campo regimen y así con los demás campos.
  • maintenance (booleano) : Cuando el SEPE se encuentra en mantenimiento.
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 enviar test=1, para producción se debe omitir.

  • cif (caracteres) : CIF de la empresa.

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

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

  • docType (caracteres) : 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) : Segundo apellido del empleado, obligatorio si es NIF/DNI. Opcional.

  • 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.

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

  • country (número entero) : Pais de domicilio del empleado.

  • 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.

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

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

    • 1 = Si.

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

  • collectiveAgreement (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.

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

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

  • jornadaType (caracteres) : Tipo de jornada, posibles valores(A=anual, D=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.

  • realDecreto_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:

    • A = RD 1435/1985 (Artistas).
    • B = RD 1435/1985 (Personal Técnico o Auxiliar).

  • recoveryPlan (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

  • indicativeDisability (caracteres) : Indicador de discapacidad. Opcional, posibles valores:

    • C = DISCAPACITADOS EN CENTROS ESPEC.EMPLEO
    • E = ENCLAVES LABORALES DISC.INTELECT.>=33%
    • F = ENCLAVES LABORALES DISC.FÕS./SENS.>=65%
    • G = ENCLAVES LABORALES MUJERES DISCAP.>=33%
    • S = DISCAPACITADOS

  • bonusDisability (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

  • bonusAgreement (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.

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

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

POST /contrata
{
  "test": 1,
  "cif": "A12345678",
  "regimen": 1234,
  "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,
  "collectiveAgreement": "S",
  "codContract": 123,
  "startDate": "2023-11-01",
  "endDate": "2024-11-'01",
  "jornadaType": "A",
  "jornadaHour": 8,
  "jornadaMin": 0,
  "realDecreto_1435_1985": "A",
  "recoveryPlan": "S",
  "duplicate": 1
}
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "doc": "00000000A",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Datos de Contrat@ y huella

Parámetros

  • dni (caracteres) : Documento nacional de identidad.
  • startDate (date) : Fecha de inicio del contrato, formato YYYY-MM-DD.
GET /contrata/data
dni
startDate

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\u00d1A"
      },
      {
        "municipio": "MADRID"
      },
      {
        "postal_code": "99999"
      }
    ],
    "account_data": [
      {
        "ccc_full": "011128199969999"
      },
      {
        "economic_activity": "ACTIVIDADES DEPORTIVAS"
      }
    ],
    "working_center": [
      {
        "pais": "ESPA\u00d1A"
      },
      {
        "municipio": "MADRID"
      }
    ],
    "employee_data": [
      {
        "nif": "09929999L"
      },
      {
        "name": "NAME EMPLOYEE"
      },
      {
        "sexo": "HOMBRE"
      },
      {
        "fecha_de_nacimiento": "DD/MM/YYYY"
      },
      {
        "nivel_formativo": "PRIMERA ETAPA DE EDUCACI\u00d3N SECUNDARIA CON T\u00cdTULO DE GRADUADO ESCOLAR O EQUIVALENTE."
      },
      {
        "nss": "999999999999"
      },
      {
        "nacionalidad": "ESPA\u00d1A"
      },
      {
        "municipio_de_domicilio": "MADRID"
      },
      {
        "pais_de_domicilio": "ESPA\u00d1A"
      }
    ],
    "contract_data": [
      {
        "cno": "ORGANIZADORES DE CONFERENCIAS"
      },
      {
        "startDate": "DD/MM/YYYY"
      },
      {
        "communicateDate": "DD/MM/YYYY"
      },
      {
        "tipo_de_jornada": "JORNADA ANUAL"
      },
      {
        "duraci\u00f3n_jornada": "Horas :0072"
      }
    ],
    "contract_data_other": [],
    "copy_basic_data": [
      {
        "signatureText": "NO EXISTE REPRESENTACI\u00d3N LEGAL"
      }
    ]
  }
}

Duplicado de Contrat@

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 /contrata
{
  "cif": "A12345678",
  "dni": "12345678A",
  "startDate": "2023-11-01"
}
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Eliminar Contrat@

Parámetros

  • test (número (1)) : Para pruebas enviar test=1, para producción se debe omitir.
  • sepeId (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999
  • option (número entero) : Posibles valores: 1 = Eliminar el contrato, 2 = Eliminar transformaciones de contrato.
DELETE /contrata
test
sepeId
option
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
{
  "success": true,
  "message": "OK",
  "data": {
    "id": "E-28-2023-9999999",
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Enviar de transformación de Contrat@ por XML

Enviar de transformación de Contrat@

Parámetros

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

Duplicado de transformación de Contrat@

Parámetros

  • dni (caracteres) : Documento nacional de identidad.
  • startDate (date) : Fecha de inicio del contrato, formato YYYY-MM-DD.
  • sepeId (caracteres) : Identificador contrato en el SEPE, formato E-99-9999-9999999. Opcional.
GET /contrata/transformation
dni
startDate
sepeId
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Copia Básica

Parámetros

  • test (número (1)) : Para pruebas enviar 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) : Identificador contrato en el SEPE, formato E-99-9999-9999999. Opcional.
  • signatureType (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.
  • copyBasicText (caracteres) : Texto de la copia básica.
  • workplace (caracteres) : Centro de trabajo.
  • duplicate (número entero) : Obtener el PDF en base64 y en formato json en la respuesta, posibles valores 1 o null. Opcional.
POST /copy-basic
{
  "test": 1,
  "cif":"B12312333",
  "docType": "D",
  "dni": "12345678A",
  "sepeId": "E-99-9999-9999999",
  "signatureType": 1,
  "startDate": "2023-11-01",
  "copyBasicText": "Texto de la copia básica (Este es un ejemplo ficticio).",
  "workplace":"CENTRO DE TRABAJO",
  "duplicate": 1
}
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Duplicado de 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
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Enviar 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
{
  "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 inicio del contrato, formato YYYY-MM-DD.
GET /certifica
dni
startDate
Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

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
{
  "success": true,
  "message": "OK"
}

Enviar CERTIFIC@2 (Certificado de empresa)

Parámetros

  • test (número (1)) : Para pruebas enviar test=1, para producción se debe omitir.

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

    • doc (caracteres) : Identificador de persona física o jurídica del representante de la empresa.
    • name (caracteres) : Nombre.
    • surname (caracteres) : Primer apellido.
    • lastSurname (caracteres) : Segundo apellido (Si lo tiene).
    • cargo (caracteres) : Cargo que ocupa en la empresa.

  • enterpriseData (objeto) : Cuenta de Cotización, 11 dígitos.

    • doc (caracteres) : Identificador de persona física o jurídica de la empresa.
    • regimen (caracteres) : Régimen, 4 dígitos, posibles valores:
      • 0111 = General.
      • 0112 = Artistas.
      • 0163 = Agrario.
    • ccc (caracteres) : Cuenta de Cotización, 11 dígitos.

  • employeeData (objeto) : Datos del trabajador.

    • doc (caracteres) : Identificador de persona física o jurídica del representante de la empresa.
    • name (caracteres) : Nombre.
    • surname (caracteres) : Primer apellido.
    • lastSurname (caracteres) : Segundo apellido (Si lo tiene).
    • nss (caracteres) : Número de Seguridad Social, 12 dígitos.
    • quoteGroup (número entero) : Grupo de cotización, 2 dígitos.
    • contractPeriod (números entero) : Tiempo en que el trabajador estuvo de alta en la empresa. (Opcional).
    • contractPeriodIndicator (caracteres) : Describe las unidades en las que se mide el tiempo indicado contractPeriod . (Opcional), posibles valores:
      • D = Diaria.
      • M = Mensual.
      • A = Anual.
    • professionCode (número entero) : Clasificación Nacional de Ocupaciones(CNO), 4 dígitos.
    • dischargeDate (date) : Fecha de alta del trabajador, formato YYYY-MM-DD.
    • suspensionCode (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.
    • suspensionDate (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.
    • daysSalaryTramitation (número entero) : 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. (Opcional).
    • ctzData (arreglo) : Datos de cotización de por contingencias comunes y de desempleo.
      • year (caracteres) : Año de cotización, 4 dígitos.
      • month (caracteres) : Mes de cotización, 2 dígitos.
      • days (número entero) : Número de días naturales que efectivamente se haya cotizado.
      • contingencyQuoteBasis (decimal) : Cantidad cotizada correspondiente a las Contingencias Comunes.
      • unemploymentQuoteBasis (decimal) : Cantidad cotizada correspondiente a Desempleo.
    • ctzVacationData (objeto) : Datos de cotización correspondientes a las vacaciones. (Opcional)
      • days (número entero) : Número de días naturales correspondientes a vacaciones que efectivamente hayan sido cotizado.
      • contingencyQuoteBasis (decimal) : Base de cotización de contingencias comunes.
      • unemploymentQuoteBasis (decimal) : Base de cotización a la Seguridad Social.
POST /certifica
{
  "representativeData":{
    "doc": "9999999B",
    "name": "nombre",
    "surname": "apellido1",
    "lastSurname": "apellido2",
    "cargo": "ADMINISTRADOR"
  },
  "enterpriseData":{
    "doc": "9999999B",
    "regimen": "0112",
    "ccc": "27770999999"
  },
  "employeeData": {
    "doc": "9999999B",
    "name": "nombre",
    "surname": "apellido1",
    "lastSurname": "apellido2",
    "nss": "187774444999",
    "quoteGroup": "05",
    "contractType": "407",
    "contractPeriod": 154,
    "contractPeriodIndicator": "D",
    "professionCode": "3831",
    "dischargeDate": "2023-06-05",
    "suspensionCode": "11",
    "suspensionDate": "2023-11-05",
    "daysSalaryTramitation": 0,
    "ctzData": [
      {
        "year": "2023",
        "month": "06",
        "days": 26,
        "contingencyQuoteBasis": 1000.5,
        "unemploymentQuoteBasis": 1000.5
      },
      {
        "year": "2023",
        "month": "07",
        "days": 31,
        "contingencyQuoteBasis": 1000.5,
        "unemploymentQuoteBasis": 1000.5
      }
    ]
  }
}
Respuesta
{
  "success": true,
  "message": "OK"
}

Comunicar llamamientos

Parámetros

  • cif (caracteres) : CIF de la empresa.

  • regimen (caracteres) : Régimen, 4 dígitos, posibles valores:

    • 0111 = General.
    • 0112 = Artistas.
    • 0163 = Agrario.

  • ccc (caracteres) : Cuenta de Cotización, 11 dígitos.

  • employees (arreglo) : Datos del trabajador.

    • doc (caracteres) : Identificador de persona física.
    • startDate (date) : Fecha inicio, formato YYYY-MM-DD.
    • endDate (date) : Fecha fin, formato YYYY-MM-DD.
    • nivelFormativo (número entero) : Nivel formativo, 2 dígitos.
    • question (caracteres) : Se incorpora a la actividad . (Opcional), posibles valores:
      • S = Si.
      • N = No.
POST /llamamientos
{
  "cif": "9999999B",
  "regimen": "0112",
  "ccc": "27770999999",
  "employees": [
    {
      "doc": "9999999B",
      "startDate": "2023-11-05",
      "endDate": "2023-11-05",
      "nivelFormativo": 12,
      "question": "S"
    }
  ]
}
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"
        }
      }
    ]
  }
}

Eliminar 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
{
  "success": true,
  "message": "OK"
}
Seguridad Social