Add Bookedhours

post https://api.next-tech.com/v1/bookedhours/

Body Params

workorderid

integer | null

WorkOrder for this time

absenceprojectid

integer | null

A non-null value defines project for this absence time. Used with piecework.

activitycode

string | null

The type of activity this record is associated with. Used with budget and forecast.

allowancequantity

number | null

Allowance quantity

allowanceunitcost

number | null

Cost per allowance unit

allowanceunitprice

number | null

Price per allowance unit

breaktime

number | null

Defaults to 0

Breaktime when using timestamps

date

required

Date to which this record belongs

debit

boolean

Defaults to true

If this record should be invoiced

diarynote

string | null

Description/Note field for the row

hours

number

required

Number of hours

locationcode

string | null

The specific location this record is associated with. Used with budget and forecast.

piecework

boolean

Defaults to false

For filtering purpose on some larger companies using PieceWork

professionitemid

integer

required

Profession of the user for this time record

projectid

integer

required

Project for this record

salarytransferdate

date-time | null

Timestamp when salarytransfer was made

starttime

string | null

Timestamp when work started, only used when work timestamps are in use

travelondutycost

number | null

Cost of travel (per km) on duty

travelondutykm

number | null

Distance traveled (km) on duty

travelondutyprice

number | null

Price of travel (per km) on duty

travelprivatecost

number | null

Cost of private travel (per km)

travelprivatekm

number | null

Private travel (km)

travelprivateprice

number | null

Price of travel (per km)

userid

integer

required

User for this record

Responses

Response body

object

integer

required

Id of record, used as primary key when looking up items using the API

changed

date-time

required

Timestamp of the last time the object was modified

changeduserid

integer

required

The Id of the user that last made changes to the object

created

date-time

required

Timestamp of when the object was first created

createduserid

integer

required

The Id of the user that first created the object

addition

boolean

If the associated work order is an AWO

workorderid

integer | null

WorkOrder for this time

workordername

string | null

The name of associated work order

workorderno

integer | null

The WorkOrderNo of the associated work order

absenceprojectid

integer | null

A non-null value defines project for this absence time. Used with piecework.

absenceprojectname

string | null

Project name of associated absence project. Used with piecework.

absenceprojectno

string | null

Project number of associated absence project. Used with piecework.

activitycode

string | null

The type of activity this record is associated with. Used with budget and forecast.

allowancequantity

number | null

Allowance quantity

allowanceunitcost

number | null

Cost per allowance unit

allowanceunitprice

number | null

Price per allowance unit

approved

boolean

Defaults to false

Make the article selectable from Mobile devices

attested

boolean

required

If the associated work order is an AWO

attestfullname

string | null

The full name of the user that attested these hours

attesttime

date-time | null

The datetime when these hours were attested

attestuserid

integer | null

The Id of the user that first created the object

breaktime

number | null

Defaults to 0

Breaktime when using timestamps

costcenterid

integer | null

The Id of the cost center assigned to the associated project.

costunit

number

required

Internal cost of the time from pricelist

customerid

integer | null

The Id of the (from work order or project) associated customer

date

required

Date to which this record belongs

debit

boolean

Defaults to true

If this record should be invoiced

diarynote

string | null

Description/Note field for the row

employeeno

string | null

Employee number, same as used in salary program

employmentcontractid

integer | null

The Id of the referenced Employment contract

employmenttypeid

integer | null

The Id of the referenced Employment type

fullname

string

required

length ≤ 50

The full name of the user

hours

number

required

Number of hours

invoiced

boolean

required

If the booked hours has been invoiced

invoiceid

integer | null

The id of the associated invoice, if any

invoicenumber

string | null

Invoice number of the associated customer invoice

isabsence

boolean

Defaults to false

If referenced project is the absence project selected in company settings.

lastsalarydocumentexportsystem

string | null

The salary system this export was for

lastsalarydocumentexporttime

date-time | null

The datetime when these hours were exported to an external salary system

locationcode

string | null

The specific location this record is associated with. Used with budget and forecast.

locked

boolean

required

Locked for editing. E.g. if the booked hours has been invoiced

piecework

boolean

Defaults to false

For filtering purpose on some larger companies using PieceWork

priceunit

number

required

Price/unit from pricelist

professionaccountno

string

required

length ≤ 5

AccountNo from the profession record

professioncode

string

required

length ≤ 20

Code of professionitem

professionitemid

integer

required

Profession of the user for this time record

professionsalaryno

string | null

Sometimes referred to as a salary code, wage code or time code. Identifies the type of salary.

projectid

integer

required

Project for this record

projectmanagername

string

required

length ≤ 50

The full name of the project manager assigned to the associated project

projectname

string

required

length ≤ 50

The name of the referenced project

projectno

string

required

length ≤ 10

The number of the associated project

salarytransferdate

date-time | null

Timestamp when salarytransfer was made

starttime

string | null

Timestamp when work started, only used when work timestamps are in use

stoptime

string | null

Timestamp when work stopped, only used when work timestamps are in use

totalcost

number

required

Hours * CostUnit

totalrevenue

number

required

Hours * PriceUnit

travelondutycost

number | null

Cost of travel (per km) on duty

travelondutykm

number | null

Distance traveled (km) on duty

travelondutyprice

number | null

Price of travel (per km) on duty

travelprivatecost

number | null

Cost of private travel (per km)

travelprivatekm

number | null

Private travel (km)

travelprivateprice

number | null

Price of travel (per km)

userid

integer

required

User for this record

Language

Credentials

OAuth2

URL


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://api.next-tech.com/v1/bookedhours/ \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "breaktime": 0,
8
  "debit": true,
9
  "piecework": false
10
}
11
'


xxxxxxxxxx
65
}
1
{
2
  "id": 5,
3
  "changed": "2025-04-12T13:32:15.559Z",
4
  "changeduserid": 7,
5
  "created": "2025-04-12T13:32:15.559Z",
6
  "createduserid": 3,
7
  "addition": false,
8
  "workorderid": 1234,
9
  "workordername": "Side building",
10
  "workorderno": 1,
11
  "absenceprojectid": 1234,
12
  "absenceprojectname": "Bridge maintenance, example lane 55",
13
  "absenceprojectno": "12345",
14
  "activitycode": "3",
15
  "allowancequantity": 20,
16
  "allowanceunitcost": 200,
17
  "allowanceunitprice": 300,
18
  "approved": false,
19
  "attested": false,
20
  "attestfullname": "Christopher Coppola",
21
  "attesttime": "2022-05-01 22:00:00",
22
  "attestuserid": 3,
23
  "breaktime": 0.5,
24
  "costcenterid": 123,
25
  "costunit": 2499.5,

200Successful Response

422Validation Error