Household employees scheme
Update a household employee registration

Update a household employee registration

⚠️

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

Update the details of a previously registered household employee.

Base URL

https://api.saltra.es/api/v4/seg-social/hogar

Parameters

  • test (number (1)): For testing, add the test=1 parameter. It must be omitted in production.
  • ccc (integer): Contribution account code, 11 digits.
  • datos_trabajador (object): Worker details.
    • DOC (string): National identity document.
    • SEL_IPF_TIPO (integer): Optional. Identification type. Possible values:
      • 1: DNI
      • 2: Passport
      • 6: NIE
    • NSS (integer): Social Security number, 12 digits.
  • datos_alta (object): Registration details.
    • FECHA_INICIO_ACTIVIDAD (date): Registration start date, format YYYY-MM-DD.
    • FECHA_VIGENCIA_NUEVO_CONTRATO (date): Date from which the new contract takes effect, format YYYY-MM-DD.
    • FECHA_VIGENCIA_DATOS_RETRIBUCION (date): Date from which the new pay details must be applied, format YYYY-MM-DD.
    • TIPO_CONTRATO (integer): Contract type, 3 digits. Same values as for the registration.
    • RETRIBUCION_MENSUAL (decimal): Monthly pay.
    • PERSONA_DED_CUIDADO_FN (string): Person dedicated to caring for a large family, values: "S" (Yes) or "N" (No).
    • Other optional parameters are the same as for the registration.
    • OPERACION (integer): Possible values:
      • 1: Correct the employment relationship details because they contain an error
      • 2: Amend the employment relationship details because one of them has changed
    • TRABAJADOR_HOR_REG_EXT (string): Hourly worker under the external scheme. Possible values:
      • S: YES
      • N: NO
PUT /hogar/alta
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_alta": {
    "FECHA_INICIO_ACTIVIDAD": "2023-01-01",
    "FECHA_VIGENCIA_NUEVO_CONTRATO": "2023-01-15",
    "FECHA_VIGENCIA_DATOS_RETRIBUCION": "2023-01-01",
    "TIPO_CONTRATO": "100",
    "RETRIBUCION_MENSUAL": 1300,
    "PERSONA_DED_CUIDADO_FN": "N",
    "OPERACION": 2
  }
}

Response

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