Seguridad Social
Régimen del hogar
Dar de alta a un empleado del hogar

Dar de alta a un empleado del hogar

Registrar un nuevo empleado en el régimen del hogar.

URL base

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

Parámetros

  • test (número (1)): Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
  • ccc (número entero): Cuenta de cotización, 11 dígitos.
  • datos_trabajador (objeto): Información del trabajador.
    • DOC (caracteres): Documento Nacional de Identidad.
    • SEL_IPF_TIPO (número entero): Opcional. Tipo de identificación. Posibles valores:
      • 1: DNI
      • 2: Pasaporte
      • 6: NIE
    • NSS (número entero): Número de Seguridad Social, 12 dígitos.
  • datos_alta (objeto): Información del alta.
    • FECHA_INI_ACTIVIDAD (fecha): Fecha de inicio de actividad, formato YYYY-MM-DD.
    • TIPO_CONTRATO (número entero): Tipo de contrato, 3 dígitos. Posibles valores:
      • 100: Contrato a tiempo completo (indefinido)
      • 200: Contrato a tiempo parcial (indefinido)
      • 300: Contrato fijo discontinuo
      • 401: Contrato temporal a tiempo completo (por obra o servicio)
      • 402: Contrato temporal a tiempo completo (por circunstancias de la producción)
      • 501: Contrato temporal a tiempo parcial (por obra o servicio)
      • 502: Contrato temporal a tiempo parcial (por circunstancias de la producción)
    • RETRIBUCION_MENSUAL (decimal): Retribución mensual.
    • PERSONA_DED_CUIDADO_FN (caracteres): Persona dedicada al cuidado de una familia numerosa, valores: "S" (Sí) o "N" (No).
    • SALARIO_ESPECIE (decimal): Opcional. Salario en especie.
    • PACTO_HORAS_PRESENCIA (caracteres): Pacto de horas de presencia, opcional, valores: "S" (Sí) o "N" (No).
    • NUM_HORAS_PRESENCIA (número entero): Número de horas de presencia, opcional.
    • RET_HORAS_PRES_PACTADAS (decimal): Opcional. Retribución por horas de presencia pactadas.
    • PACTO_PERNOCTA (caracteres): Opcional. Pacto de pernocta, valores: "S" (Sí) o "N" (No).
    • RET_PACTO_PERNOCTA (decimal): Opcional. Retribución por pacto de pernocta.

Para contratos a tiempo parcial (200, 300, 501, 502), se requieren parámetros adicionales:

  • TRABAJADOR_HOR_REG_EXT (caracteres): Trabajador por horas régimen externo, valores: "S" (Sí) o "N" (No).

  • HORAS_TM (número entero): Horas de trabajo mensual.

  • MINUTOS_TM (número entero): Opcional. Minutos de trabajo mensual.

  • NUM_HORAS_TRAB_SEMANA (número entero): Opcional. Horas de trabajo a la semana.

  • SALARIO_HORA (decimal): Salario por hora.

  • datos_bancarios (objeto): Opcional. Información bancaria.

    • IPF_NOMBRE (caracteres): Nombre del titular de la cuenta.
    • NUMDOCUMENTO (caracteres): Número de documento.
    • IBAN (caracteres): Número de IBAN.
POST /hogar/alta
{
  "test": 1,
  "ccc": "12345678901",
  "datos_trabajador": {
    "DOC": "12345678A",
    "SEL_IPF_TIPO": 1,
    "NSS": "123456789012"
  },
  "datos_alta": {
    "FECHA_INI_ACTIVIDAD": "2023-01-01",
    "TIPO_CONTRATO": "100",
    "RETRIBUCION_MENSUAL": 1200,
    "PERSONA_DED_CUIDADO_FN": "N",
    "SALARIO_ESPECIE": 0,
    "PACTO_HORAS_PRESENCIA": "N",
    "PACTO_PERNOCTA": "N"
  },
  "datos_bancarios": {
    "IPF_NOMBRE": "NOMBRE APELLIDO",
    "NUMDOCUMENTO": "12345678A",
    "IBAN": "ES0012345678901234567890"
  }
}

Respuesta

Respuesta
{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}
Afiliación de NAFDar de baja a un empleado del hogar