Workers documentation state with token

Description

Services for the Control of Workers' Documentation State

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador-token.action.

Operations

Trabajador-token

Description: This service return the state of the documentation of the worker. The accreditation field in the worker's general information. It can have the following values:

● P: Blue, document pending validation (Pending).
● G: Green state (Suitable)
● O: Orange (Deficient)
● R: Red state (Unfit)
●
The GeneralGeneral state field in worker informationGeneral, can have the following values:
● P: Blue, document pending validation (Pending).
● G: Green state (Suitable)
● O: Orange (Deficient)
● R: Red state (Not suitable)

The parameters that are taken into account to calculate it are: accreditation, the way in which the work is recorded, and the incidents. Incidents are above the other values. When an incident prevents access, its value will be R and otherwise there is an incident that allows access, its value will be G.

The worker's General information state field can have the following values:

● G: Green state (Suitable).
● R: Red state (Not suitable)
● A: state Green - (Permitted)
● D: state Red - (Denied)

Request:

{
	"request": {
		"trabajadorNif": "NIF",
		"contrataId": "ID_NUMERICO_CONTRATA",
		"idDispositivo": "ID_DISPOSITIVO_ASIGNADO_A_OBRA"
	}
}

Request fields:

trabajadorId : ID of the worker. Higher preference than nif.
trabajadorNif: Worker's id card. Lower preference than Id.
contrataId: Identifier that the contract has in the Obralia system.
idDispositivo: Identifier of the device registered in the system.

Response:

{
    "informacionContrata": {
        "cif": "XXXXXXXXX",
        "descripcion": "TALLERES CONRAD, S.L.",
        "id": 12309071
    },
    "informacionObra": {
        "cif": "XXXXXXXXX",
        "codigoInterno": "A6007",
        "id": 18,
        "informacionConstructora": {
            "cif": "XXXXXXXXX",
            "descripcion": "CONSTRUCTORA"
        }
    },
    "informacionTrabajador": {
        "informacionDocumental": {
            "documentos": {
                "altaSeguridadSocial": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Alta en seguridad social",
                        "tipo": "altaSeguridadSocial"
                    }
                ],
                "autorizacionUsoMaquinariaEquipo": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Autorización de uso de Maquinaria / equipo",
                        "tipo": "autorizacionUsoMaquinariaEquipo"
                    }
                ],
                "contratoDeTrabajo": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Contrato de Trabajo",
                        "tipo": "contratoDeTrabajo"
                    }
                ],
                "cursoBasicoPrevencion": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Curso básico de prevención",
                        "tipo": "cursoBasicoPrevencion"
                    }
                ],
                "cursosDeAptitud": [
                    {
                        "estado": "G",
                        "fechaCaducidad": "2022-10-18T00:00:00+0200",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Curso de Aptitud",
                        "tipo": "cursosDeAptitud"
                    },
                    {
                        "estado": "G",
                        "fechaCaducidad": "2022-10-18T00:00:00+0200",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Curso de Aptitud",
                        "tipo": "cursosDeAptitud"
                    }
                ],
                "cursoSegundoCicloFormacion": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Curso segundo ciclo / oficio",
                        "tipo": "cursoSegundoCicloFormacion"
                    }
                ],
                "dniPasaporte": [
                    {
                        "estado": "O",
                        "fechaCaducidad": "2029-03-12T00:00:00+0100",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "DNI / Pasaporte",
                        "tipo": "dniPasaporte"
                    }
                ],
                "documentacionGenerica": [
                    {
                        "estado": "R",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Genérico 1",
                        "tipo": "documentacionGenerica"
                    },
                    {
                        "estado": "R",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Genérico 2",
                        "tipo": "documentacionGenerica"
                    },
                    {
                        "estado": "R",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Genérico 3",
                        "tipo": "documentacionGenerica"
                    },
                    {
                        "estado": "R",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Genérico 4",
                        "tipo": "documentacionGenerica"
                    },
                    {
                        "estado": "R",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Genérico 5",
                        "tipo": "documentacionGenerica"
                    },
                    {
                        "estado": "R",
                        "nombreDocumento": "Genérico 6",
                        "tipo": "documentacionGenerica"
                    }
                ],
                "entregaInformacionRiesgosLaborales": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Entrega de información de riesgos laborales",
                        "tipo": "entregaInformacionRiesgosLaborales"
                    }
                ],
                "EPIS": [
                    {
                        "estado": "G",
                        "fechaCaducidad": "2020-03-12T00:00:00+0100",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Entrega de Epis",
                        "tipo": "EPIS"
                    }
                ],
                "foto": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Fotografía del Trabajador",
                        "tipo": "foto"
                    }
                ],
                "permisoDeTrabajo": [
                    {
                        "estado": "G",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Permiso de Trabajo",
                        "tipo": "permisoDeTrabajo"
                    }
                ],
                "reconocimientoMedico": [
                    {
                        "estado": "G",
                        "fechaCaducidad": "2020-03-12T00:00:00+0100",
                        "fechaSubidaDocumento": "2019-12-05T13:05:27+0100",
                        "nombreDocumento": "Reconocimiento Médico",
                        "tipo": "reconocimientoMedico"
                    }
                ]
            }
        },
        "informacionDocumentalTrabajadorEspecificaContrata": {
            "enAuditoria": false,
            "enGerem": false,
            "enRecursoPreventivo": false,
            "enVigilanciaEspecial": false,
            "fechaSalidaExpirada": false,
            "informacionOficiosEnObra": [
            ],
            "informacionRiesgosTrabajador": [
            ]
        },
        "informacionGeneral": {
            "acreditacion": "R",
            "apellidos": "COOPER",
            "autorizacionesDeMaquinaria": [
                {
                    "icono": "https://iot.nalandaglobal.com/imagenes/maquinasAutorizacionTrabajadores/Herramientas-\r\nMano2.png",
                    "tipoMaquinaria": "HERRAMIENTA_DE_MANO"
                },
                {
                    "icono": "https://iot.nalandaglobal.com/imagenes/maquinasAutorizacionTrabajadores/Radial.png",
                    "tipoMaquinaria": "RADIAL_AMOLADORA"
                }
            ],
            "categoria": "08: OFICIALES DE 1a Y 2a",
            "categoriaEstado": "G",
            "codigoTrabajador": 25679,
            "estado": "R",
            "estadoGeneral": "R",
            "genero": "MASCULINO",
            "informacionEpis": [
                {
                    "epi": "BOTAS",
                    "icono": "https://iot.nalandaglobal.com/imagenes/desgloseEpis/botas.png"
                },
                {
                    "epi": "CASCO",
                    "icono": "https://iot.nalandaglobal.com/imagenes/desgloseEpis/casco.png"
                },
                {
                    "epi": "CHALECO",
                    "icono": "https://iot.nalandaglobal.com/imagenes/desgloseEpis/chaleco.png"
                },
                {
                    "epi": "GAFAS",
                    "icono": "https://iot.nalandaglobal.com/imagenes/desgloseEpis/gafas.png"
                },
                {
                    "epi": "GUANTES",
                    "icono": "https://iot.nalandaglobal.com/imagenes/desgloseEpis/guantes.png"
                }
            ],
            "informacionOficios": [
                {
                    "articulo": "150",
                    "color": "#0e4d0a",
                    "curso": "20H ALBAÑILERÍA",
                    "icono": "https://iot.nalandaglobal.com/media/img/oficios/obra/albanil.png",
                    "nombre": "Albañil",
                    "tipo": "CONSTRUCCION"
                },
                {
                    "articulo": "Metal",
                    "color": "#9e9e9e",
                    "curso": "20H Instalaciones, reparaciones, montajes, estruc. Metálica, cerrajería y\r\ncarp. Metálica",
                    "icono": "https://iot.nalandaglobal.com/media/img/oficios/obra/aluminio_pvc.png",
                    "nombre": "Carpintero Alumnio/Metal/PVC",
                    "tipo": "METAL"
                },
                {
                    "articulo": "Convenio metal",
                    "color": "#9e9e9e",
                    "curso": "20H Electricidad",
                    "icono": "https://iot.nalandaglobal.com/media/img/oficios/obra/electricista.png",
                    "nombre": "Electricista",
                    "tipo": "METAL"
                }
            ],
            "limpiadorJardinero": false,
            "nifTrabajador": "47274611C",
            "nombre": "SHELDON",
            "urlFoto": "https://iot.nalandaglobal.com/gestiona/trabajadores/doc/2/25679/25679_ope_DSC_foto_20190312_083\r\n8_1552376339419.jpg"
        }
    }
}

Workers documentation state by project

Description

Service to obtain worker information by providing the identifier of the site to which the worker is assigned.

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador-en-obra-token.action.

Operations

Trabajador-en-obra-token

Request:

{
	"request": {
		"nifTrabajador": "NIF",
		"idObra": "ID_NUMERICO_OBRA",
		"idDispositivo": "ID_DISPOSITIVO_ASIGNADO_A_OBRA"
	}
}

Request fields:

nifTrabajador: Nif of the worker
idObra: Identifier of the work site to which the worker is assigned
idDispositivo: Identifier of the device registered in the system

Response: Receives the same response as https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador-token.action

Workers documentation state by contractor

Description

Service for obtaining workers' information from a project

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajadores-de-obra-token.action.

Operations

Trabajadores-de-obra-token

Request:

{
	"request": {
		"idDispositivo": "ID_DISPOSITIVO_ASIGNADO_A_OBRA" 
	}
}

Request fields: idDispositivo: Identifier that the contract has in the Nalanda system.

Response: Receives a collection of elements similar to those obtained at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador-token.action containing the data of all the workers assigned to the contractors of the site associated to the device.

Workers documentation state by device

Description

Service for obtaining worker information from a project without documentation

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/datos-trabajadores-de-obra-token.action.

Operations

Datos-trabajadores-de-obra-token

Request:

{
	"request": {
		"idDispositivo": "ID_DISPOSITIVO_ASIGNADO_A_OBRA"
	}
}

Request fields: idDispositivo: Identifier that the contract has in the Nalanda system.

Response: Receives a collection of elements similar to those obtained at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajadores-de-obra-token.action containing the data of all the workers assigned to the contractors of the site associated to the device, but without all the information on the documents.

LEGACY SERVICES

Workers documentation state

Description

Services for the Control of Workers' Documentation State

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador.action.

Operations

Trabajador

Description: This service return the state of the documentation of the worker. The accreditation field in the worker's general information. It can have the following values:

● P: Blue, document pending validation (Pending).
● G: Green state (Suitable)
● O: Orange (Deficient)
● R: Red state (Unfit)
●
The GeneralGeneral state field in worker informationGeneral, can have the following values:
● P: Blue, document pending validation (Pending).
● G: Green state (Suitable)
● O: Orange (Deficient)
● R: Red state (Not suitable)

The worker's General information state field can have the following values:

● G: Green state (Suitable).
● R: Red state (Not suitable)
● A: state Green - (Permitted)
● D: state Red - (Denied)

Request:

{
  "userName" : "usuario",
  "password" : "contraseña",
  "request" : {
    "contrataId": "22960",
    "trabajadorNif" : "A123456",
    "trabajadorId" : "545123125"
  }
}

Request fields: userName: Portal user with permission to access the information.
password: Password of the user with permission to access the information.
trabajadorId : ID of the worker. Higher preference than nif.
trabajadorNif: Worker's id card. Lower preference than Id.
contrataId: Identifier that the contract has in the Obralia system.
idDispositivo: Identifier of the device registered in the system.

Response: Same response as https://iot.nalandaglobal.com/gestiona/obras/remote/trabajador-token.action

Workers documentation state by contractor

Description

Service for obtaining workers' information from a project

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/trabajadores-de-obra.action.

Operations

Trabajadores-de-obra

Request:

{
  "userName" : "thomas",
  "password" : "thomas",
  "request" : {
    "idObra" : "4519",
    "fotos" : "false"
  }
}

Request fields: userName: Portal user with permission to access the information.
password: Password of the user with permission to access the information.
idObra: Project Id of the worker to be searched
fotos: (true or false) Indicates if you want to receive the photos embedded in the json

Workers documentation state by device

Description

Service for obtaining worker information from a project without documentation

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/obras/remote/datos-trabajadores-de-obra.action.

Operations

Datos-trabajadores-de-obra

Request:

{
  "userName" : "thomas",
  "password" : "thomas",
  "request" : {
    "idObra" : "4519",
    "fotos" : "false"
  }
}

Response: Receives a collection of elements similar to those obtained at https://iot.nalandaglobal.com/gestiona/obras/remote/datos-trabajadores-de-obra-token.action containing the data of all the workers assigned to the contractors of the site associated to the device, but without all the information on the documents.

Relevant information on users and devices

In order for the services related to the access control of workers and machinery to work properly, it is necessary that some matching criteria between the user and the device are met.

Thus, the company to which the user belongs, who logs in and receives the security token, must be the same company as the owner of the device used in the rest of the requests.

In the same way the device, used in the rest of the requests, must be configured with the projects related to the same company of the user, who has logged in and received the security token. The configuration of the device with the related projects must be managed with a valid Nalanda interlocutor.