Human resources

Read human resource

GET https://api.sengerio.com/v1/human-resource

Parameters

NameTypeRequiredDefaultNotes
idintegerYesHuman resource Id

 

Example response

{
    "success": true,
    "data": {
        "id": 4592,
        "prog": 18,
        "additional_code": "FRRMRZ68S15I726S",
        "name": "Maurizio",
        "surname": "Ferrari",
        "address": "Viale Sardegna 14",
        "city": "Siena",
        ...
        "leaveRequests": [
           {
              "id": 7456,
              "date_from": "2018-07-21 08:00:00",
              "date_to": "2018-07-22 19:00:00",
              "type": "annual leave",
              "craetd_at": "2018-06-19 08:35:00"
              "processeD_on": "2018-06-20 10:55:00"
              "status": "Accepted"
           },
           {
              ...
           },
           ...
        ],
        "contracts": [
           {
              "id": 63245,
              "contract_type": "Driver",
              "date_from": "2016-10-21 00:00:00",
              "date_to": null,
              "first_contract": true,
              ...
           },
           {
              ...
           },
           ...
        ],
        "documents": [
           {
              "id": 63245,
              "document": "Driving license",
              "number": null,
              "issued_by": null,
              "issued_on": null,
              "expire_date": "2018-08-04",
              "status": "Activated",
              ...
           },
           {
              ...
           },
           ...
        ],
        "suitabilities": [
           {
              "id": 63245,
              "note": "...",
              "valid_from": "2017-10-21",
              "valid_to": "2018-10-21",
              "suitability_type": "B2"
           },
           {
              ...
           },
           ...
        ],
        "advances": [
           {
              "id": 63245,
              "date": "2018-05-20",
              "amount": "200.00",
              "description": null
           },
           {
              ...
           },
           ...
        ]
   ]
}

Write human resource

POST https://api.sengerio.com/v1/human-resource
Parameters

NameTypeRequiredNotes
dto_node_namestringYesValue = HumanResources.HumanResource
datajsonYesHuman resource part with id and updated_at is mandatory. “U” key means Update, “C” key is for Create.  Datetime and number values must be written in the standard format (yyyy-mm-dd for dates and 10.30 for numbers).


Example request (update address and telephone of human resource)

 
   "dto_node_name": "HumanResources.HumanResource",
   "data": [
       {
          "HumanResources.HumanResource": {
             "U": [
                 {
                    "id": 712841,
                    "updated_at": 1501843214,
                    "tel_1": "+393331234567",
                    "address": "Viale Sardegna 14",
                    "city": "Siena"
                 }
             ]
          }
       }
    ]


Human resource creation example request

    
    "dto_node_name": "HumanResources.HumanResource",
    "data": [
       {
          "HumanResources.HumanResource": {
             "C": [
                 {
                    "id": -1,
                    "name": "Maurizio",
                    "surname": "Ferrari",
                    "status": "Active",
                    "job_title": "Driver"
                 }
             ]
          },
         "HumanResources.Contract": {
             "C": [
                 {
                    "id": -1,
                    "contract_type": "Default",
                    "first_contract": true,
                    "humanResourceId": -1
                 }
             ]
          }
       }
    ]

Request drivers activities

GET https://api.sengerio.com/v1/driver-activities

Parameters

NameTypeRequiredDefaultNotes
filterjsonYesSet of properties to filter in an AND clause. For each property select the operator (gt: greather than; lt: less than; eq: equals) and the value to filter. Datetime and number values must be written in the standard format (yyyy-mm-dd for dates and 10.30 for numbers).

[
  {
    "property":"start",
    "operator":"gt",
    "value":"2018-06-27"
  },
  {
    "property":"finish",
    "operator":"lt",
    "value":"2018-06-29"
  }
]
sortjsonNoProperty name and sort direction (ASC or DESC) on which sort the result.

[
  {
    "property":"start",
    "direction":"ASC"
  }  
]
startintegerNo1Initial row
limitintegerNo25Number of rows per page.


Example response

{
    "success": true,
    "total": 9,
    "rows": [ 
      {
        "id": 1162261,
        "presence_start": "2018-06-28 09:35:00",
        "presence_finish": "2018-06-28 11:40:00",
        "driving_time_hours": 2,
        "driving_time_minutes": 5,
        "additional_duty_code": null,
        "booking_id": 559140,
        "number": "104",
        "business_partner_id": 62276,
        "customer": "Blue Travel Group",
        "vehicle_code": "02 SPRINT",
        "start_duty": "2018-06-28 09:45:00",
        "finish_duty": "2018-06-28 11:45:00",
        "code": "1.1 A",
        "start_location": "Brooklyn",
        "finish_location": "JFK",
        "surname_name": "Tim Seal",
        "driver_id": 24
        ...
     },
     {
        "id": 1162261,
        "presence_start": "2018-06-28 10:00:00",
        ...
     } 
   ]
}

Request absences

GET https://api.sengerio.com/v1/absences

Parameters

NameTypeRequiredDefaultNotes
filterjsonYesSet of properties to filter in an AND clause. For each property select the operator (gt: greather than; lt: less than; eq: equals) and the value to filter. Datetime and number values must be written in the standard format (yyyy-mm-dd for dates and 10.30 for numbers).

[
  {
    "property":"date_from",
    "operator":"gt",
    "value":"2018-06-25"
  },
  {
    "property":"date_to",
    "operator":"lt",
    "value":"2018-06-30"
  }
]
sortjsonNoProperty name and sort direction (ASC or DESC) on which sort the result.

[
  {
    "property":"date_from",
    "direction":"ASC"
  }  
]
startintegerNo1Initial row
limitintegerNo25Number of rows per page.


Example response

{
    "success": true,
    "total": 2,
    "rows": [ 
      {
        "id": 621231,
        "date_from": "2018-06-26 12:00:00",
        "date_to": "2018-06-29 23:59:00",
        "type": "annual leave",
        "surname_name": "Padgett Stephen H.",
        ...
     },
     {
        "id": 621106,
        "date_from": "2018-06-27 09:00:00",
        "date_to": "2018-06-27 14:30:00",
        "type": "rest",
        "surname_name": "Guerrero Andrew C.",
        ...
     } 
   ]
}
More Questions?

We're happy to help! Get in touch