General Description

HTTP method	API version
POST	v1

Don’t forget to put the Authorization field in the header

API Path: /ActualCostProducts
or

Fields

The following fields are available:

Field Name	Type
id	Number
project_id	Number
project_pnr	Number
project_unr	Number
project_name	String
actualcostitem_id	Number
actualcostitem_nr1	String
actualcostitem_nr2	String
actualcostitem_description	String
actualcostitem_description_localized	String
employee_id	Number
employee_name	String
date	String
job_id	Number
job_code	String
job_name	String
product_id	Number
nr	String
description	String
quantity	Number
unit	String
unit_localized	String
price_unit	Number
price_total_without_margin	Number
margin	Number
price_total_with_margin	Number
working_on_time_and_expense_basis	Boolean
extra_work	Boolean
location	String
stocklocationid	Number
stocklocation	String
note	String
company_id	Number
invoiced	Boolean

/ActualCostProducts

API Path: /ActualCostProducts/

If everything succeeds the HTTP response status is 201
(201 CREATED)

If you forget to send the Authorization, the response status and code is 401
(401 Unauthorized)

For an explanation of all possible errors, please consult our section on possible answers to API calls here

Examples:

https://ra.bouwsoft.be/api/v1/ActualCostProducts

with the following parameters :

Header Parameters :
ParameterName: Clientnr, ParameterValue: 115
ParameterName: AccessToken, ParameterValue: PUmfWxfmIkzSfGrjDfzRqlIIflVjfGPDfktkzPOrPrOGkGtAlk

Query Parameters :
ParameterName: columns, ParameterValue: project_id=3149,company_id=1,product_id=2809432,quantity=10

Success gives statuscode 201 And the following result

{“RecordChanges”: [
  {
    "id": 6215,
    "project_id": 3149,
    "project_pnr": 2013086,
    "project_unr": 1275,
    "project_name": "Schilderen van API blokjes",
    "actualcostitem_id": 2576,
    "actualcostitem_nr1": "",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Volledig Project",
    "actualcostitem_description_localized": "Complete project",
    "employee_id": 0,
    "employee_name": "",
    "date": "2025–02–12",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 2809432,
    "nr": "190165",
    "description": "Tegels Citroengeel 40*60",
    "quantity": 10,
    "unit": "st.",
    "unit_localized": "pc.",
    "price_unit": 12.35,
    "price_total_without_margin": 123.5,
    "margin": 20,
    "price_total_with_margin": 148.199999999999989,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 0,
    "stocklocation": "",
    "note": "",
    "company_id": 1,
    "invoiced": false
  }
]
}

https://ra.bouwsoft.be/api/v1/ActualCostProducts

with the following parameters :

Header Parameters :
ParameterName: Clientnr, ParameterValue: 115
ParameterName: AccessToken, ParameterValue: PUmfWxfmIkzSfGrjDfzRqlIIflVjfGPDfktkzPOrPrOGkGtAlk

Query Parameters :
ParameterName: columns, ParameterValue: project_id=3149,product_id=2809432,quantity=10

Success gives statuscode 201 And the following result

{“RecordChanges”: [
  {
    "id": 6216,
    "project_id": 3149,
    "project_pnr": 2013086,
    "project_unr": 1275,
    "project_name": "Schilderen van API blokjes",
    "actualcostitem_id": 2576,
    "actualcostitem_nr1": "",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Volledig Project",
    "actualcostitem_description_localized": "Complete project",
    "employee_id": 0,
    "employee_name": "",
    "date": "2025–02–12",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 2809432,
    "nr": "190165",
    "description": "Tegels Citroengeel 40*60",
    "quantity": 10,
    "unit": "st.",
    "unit_localized": "pc.",
    "price_unit": 12.35,
    "price_total_without_margin": 123.5,
    "margin": 20,
    "price_total_with_margin": 148.199999999999989,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 0,
    "stocklocation": "",
    "note": "",
    "company_id": 2,
    "invoiced": false
  }
]
}

https://ra.bouwsoft.be/api/v1/ActualCostProducts

with the following parameters :

Header Parameters :
ParameterName: Clientnr, ParameterValue: 115
ParameterName: AccessToken, ParameterValue: OAtfWxfrDUzSfPAOUfzRqrlffkkjfGOlfrAkzmIVPfmGllGPDP

Query Parameters :
ParameterName: columns, ParameterValue: project_id=3038,product_id=2789553,unit=’lm’,quantity=2,stocklocationid=1

Success gives statuscode 201 And the following result

{“RecordChanges”: [
  {
    "id": 6217,
    "project_id": 3038,
    "project_pnr": 2013063,
    "project_unr": 1307,
    "project_name": "Groensoft - 2024 - M.05",
    "actualcostitem_id": 2369,
    "actualcostitem_nr1": "",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Volledig Project",
    "actualcostitem_description_localized": "Complete project",
    "employee_id": 0,
    "employee_name": "",
    "date": "2025–02–12",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 2789553,
    "nr": "H.018",
    "description": "Panlat gedrenkt 24x38 Lengte 4,20Lm",
    "quantity": 2,
    "unit": "lm",
    "unit_localized": "rm",
    "price_unit": 0.32,
    "price_total_without_margin": 0.64,
    "margin": 23.25,
    "price_total_with_margin": 0.79,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 1,
    "stocklocation": "Magazijn",
    "note": "",
    "company_id": 2,
    "invoiced": false
  }
]
}

https://ra.bouwsoft.be/api/v1/ActualCostProducts

with the following parameters :

Header Parameters :
ParameterName: Clientnr, ParameterValue: 115
ParameterName: AccessToken, ParameterValue: OAtfWxfrDUzSfPAOUfzRqrlffkkjfGOlfrAkzmIVPfmGllGPDP

Query Parameters :
ParameterName: columns, ParameterValue: project_id=3038,product_id=2789553,unit=’lm’,quantity=2,stocklocationid=5

Success gives statuscode 201 And the following result

{“RecordChanges”: [
  {
    "id": 6218,
    "project_id": 3038,
    "project_pnr": 2013063,
    "project_unr": 1307,
    "project_name": "Groensoft - 2024 - M.05",
    "actualcostitem_id": 2369,
    "actualcostitem_nr1": "",
    "actualcostitem_nr2": "",
    "actualcostitem_description": "Volledig Project",
    "actualcostitem_description_localized": "Complete project",
    "employee_id": 0,
    "employee_name": "",
    "date": "2025–02–12",
    "job_id": 0,
    "job_code": "",
    "job_name": "",
    "product_id": 2789553,
    "nr": "H.018",
    "description": "Panlat gedrenkt 24x38 Lengte 4,20Lm",
    "quantity": 2,
    "unit": "lm",
    "unit_localized": "rm",
    "price_unit": 0.32,
    "price_total_without_margin": 0.64,
    "margin": 23.25,
    "price_total_with_margin": 0.79,
    "working_on_time_and_expense_basis": false,
    "extra_work": false,
    "location": "Werf",
    "stocklocationid": 5,
    "stocklocation": "Depot 2",
    "note": "",
    "company_id": 2,
    "invoiced": false
  }
]
}