Skip to main content

Actions

The ballerinax/sap.businessone.fixedassets package exposes the following clients:

Available clients:

ClientPurpose
ClientManage fixed asset objects of the SAP Business One Service Layer — asset master data, capitalization, retirement, transfers, revaluations, and depreciation configuration.

Client

The Client provides access to every fixed asset object exposed by the SAP Business One Service Layer — asset capitalization, capitalization credit memos, manual depreciation, retirement, transfer, revaluation, master data (asset classes, asset groups, depreciation groups), depreciation configuration (depreciation types, type pools, areas), FA account determinations, and fixed asset item balances.

Configuration

SessionConfig

SAP Business One Service Layer session credentials, passed as the first argument to the client initializer.

FieldTypeDefaultDescription
companyDbstringRequiredThe SAP Business One company database to log in to
usernamestringRequiredThe Service Layer user name
passwordstringRequiredThe Service Layer user password

ConnectionConfig

Provides a set of configurations for controlling the behaviours when communicating with the Service Layer HTTP endpoint. Passed as the optional second argument to the client initializer.

FieldTypeDefaultDescription
httpVersionhttp:HttpVersionhttp:HTTP_2_0The HTTP version understood by the client
http1Settingshttp:ClientHttp1SettingsConfigurations related to HTTP/1.x protocol
http2Settingshttp:ClientHttp2SettingsConfigurations related to HTTP/2 protocol
timeoutdecimal30The maximum time to wait (in seconds) for a response before closing the connection
forwardedstring"disable"The choice of setting forwarded/x-forwarded header
followRedirectshttp:FollowRedirectsOptionalConfigurations associated with redirection
poolConfighttp:PoolConfigurationOptionalConfigurations associated with request pooling
cachehttp:CacheConfigHTTP caching related configurations
compressionhttp:Compressionhttp:COMPRESSION_AUTOSpecifies the way of handling compression (accept-encoding) header
circuitBreakerhttp:CircuitBreakerConfigOptionalConfigurations associated with the behaviour of the Circuit Breaker
retryConfighttp:RetryConfigOptionalConfigurations associated with retrying
cookieConfighttp:CookieConfigOptionalConfigurations associated with cookies
responseLimitshttp:ResponseLimitConfigsConfigurations associated with inbound response size limits
secureSockethttp:ClientSecureSocketOptionalSSL/TLS-related options
proxyhttp:ProxyConfigOptionalProxy server related options
socketConfighttp:ClientSocketConfigProvides settings related to client socket configuration
validationbooleantrueEnables the inbound payload validation functionality provided by the constraint package
laxDataBindingbooleantrueEnables relaxed data binding on the client side, treating nil values and absent fields as optional

The client also accepts a serviceUrl string parameter — the base URL of the target Service Layer instance — which defaults to https://localhost:50000/b1s/v1.

Initializing the client

import ballerinax/sap.businessone;
import ballerinax/sap.businessone.fixedassets;

businessone:SessionConfig session = {
companyDb: "SBODemoUS",
username: "manager",
password: "<password>"
};

fixedassets:Client client = check new (session, serviceUrl = "https://<host>:50000/b1s/v1");

Operations

Asset Capitalization

listAssetCapitalization

Query the AssetCapitalization collection.

Parameters:

NameTypeRequiredDescription
headersListAssetCapitalizationHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100 to control server-side paging
queriesListAssetCapitalizationQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetCapitalizationCollectionResponse&#124;error

Sample code:

AssetCapitalizationCollectionResponse response = check client->listAssetCapitalization(
queries = {dollarTop: 20, dollarOrderby: "DocEntry desc"}
);

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetCapitalization",
"value": [
{
"DocEntry": 191,
"DocNum": 191,
"Series": 3,
"PostingDate": "2026-07-01",
"Status": "adsPosted",
"DocumentType": "adtOrdinaryDepreciation",
"DepreciationArea": "10"
}
],
"odata.nextLink": "AssetCapitalization?$skip=20"
}
createAssetCapitalization

Create a new AssetDocument in the AssetCapitalization collection.

Parameters:

NameTypeRequiredDescription
payloadAssetDocumentYesThe asset capitalization document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDocument&#124;error

Sample code:

AssetDocument created = check client->createAssetCapitalization({
PostingDate: "2026-07-01",
DocumentDate: "2026-07-01",
Remarks: "Capitalization of new forklift",
DepreciationArea: "10",
AssetDocumentLineCollection: [
{AssetNumber: "100002", Quantity: 1, TotalLC: 18500.00, DepreciationArea: "10"}
]
});

Sample response:

{
"DocEntry": 191,
"DocNum": 191,
"Series": 3,
"PostingDate": "2026-07-01",
"DocumentDate": "2026-07-01",
"Status": "adsPosted",
"Remarks": "Capitalization of new forklift",
"DepreciationArea": "10",
"AssetDocumentLineCollection": [
{"DocEntry": 191, "LineNumber": 0, "AssetNumber": "100002", "Quantity": 1, "TotalLC": 18500.00, "DepreciationArea": "10"}
]
}
getAssetCapitalization

Get a single AssetDocument in the AssetCapitalization collection by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetCapitalizationQueriesNoOData query options: $expand, $select

Returns: AssetDocument&#124;error

Sample code:

AssetDocument doc = check client->getAssetCapitalization(191);

Sample response:

{
"DocEntry": 191,
"DocNum": 191,
"Series": 3,
"PostingDate": "2026-07-01",
"DocumentDate": "2026-07-01",
"Status": "adsPosted",
"Remarks": "Capitalization of new forklift",
"DepreciationArea": "10",
"AssetDocumentLineCollection": [
{"DocEntry": 191, "LineNumber": 0, "AssetNumber": "100002", "Quantity": 1, "TotalLC": 18500.00, "DepreciationArea": "10"}
]
}
deleteAssetCapitalization

Delete an AssetDocument from the AssetCapitalization collection.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetCapitalization(191);
updateAssetCapitalization

Partially update an AssetDocument in the AssetCapitalization collection (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetDocumentYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetCapitalization(191, {Remarks: "Updated remarks"});
assetCapitalizationServiceCancel

Cancel an asset capitalization document.

Parameters:

NameTypeRequiredDescription
payloadAssetCapitalizationService_Cancel_bodyYesCancellation parameters wrapping an AssetDocumentParams object
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->assetCapitalizationServiceCancel({
assetDocumentParams: {docEntry: 191, cancellationOption: "coByCurrentSystemDate"}
});
assetCapitalizationServiceGetList

Get the list of asset capitalization document parameters available for cancellation.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_1&#124;error

Sample code:

inline_response_200_1 list = check client->assetCapitalizationServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetCapitalizationService_GetList",
"value": [
{"DocEntry": 191, "CancellationOption": "coByCurrentSystemDate"}
]
}

Asset Capitalization Credit Memos

listAssetCapitalizationCreditMemo

Query the AssetCapitalizationCreditMemo collection.

Parameters:

NameTypeRequiredDescription
headersListAssetCapitalizationCreditMemoHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetCapitalizationCreditMemoQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetCapitalizationCreditMemoCollectionResponse&#124;error

Sample code:

AssetCapitalizationCreditMemoCollectionResponse response =
check client->listAssetCapitalizationCreditMemo(queries = {dollarTop: 20});

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetCapitalizationCreditMemo",
"value": [
{
"DocEntry": 44,
"DocNum": 44,
"PostingDate": "2026-06-15",
"Status": "adsPosted",
"DocumentType": "adtOrdinaryDepreciation",
"DepreciationArea": "10"
}
]
}
createAssetCapitalizationCreditMemo

Create a new AssetDocument in the AssetCapitalizationCreditMemo collection.

Parameters:

NameTypeRequiredDescription
payloadAssetDocumentYesThe capitalization credit memo document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDocument&#124;error

Sample code:

AssetDocument created = check client->createAssetCapitalizationCreditMemo({
PostingDate: "2026-06-15",
DocumentDate: "2026-06-15",
Remarks: "Correction for over-capitalized forklift",
DepreciationArea: "10",
AssetDocumentLineCollection: [
{AssetNumber: "100002", Quantity: 1, TotalLC: -500.00, DepreciationArea: "10"}
]
});

Sample response:

{
"DocEntry": 44,
"DocNum": 44,
"PostingDate": "2026-06-15",
"DocumentDate": "2026-06-15",
"Status": "adsPosted",
"Remarks": "Correction for over-capitalized forklift",
"DepreciationArea": "10"
}
getAssetCapitalizationCreditMemo

Get a single AssetDocument in the AssetCapitalizationCreditMemo collection by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetCapitalizationCreditMemoQueriesNoOData query options: $expand, $select

Returns: AssetDocument&#124;error

Sample code:

AssetDocument doc = check client->getAssetCapitalizationCreditMemo(44);

Sample response:

{
"DocEntry": 44,
"DocNum": 44,
"PostingDate": "2026-06-15",
"Status": "adsPosted",
"Remarks": "Correction for over-capitalized forklift",
"DepreciationArea": "10"
}
deleteAssetCapitalizationCreditMemo

Delete an AssetDocument from the AssetCapitalizationCreditMemo collection.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetCapitalizationCreditMemo(44);
updateAssetCapitalizationCreditMemo

Partially update an AssetDocument in the AssetCapitalizationCreditMemo collection (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetDocumentYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetCapitalizationCreditMemo(44, {Remarks: "Revised remarks"});
assetCapitalizationCreditMemoServiceCancel

Cancel an asset capitalization credit memo document.

Parameters:

NameTypeRequiredDescription
payloadAssetCapitalizationCreditMemoService_Cancel_bodyYesCancellation parameters wrapping an AssetDocumentParams object
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->assetCapitalizationCreditMemoServiceCancel({
assetDocumentParams: {docEntry: 44, cancellationOption: "coByCurrentSystemDate"}
});
assetCapitalizationCreditMemoServiceGetList

Get the list of asset capitalization credit memo document parameters available for cancellation.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200&#124;error

Sample code:

inline_response_200 list = check client->assetCapitalizationCreditMemoServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetCapitalizationCreditMemoService_GetList",
"value": [
{"DocEntry": 44, "CancellationOption": "coByCurrentSystemDate"}
]
}

Asset Classes

listAssetClasses

Query the AssetClasses collection.

Parameters:

NameTypeRequiredDescription
headersListAssetClassesHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetClassesQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetClassesCollectionResponse&#124;error

Sample code:

AssetClassesCollectionResponse response = check client->listAssetClasses();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetClasses",
"value": [
{"Code": "VEHICLES", "Description": "Company Vehicles", "AssetType": "atAssetTypeGeneral"}
]
}
createAssetClasses

Create a new AssetClass.

Parameters:

NameTypeRequiredDescription
payloadAssetClassYesThe asset class to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetClass&#124;error

Sample code:

AssetClass created = check client->createAssetClasses({
Code: "VEHICLES",
Description: "Company Vehicles",
AssetType: "atAssetTypeGeneral",
AssetClassCollection: [
{DepreciationAreaID: "10", DepreciationTypeID: "STR-5Y", UseLife: 60, ActiveStatus: "tYES"}
]
});

Sample response:

{
"Code": "VEHICLES",
"Description": "Company Vehicles",
"AssetType": "atAssetTypeGeneral",
"AssetClassCollection": [
{"Code": "VEHICLES", "LineNumber": 0, "DepreciationAreaID": "10", "DepreciationTypeID": "STR-5Y", "UseLife": 60, "ActiveStatus": "tYES"}
]
}
getAssetClasses

Get a single AssetClass by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetClassesQueriesNoOData query options: $expand, $select

Returns: AssetClass&#124;error

Sample code:

AssetClass assetClass = check client->getAssetClasses("VEHICLES");

Sample response:

{
"Code": "VEHICLES",
"Description": "Company Vehicles",
"AssetType": "atAssetTypeGeneral"
}
deleteAssetClasses

Delete an AssetClass.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetClasses("VEHICLES");
updateAssetClasses

Partially update an AssetClass (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadAssetClassYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetClasses("VEHICLES", {Description: "Fleet Vehicles"});
assetClassesServiceGetList

Get the list of asset class parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_2&#124;error

Sample code:

inline_response_200_2 list = check client->assetClassesServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetClassesService_GetList",
"value": [
{"Code": "VEHICLES", "Description": "Company Vehicles"}
]
}

Asset Depreciation Groups

listAssetDepreciationGroups

Query the AssetDepreciationGroups collection.

Parameters:

NameTypeRequiredDescription
headersListAssetDepreciationGroupsHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetDepreciationGroupsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetDepreciationGroupsCollectionResponse&#124;error

Sample code:

AssetDepreciationGroupsCollectionResponse response = check client->listAssetDepreciationGroups();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetDepreciationGroups",
"value": [
{"Code": "MACHINERY", "Group": "10", "Description": "Machinery and Equipment"}
]
}
createAssetDepreciationGroups

Create a new AssetDepreciationGroup.

Parameters:

NameTypeRequiredDescription
payloadAssetDepreciationGroupYesThe asset depreciation group to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDepreciationGroup&#124;error

Sample code:

AssetDepreciationGroup created = check client->createAssetDepreciationGroups({
code: "MACHINERY",
group: "10",
description: "Machinery and Equipment"
});

Sample response:

{
"Code": "MACHINERY",
"Group": "10",
"Description": "Machinery and Equipment"
}
getAssetDepreciationGroups

Get a single AssetDepreciationGroup by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetDepreciationGroupsQueriesNoOData query options: $expand, $select

Returns: AssetDepreciationGroup&#124;error

Sample code:

AssetDepreciationGroup group = check client->getAssetDepreciationGroups("MACHINERY");

Sample response:

{
"Code": "MACHINERY",
"Group": "10",
"Description": "Machinery and Equipment"
}
deleteAssetDepreciationGroups

Delete an AssetDepreciationGroup.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetDepreciationGroups("MACHINERY");
updateAssetDepreciationGroups

Partially update an AssetDepreciationGroup (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadAssetDepreciationGroupYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetDepreciationGroups("MACHINERY", {description: "Heavy Machinery"});
assetDepreciationGroupsServiceGetList

Get the list of asset depreciation group parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_3&#124;error

Sample code:

inline_response_200_3 list = check client->assetDepreciationGroupsServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetDepreciationGroupsService_GetList",
"value": [
{"Code": "MACHINERY", "Description": "Machinery and Equipment"}
]
}

Asset Groups

listAssetGroups

Query the AssetGroups collection.

Parameters:

NameTypeRequiredDescription
headersListAssetGroupsHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetGroupsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetGroupsCollectionResponse&#124;error

Sample code:

AssetGroupsCollectionResponse response = check client->listAssetGroups();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetGroups",
"value": [
{"Code": "OFFICE", "Description": "Office Equipment"}
]
}
createAssetGroups

Create a new AssetGroup.

Parameters:

NameTypeRequiredDescription
payloadAssetGroupYesThe asset group to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetGroup&#124;error

Sample code:

AssetGroup created = check client->createAssetGroups({code: "OFFICE", description: "Office Equipment"});

Sample response:

{
"Code": "OFFICE",
"Description": "Office Equipment"
}
getAssetGroups

Get a single AssetGroup by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetGroupsQueriesNoOData query options: $expand, $select

Returns: AssetGroup&#124;error

Sample code:

AssetGroup group = check client->getAssetGroups("OFFICE");

Sample response:

{
"Code": "OFFICE",
"Description": "Office Equipment"
}
deleteAssetGroups

Delete an AssetGroup.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetGroups("OFFICE");
updateAssetGroups

Partially update an AssetGroup (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadAssetGroupYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetGroups("OFFICE", {description: "Office & IT Equipment"});
assetGroupsServiceGetList

Get the list of asset group parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_4&#124;error

Sample code:

inline_response_200_4 list = check client->assetGroupsServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetGroupsService_GetList",
"value": [
{"Code": "OFFICE", "Description": "Office Equipment"}
]
}

Asset Manual Depreciation

listAssetManualDepreciation

Query the AssetManualDepreciation collection.

Parameters:

NameTypeRequiredDescription
headersListAssetManualDepreciationHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetManualDepreciationQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetManualDepreciationCollectionResponse&#124;error

Sample code:

AssetManualDepreciationCollectionResponse response = check client->listAssetManualDepreciation();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetManualDepreciation",
"value": [
{
"DocEntry": 77,
"DocNum": 77,
"PostingDate": "2026-06-30",
"Status": "adsPosted",
"ManualDepreciationType": "Special",
"DepreciationArea": "10"
}
]
}
createAssetManualDepreciation

Create a new AssetDocument in the AssetManualDepreciation collection.

Parameters:

NameTypeRequiredDescription
payloadAssetDocumentYesThe manual depreciation document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDocument&#124;error

Sample code:

AssetDocument created = check client->createAssetManualDepreciation({
PostingDate: "2026-06-30",
DocumentDate: "2026-06-30",
ManualDepreciationType: "Special",
DepreciationArea: "10",
AssetDocumentLineCollection: [
{AssetNumber: "100002", TotalLC: 500.00, DepreciationArea: "10"}
]
});

Sample response:

{
"DocEntry": 77,
"DocNum": 77,
"PostingDate": "2026-06-30",
"Status": "adsPosted",
"ManualDepreciationType": "Special",
"DepreciationArea": "10"
}
getAssetManualDepreciation

Get a single AssetDocument in the AssetManualDepreciation collection by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetManualDepreciationQueriesNoOData query options: $expand, $select

Returns: AssetDocument&#124;error

Sample code:

AssetDocument doc = check client->getAssetManualDepreciation(77);

Sample response:

{
"DocEntry": 77,
"DocNum": 77,
"PostingDate": "2026-06-30",
"Status": "adsPosted",
"ManualDepreciationType": "Special",
"DepreciationArea": "10"
}
deleteAssetManualDepreciation

Delete an AssetDocument from the AssetManualDepreciation collection.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetManualDepreciation(77);
updateAssetManualDepreciation

Partially update an AssetDocument in the AssetManualDepreciation collection (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetDocumentYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetManualDepreciation(77, {Remarks: "Adjusted"});
assetManualDepreciationServiceCancel

Cancel an asset manual depreciation document.

Parameters:

NameTypeRequiredDescription
payloadAssetManualDepreciationService_Cancel_bodyYesCancellation parameters wrapping an AssetDocumentParams object
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->assetManualDepreciationServiceCancel({
assetDocumentParams: {docEntry: 77, cancellationOption: "coByCurrentSystemDate"}
});
assetManualDepreciationServiceGetList

Get the list of asset manual depreciation document parameters available for cancellation.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_5&#124;error

Sample code:

inline_response_200_5 list = check client->assetManualDepreciationServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetManualDepreciationService_GetList",
"value": [
{"DocEntry": 77, "CancellationOption": "coByCurrentSystemDate"}
]
}

Asset Retirement

listAssetRetirement

Query the AssetRetirement collection.

Parameters:

NameTypeRequiredDescription
headersListAssetRetirementHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetRetirementQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetRetirementCollectionResponse&#124;error

Sample code:

AssetRetirementCollectionResponse response = check client->listAssetRetirement();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetRetirement",
"value": [
{
"DocEntry": 12,
"DocNum": 12,
"PostingDate": "2026-05-20",
"Status": "adsPosted",
"DocumentType": "adtSales",
"DepreciationArea": "10"
}
]
}
createAssetRetirement

Create a new AssetDocument in the AssetRetirement collection.

Parameters:

NameTypeRequiredDescription
payloadAssetDocumentYesThe asset retirement document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDocument&#124;error

Sample code:

AssetDocument created = check client->createAssetRetirement({
PostingDate: "2026-05-20",
DocumentDate: "2026-05-20",
DocumentType: "adtSales",
DepreciationArea: "10",
AssetDocumentLineCollection: [
{AssetNumber: "100002", Quantity: 1, TotalLC: 12000.00, DepreciationArea: "10"}
]
});

Sample response:

{
"DocEntry": 12,
"DocNum": 12,
"PostingDate": "2026-05-20",
"Status": "adsPosted",
"DocumentType": "adtSales",
"DepreciationArea": "10"
}
getAssetRetirement

Get a single AssetDocument in the AssetRetirement collection by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetRetirementQueriesNoOData query options: $expand, $select

Returns: AssetDocument&#124;error

Sample code:

AssetDocument doc = check client->getAssetRetirement(12);

Sample response:

{
"DocEntry": 12,
"DocNum": 12,
"PostingDate": "2026-05-20",
"Status": "adsPosted",
"DocumentType": "adtSales",
"DepreciationArea": "10"
}
deleteAssetRetirement

Delete an AssetDocument from the AssetRetirement collection.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetRetirement(12);
updateAssetRetirement

Partially update an AssetDocument in the AssetRetirement collection (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetDocumentYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetRetirement(12, {Remarks: "Sold to third party"});
assetRetirementServiceCancel

Cancel an asset retirement document.

Parameters:

NameTypeRequiredDescription
payloadAssetRetirementService_Cancel_bodyYesCancellation parameters wrapping an AssetDocumentParams object
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->assetRetirementServiceCancel({
assetDocumentParams: {docEntry: 12, cancellationOption: "coByCurrentSystemDate"}
});
assetRetirementServiceGetList

Get the list of asset retirement document parameters available for cancellation.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_6&#124;error

Sample code:

inline_response_200_6 list = check client->assetRetirementServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetRetirementService_GetList",
"value": [
{"DocEntry": 12, "CancellationOption": "coByCurrentSystemDate"}
]
}

Asset Revaluations

assetRevaluationServiceGetList

Get the list of asset revaluation document parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_7&#124;error

Sample code:

inline_response_200_7 list = check client->assetRevaluationServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetRevaluationService_GetList",
"value": [
{"DocEntry": 25}
]
}
listAssetRevaluations

Query the AssetRevaluations collection.

Parameters:

NameTypeRequiredDescription
headersListAssetRevaluationsHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetRevaluationsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetRevaluationsCollectionResponse&#124;error

Sample code:

AssetRevaluationsCollectionResponse response = check client->listAssetRevaluations();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetRevaluations",
"value": [
{
"DocEntry": 25,
"DocNum": 25,
"PostingDate": "2026-06-30",
"Reference": "REVAL-2026-Q2",
"DepreciationArea": "10"
}
]
}
createAssetRevaluations

Create a new AssetRevaluation.

Parameters:

NameTypeRequiredDescription
payloadAssetRevaluationYesThe asset revaluation document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetRevaluation&#124;error

Sample code:

AssetRevaluation created = check client->createAssetRevaluations({
postingDate: "2026-06-30",
documentDate: "2026-06-30",
reference: "REVAL-2026-Q2",
depreciationArea: "10",
assetRevaluationLineCollection: [
{assetNumber: "100002", currentNBV: 15000.00, newNBV: 16200.00, revaluationPercent: 8}
]
});

Sample response:

{
"DocEntry": 25,
"DocNum": 25,
"PostingDate": "2026-06-30",
"Reference": "REVAL-2026-Q2",
"DepreciationArea": "10",
"AssetRevaluationLineCollection": [
{"DocEntry": 25, "LineNumber": 0, "AssetNumber": "100002", "CurrentNBV": 15000.00, "NewNBV": 16200.00, "RevaluationPercent": 8}
]
}
getAssetRevaluations

Get a single AssetRevaluation by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetRevaluationsQueriesNoOData query options: $expand, $select

Returns: AssetRevaluation&#124;error

Sample code:

AssetRevaluation revaluation = check client->getAssetRevaluations(25);

Sample response:

{
"DocEntry": 25,
"DocNum": 25,
"PostingDate": "2026-06-30",
"Reference": "REVAL-2026-Q2",
"DepreciationArea": "10"
}
deleteAssetRevaluations

Delete an AssetRevaluation.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetRevaluations(25);
updateAssetRevaluations

Partially update an AssetRevaluation (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetRevaluationYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetRevaluations(25, {remarks: "Reviewed by controller"});

Asset Transfer

listAssetTransfer

Query the AssetTransfer collection.

Parameters:

NameTypeRequiredDescription
headersListAssetTransferHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListAssetTransferQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: AssetTransferCollectionResponse&#124;error

Sample code:

AssetTransferCollectionResponse response = check client->listAssetTransfer();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetTransfer",
"value": [
{
"DocEntry": 33,
"DocNum": 33,
"PostingDate": "2026-04-10",
"Status": "adsPosted",
"DocumentType": "adtAssetTransfer",
"DepreciationArea": "10"
}
]
}
createAssetTransfer

Create a new AssetDocument in the AssetTransfer collection.

Parameters:

NameTypeRequiredDescription
payloadAssetDocumentYesThe asset transfer document to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AssetDocument&#124;error

Sample code:

AssetDocument created = check client->createAssetTransfer({
PostingDate: "2026-04-10",
DocumentDate: "2026-04-10",
DocumentType: "adtAssetTransfer",
DepreciationArea: "10",
AssetDocumentNewLocCollection: [
{AssetNumber: "100002", CurLocation: 1, NewLocation: 2, Quantity: 1}
]
});

Sample response:

{
"DocEntry": 33,
"DocNum": 33,
"PostingDate": "2026-04-10",
"Status": "adsPosted",
"DocumentType": "adtAssetTransfer",
"DepreciationArea": "10"
}
getAssetTransfer

Get a single AssetDocument in the AssetTransfer collection by key.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAssetTransferQueriesNoOData query options: $expand, $select

Returns: AssetDocument&#124;error

Sample code:

AssetDocument doc = check client->getAssetTransfer(33);

Sample response:

{
"DocEntry": 33,
"DocNum": 33,
"PostingDate": "2026-04-10",
"Status": "adsPosted",
"DocumentType": "adtAssetTransfer",
"DepreciationArea": "10"
}
deleteAssetTransfer

Delete an AssetDocument from the AssetTransfer collection.

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteAssetTransfer(33);
updateAssetTransfer

Partially update an AssetDocument in the AssetTransfer collection (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
docEntryint:Signed32YesKey property 'DocEntry' (Edm.Int32)
payloadAssetDocumentYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateAssetTransfer(33, {Remarks: "Relocated to warehouse 2"});
assetTransferServiceCancel

Cancel an asset transfer document.

Parameters:

NameTypeRequiredDescription
payloadAssetTransferService_Cancel_bodyYesCancellation parameters wrapping an AssetDocumentParams object
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->assetTransferServiceCancel({
assetDocumentParams: {docEntry: 33, cancellationOption: "coByCurrentSystemDate"}
});
assetTransferServiceGetList

Get the list of asset transfer document parameters available for cancellation.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_8&#124;error

Sample code:

inline_response_200_8 list = check client->assetTransferServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#AssetTransferService_GetList",
"value": [
{"DocEntry": 33, "CancellationOption": "coByCurrentSystemDate"}
]
}

Depreciation Areas

listDepreciationAreas

Query the DepreciationAreas collection.

Parameters:

NameTypeRequiredDescription
headersListDepreciationAreasHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListDepreciationAreasQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: DepreciationAreasCollectionResponse&#124;error

Sample code:

DepreciationAreasCollectionResponse response = check client->listDepreciationAreas();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationAreas",
"value": [
{
"Code": "10",
"Description": "Book Depreciation Area",
"AreaType": "atPostingtoGL",
"MainBookingArea": "tYES",
"PostingOfDepreciation": "podDirectPosting"
}
]
}
createDepreciationAreas

Create a new DepreciationArea.

Parameters:

NameTypeRequiredDescription
payloadDepreciationAreaYesThe depreciation area to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: DepreciationArea&#124;error

Sample code:

DepreciationArea created = check client->createDepreciationAreas({
code: "10",
description: "Book Depreciation Area",
areaType: "atPostingtoGL",
mainBookingArea: "tYES",
postingOfDepreciation: "podDirectPosting"
});

Sample response:

{
"Code": "10",
"Description": "Book Depreciation Area",
"AreaType": "atPostingtoGL",
"MainBookingArea": "tYES",
"PostingOfDepreciation": "podDirectPosting"
}
getDepreciationAreas

Get a single DepreciationArea by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDepreciationAreasQueriesNoOData query options: $expand, $select

Returns: DepreciationArea&#124;error

Sample code:

DepreciationArea area = check client->getDepreciationAreas("10");

Sample response:

{
"Code": "10",
"Description": "Book Depreciation Area",
"AreaType": "atPostingtoGL",
"MainBookingArea": "tYES"
}
deleteDepreciationAreas

Delete a DepreciationArea.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteDepreciationAreas("10");
updateDepreciationAreas

Partially update a DepreciationArea (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadDepreciationAreaYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateDepreciationAreas("10", {description: "Statutory Book Area"});
depreciationAreasServiceGetList

Get the list of depreciation area parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_9&#124;error

Sample code:

inline_response_200_9 list = check client->depreciationAreasServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationAreasService_GetList",
"value": [
{"Code": "10", "Description": "Book Depreciation Area"}
]
}

Depreciation Type Pools

listDepreciationTypePools

Query the DepreciationTypePools collection.

Parameters:

NameTypeRequiredDescription
headersListDepreciationTypePoolsHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListDepreciationTypePoolsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: DepreciationTypePoolsCollectionResponse&#124;error

Sample code:

DepreciationTypePoolsCollectionResponse response = check client->listDepreciationTypePools();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationTypePools",
"value": [
{"Code": "POOL-5Y", "Description": "5-Year Straight Line Pool"}
]
}
createDepreciationTypePools

Create a new DepreciationTypePool.

Parameters:

NameTypeRequiredDescription
payloadDepreciationTypePoolYesThe depreciation type pool to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: DepreciationTypePool&#124;error

Sample code:

DepreciationTypePool created = check client->createDepreciationTypePools({
code: "POOL-5Y",
description: "5-Year Straight Line Pool"
});

Sample response:

{
"Code": "POOL-5Y",
"Description": "5-Year Straight Line Pool"
}
getDepreciationTypePools

Get a single DepreciationTypePool by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDepreciationTypePoolsQueriesNoOData query options: $expand, $select

Returns: DepreciationTypePool&#124;error

Sample code:

DepreciationTypePool pool = check client->getDepreciationTypePools("POOL-5Y");

Sample response:

{
"Code": "POOL-5Y",
"Description": "5-Year Straight Line Pool",
"DepreciationTypes": [
{"Code": "STR-5Y", "Description": "Straight Line 5 Years"}
]
}
deleteDepreciationTypePools

Delete a DepreciationTypePool.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteDepreciationTypePools("POOL-5Y");
updateDepreciationTypePools

Partially update a DepreciationTypePool (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadDepreciationTypePoolYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateDepreciationTypePools("POOL-5Y", {description: "5-Year SL Pool (Revised)"});
depreciationTypePoolsServiceGetList

Get the list of depreciation type pool parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_10&#124;error

Sample code:

inline_response_200_10 list = check client->depreciationTypePoolsServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationTypePoolsService_GetList",
"value": [
{"Code": "POOL-5Y", "Description": "5-Year Straight Line Pool"}
]
}

Depreciation Types

listDepreciationTypes

Query the DepreciationTypes collection.

Parameters:

NameTypeRequiredDescription
headersListDepreciationTypesHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListDepreciationTypesQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: DepreciationTypesCollectionResponse&#124;error

Sample code:

DepreciationTypesCollectionResponse response = check client->listDepreciationTypes();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationTypes",
"value": [
{
"Code": "STR-5Y",
"Description": "Straight Line 5 Years",
"DepreciationMethod": "dmStraightLine",
"StraightLinePercentage": 20,
"CalculationBase": "cbYearly"
}
]
}
createDepreciationTypes

Create a new DepreciationType.

Parameters:

NameTypeRequiredDescription
payloadDepreciationTypeYesThe depreciation type to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: DepreciationType&#124;error

Sample code:

DepreciationType created = check client->createDepreciationTypes({
code: "STR-5Y",
description: "Straight Line 5 Years",
depreciationMethod: "dmStraightLine",
straightLinePercentage: 20,
calculationBase: "cbYearly",
depreciationTypePool: "POOL-5Y"
});

Sample response:

{
"Code": "STR-5Y",
"Description": "Straight Line 5 Years",
"DepreciationMethod": "dmStraightLine",
"StraightLinePercentage": 20,
"CalculationBase": "cbYearly",
"DepreciationTypePool": "POOL-5Y"
}
getDepreciationTypes

Get a single DepreciationType by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDepreciationTypesQueriesNoOData query options: $expand, $select

Returns: DepreciationType&#124;error

Sample code:

DepreciationType depreciationType = check client->getDepreciationTypes("STR-5Y");

Sample response:

{
"Code": "STR-5Y",
"Description": "Straight Line 5 Years",
"DepreciationMethod": "dmStraightLine",
"StraightLinePercentage": 20,
"CalculationBase": "cbYearly",
"ValidFrom": "2020-01-01"
}
deleteDepreciationTypes

Delete a DepreciationType.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteDepreciationTypes("STR-5Y");
updateDepreciationTypes

Partially update a DepreciationType (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadDepreciationTypeYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateDepreciationTypes("STR-5Y", {straightLinePercentage: 25});
depreciationTypesServiceGetList

Get the list of depreciation type parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_11&#124;error

Sample code:

inline_response_200_11 list = check client->depreciationTypesServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#DepreciationTypesService_GetList",
"value": [
{"Code": "STR-5Y", "Description": "Straight Line 5 Years"}
]
}

FA Account Determinations

listFAAccountDeterminations

Query the FAAccountDeterminations collection.

Parameters:

NameTypeRequiredDescription
headersListFAAccountDeterminationsHeadersNoHeaders to be sent with the request, e.g. Prefer: odata.maxpagesize=100
queriesListFAAccountDeterminationsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount, $select

Returns: FAAccountDeterminationsCollectionResponse&#124;error

Sample code:

FAAccountDeterminationsCollectionResponse response = check client->listFAAccountDeterminations();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#FAAccountDeterminations",
"value": [
{
"Code": "DEFAULT",
"Description": "Default FA Account Determination",
"AssetBalanceSheetAccount": "_SYS00000000273",
"OrdinaryDepreciation": "_SYS00000000275"
}
]
}
createFAAccountDeterminations

Create a new FAAccountDetermination.

Parameters:

NameTypeRequiredDescription
payloadFAAccountDeterminationYesThe FA account determination to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: FAAccountDetermination&#124;error

Sample code:

FAAccountDetermination created = check client->createFAAccountDeterminations({
code: "DEFAULT",
description: "Default FA Account Determination",
assetBalanceSheetAccount: "_SYS00000000273",
ordinaryDepreciation: "_SYS00000000275"
});

Sample response:

{
"Code": "DEFAULT",
"Description": "Default FA Account Determination",
"AssetBalanceSheetAccount": "_SYS00000000273",
"OrdinaryDepreciation": "_SYS00000000275"
}
getFAAccountDeterminations

Get a single FAAccountDetermination by key.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetFAAccountDeterminationsQueriesNoOData query options: $expand, $select

Returns: FAAccountDetermination&#124;error

Sample code:

FAAccountDetermination determination = check client->getFAAccountDeterminations("DEFAULT");

Sample response:

{
"Code": "DEFAULT",
"Description": "Default FA Account Determination",
"AssetBalanceSheetAccount": "_SYS00000000273",
"OrdinaryDepreciation": "_SYS00000000275"
}
deleteFAAccountDeterminations

Delete an FAAccountDetermination.

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteFAAccountDeterminations("DEFAULT");
updateFAAccountDeterminations

Partially update an FAAccountDetermination (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
codestringYesKey property 'Code' (Edm.String)
payloadFAAccountDeterminationYesFields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateFAAccountDeterminations("DEFAULT", {description: "Default FA Accounts (Revised)"});
fAAccountDeterminationsServiceGetList

Get the list of FA account determination parameters.

Parameters:

NameTypeRequiredDescription
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_12&#124;error

Sample code:

inline_response_200_12 list = check client->fAAccountDeterminationsServiceGetList();

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#FAAccountDeterminationsService_GetList",
"value": [
{"Code": "DEFAULT", "Description": "Default FA Account Determination"}
]
}

Fixed Asset Items

fixedAssetItemsServiceGetAssetEndBalance

Get the end balance (net book value, accumulated depreciation, etc.) of a fixed asset item.

Parameters:

NameTypeRequiredDescription
payloadFixedAssetItemsService_GetAssetEndBalance_bodyYesWraps a FixedAssetValuesParams object identifying the item, fiscal year, and depreciation area
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: FixedAssetEndBalance&#124;error

Sample code:

FixedAssetEndBalance balance = check client->fixedAssetItemsServiceGetAssetEndBalance({
fixedAssetValuesParams: {itemCode: "100002", fiscalYear: "2026", depreciationArea: "10"}
});

Sample response:

{
"AcquisitionCost": 18500.00,
"NetBookValue": 12300.00,
"OrdinaryDepreciationValue": 6200.00,
"SpecialDepreciationValue": 0,
"SalvageValue": 0,
"Quantity": 1
}
fixedAssetItemsServiceGetAssetValuesList

Get the list of asset transaction values (acquisitions, depreciation, appreciation, etc.) for a fixed asset item.

Parameters:

NameTypeRequiredDescription
payloadFixedAssetItemsService_GetAssetValuesList_bodyYesWraps a FixedAssetValuesParams object identifying the item, fiscal year, and depreciation area
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_13&#124;error

Sample code:

inline_response_200_13 valuesList = check client->fixedAssetItemsServiceGetAssetValuesList({
fixedAssetValuesParams: {itemCode: "100002", fiscalYear: "2026", depreciationArea: "10"}
});

Sample response:

{
"odata.metadata": "https://<host>:50000/b1s/v1/$metadata#FixedAssetItemsService_GetAssetValuesList",
"value": [
{
"TransactionType": "att_Acquistion",
"AcquisitionCost": 18500.00,
"NetBookValue": 18500.00,
"DepreciationValue": 0
},
{
"TransactionType": "att_OrdinaryDepreciation",
"AcquisitionCost": 18500.00,
"NetBookValue": 12300.00,
"OrdinaryDepreciationValue": 6200.00
}
]
}
fixedAssetItemsServiceUpdateAssetEndBalance

Update the end balance of a fixed asset item.

Parameters:

NameTypeRequiredDescription
payloadFixedAssetItemsService_UpdateAssetEndBalance_bodyYesWraps a FixedAssetEndBalance object and a FixedAssetValuesParams object identifying the item, fiscal year, and depreciation area
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->fixedAssetItemsServiceUpdateAssetEndBalance({
fixedAssetEndBalance: {netBookValue: 12300.00, ordinaryDepreciationValue: 6200.00},
fixedAssetValuesParams: {itemCode: "100002", fiscalYear: "2026", depreciationArea: "10"}
});

Session

logout

Ends the active SAP Business One Service Layer session.

Parameters:

None

Returns: error?

Sample code:

check client->logout();