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 (string) : Optional. 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 (boolean) : Optional. 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 (date) : Optional. 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 (string) : Optional. 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 (string) : Optional. Code for the reason for the interim replacement. Possible values:

  • 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 (string) : Optional. 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 (integer) : Optional. Academic qualification, 12 digits. Possible values:

  • ID_OFERTA (string) : Optional. Job offer identifier.

  • DATOS_COPIA_BASICA (object): Optional. 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 (string) : Optional. Work centre.

  • duplicate (integer) : Optional. 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"
    }
  }
}