General Description

HTTP method	API version
PUT	v1

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

API Path: /PurchaseInvoices/{id}

You make this API call with the key field id as the path parameter (the id of the PurchaseInvoice you want to update)

Fields

The following fields are available:

Field Name	Type
id	Number
basis1	Number
amountexclvat1	Number
taxableamount1	Number
vatamount1	Number
amountinclvat1	Number
amountexclvat_total	Number
vatamount_total	Number
amountinclvat_total	Number
amountoutstanding	Number
ts_lastupdate	String
expirationdate	String
paymentnotification	String
commercialdiscount	Number
cashdiscount	Number
cashdiscount_amount	Number
cashdiscount_approved	Boolean
totalsbasedonvatcodebreakdown	Boolean
amountpaid	Number

/PurchaseInvoices/{id}

If everything succeeds the HTTP response status is 200
(200 OK)

If there is something wrong with the request, the response status and code is 400
(400 Bad Request)

If there is no record that has the requested id the HTTP response status and code is 404
(404 Not found)

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

If what you sent can’t be processed, the response status is 500
(500 Internal Server Error)

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/PurchaseInvoices/884

with the following parameters :

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

Query Parameters :
ParameterName: columns, ParameterValue: basis1=110

Success gives statuscode 200 And the following result

{“RecordChanges”: [
  {
    "id": 884,
    "basis1": 110.0,
    "amountexclvat1": 110.0,
    "taxableamount1": 110.0,
    "vatamount1": 23.100000000000001,
    "amountinclvat1": 133.099999999999994,
    "amountexclvat_total": 110.0,
    "vatamount_total": 23.100000000000001,
    "amountinclvat_total": 133.099999999999994,
    "amountoutstanding": 133.099999999999994,
    "ts_lastupdate": "2025–02–12 14:34:52"
  }
]
}

https://ra.bouwsoft.be/api/v1/PurchaseInvoices/885

with the following parameters :

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

Query Parameters :
ParameterName: columns, ParameterValue: amountexclvat_total=110,vatamount_total=23.1

Success gives statuscode 200 And the following result

{“RecordChanges”: [
  {
    "id": 885,
    "amountexclvat_total": 110.0,
    "vatamount_total": 23.100000000000001,
    "amountinclvat_total": 133.099999999999994,
    "amountoutstanding": 133.099999999999994,
    "ts_lastupdate": "2025–02–12 14:34:53"
  }
]
}

https://ra.bouwsoft.be/api/v1/PurchaseInvoices/884

with the following parameters :

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

Query Parameters :
ParameterName: columns, ParameterValue: paymentnotification=’000/0005/13490‘,expirationdate=’2017–04–21’,commercialdiscount=5,cashdiscount=3,basis1=150.55,cashdiscount_amount=4.8,cashdiscount_approved=True,paid=True

Success gives statuscode 200 And the following result

{“RecordChanges”: [
  {
    "id": 884,
    "expirationdate": "2017–04–21",
    "paymentnotification": "000000513490",
    "commercialdiscount": 5,
    "cashdiscount": 3.356115,
    "cashdiscount_amount": 4.8,
    "cashdiscount_approved": true,
    "basis1": 150.550000000000011,
    "amountexclvat1": 143.02000000000001,
    "taxableamount1": 138.219999999999999,
    "vatamount1": 29.030000000000001,
    "amountinclvat1": 172.050000000000011,
    "totalsbasedonvatcodebreakdown": true,
    "amountexclvat_total": 150.550000000000011,
    "vatamount_total": 29.030000000000001,
    "amountinclvat_total": 172.050000000000011,
    "amountpaid": 167.25,
    "ts_lastupdate": "2025–02–12 14:28:58"
  }
]
}