Skip to content
OnceForAll Developer Portal
onceforall.comContact

Project by clockings

Description

Service for obtaining projects associated with a clocking terminal.

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/fichaje/getObrasAsociadas.action.

Operations

GetObrasAsociadas

Request:

{
"idDispositivo": "TORNO_FICHAJE"
}

Request fields: idDispositivo: Device identifier registered in the system

Response:

{
    "resultadoObrasAsociadas": {
        "obraPorDefecto": {
            "cifPropietario": "C12345678",
            "codigoObra": "OBR-001",
            "descripcionObra": "Obra Pruebas 01",
            "idObra": 123456781
        },
        "obrasAsocidas": [
            {
                "cifPropietario": "C12345678",
                "codigoObra": "OBR-002",
                "descripcionObra": "Obra Pruebas 02",
                "idObra": 123456782
            },
            {
                "cifPropietario": "C12345678",
                "codigoObra": "OBR-003",
                "descripcionObra": "Obra Pruebas 03",
                "idObra": 123456783
            }
        ]
    }
}

Default project by clocking

Description

Service to change the default project on which a clocking terminal

URL

The URL of the production service is available at https://iot.nalandaglobal.com/gestiona/fichaje/establecerObraPorDefecto.action.

Operations

EstablecerObraPorDefecto

Request:

{
  "idDispositivo": "TORNO_FICHAJE",
  "idObra": 123456782
}

Request fields: idObra: Identifier of the work site to which the worker is assigned. idDevice Identifier of the device registered in the system. idDispositivo: Identifier of the device registered in the system

Response: Receives the same response as https://iot.nalandaglobal.com/gestiona/fichaje/getObrasAsociadas.action

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 correctly, 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, 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 partner from Nalanda