SEPE
Contrat@
Contrat@

Contrat@

⚠️

Add test=1 to run tests without real effects. In production, omit this parameter.

Parameters

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

  • cif (string) : Company CIF.

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

  • ccc (integer) : Contribution account code, 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 optional (string) : Employee's second surname, mandatory for a NIF/DNI.

  • sex (integer) : 1 for male and 2 for female

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

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

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

  • PAIS_RESIDENCIA (integer) : Employee's country of residence. Possible values:

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

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

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

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

  • IND_CONTRATO_ESCRITO optional (boolean) : Whether the contract is in writing. Possible values:

    • 1: Yes.

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

  • IND_CONVENIO_COLECTIVO (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 code 404 when its duration is less than one year, if the worker has had a previous pre-doctoral contract. It reflects the existence ("S") or non-existence ("N") of a pre-doctoral contract.
    • Contract code 412 when its duration is less than three years, if the worker has had a previous contract of this type. It reflects the existence ("S") or non-existence ("N") of a contract of this type.
    • Contracts with code 421 when their duration is between 24 and 36 months, and the start date is before 30-03-2022. It reflects the existence ("S") or non-existence ("N") of a collective agreement authorising these durations.
    • For contracts with codes 402 and 502 and their variants 450-402 and 550-502 when their duration is 90 days or less, foreseeable situation: Answer Yes ("C") or Answer No ("D").

    For all other contracts that do not fall into one of the cases above, this element must 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 optional (date) : End date, format YYYY-MM-DD.

  • jornadaType (string) : Working hours type. Possible values:

    • A: Annual
    • B: Daily
    • M: Monthly
    • S: Weekly
    • Note: mandatory for part-time contracts.
    • jornadaHour (integer) : Working hours, 4 digits. Note: mandatory for part-time contracts.
    • jornadaMin (integer) : Working minutes, 2 digits. Note: mandatory for part-time contracts.

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

  • INDICATIVO_PRTR (string) : Indicate whether 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

  • IND_DISCAPACIDAD optional (string) : Disability indicator. Possible values:

  • TEMPORAL_MINUSV_BONIFICADO (string) : Mandatory for contracts 430 and 530 unless they are for people with disabilities in Special Employment Centres (IND_DISCAPACIDAD=C). Indicates whether the temporary contract for people with disabilities is subsidised or not. Possible values:

    • S: Yes.
    • N: No

  • CODIGO_COLECTIVO_BONIF (integer) : Subsidy collective code; its value does not need to be specified for Special Employment Centre contracts (IND_DISCAPACIDAD=C), 2 or 3 digits. Possible values:

  • CAUSA_SUSTITUCION optional (string) : Single-letter code for the reason for the interim replacement. Possible values:

    • A: WORKER WITH THE RIGHT TO JOB RESERVATION
    • B: WORKER ON MATERNITY LEAVE WITHOUT CONTRIBUTION SUBSIDY
    • C: CHILDCARE LEAVE, BENEFIT RECIPIENT
    • …
    • Table of codes (opens in a new tab) TEIINTER.txt
    • It is a single letter. The accepted codes depend on the contract: if SEPE does not accept the one you send for that contract, the API answers 422 with the codes it does accept in data.accepted (in test mode the SEPE form is never opened, so this check does not run): 
      {
  "success": false,
  "message": "SEPE: Causa de sustitución «19» no admitida por el SEPE para este contrato. Los códigos admitidos van en data.accepted",
  "errors": { "sepe": ["SEPE: Causa de sustitución «19» no admitida por el SEPE para este contrato. Los códigos admitidos van en data.accepted"] },
  "data": {
    "field": "CAUSA_SUSTITUCION",
    "value": "19",
    "accepted": [{ "code": "A", "description": "..." }, { "code": "B", "description": "..." }]
  }
}

  • IND_ERE (integer) : Whether the company has an authorised collective redundancy procedure (ERE) at the time of hiring. Possible values:

    • S: Yes
    • N: No

  • IND_CONVENIO_COLECTIVO optional (string) : Collective agreement indicator. Possible values:

    • S: Yes
    • N: No
    • For contracts with codes 402 and 502 and their variants 450-402 and 550-502 when their duration is 90 days or less, foreseeable situation:
      • C: Yes
      • D: No

  • TITULACION_ACADEMICA optional (integer) : Academic qualification, 12 digits. Possible values:

  • ID_OFERTA optional (string) : Job offer identifier.

  • DATOS_COPIA_BASICA optional (object): Basic copy data.

    • TIPO_FIRMA (integer) : Signature type. Possible values:
      • 1: SIGNED BY THE LEGAL REPRESENTATIVES.
      • 2: THERE IS NO LEGAL REPRESENTATION.
      • 3: THE COPY HAS NOT BEEN PROVIDED.
      • 4: THEY REFUSE TO SIGN.
    • TEXTO_COPIABASICA (string) : Text of the basic copy.
    • DOMIC_CENTRO_TRABAJO optional (string) : Work centre.

  • duplicate optional (integer) : Get the PDF as base64 in JSON format in the response; possible values 1 or 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
}

Response

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"
    }
  }
}