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": "21/07/18 08:00",
              "date_to": "22/07/18 19:00",
              "type": "annual leave",
              "craetd_at": "19/06/18 08:35"
              "processeD_on": "20/06/18 10:55"
              "status": "Accepted"
           },
           {
              ...
           },
           ...
        ],
        "contracts": [
           {
              "id": 63245,
              "contract_type": "Driver",
              "date_from": "21/10/16 09:00",
              "date_to": null,
              "first_contract": true,
              ...
           },
           {
              ...
           },
           ...
        ],
        "documents": [
           {
              "id": 63245,
              "document": "Driving license",
              "number": null,
              "issued_by": null,
              "issued_on": null,
              "expire_date": "04/08/18",
              "status": "Activated",
              ...
           },
           {
              ...
           },
           ...
        ],
        "suitabilities": [
           {
              "id": 63245,
              "note": "...",
              "valid_from": "21/10/17 09:00",
              "valid_to": "21/10/18 23:59",
              "suitability_type": "B2"
           },
           {
              ...
           },
           ...
        ],
        "advances": [
           {
              "id": 63245,
              "date": "20/05/18",
              "amount": "200 USD",
              "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 locale format according to the Sengerio account.


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 locale format according to the Sengerio account.

[
  {
    "property":"start_duty",
    "operator":"gt",
    "value":"6/27/18"
  },
  {
    "property":"finish_duty",
    "operator":"lt",
    "value":"6/29/18"
  }
]
sortjsonNoProperty name and sort direction (ASC or DESC) on which sort the result.

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


Example response

{
    "success": true,
    "total": 9,
    "rows": [ 
      {
        "id": 1162261,
        "presence_start": "6/28/18 9:35 AM",
        "presence_finish": "6/28/18 11:40 AM",
        "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": "6/28/18 9:45 AM",
        "finish_duty": "6/28/18 11:45 AM",
        "code": "1.1 A",
        "start_location": "Brooklyn",
        "finish_location": "JFK",
        "surname_name": "Tim Seal",
        "driver_id": 24
        ...
     },
     {
        "id": 1162261,
        "presence_start": "6/28/18 10:00 AM",
        ...
     } 
   ]
}

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 locale format according to the Sengerio account.

[
  {
    "property":"date_from",
    "operator":"gt",
    "value":"6/25/18"
  },
  {
    "property":"date_to",
    "operator":"lt",
    "value":"6/30/18"
  }
]
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": "6/26/18 12:00 PM",
        "date_to": "6/29/18 11:59 PM",
        "type": "annual leave",
        "surname_name": "Padgett Stephen H.",
        ...
     },
     {
        "id": 621106,
        "date_from": "6/27/18 9:00 AM",
        "date_to": "6/27/18 2:30 PM",
        "type": "rest",
        "surname_name": "Guerrero Andrew C.",
        ...
     } 
   ]
}