Afiliación de NAF

Inscripción de número de afiliación, este método se encuentra en fase beta.

Parámetros

• dni (caracteres) : Documento del trabajador (DNI, NIE o pasaporte).
• identificacion (número entero) : Tipo de documento, posibles valores (cualquier otro valor devuelve 422 con errors.identificacion). Si no lo envías, se deduce del documento: DNI→1, NIE→6, resto→2.
  • 1: DNI
  • 2: Pasaporte
  • 6: NIE
• name (caracteres) : Nombre.
• surname (caracteres) : Primer apellido.
• lastSurname (caracteres) : Segundo apellido, si lo tiene.
• country (número entero) : Nacionalidad. Posibles valores:
  • 724: España
  • Tabla con los códigos de nacionalidad 
• sexo (caracteres) : Sexo, posibles valores:
  • M: Masculino
  • F: Femenino
• fnacimiento (fecha) : Fecha de nacimiento. Formato YYYY-MM-DD.
• fatherName (caracteres) : Nombre del padre.
• motherName (caracteres) : Nombre de la madre.
• phoneCode (número entero) : Código de teléfono. Ejemplo: 34
• phone (número entero) : Número de teléfono.
• streetType (caracteres) : Tipo de calle: código de 2 letras mayúsculas (CL, AV…); si no, 422. Ejemplo:
  • CL: Calle
• streetName (caracteres) : Nombre de la calle.
• streetNumber (caracteres) : Número de la calle.
• bis (caracteres) : Bis.
• block (caracteres) : Bloque.
• stairs (caracteres) : Escalera.
• floor (caracteres) : Piso.
• door (caracteres) : Puerta.
• postalCode (caracteres) : Código postal, máximo 5 dígitos.
• city (número entero) : Ciudad. Posibles valores:
  • 13044: Fuente el Fresno
  • Tabla con los códigos de municipio 

El domicilio (streetType, streetName, postalCode, city…) debe ser el del trabajador, no el de la empresa.

{
  "dni": "12345678A",
  "identificacion": 1,
  "name": "Juan",
  "surname": "Perez",
  "lastSurname": "Garcia",
  "country": 724,
  "sexo": "M",
  "fnacimiento": "2023-01-01",
  "fatherName": "Juan",
  "motherName": "Perez",
  "phoneCode": 34,
  "phone": 123456789,
  "streetType": "CL",
  "streetName": "Calle 1",
  "streetNumber": "1",
  "bis": "",
  "block": "",
  "stairs": "",
  "floor": "4",
  "door": "A",
  "postalCode": "13044",
  "city": 13044
}

Respuesta

{
  "success": true,
  "message": "OK",
  "data": {
    "nss": "123456789012",
    "identity": "1",
    "dni": "12345678A"
  }
}

Errores

• 422, identificacion fuera de 1, 2 o 6: «El campo Identificación debe ser 1 (DNI/NIF), 2 (Pasaporte) o 6 (NIE).»
• 422, country de la UE/EEE/Suiza (sin España) con tipo efectivo 2 (enviado o deducido): Saltra no llama a la TGSS.

{
  "success": false,
  "status": 422,
  "message": "validation_errors",
  "data": [],
  "errors": {
    "identificacion": [
      "La TGSS no asigna NAF por Sistema RED a ciudadanos de la UE/EEE sin NIE. Indica el NIE (certificado de registro de ciudadano de la UE, tipo 6) o solicita el NAF en una administración de la TGSS (modelo TA.1)."
    ]
  }
}

• 422: el resto de validaciones (errors.streetType…).
• 424: rechazo de la TGSS (no reintentes sin corregir los datos). Si responde 3001 e indica un campo concreto, el message termina con el texto «(campo rechazado por la TGSS: etiqueta — campo_api)» y errors.field contiene la clave de la API; si el campo es identificacion, el mensaje añade la pista del NIE. Si la TGSS no indica el campo, el mensaje es el habitual y no hay errors.field.

{
  "success": false,
  "status": 424,
  "message": "SISTEMA RED: 3001*ERROR DE VALIDACION U OBLIGATORIEDAD NO CUMPLIDA (campo rechazado por la TGSS: nombre del padre — `fatherName`)",
  "data": [],
  "errors": {
    "tgss": [
      "SISTEMA RED: 3001*ERROR DE VALIDACION U OBLIGATORIEDAD NO CUMPLIDA (campo rechazado por la TGSS: nombre del padre — `fatherName`)"
    ],
    "field": [
      "fatherName"
    ]
  }
}