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
{
"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:
- 0111: General scheme
- Table with regime codes (opens in a new tab)
-
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:
- 004: Afghanistan
- Nationality codes table (opens in a new tab)
-
municipality (integer): Employee's municipality. Possible values:
- 13044: Fuente el Fresno
- Municipality codes table (opens in a new tab)
-
country (integer) : Country of residence. Possible values:
- 004: Afghanistan
- Country codes table (opens in a new tab)
-
nss (integer) : Social Security Number, 12 digits.
-
nivelFormativo (integer) : Educational level, 2 digits.
-
occupation (integer) : National Occupational Classification (CNO), 4 digits. Possible values:
- 0011: Armed Forces officers
- Table with occupation codes (opens in a new tab)
-
nationalityContract (integer) : Country of the workplace. Possible values:
- 004: Afghanistan
- Country codes table (opens in a new tab)
-
contractWrite (boolean) : Indicates if the contract is in writing. Optional. Possible values:
- 1: Yes.
-
municipalityContract (integer) : Municipality of the workplace. Possible values:
- 13044: Fuente el Fresno
- Municipality codes table (opens in a new tab)
-
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:
- 100: Permanent Full-Time - Regular
- Table with contract codes (opens in a new tab)
-
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.
{
"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
{
"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.
{
"dni": "01234567A",
"startDate": "2025-01-01"
}
Response
- id (characters): Contrat@ footprint and formatted as E-##-####-#######.
{
"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.
{
"cif": "A12345678",
"dni": "12345678A",
"startDate": "2023-11-01"
}
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.
{
"test": 1,
"sepeId": "E-28-2023-9999999",
"option": 1
}
Response
{
"success": true,
"message": "OK"
}
Send Contrat@ by XML
Parameters
- file (file): Contrat@ XML.
{
"file": {
"content": "data:...",
"contentType": "application/xml",
"name": "document.xml",
"size": 1024
}
}
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.
{
"file": {
"content": "data:...",
"contentType": "application/xml",
"name": "document.xml",
"size": 1024
}
}
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.
{
"dni": "12345678A",
"startDate": "2025-01-01",
"sepeId": "E-28-2023-9999999"
}
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.
- signatureType (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.
- copyBasicText (characters): Text of the basic copy.
- workplace (characters): Workplace.
- duplicate (integer): Get the PDF in base64 and in JSON format in the response, possible values 1 or null. Optional.
{
"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
}
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.
{
"cif": "A12345678",
"dni": "12345678A",
"startDate": "2023-11-01"
}
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.
{
"file": {
"content": "data:...",
"contentType": "application/xml",
"name": "document.xml",
"size": 1024
}
}
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.
{
"dni": "12345678A",
"startDate": "2025-01-01"
}
Response
{
"success": true,
"message": "OK",
"data": {
"file": {
"contentType": "application/pdf",
"name": "document.pdf",
"content": "base64"
}
}
}
Certific@2 data
Parameters
- dni (string) : National Identity Document.
{
"dni": "99999999T"
}
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.
{
"file": {
"content": "data:...",
"contentType": "application/xml",
"name": "document.xml",
"size": 1024
}
}
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:
- 03: Administrative and workshop managers
- Table with contribution group codes (opens in a new tab)
- TipoContrato (integer): Contract type, 3 digits. Possible values:
- 100: Full-time contract (regular)
- Table with contract type codes (opens in a new tab)
- 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:
- 0011: Armed Forces officers
- Table with occupation codes (opens in a new tab)
- 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.
{
"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
{
"success": true,
"message": "OK"
}
Communicate calls to action
Parameters
- cif (string): Company CIF.
- regimen (string): Regime, 4 digits, Possible values:
- 0111: General scheme
- Table with regime codes (opens in a new tab)
- 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:
- 13044: Fuente el Fresno
- Table with municipality codes (opens in a new tab)
- 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.
{
"cif": "9999999B",
"regimen": "0112",
"ccc": "27770999999",
"employees": [
{
"doc": "9999999B",
"startDate": "2023-11-05",
"endDate": "2023-11-05",
"nivelFormativo": 12,
"question": "S"
}
]
}
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.
{
"ccc": "27770999999",
"sepeId": "E-99-9999-9999999",
}
Response
{
"success": true,
"message": "OK"
}