SEPE

SEPE

Connect your applications with SEPE functions.

Parameters in the HTTP header

  • Authorization (characters): API Authorization. Example: Bearer {token}
  • X-Cert-Secret (characters) : Secret key associated with the client's certificate.

Base URL

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

Issues

Issues received in the SEPE API or validation errors.

  • success (boolean): The response is "true" when everything is okay, and "false" when there are issues.
  • message (characters): The message of the response.
  • errors (array) : The errors captured in the API, either from SEPE or validation errors.
    • sepe: Errors related to SEPE.
    • regimen: Validation errors.
  • maintenance (boolean): When SEPE is in maintenance.

Response

Response
{
  "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@

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production it must be omitted.

  • cif (string) : Company's CIF.

  • regimen (integer) : Regime, 4 digits. Possible values:

  • ccc (integer) : Social Security Account, 11 digits.

  • docType (string): Possible values:

    • D: NIF/DNI
    • E: NIE
    • U: EU Citizen
    • W: Passport

  • dni (string) : National Identity Document.

  • name (string) : Employee’s first name.

  • surname (string) : Employee’s first surname.

  • lastSurname (string) : Employee’s second surname, mandatory if NIF/DNI. Optional.

  • sex (integer) : 1 if male and 2 if female.

  • dateOfBirth (date) : Date of birth, format YYYY-MM-DD.

  • nationality (integer): Employee's nationality. Possible values:

  • municipality (integer): Employee's municipality. Possible values:

  • country (integer) : Country of residence. Possible values:

  • nss (integer) : Social Security Number, 12 digits.

  • nivelFormativo (integer) : Educational level, 2 digits.

  • occupation (integer) : National Occupational Classification (CNO), 4 digits. Possible values:

  • nationalityContract (integer) : Country of the workplace. Possible values:

  • IND_CONTRATO_ESCRITO (boolean) : Indicates if the contract is in writing. Optional. Possible values:

    • 1: Yes.

  • municipalityContract (integer) : Municipality of the workplace. Possible values:

  • collectiveAgreement (string) : Collective agreement indicator, possible values (S, N, C, D). Mandatory for:

    • Contracts with codes 402 and 502 when their duration is between 6 and 12 months.
    • Contract with code 404 when its duration is less than one year, if the employee previously had a predoctoral contract. Indicates the existence ("S") or absence ("N") of a predoctoral contract.
    • Contract with code 412 when its duration is less than three years, if the employee previously had a contract of this type. Indicates the existence ("S") or absence ("N") of such a contract.
    • Contracts with code 421 when their duration is between 24 and 36 months, and the start date is before 30-03-2022. Indicates the existence ("S") or absence ("N") of a collective agreement authorizing these durations.
    • For contracts with codes 402 and 502 and their variants 450-402 and 550-502 when their duration is equal to or less than 90 days, the expected response is: Answer Yes ("C") or Answer No ("D").

    For all other contracts that do not fall under one of these cases, this element should not appear in the file to be sent.

  • codContract (integer) : Contract type, 3 digits. Possible values:

  • startDate (date) : Start date, format YYYY-MM-DD.

  • endDate (date) : End date, format YYYY-MM-DD. Optional.

  • jornadaType (string): Type of work schedule, possible values:

    • A: Annual
    • B: Daily
    • M: Monthly
    • S: Weekly
    • Note: This field is mandatory for part-time contracts.

  • jornadaHour (integer) : Work hours, 4 digits. Note: Mandatory for part-time contracts.

  • jornadaMin (integer) : Work minutes, 2 digits. Note: Mandatory for part-time contracts.

  • REAL_DECRETO_1435_1985 (string) : Indicates if the contract falls under RD 1435/1985. Mandatory for contracts with codes (402, 407, 502, 507), possible values:

    • A: RD 1435/1985 (Artists).
    • B: RD 1435/1985 (Technical or Auxiliary Staff).

  • INDICATIVO_PRTR (string) : Indicates if it falls under the Recovery, Transformation and Resilience Plan. Next Generation EU. Mandatory for all contracts. (Optional for contracts (405,505)). Possible values:

    • S: Yes
    • N: No

  • indicativeDisability (string) : Disability indicator. Optional, possible values:

    • C: DISABLED IN SPECIAL EMPLOYMENT CENTERS
    • E: LABOR ENCLOSURES INTELLECTUAL DISABILITY >=33%
    • F: LABOR ENCLOSURES PHYSICAL/SENSORY DISABILITY >=65%
    • G: LABOR ENCLOSURES FEMALE DISABILITY >=33%
    • S: DISABLED

  • bonusDisability (string) : Mandatory for contracts 430 and 530 unless they are in Special Employment Centers (IND_DISCAPACIDAD=C). Indicates if the temporary contract for people with disabilities is subsidized; possible values:

    • S: Yes.
    • N: No.

  • bonusAgreement (integer) : Subsidy collective code, not required for contracts from Special Employment Centers (IND_DISCAPACIDAD=C), 2 or 3 digits.

  • sustitucion (string) : Replacement cause code for temporary substitution. (Optional)

  • duplicate (integer) : Retrieve the PDF in base64 and in JSON format in the response, possible values 1 or null. Optional.

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,
  "collectiveAgreement": "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",
  "duplicate": 1
}

Response

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

Contrat@ data and footprint

Parameters

  • dni (characters): National identity document.
  • startDate (date): Contract start date, format YYYY-MM-DD.
GET /contrata/data
 
{
  "dni": "01234567A",
  "startDate": "2025-01-01"
}

Response

  • id (characters): Contrat@ footprint and formatted as 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"
      }
    ]
  }
}

Contrat@ duplicate

Parameters

  • cif (characters): Company's CIF.
  • dni (characters): National Identity Document.
  • startDate (date): Contract start date, format YYYY-MM-DD.
GET /contrata
{
  "cif": "A12345678",
  "dni": "12345678A",
  "startDate": "2023-11-01"
}

Response

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

Delete Contrat@

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production it must be omitted.
  • sepeId (characters): Contract identifier in SEPE format, E-99-9999-9999999.
  • option (integer): Possible values:
    • 1: Delete the contract.
    • 2: Delete contract transformations.
DELETE /contrata
{
  "test": 1,
  "sepeId": "E-28-2023-9999999",
  "option": 1
}

Response

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

Send Contrat@ by XML

Parameters

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

Response

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

Submit Contrat@ Data via XML transformation

Parameters

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

Response

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

Contrat@ transformation duplicate

Parameters

  • dni (characters): National Identity Document.
  • startDate (date): Contract start date, format YYYY-MM-DD.
  • sepeId (characters): Contract identifier in SEPE format, E-99-9999-9999999. Optional.
GET /contrata/transformation
{
  "dni": "12345678A",
  "startDate": "2025-01-01",
  "sepeId": "E-28-2023-9999999"
}

Response

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

Basic copy

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production it must be omitted.
  • cif (characters): Company CIF.
  • docType (characters): D=NIF/DNI, E=NIE, U=EU Citizen, W=Passport.
  • dni (characters): National identity document.
  • sepeId (characters): Contract identifier in SEPE format, E-99-9999-9999999. Optional.
  • TIPO_FIRMA (integer): Signature type, possible values:
    • 1: SIGNED BY LEGAL REPRESENTATIVES.
    • 2: NO LEGAL REPRESENTATION EXISTS.
    • 3: COPY NOT PROVIDED.
    • 4: REFUSE TO SIGN.
  • startDate (date): Contract date, format YYYY-MM-DD.
  • TEXTO_COPIABASICA (characters): Text of the basic copy.
  • DOMIC_CENTRO_TRABAJO (characters): Workplace.
  • duplicate (integer): Get the PDF in base64 and in JSON format in the response, possible values 1 or null. Optional.
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
}

Response

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

Duplicate of basic copy

Parameters

  • cif (characters): Company CIF.
  • dni (characters): National identity document.
  • startDate (date): Contract start date, format YYYY-MM-DD.
GET /copy-basic
{
  "cif": "A12345678",
  "dni": "12345678A",
  "startDate": "2023-11-01"
}

Response

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

Send basic copy by XML

Parameters

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

Response

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

Certific@2 duplicate

Parameters

  • dni (characters): National Identity Document.
  • startDate (date): Contract termination or end date, format YYYY-MM-DD.
GET /certifica
{
  "dni": "12345678A",
  "startDate": "2025-01-01"
}

Response

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

Certific@2 data

Parameters

  • dni (string) : National Identity Document.
GET /certifica/data
{
  "dni": "99999999T"
}

Response

Response
{
  "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"
      }
    ]
  }
}

Send Certific@2 via XML

Parameters

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

Response

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

Send CERTIFIC@2 (Company certificate)

Parameters

  • test (number (1)): For testing, add the parameter test=1. For production it must be omitted.

  • Datos_Representante (object): Data for the company representative, an administrative firm, or an authorized professional.

    • CIF_NIF (string): Identifier (for a natural or legal person) of the company representative.
    • Nombre (string): First name.
    • Apellido1 (string): First surname.
    • Apellido2 (string): Second surname (if applicable).
    • Cargo (string): Position held in the company.

  • Datos_Empresa (object): Contribution Account, 11 digits.

    • CIF_NIF (string): Identifier (for a natural or legal person) of the company.
    • CCC (string): Contribution Regime and Account, 15 digits. Example: 011112345678901.

  • Datos_Trabajador (object): Employee data.

    • DNI_NIE (string): Identifier (for a natural or legal person) of the employee.
    • Nombre (string): First name.
    • Apellido1 (string): First surname.
    • Apellido2 (string): Second surname (if applicable).
    • NumSS (string): Social Security Number, 12 digits.
    • GrupoCotizacion (integer): Contribution group, 2 digits. Possible values:
    • TipoContrato (integer): Contract type, 3 digits. Possible values:
    • DuracionContrato (integer): Duration for which the employee was registered with the company. (Optional)
    • IndicadorDuracionContrato (string): Describes the units used to measure the specified time, optional. Possible values:
      • D = Daily.
      • M = Monthly.
      • A = Annual.
    • CodProfesion (integer): National Occupation Classification (CNO), 4 digits. Possible values:
    • FechaAltaEmpresa (date): Employee registration date, format YYYY-MM-DD.
    • CodCausaSuspension (integer): Code foir the cause of suspension or termination of the employment relationship, 2 digits.
    • FechaSuspensionExtincion (date): Date of the suspension or termination cause, format YYYY-MM-DD.
    • DiasSalarioTramitacion (integer): Number of calendar days between the start and end dates of wage processing. (Optional)
    • Datos_Cotizacion (array): Contribution data for common contingencies and unemployment.
      • Ano (string): Contribution year, 4 digits.
      • Mes (string): Contribution month, 2 digits.
      • NumDiasCotizados (integer): Number of calendar days effectively contributed.
      • BaseCotizacionContingenciasComunes (decimal): Contributed amount for Common Contingencies.
      • BaseCotizacionDesempleo (decimal): Contributed amount for Unemployment.
    • Datos_VacacionesCotizadas (object): Contribution data corresponding to vacation. (Optional)
      • NumDiasCotizados (integer): Number of calendar days associated with vacation that were effectively contributed.
      • BaseCotizacionContingenciasComunes (decimal): Contribution basis for common contingencies.
      • BaseCotizacionDesempleo (decimal): Social Security contribution basis.
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
      }
    ]
  }
}

Response

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

Communicate calls to action

Parameters

  • cif (string): Company CIF.
  • regimen (string): Regime, 4 digits, Possible values:
  • ccc (string): Contribution Account, 11 digits.
  • employees (array): Employee data.
    • doc (string): Natural person identifier.
    • docType (string): Document type. Possible values:
      • D: NIF/DNI,
      • E: NIE,
      • U: EU Citizen,
      • W: Passport.
    • name (string): Employee's first name.
    • surname (string): Employee's first surname.
    • lastSurname (string): Employee's second surname, mandatory if NIF/DNI. Optional.
    • sex (integer) : Possible values:
      • 1 = Male
      • 2 = Female
    • dateOfBirth (date): Date of birth, format YYYY-MM-DD.
    • nationality (integer): Employee's nationality. Possible values:
    • municipality (integer): Employee's municipality. Possible values:
    • country (integer) : Country of residence. Possible values:
    • nss (integer) : Social Security Number, 12 digits.
    • startDate (date): Start date, format YYYY-MM-DD.
    • endDate (date): End date, format YYYY-MM-DD.
    • nivelFormativo (integer): Educational level, 2 digits.
    • question (string): Indicates if included in the activity, optional. Possible values:
      • S = Yes.
      • 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"
    }
  ]
}

Response

Response
{
  "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"
        }
      }
    ]
  }
}

Delete call to action

Parameters

  • ccc (string): Contribution Account, 11 digits.
  • sepeId (string): Contract identifier in SEPE, format E-99-9999-9999999.
DELETE /llamamientos
{
  "ccc": "27770999999",
  "sepeId": "E-99-9999-9999999",
}

Response

Response
{
  "success": true,
  "message": "OK"
}
Household regimeIssues