Skip to main content

Actions

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

Available clients:

ClientPurpose
ClientManages SAP Business One administration and setup objects — users, user groups & permissions; approval requests, stages & templates; alerts, event notifications & subscriptions; countries, counties, states & branches; SQL views, SQL queries & user queries; Web Client dashboards, launchpads, form settings & preferences — over the session-authenticated Service Layer (OData V3).

Client

The Client provides access to the administration and setup objects exposed by the SAP Business One Service Layer — users and permissions, approval workflow configuration, general setup data (countries, states, branches, departments), saved queries and views, Web Client customization, and system alerts/notifications.

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.administration;

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

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

Operations

Cockpits

listCockpits

Queries the Cockpits collection and returns a page of Cockpit entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListCockpitsHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListCockpitsQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: CockpitsCollectionResponse&#124;error

Sample code:

CockpitsCollectionResponse result = check client->listCockpits();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#Cockpits",
"value": [
{
"AbsEntry": 1,
"Code": 1,
"Name": "Sales Overview",
"Description": "Default sales cockpit",
"CockpitType": "cpt_System",
"User": null,
"UserSignature": 1,
"Manufacturer": "SAP",
"Publisher": "SAP",
"Time": "00:00:00",
"Date": "2024-01-01"
}
]
}
createCockpits

Creates a new Cockpit entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadCockpitYesRequest payload describing the Cockpit to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: Cockpit&#124;error

Sample code:

Cockpit result = check client->createCockpits(payload);

Sample response:

{
"AbsEntry": 2,
"Code": 2,
"Name": "New Cockpit",
"Description": "Custom cockpit",
"CockpitType": "cpt_User",
"UserSignature": 1,
"Manufacturer": "",
"Publisher": "",
"Time": "10:00:00",
"Date": "2026-07-13"
}
getCockpits

Retrieves a single Cockpit entity identified by its AbsEntry key property.

Parameters:

NameTypeRequiredDescription
absEntryint:Signed32YesKey property 'AbsEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetCockpitsQueriesNoOData query options: dollarExpand, dollarSelect

Returns: Cockpit&#124;error

Sample code:

Cockpit result = check client->getCockpits(absEntry);

Sample response:

{
"AbsEntry": 1,
"Code": 1,
"Name": "Sales Overview",
"Description": "Default sales cockpit",
"CockpitType": "cpt_System",
"UserSignature": 1,
"Manufacturer": "SAP",
"Publisher": "SAP",
"Time": "00:00:00",
"Date": "2024-01-01"
}
deleteCockpits

Deletes the Cockpit identified by its AbsEntry key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteCockpits(absEntry);
updateCockpits

Partially updates a Cockpit identified by its AbsEntry key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
absEntryint:Signed32YesKey property 'AbsEntry' (Edm.Int32)
payloadCockpitYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateCockpits(absEntry, payload);
cockpitsServiceGetCockpitList

Calls the CockpitsService_GetCockpitList function to retrieve the list of cockpits available to the current user context.

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 result = check client->cockpitsServiceGetCockpitList();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#CockpitsService_GetCockpitList",
"value": [
{
"CockpitType": "cpt_System",
"AbsEntry": 1
}
]
}
cockpitsServiceGetTemplateCockpitList

Calls the CockpitsService_GetTemplateCockpitList function to retrieve the list of template cockpits.

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 result = check client->cockpitsServiceGetTemplateCockpitList();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#CockpitsService_GetTemplateCockpitList",
"value": [
{
"CockpitType": "cpt_Template",
"AbsEntry": 3
}
]
}
cockpitsServiceGetUserCockpitList

Calls the CockpitsService_GetUserCockpitList function to retrieve the list of cockpits owned by the current user.

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 result = check client->cockpitsServiceGetUserCockpitList();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#CockpitsService_GetUserCockpitList",
"value": [
{
"CockpitType": "cpt_User",
"AbsEntry": 2
}
]
}
cockpitsServicePublishCockpit

Calls the CockpitsService_PublishCockpit function to publish a Cockpit so it becomes available to other users.

Parameters:

NameTypeRequiredDescription
payloadCockpitsService_PublishCockpit_bodyYesRequest payload wrapping the cockpit (Cockpit) to publish
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->cockpitsServicePublishCockpit(payload);

Countries

listCountries

Queries the Countries collection and returns a page of Country entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListCountriesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListCountriesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: CountriesCollectionResponse&#124;error

Sample code:

CountriesCollectionResponse result = check client->listCountries();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#Countries",
"value": [
{
"Code": "US",
"Name": "USA",
"CodeForReports": "US",
"AddressFormat": 1,
"EU": "tNO",
"ISOAlpha2Code": "US",
"ISOAlpha3Code": "USA",
"ISONumeric": "840"
}
]
}
createCountries

Creates a new Country entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadCountryYesRequest payload describing the Country to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: Country&#124;error

Sample code:

Country result = check client->createCountries(payload);

Sample response:

{
"Code": "XY",
"Name": "Example Land",
"CodeForReports": "XY",
"AddressFormat": 1,
"EU": "tNO",
"ISOAlpha2Code": "XY",
"ISOAlpha3Code": "XYZ",
"ISONumeric": "999"
}
getCountries

Retrieves a single Country entity identified by its Code key property.

Parameters:

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

Returns: Country&#124;error

Sample code:

Country result = check client->getCountries(code);

Sample response:

{
"Code": "US",
"Name": "USA",
"CodeForReports": "US",
"AddressFormat": 1,
"EU": "tNO",
"ISOAlpha2Code": "US",
"ISOAlpha3Code": "USA",
"ISONumeric": "840"
}
deleteCountries

Deletes the Country identified by its Code key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteCountries(code);
updateCountries

Partially updates a Country identified by its Code key property using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->updateCountries(code, payload);
countriesServiceGetCountryList

Calls the CountriesService_GetCountryList function to retrieve a simplified list of countries (code and name).

Parameters:

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

Returns: inline_response_200_16&#124;error

Sample code:

inline_response_200_16 result = check client->countriesServiceGetCountryList();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#CountriesService_GetCountryList",
"value": [
{
"Code": "US",
"Name": "USA"
}
]
}

ApprovalStages

listApprovalStages

Queries the ApprovalStages collection and returns a page of ApprovalStage entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListApprovalStagesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListApprovalStagesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: ApprovalStagesCollectionResponse&#124;error

Sample code:

ApprovalStagesCollectionResponse result = check client->listApprovalStages();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#ApprovalStages",
"value": [
{
"Code": 1,
"Name": "First Stage",
"NoOfApproversRequired": 1,
"Remarks": "",
"ApprovalStageApprovers": []
}
]
}
createApprovalStages

Creates a new ApprovalStage entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadApprovalStageYesRequest payload describing the ApprovalStage to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: ApprovalStage&#124;error

Sample code:

ApprovalStage result = check client->createApprovalStages(payload);

Sample response:

{
"Code": 2,
"Name": "Second Stage",
"NoOfApproversRequired": 2,
"Remarks": "Requires manager sign-off",
"ApprovalStageApprovers": []
}
getApprovalStages

Retrieves a single ApprovalStage entity identified by its Code key property.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetApprovalStagesQueriesNoOData query options: dollarExpand, dollarSelect

Returns: ApprovalStage&#124;error

Sample code:

ApprovalStage result = check client->getApprovalStages(code);

Sample response:

{
"Code": 1,
"Name": "First Stage",
"NoOfApproversRequired": 1,
"Remarks": "",
"ApprovalStageApprovers": []
}
deleteApprovalStages

Deletes the ApprovalStage identified by its Code key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteApprovalStages(code);
updateApprovalStages

Partially updates an ApprovalStage identified by its Code key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
payloadApprovalStageYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateApprovalStages(code, payload);
approvalStagesServiceGetApprovalStageList

Calls the ApprovalStagesService_GetApprovalStageList function to retrieve a simplified list of approval stages (code and name).

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 result = check client->approvalStagesServiceGetApprovalStageList();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#ApprovalStagesService_GetApprovalStageList",
"value": [
{
"Code": 1,
"Name": "First Stage"
}
]
}

FormattedSearches

listFormattedSearches

Queries the FormattedSearches collection and returns a page of FormattedSearch entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListFormattedSearchesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListFormattedSearchesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: FormattedSearchesCollectionResponse&#124;error

Sample code:

FormattedSearchesCollectionResponse result = check client->listFormattedSearches();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#FormattedSearches",
"value": [
{
"FormID": "139",
"ItemID": "4",
"ColumnID": "1",
"Action": "bofsaaSetPromptFromExternalLinkedFile",
"QueryID": 1,
"Index": 1,
"Refresh": "tNO",
"FieldID": "CardCode",
"ForceRefresh": "tNO",
"ByField": "tNO"
}
]
}
createFormattedSearches

Creates a new FormattedSearch entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadFormattedSearchYesRequest payload describing the FormattedSearch to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: FormattedSearch&#124;error

Sample code:

FormattedSearch result = check client->createFormattedSearches(payload);

Sample response:

{
"FormID": "139",
"ItemID": "4",
"ColumnID": "1",
"Action": "bofsaaSetPromptFromExternalLinkedFile",
"QueryID": 2,
"Index": 2,
"Refresh": "tNO",
"FieldID": "CardCode",
"ForceRefresh": "tNO",
"ByField": "tNO"
}
getFormattedSearches

Retrieves a single FormattedSearch entity identified by its Index key property.

Parameters:

NameTypeRequiredDescription
indexint:Signed32YesKey property 'Index' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetFormattedSearchesQueriesNoOData query options: dollarExpand, dollarSelect

Returns: FormattedSearch&#124;error

Sample code:

FormattedSearch result = check client->getFormattedSearches(index);

Sample response:

{
"FormID": "139",
"ItemID": "4",
"ColumnID": "1",
"Action": "bofsaaSetPromptFromExternalLinkedFile",
"QueryID": 1,
"Index": 1,
"Refresh": "tNO",
"FieldID": "CardCode",
"ForceRefresh": "tNO",
"ByField": "tNO"
}
deleteFormattedSearches

Deletes the FormattedSearch identified by its Index key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteFormattedSearches(index);
updateFormattedSearches

Partially updates a FormattedSearch identified by its Index key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
indexint:Signed32YesKey property 'Index' (Edm.Int32)
payloadFormattedSearchYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateFormattedSearches(index, payload);

WebClientDashboards

listWebClientDashboards

Queries the WebClientDashboards collection and returns a page of WebClientDashboard entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListWebClientDashboardsHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListWebClientDashboardsQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: WebClientDashboardsCollectionResponse&#124;error

Sample code:

WebClientDashboardsCollectionResponse result = check client->listWebClientDashboards();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#WebClientDashboards",
"value": [
{
"Guid": "b1e2c3d4-0000-0000-0000-000000000001",
"UserId": 1,
"Content": "{}",
"Sys": "tNO",
"WebClientDashboardCards": []
}
]
}
createWebClientDashboards

Creates a new WebClientDashboard entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadWebClientDashboardYesRequest payload describing the WebClientDashboard to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: WebClientDashboard&#124;error

Sample code:

WebClientDashboard result = check client->createWebClientDashboards(payload);

Sample response:

{
"Guid": "b1e2c3d4-0000-0000-0000-000000000002",
"UserId": 1,
"Content": "{}",
"Sys": "tNO",
"WebClientDashboardCards": []
}
getWebClientDashboards

Retrieves a single WebClientDashboard entity identified by its Guid key property.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientDashboardsQueriesNoOData query options: dollarExpand, dollarSelect

Returns: WebClientDashboard&#124;error

Sample code:

WebClientDashboard result = check client->getWebClientDashboards(guid);

Sample response:

{
"Guid": "b1e2c3d4-0000-0000-0000-000000000001",
"UserId": 1,
"Content": "{}",
"Sys": "tNO",
"WebClientDashboardCards": []
}
deleteWebClientDashboards

Deletes the WebClientDashboard identified by its Guid key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteWebClientDashboards(guid);
updateWebClientDashboards

Partially updates a WebClientDashboard identified by its Guid key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientDashboardYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateWebClientDashboards(guid, payload);

AdditionalExpenses

listAdditionalExpenses

Queries the AdditionalExpenses collection and returns a page of AdditionalExpense entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListAdditionalExpensesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListAdditionalExpensesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: AdditionalExpensesCollectionResponse&#124;error

Sample code:

AdditionalExpensesCollectionResponse result = check client->listAdditionalExpenses();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#AdditionalExpenses",
"value": [
{
"ExpensCode": 1,
"Name": "Freight",
"RevenuesAccount": "_SYS00000000001",
"ExpenseAccount": "_SYS00000000002",
"TaxLiable": "tYES",
"FixedAmountRevenues": 0,
"FixedAmountExpenses": 0,
"DistributionMethod": "aed_Equally",
"FreightType": "ft_Value"
}
]
}
createAdditionalExpenses

Creates a new AdditionalExpense entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadAdditionalExpenseYesRequest payload describing the AdditionalExpense to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: AdditionalExpense&#124;error

Sample code:

AdditionalExpense result = check client->createAdditionalExpenses(payload);

Sample response:

{
"ExpensCode": 2,
"Name": "Handling",
"RevenuesAccount": "_SYS00000000003",
"ExpenseAccount": "_SYS00000000004",
"TaxLiable": "tYES",
"FixedAmountRevenues": 0,
"FixedAmountExpenses": 0,
"DistributionMethod": "aed_Equally",
"FreightType": "ft_Value"
}
getAdditionalExpenses

Retrieves a single AdditionalExpense entity identified by its ExpensCode key property.

Parameters:

NameTypeRequiredDescription
expensCodeint:Signed32YesKey property 'ExpensCode' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAdditionalExpensesQueriesNoOData query options: dollarExpand, dollarSelect

Returns: AdditionalExpense&#124;error

Sample code:

AdditionalExpense result = check client->getAdditionalExpenses(expensCode);

Sample response:

{
"ExpensCode": 1,
"Name": "Freight",
"RevenuesAccount": "_SYS00000000001",
"ExpenseAccount": "_SYS00000000002",
"TaxLiable": "tYES",
"FixedAmountRevenues": 0,
"FixedAmountExpenses": 0,
"DistributionMethod": "aed_Equally",
"FreightType": "ft_Value"
}
deleteAdditionalExpenses

Deletes the AdditionalExpense identified by its ExpensCode key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteAdditionalExpenses(expensCode);
updateAdditionalExpenses

Partially updates an AdditionalExpense identified by its ExpensCode key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
expensCodeint:Signed32YesKey property 'ExpensCode' (Edm.Int32)
payloadAdditionalExpenseYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateAdditionalExpenses(expensCode, payload);

DynamicSystemStrings

listDynamicSystemStrings

Queries the DynamicSystemStrings collection and returns a page of DynamicSystemString entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListDynamicSystemStringsHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListDynamicSystemStringsQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: DynamicSystemStringsCollectionResponse&#124;error

Sample code:

DynamicSystemStringsCollectionResponse result = check client->listDynamicSystemStrings();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#DynamicSystemStrings",
"value": [
{
"FormID": "139",
"ItemID": "4",
"ColumnID": "1",
"ItemString": "Business Partner",
"IsBold": "tNO",
"IsItalics": "tNO"
}
]
}
createDynamicSystemStrings

Creates a new DynamicSystemString entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadDynamicSystemStringYesRequest payload describing the DynamicSystemString to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: DynamicSystemString&#124;error

Sample code:

DynamicSystemString result = check client->createDynamicSystemStrings(payload);

Sample response:

{
"FormID": "139",
"ItemID": "5",
"ColumnID": "1",
"ItemString": "Item Code",
"IsBold": "tNO",
"IsItalics": "tNO"
}
getDynamicSystemStrings

Retrieves a single DynamicSystemString entity identified by its composite key of FormID, ItemID, and ColumnID.

Parameters:

NameTypeRequiredDescription
formIDstringYesComposite key part 'FormID' (Edm.String)
itemIDstringYesComposite key part 'ItemID' (Edm.String)
columnIDstringYesComposite key part 'ColumnID' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDynamicSystemStringsQueriesNoOData query options: dollarExpand, dollarSelect

Returns: DynamicSystemString&#124;error

Sample code:

DynamicSystemString result = check client->getDynamicSystemStrings(formID, itemID, columnID);

Sample response:

{
"FormID": "139",
"ItemID": "4",
"ColumnID": "1",
"ItemString": "Business Partner",
"IsBold": "tNO",
"IsItalics": "tNO"
}
deleteDynamicSystemStrings

Deletes the DynamicSystemString identified by its composite key of FormID, ItemID, and ColumnID.

Parameters:

NameTypeRequiredDescription
formIDstringYesComposite key part 'FormID' (Edm.String)
itemIDstringYesComposite key part 'ItemID' (Edm.String)
columnIDstringYesComposite key part 'ColumnID' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->deleteDynamicSystemStrings(formID, itemID, columnID);
updateDynamicSystemStrings

Partially updates a DynamicSystemString identified by its composite key of FormID, ItemID, and ColumnID using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
formIDstringYesComposite key part 'FormID' (Edm.String)
itemIDstringYesComposite key part 'ItemID' (Edm.String)
columnIDstringYesComposite key part 'ColumnID' (Edm.String)
payloadDynamicSystemStringYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateDynamicSystemStrings(formID, itemID, columnID, payload);

Pictures

listPictures

Queries the Pictures collection and returns a page of Picture entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListPicturesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListPicturesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: PicturesCollectionResponse&#124;error

Sample code:

PicturesCollectionResponse result = check client->listPictures();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#Pictures",
"value": [
{
"PictureName": "logo.png",
"PictureSize": 20480,
"PicturePath": "/Pictures/logo.png",
"PictureCreateDate": "2024-01-01",
"PictureModifyDate": "2024-01-01"
}
]
}
createPictures

Creates a new Picture entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadPictureYesRequest payload describing the Picture to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: Picture&#124;error

Sample code:

Picture result = check client->createPictures(payload);

Sample response:

{
"PictureName": "banner.png",
"PictureSize": 40960,
"PicturePath": "/Pictures/banner.png",
"PictureCreateDate": "2026-07-13",
"PictureModifyDate": "2026-07-13"
}
getPictures

Retrieves a single Picture entity identified by its PictureName key property.

Parameters:

NameTypeRequiredDescription
pictureNamestringYesKey property 'PictureName' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetPicturesQueriesNoOData query options: dollarExpand, dollarSelect

Returns: Picture&#124;error

Sample code:

Picture result = check client->getPictures(pictureName);

Sample response:

{
"PictureName": "logo.png",
"PictureSize": 20480,
"PicturePath": "/Pictures/logo.png",
"PictureCreateDate": "2024-01-01",
"PictureModifyDate": "2024-01-01"
}
deletePictures

Deletes the Picture identified by its PictureName key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deletePictures(pictureName);
updatePictures

Partially updates a Picture identified by its PictureName key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
pictureNamestringYesKey property 'PictureName' (Edm.String)
payloadPictureYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updatePictures(pictureName, payload);

UserKeysMD

listUserKeysMD

Queries the UserKeysMD collection and returns a page of UserKeysMD entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListUserKeysMDHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListUserKeysMDQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: UserKeysMDCollectionResponse&#124;error

Sample code:

UserKeysMDCollectionResponse result = check client->listUserKeysMD();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#UserKeysMD",
"value": [
{
"TableName": "OCRD",
"KeyIndex": 1,
"KeyName": "CardCode",
"Unique": "tYES",
"UserKeysMD_Elements": []
}
]
}
createUserKeysMD

Creates a new UserKeysMD entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadUserKeysMDYesRequest payload describing the UserKeysMD to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: UserKeysMD&#124;error

Sample code:

UserKeysMD result = check client->createUserKeysMD(payload);

Sample response:

{
"TableName": "OCRD",
"KeyIndex": 2,
"KeyName": "CardName",
"Unique": "tNO",
"UserKeysMD_Elements": []
}
getUserKeysMD

Retrieves a single UserKeysMD entity identified by its composite key of TableName and KeyIndex.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
keyIndexint:Signed32YesComposite key part 'KeyIndex' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetUserKeysMDQueriesNoOData query options: dollarExpand, dollarSelect

Returns: UserKeysMD&#124;error

Sample code:

UserKeysMD result = check client->getUserKeysMD(tableName, keyIndex);

Sample response:

{
"TableName": "OCRD",
"KeyIndex": 1,
"KeyName": "CardCode",
"Unique": "tYES",
"UserKeysMD_Elements": []
}
deleteUserKeysMD

Deletes the UserKeysMD identified by its composite key of TableName and KeyIndex.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
keyIndexint:Signed32YesComposite key part 'KeyIndex' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->deleteUserKeysMD(tableName, keyIndex);
updateUserKeysMD

Partially updates a UserKeysMD identified by its composite key of TableName and KeyIndex using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
keyIndexint:Signed32YesComposite key part 'KeyIndex' (Edm.Int32)
payloadUserKeysMDYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateUserKeysMD(tableName, keyIndex, payload);

WebClientPreferences

listWebClientPreferences

Queries the WebClientPreferences collection and returns a page of WebClientPreference entities, optionally filtered, sorted, and paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListWebClientPreferencesHeadersNoHeaders to be sent with the request (e.g. prefer for server-side paging control)
queriesListWebClientPreferencesQueriesNoOData query options: dollarSkip, dollarTop, dollarFilter, dollarOrderby, dollarExpand, dollarInlinecount, dollarSelect

Returns: WebClientPreferencesCollectionResponse&#124;error

Sample code:

WebClientPreferencesCollectionResponse result = check client->listWebClientPreferences();

Sample response:

{
"odata.metadata": "https://localhost:50000/b1s/v1/$metadata#WebClientPreferences",
"value": [
{
"Guid": "c1d2e3f4-0000-0000-0000-000000000001",
"TableName": "OCRD",
"ColumnName": "CardCode",
"DefaultValue": "",
"UserId": 1
}
]
}
createWebClientPreferences

Creates a new WebClientPreference entity from the supplied payload.

Parameters:

NameTypeRequiredDescription
payloadWebClientPreferenceYesRequest payload describing the WebClientPreference to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: WebClientPreference&#124;error

Sample code:

WebClientPreference result = check client->createWebClientPreferences(payload);

Sample response:

{
"Guid": "c1d2e3f4-0000-0000-0000-000000000002",
"TableName": "OCRD",
"ColumnName": "CardName",
"DefaultValue": "",
"UserId": 1
}
getWebClientPreferences

Retrieves a single WebClientPreference entity identified by its Guid key property.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientPreferencesQueriesNoOData query options: dollarExpand, dollarSelect

Returns: WebClientPreference&#124;error

Sample code:

WebClientPreference result = check client->getWebClientPreferences(guid);

Sample response:

{
"Guid": "c1d2e3f4-0000-0000-0000-000000000001",
"TableName": "OCRD",
"ColumnName": "CardCode",
"DefaultValue": "",
"UserId": 1
}
deleteWebClientPreferences

Deletes the WebClientPreference identified by its Guid key property.

Parameters:

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

Returns: error?

Sample code:

error? result = check client->deleteWebClientPreferences(guid);
updateWebClientPreferences

Partially updates a WebClientPreference identified by its Guid key property using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientPreferenceYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check client->updateWebClientPreferences(guid, payload);

Sections

listSections

Retrieves a paged list of Section entities from the Sections collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListSectionsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListSectionsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: SectionsCollectionResponse&#124;error

Sample code:

SectionsCollectionResponse result = check client->listSections();

Sample response:

{
"odata.metadata": "$metadata#Sections",
"value": [
{
"Description": "Sales Section",
"AbsEntry": 1,
"Code": "S1",
"ECode": "SEC1"
}
],
"odata.nextLink": "Sections?$skip=20"
}
createSections

Creates a new Section entity in the Sections collection.

Parameters:

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

Returns: Section&#124;error

Sample code:

Section result = check client->createSections(payload);

Sample response:

{
"Description": "Sales Section",
"AbsEntry": 1,
"Code": "S1",
"ECode": "SEC1"
}
getSections

Retrieves a single Section entity identified by its AbsEntry key.

Parameters:

NameTypeRequiredDescription
absEntryint:Signed32YesKey property 'AbsEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetSectionsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: Section&#124;error

Sample code:

Section result = check client->getSections(absEntry);

Sample response:

{
"Description": "Sales Section",
"AbsEntry": 1,
"Code": "S1",
"ECode": "SEC1"
}
deleteSections

Deletes a Section entity identified by its AbsEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteSections(absEntry);
updateSections

Partially updates a Section entity identified by its AbsEntry key using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateSections(absEntry, payload);
sectionsServiceGetSectionList

Retrieves the list of sections via the SectionsService_GetSectionList service operation.

Parameters:

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

Returns: inline_response_200_36&#124;error

Sample code:

inline_response_200_36 result = check client->sectionsServiceGetSectionList();

Sample response:

{
"odata.metadata": "$metadata#SectionsService_GetSectionList",
"value": [
{
"Description": "Sales Section",
"AbsEntry": 1,
"Code": "S1"
}
]
}

PredefinedTexts

listPredefinedTexts

Retrieves a paged list of PredefinedText entities from the PredefinedTexts collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListPredefinedTextsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListPredefinedTextsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: PredefinedTextsCollectionResponse&#124;error

Sample code:

PredefinedTextsCollectionResponse result = check client->listPredefinedTexts();

Sample response:

{
"odata.metadata": "$metadata#PredefinedTexts",
"value": [
{
"Numerator": 1,
"TextCode": "GREETING",
"Text": "Thank you for your business"
}
],
"odata.nextLink": "PredefinedTexts?$skip=20"
}
createPredefinedTexts

Creates a new PredefinedText entity in the PredefinedTexts collection.

Parameters:

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

Returns: PredefinedText&#124;error

Sample code:

PredefinedText result = check client->createPredefinedTexts(payload);

Sample response:

{
"Numerator": 1,
"TextCode": "GREETING",
"Text": "Thank you for your business"
}
getPredefinedTexts

Retrieves a single PredefinedText entity identified by its Numerator key.

Parameters:

NameTypeRequiredDescription
numeratorint:Signed32YesKey property 'Numerator' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetPredefinedTextsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: PredefinedText&#124;error

Sample code:

PredefinedText result = check client->getPredefinedTexts(numerator);

Sample response:

{
"Numerator": 1,
"TextCode": "GREETING",
"Text": "Thank you for your business"
}
deletePredefinedTexts

Deletes a PredefinedText entity identified by its Numerator key.

Parameters:

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

Returns: error?

Sample code:

check client->deletePredefinedTexts(numerator);
updatePredefinedTexts

Partially updates a PredefinedText entity identified by its Numerator key using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updatePredefinedTexts(numerator, payload);
predefinedTextsServiceGetPredefinedTextList

Retrieves the list of predefined texts via the PredefinedTextsService_GetPredefinedTextList service operation.

Parameters:

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

Returns: inline_response_200_31&#124;error

Sample code:

inline_response_200_31 result = check client->predefinedTextsServiceGetPredefinedTextList();

Sample response:

{
"odata.metadata": "$metadata#PredefinedTextsService_GetPredefinedTextList",
"value": [
{
"Numerator": 1,
"TextCode": "GREETING"
}
]
}

WebClientRecentActivities

listWebClientRecentActivities

Retrieves a paged list of WebClientRecentActivity entities from the WebClientRecentActivities collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListWebClientRecentActivitiesHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListWebClientRecentActivitiesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: WebClientRecentActivitiesCollectionResponse&#124;error

Sample code:

WebClientRecentActivitiesCollectionResponse result = check client->listWebClientRecentActivities();

Sample response:

{
"odata.metadata": "$metadata#WebClientRecentActivities",
"value": [
{
"AppId": "app-01",
"UserId": 1,
"Title": "Sales Order 1000",
"RecentDay": "2026-07-01",
"Guid": "3f1e2a4b-1234-5678-90ab-cdef01234567",
"Count": 3,
"AppType": "SalesOrder",
"Timestamp": "2026-07-01T10:15:00Z",
"Url": "/app/salesorder/1000"
}
],
"odata.nextLink": "WebClientRecentActivities?$skip=20"
}
createWebClientRecentActivities

Creates a new WebClientRecentActivity entity in the WebClientRecentActivities collection.

Parameters:

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

Returns: WebClientRecentActivity&#124;error

Sample code:

WebClientRecentActivity result = check client->createWebClientRecentActivities(payload);

Sample response:

{
"AppId": "app-01",
"UserId": 1,
"Title": "Sales Order 1000",
"RecentDay": "2026-07-01",
"Guid": "3f1e2a4b-1234-5678-90ab-cdef01234567",
"Count": 3,
"AppType": "SalesOrder",
"Timestamp": "2026-07-01T10:15:00Z",
"Url": "/app/salesorder/1000"
}
getWebClientRecentActivities

Retrieves a single WebClientRecentActivity entity identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientRecentActivitiesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: WebClientRecentActivity&#124;error

Sample code:

WebClientRecentActivity result = check client->getWebClientRecentActivities(guid);

Sample response:

{
"AppId": "app-01",
"UserId": 1,
"Title": "Sales Order 1000",
"Guid": "3f1e2a4b-1234-5678-90ab-cdef01234567",
"Count": 3
}
deleteWebClientRecentActivities

Deletes a WebClientRecentActivity entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientRecentActivities(guid);
updateWebClientRecentActivities

Partially updates a WebClientRecentActivity entity identified by its Guid key using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientRecentActivityYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientRecentActivities(guid, payload);
webClientRecentActivityServiceGetList

Retrieves the list of web client recent activities via the WebClientRecentActivityService_GetList service operation.

Parameters:

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

Returns: inline_response_200_53&#124;error

Sample code:

inline_response_200_53 result = check client->webClientRecentActivityServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientRecentActivityService_GetList",
"value": [
{
"Guid": "3f1e2a4b-1234-5678-90ab-cdef01234567"
}
]
}

Departments

listDepartments

Retrieves a paged list of Department entities from the Departments collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListDepartmentsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListDepartmentsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: DepartmentsCollectionResponse&#124;error

Sample code:

DepartmentsCollectionResponse result = check client->listDepartments();

Sample response:

{
"odata.metadata": "$metadata#Departments",
"value": [
{
"Description": "Sales Department",
"Code": 1,
"Name": "Sales"
}
],
"odata.nextLink": "Departments?$skip=20"
}
createDepartments

Creates a new Department entity in the Departments collection.

Parameters:

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

Returns: Department&#124;error

Sample code:

Department result = check client->createDepartments(payload);

Sample response:

{
"Description": "Sales Department",
"Code": 1,
"Name": "Sales"
}
getDepartments

Retrieves a single Department entity identified by its Code key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDepartmentsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: Department&#124;error

Sample code:

Department result = check client->getDepartments(code);

Sample response:

{
"Description": "Sales Department",
"Code": 1,
"Name": "Sales"
}
deleteDepartments

Deletes a Department entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteDepartments(code);
updateDepartments

Partially updates a Department entity identified by its Code key using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateDepartments(code, payload);
departmentsServiceGetDepartmentList

Retrieves the department list via the DepartmentsService_GetDepartmentList service operation.

Parameters:

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

Returns: inline_response_200_17&#124;error

Sample code:

inline_response_200_17 result = check client->departmentsServiceGetDepartmentList();

Sample response:

{
"odata.metadata": "$metadata#DepartmentsService_GetDepartmentList",
"value": [
{
"Code": 1,
"Name": "Sales"
}
]
}

UserFieldsMD

listUserFieldsMD

Retrieves a paged list of UserFieldMD entities from the UserFieldsMD collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListUserFieldsMDHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListUserFieldsMDQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserFieldsMDCollectionResponse&#124;error

Sample code:

UserFieldsMDCollectionResponse result = check client->listUserFieldsMD();

Sample response:

{
"odata.metadata": "$metadata#UserFieldsMD",
"value": [
{
"Description": "Customer Priority",
"SubType": "st_None",
"Size": 20,
"Name": "U_Priority",
"TableName": "OCRD",
"Type": "db_Alpha",
"FieldID": 1,
"EditSize": 20
}
],
"odata.nextLink": "UserFieldsMD?$skip=20"
}
createUserFieldsMD

Creates a new UserFieldMD entity in the UserFieldsMD collection.

Parameters:

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

Returns: UserFieldMD&#124;error

Sample code:

UserFieldMD result = check client->createUserFieldsMD(payload);

Sample response:

{
"Description": "Customer Priority",
"SubType": "st_None",
"Size": 20,
"Name": "U_Priority",
"TableName": "OCRD",
"Type": "db_Alpha",
"FieldID": 1,
"EditSize": 20
}
getUserFieldsMD

Retrieves a single UserFieldMD entity identified by the composite key TableName/FieldID.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
fieldIDint:Signed32YesComposite key part 'FieldID' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetUserFieldsMDQueriesNoQueries to be sent with the request ($expand, $select)

Returns: UserFieldMD&#124;error

Sample code:

UserFieldMD result = check client->getUserFieldsMD(tableName, fieldID);

Sample response:

{
"Description": "Customer Priority",
"Name": "U_Priority",
"TableName": "OCRD",
"Type": "db_Alpha",
"FieldID": 1
}
deleteUserFieldsMD

Deletes a UserFieldMD entity identified by the composite key TableName/FieldID.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
fieldIDint:Signed32YesComposite key part 'FieldID' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteUserFieldsMD(tableName, fieldID);
updateUserFieldsMD

Partially updates a UserFieldMD entity identified by the composite key TableName/FieldID using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
tableNamestringYesComposite key part 'TableName' (Edm.String)
fieldIDint:Signed32YesComposite key part 'FieldID' (Edm.Int32)
payloadUserFieldMDYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateUserFieldsMD(tableName, fieldID, payload);

WebClientNotifications

webClientNotificationServiceGetList

Retrieves the list of web client notifications via the WebClientNotificationService_GetList service operation.

Parameters:

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

Returns: inline_response_200_51&#124;error

Sample code:

inline_response_200_51 result = check client->webClientNotificationServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientNotificationService_GetList",
"value": [
{
"Guid": "9a8b7c6d-1234-5678-90ab-cdef01234567"
}
]
}
listWebClientNotifications

Retrieves a paged list of WebClientNotification entities from the WebClientNotifications collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListWebClientNotificationsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListWebClientNotificationsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: WebClientNotificationsCollectionResponse&#124;error

Sample code:

WebClientNotificationsCollectionResponse result = check client->listWebClientNotifications();

Sample response:

{
"odata.metadata": "$metadata#WebClientNotifications",
"value": [
{
"ReadStatus": "N",
"NotiType": 1,
"ActivityDate": "2026-07-01",
"UserId": 1,
"IsDismissed": "N",
"Guid": "9a8b7c6d-1234-5678-90ab-cdef01234567"
}
],
"odata.nextLink": "WebClientNotifications?$skip=20"
}
createWebClientNotifications

Creates a new WebClientNotification entity in the WebClientNotifications collection.

Parameters:

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

Returns: WebClientNotification&#124;error

Sample code:

WebClientNotification result = check client->createWebClientNotifications(payload);

Sample response:

{
"ReadStatus": "N",
"NotiType": 1,
"ActivityDate": "2026-07-01",
"UserId": 1,
"IsDismissed": "N",
"Guid": "9a8b7c6d-1234-5678-90ab-cdef01234567"
}
getWebClientNotifications

Retrieves a single WebClientNotification entity identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientNotificationsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: WebClientNotification&#124;error

Sample code:

WebClientNotification result = check client->getWebClientNotifications(guid);

Sample response:

{
"ReadStatus": "N",
"NotiType": 1,
"UserId": 1,
"Guid": "9a8b7c6d-1234-5678-90ab-cdef01234567"
}
deleteWebClientNotifications

Deletes a WebClientNotification entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientNotifications(guid);
updateWebClientNotifications

Partially updates a WebClientNotification entity identified by its Guid key using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientNotificationYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientNotifications(guid, payload);

EventNotifications

listEventNotifications

Retrieves a paged list of EventNotification entities from the EventNotifications collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListEventNotificationsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListEventNotificationsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: EventNotificationsCollectionResponse&#124;error

Sample code:

EventNotificationsCollectionResponse result = check client->listEventNotifications();

Sample response:

{
"odata.metadata": "$metadata#EventNotifications",
"value": [
{
"Status": "est_Success",
"TransactionType": "A",
"ReplayState": "erps_Sent",
"CreateTime": "10:00:00",
"SourceDB": "SBODEMOUS",
"FieldsInKey": 1,
"Operation": "C",
"BusinessObject": "oInvoices",
"CreateDate": "2026-07-01",
"ObjectType": "13",
"EventID": "EVT-0001"
}
],
"odata.nextLink": "EventNotifications?$skip=20"
}
createEventNotifications

Creates a new EventNotification entity in the EventNotifications collection.

Parameters:

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

Returns: EventNotification&#124;error

Sample code:

EventNotification result = check client->createEventNotifications(payload);

Sample response:

{
"Status": "est_Success",
"TransactionType": "A",
"ReplayState": "erps_Sent",
"SourceDB": "SBODEMOUS",
"Operation": "C",
"BusinessObject": "oInvoices",
"CreateDate": "2026-07-01",
"EventID": "EVT-0001"
}
getEventNotifications

Retrieves a single EventNotification entity identified by its EventID key.

Parameters:

NameTypeRequiredDescription
eventIDstringYesKey property 'EventID' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetEventNotificationsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: EventNotification&#124;error

Sample code:

EventNotification result = check client->getEventNotifications(eventID);

Sample response:

{
"Status": "est_Success",
"TransactionType": "A",
"BusinessObject": "oInvoices",
"EventID": "EVT-0001"
}
deleteEventNotifications

Deletes an EventNotification entity identified by its EventID key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteEventNotifications(eventID);
updateEventNotifications

Partially updates an EventNotification entity identified by its EventID key using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
eventIDstringYesKey property 'EventID' (Edm.String)
payloadEventNotificationYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateEventNotifications(eventID, payload);

QueryAuthGroups

queryAuthGroupServiceGetQueryAuthGroupList

Retrieves the query auth group list via the QueryAuthGroupService_GetQueryAuthGroupList service operation.

Parameters:

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

Returns: inline_response_200_32&#124;error

Sample code:

inline_response_200_32 result = check client->queryAuthGroupServiceGetQueryAuthGroupList();

Sample response:

{
"odata.metadata": "$metadata#QueryAuthGroupService_GetQueryAuthGroupList",
"value": [
{
"AuthGroupCode": "AG1",
"AuthGroupDes": "Finance Queries",
"AuthGroupId": 1
}
]
}
listQueryAuthGroups

Retrieves a paged list of QueryAuthGroup entities from the QueryAuthGroups collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListQueryAuthGroupsHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListQueryAuthGroupsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: QueryAuthGroupsCollectionResponse&#124;error

Sample code:

QueryAuthGroupsCollectionResponse result = check client->listQueryAuthGroups();

Sample response:

{
"odata.metadata": "$metadata#QueryAuthGroups",
"value": [
{
"AuthGroupCode": "AG1",
"AuthGroupDes": "Finance Queries",
"AuthGroupId": 1,
"CategoryGroupCollection": []
}
],
"odata.nextLink": "QueryAuthGroups?$skip=20"
}
createQueryAuthGroups

Creates a new QueryAuthGroup entity in the QueryAuthGroups collection.

Parameters:

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

Returns: QueryAuthGroup&#124;error

Sample code:

QueryAuthGroup result = check client->createQueryAuthGroups(payload);

Sample response:

{
"AuthGroupCode": "AG1",
"AuthGroupDes": "Finance Queries",
"AuthGroupId": 1,
"CategoryGroupCollection": []
}
getQueryAuthGroups

Retrieves a single QueryAuthGroup entity identified by its AuthGroupId key.

Parameters:

NameTypeRequiredDescription
authGroupIdint:Signed32YesKey property 'AuthGroupId' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetQueryAuthGroupsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: QueryAuthGroup&#124;error

Sample code:

QueryAuthGroup result = check client->getQueryAuthGroups(authGroupId);

Sample response:

{
"AuthGroupCode": "AG1",
"AuthGroupDes": "Finance Queries",
"AuthGroupId": 1
}
deleteQueryAuthGroups

Deletes a QueryAuthGroup entity identified by its AuthGroupId key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteQueryAuthGroups(authGroupId);
updateQueryAuthGroups

Partially updates a QueryAuthGroup entity identified by its AuthGroupId key using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateQueryAuthGroups(authGroupId, payload);

UserObjectsMD

listUserObjectsMD

Retrieves a paged list of UserObjectsMD entities from the UserObjectsMD collection, supporting OData query and paging headers.

Parameters:

NameTypeRequiredDescription
headersListUserObjectsMDHeadersNoHeaders to be sent with the request (e.g. Prefer for paging control)
queriesListUserObjectsMDQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserObjectsMDCollectionResponse&#124;error

Sample code:

UserObjectsMDCollectionResponse result = check client->listUserObjectsMD();

Sample response:

{
"odata.metadata": "$metadata#UserObjectsMD",
"value": [
{
"TableName": "@MY_UDO",
"Code": "MYUDO1",
"LogTableName": "@MY_UDO_LOG",
"CanCreateDefaultForm": "tYES",
"ObjectType": "boud_MasterData",
"Name": "My User Object",
"CanCancel": "tNO",
"CanDelete": "tYES",
"CanLog": "tYES",
"ManageSeries": "tNO"
}
],
"odata.nextLink": "UserObjectsMD?$skip=20"
}
createUserObjectsMD

Creates a new UserObjectsMD entity in the UserObjectsMD collection.

Parameters:

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

Returns: UserObjectsMD&#124;error

Sample code:

UserObjectsMD result = check client->createUserObjectsMD(payload);

Sample response:

{
"TableName": "@MY_UDO",
"Code": "MYUDO1",
"LogTableName": "@MY_UDO_LOG",
"CanCreateDefaultForm": "tYES",
"ObjectType": "boud_MasterData",
"Name": "My User Object"
}
getUserObjectsMD

Retrieves a single UserObjectsMD entity identified by its Code key.

Parameters:

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

Returns: UserObjectsMD&#124;error

Sample code:

UserObjectsMD result = check client->getUserObjectsMD(code);

Sample response:

{
"TableName": "@MY_UDO",
"Code": "MYUDO1",
"Name": "My User Object",
"ObjectType": "boud_MasterData"
}
deleteUserObjectsMD

Deletes a UserObjectsMD entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteUserObjectsMD(code);
updateUserObjectsMD

Partially updates a UserObjectsMD entity identified by its Code key using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateUserObjectsMD(code, payload);

MobileAddOnSetting

listMobileAddOnSetting

Queries the MobileAddOnSetting collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListMobileAddOnSettingHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListMobileAddOnSettingQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: MobileAddOnSettingCollectionResponse|error

Sample code:

MobileAddOnSettingCollectionResponse result = check client->listMobileAddOnSetting();

Sample response:

{
"odata.metadata": "$metadata#MobileAddOnSetting",
"value": [
{
"Type": "mastModule",
"B1SalesApp": "tYES",
"Description": "Sales Mobile Module",
"LogonMethod": "lmStandardLogon",
"Enable": "tYES",
"ViewStyle": "vstPage",
"B1MobileApp": "tYES",
"Code": "SM01",
"B1ServiceApp": "tNO",
"Url": "https://example.com/mobile",
"Provider": "SAP"
}
],
"odata.nextLink": "MobileAddOnSetting?$skip=20"
}
createMobileAddOnSetting

Creates a new MobileAddOnSetting entity.

Parameters:

NameTypeRequiredDescription
payloadMobileAddOnSettingYesRequest payload describing the mobile add-on setting to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: MobileAddOnSetting|error

Sample code:

MobileAddOnSetting result = check client->createMobileAddOnSetting(payload);

Sample response:

{
"Type": "mastModule",
"B1SalesApp": "tYES",
"Description": "Sales Mobile Module",
"LogonMethod": "lmStandardLogon",
"Enable": "tYES",
"ViewStyle": "vstPage",
"B1MobileApp": "tYES",
"Code": "SM01",
"B1ServiceApp": "tNO",
"Url": "https://example.com/mobile",
"Provider": "SAP"
}
getMobileAddOnSetting

Retrieves a single MobileAddOnSetting entity identified by its Code key.

Parameters:

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

Returns: MobileAddOnSetting|error

Sample code:

MobileAddOnSetting result = check client->getMobileAddOnSetting("SM01");

Sample response:

{
"Type": "mastModule",
"B1SalesApp": "tYES",
"Description": "Sales Mobile Module",
"LogonMethod": "lmStandardLogon",
"Enable": "tYES",
"ViewStyle": "vstPage",
"B1MobileApp": "tYES",
"Code": "SM01",
"B1ServiceApp": "tNO",
"Url": "https://example.com/mobile",
"Provider": "SAP"
}
deleteMobileAddOnSetting

Deletes a MobileAddOnSetting entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteMobileAddOnSetting("SM01");
updateMobileAddOnSetting

Partially updates a MobileAddOnSetting entity (PATCH/MERGE semantics) identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->updateMobileAddOnSetting("SM01", payload);
mobileAddOnSettingServiceGetMobileAddOnSettingList

Returns a lightweight list of mobile add-on settings (code and description only) via the MobileAddOnSettingService function import.

Parameters:

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

Returns: inline_response_200_28|error

Sample code:

inline_response_200_28 result = check client->mobileAddOnSettingServiceGetMobileAddOnSettingList();

Sample response:

{
"odata.metadata": "$metadata#MobileAddOnSettingService_GetMobileAddOnSettingList",
"value": [
{
"Description": "Sales Mobile Module",
"Code": "SM01"
}
]
}

KPIs

listKPIs

Queries the KPIs collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListKPIsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListKPIsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: KPIsCollectionResponse|error

Sample code:

KPIsCollectionResponse result = check client->listKPIs();

Sample response:

{
"odata.metadata": "$metadata#KPIs",
"value": [
{
"KPICode": "KPI01",
"KPIName": "Monthly Sales",
"KPIType": "asMonthly",
"NumberOfColumns": 3,
"KPI_ItemLines": []
}
],
"odata.nextLink": "KPIs?$skip=20"
}
createKPIs

Creates a new KPI entity.

Parameters:

NameTypeRequiredDescription
payloadKPIYesRequest payload describing the KPI to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: KPI|error

Sample code:

KPI result = check client->createKPIs(payload);

Sample response:

{
"KPICode": "KPI01",
"KPIName": "Monthly Sales",
"KPIType": "asMonthly",
"NumberOfColumns": 3,
"KPI_ItemLines": []
}
getKPIs

Retrieves a single KPI entity identified by its KPICode key.

Parameters:

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

Returns: KPI|error

Sample code:

KPI result = check client->getKPIs("KPI01");

Sample response:

{
"KPICode": "KPI01",
"KPIName": "Monthly Sales",
"KPIType": "asMonthly",
"NumberOfColumns": 3,
"KPI_ItemLines": []
}
deleteKPIs

Deletes a KPI entity identified by its KPICode key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteKPIs("KPI01");
updateKPIs

Partially updates a KPI entity (PATCH/MERGE semantics) identified by its KPICode key.

Parameters:

NameTypeRequiredDescription
kPICodestringYesKey property 'KPICode' (Edm.String)
payloadKPIYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateKPIs("KPI01", payload);
kPIsServiceGetList

Returns a lightweight list of KPIs (code and name only) via the KPIsService function import.

Parameters:

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

Returns: inline_response_200_24|error

Sample code:

inline_response_200_24 result = check client->kPIsServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#KPIsService_GetList",
"value": [
{
"KPICode": "KPI01",
"KPIName": "Monthly Sales"
}
]
}

Users

listUsers

Queries the Users collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListUsersHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListUsersQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: UsersCollectionResponse|error

Sample code:

UsersCollectionResponse result = check client->listUsers();

Sample response:

{
"odata.metadata": "$metadata#Users",
"value": [
{
"InternalKey": 1,
"UserCode": "manager",
"UserName": "System Administrator",
"Superuser": "tYES",
"eMail": "[email protected]",
"Branch": 1,
"Department": -1,
"LanguageCode": "ln_English",
"Locked": "tNO",
"Group": -1
}
],
"odata.nextLink": "Users?$skip=20"
}
createUsers

Creates a new User entity.

Parameters:

NameTypeRequiredDescription
payloadUserYesRequest payload describing the user to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: User|error

Sample code:

User result = check client->createUsers(payload);

Sample response:

{
"InternalKey": 10,
"UserCode": "jdoe",
"UserName": "Jane Doe",
"Superuser": "tNO",
"eMail": "[email protected]",
"Branch": 1,
"Department": -1,
"LanguageCode": "ln_English",
"Locked": "tNO",
"Group": -1
}
getUsers

Retrieves a single User entity identified by its InternalKey key.

Parameters:

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

Returns: User|error

Sample code:

User result = check client->getUsers(10);

Sample response:

{
"InternalKey": 10,
"UserCode": "jdoe",
"UserName": "Jane Doe",
"Superuser": "tNO",
"eMail": "[email protected]",
"Branch": 1,
"Department": -1,
"LanguageCode": "ln_English",
"Locked": "tNO",
"Group": -1
}
deleteUsers

Deletes a User entity identified by its InternalKey key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteUsers(10);
updateUsers

Partially updates a User entity (PATCH/MERGE semantics) identified by its InternalKey key.

Parameters:

NameTypeRequiredDescription
internalKeyint:Signed32YesKey property 'InternalKey' (Edm.Int32)
payloadUserYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateUsers(10, payload);
usersClose

Invokes the bound action Close on a User entity (binding type User), closing the user account.

Parameters:

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

Returns: error?

Sample code:

check client->usersClose(10);
usersRemoveUserAndLicense

Invokes the bound action RemoveUserAndLicense on a User entity (binding type User), removing the user and freeing its assigned license.

Parameters:

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

Returns: error?

Sample code:

check client->usersRemoveUserAndLicense(10);
usersServiceGetCurrentUser

Returns the User entity for the currently logged-in session, via the UsersService function import.

Parameters:

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

Returns: User|error

Sample code:

User result = check client->usersServiceGetCurrentUser();

Sample response:

{
"InternalKey": 1,
"UserCode": "manager",
"UserName": "System Administrator",
"Superuser": "tYES",
"eMail": "[email protected]",
"Branch": 1,
"Department": -1,
"LanguageCode": "ln_English",
"Locked": "tNO",
"Group": -1
}

WebClientVariants

webClientVariantServiceGetList

Returns a lightweight list of web client variants (GUID only) via the WebClientVariantService function import.

Parameters:

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

Returns: inline_response_200_55|error

Sample code:

inline_response_200_55 result = check client->webClientVariantServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientVariantService_GetList",
"value": [
{
"Guid": "8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c"
}
]
}
listWebClientVariants

Queries the WebClientVariants collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListWebClientVariantsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListWebClientVariantsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: WebClientVariantsCollectionResponse|error

Sample code:

WebClientVariantsCollectionResponse result = check client->listWebClientVariants();

Sample response:

{
"odata.metadata": "$metadata#WebClientVariants",
"value": [
{
"Guid": "8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c",
"Name": "Default View",
"ObjectName": "Invoices",
"Order": 1,
"FilterBarLayout": "",
"ChartCustomization": "",
"OverviewCustomization": "",
"ReportCustomization": "",
"UserFilter": ""
}
],
"odata.nextLink": "WebClientVariants?$skip=20"
}
createWebClientVariants

Creates a new WebClientVariant entity.

Parameters:

NameTypeRequiredDescription
payloadWebClientVariantYesRequest payload describing the web client variant to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: WebClientVariant|error

Sample code:

WebClientVariant result = check client->createWebClientVariants(payload);

Sample response:

{
"Guid": "8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c",
"Name": "Default View",
"ObjectName": "Invoices",
"Order": 1,
"FilterBarLayout": "",
"ChartCustomization": "",
"OverviewCustomization": "",
"ReportCustomization": "",
"UserFilter": ""
}
getWebClientVariants

Retrieves a single WebClientVariant entity identified by its Guid key.

Parameters:

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

Returns: WebClientVariant|error

Sample code:

WebClientVariant result = check client->getWebClientVariants("8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c");

Sample response:

{
"Guid": "8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c",
"Name": "Default View",
"ObjectName": "Invoices",
"Order": 1,
"FilterBarLayout": "",
"ChartCustomization": "",
"OverviewCustomization": "",
"ReportCustomization": "",
"UserFilter": ""
}
deleteWebClientVariants

Deletes a WebClientVariant entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientVariants("8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c");
updateWebClientVariants

Partially updates a WebClientVariant entity (PATCH/MERGE semantics) identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientVariantYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientVariants("8f14e45f-ceea-467e-9ec5-2f4c0b1a1b2c", payload);

EmailGroups

listEmailGroups

Queries the EmailGroups collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListEmailGroupsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListEmailGroupsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: EmailGroupsCollectionResponse|error

Sample code:

EmailGroupsCollectionResponse result = check client->listEmailGroups();

Sample response:

{
"odata.metadata": "$metadata#EmailGroups",
"value": [
{
"EmailGroupName": "Sales Team",
"EmailGroupCode": "EG01"
}
],
"odata.nextLink": "EmailGroups?$skip=20"
}
createEmailGroups

Creates a new EmailGroup entity.

Parameters:

NameTypeRequiredDescription
payloadEmailGroupYesRequest payload describing the email group to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: EmailGroup|error

Sample code:

EmailGroup result = check client->createEmailGroups(payload);

Sample response:

{
"EmailGroupName": "Sales Team",
"EmailGroupCode": "EG01"
}
getEmailGroups

Retrieves a single EmailGroup entity identified by its EmailGroupCode key.

Parameters:

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

Returns: EmailGroup|error

Sample code:

EmailGroup result = check client->getEmailGroups("EG01");

Sample response:

{
"EmailGroupName": "Sales Team",
"EmailGroupCode": "EG01"
}
deleteEmailGroups

Deletes an EmailGroup entity identified by its EmailGroupCode key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteEmailGroups("EG01");
updateEmailGroups

Partially updates an EmailGroup entity (PATCH/MERGE semantics) identified by its EmailGroupCode key.

Parameters:

NameTypeRequiredDescription
emailGroupCodestringYesKey property 'EmailGroupCode' (Edm.String)
payloadEmailGroupYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateEmailGroups("EG01", payload);
emailGroupsServiceGetList

Returns a lightweight list of email groups (code and name only) via the EmailGroupsService function import.

Parameters:

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

Returns: inline_response_200_19|error

Sample code:

inline_response_200_19 result = check client->emailGroupsServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#EmailGroupsService_GetList",
"value": [
{
"EmailGroupName": "Sales Team",
"EmailGroupCode": "EG01"
}
]
}

WebClientBookmarkTiles

webClientBookmarkTileServiceGetList

Returns a lightweight list of web client bookmark tiles (GUID only) via the WebClientBookmarkTileService function import.

Parameters:

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

Returns: inline_response_200_46|error

Sample code:

inline_response_200_46 result = check client->webClientBookmarkTileServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientBookmarkTileService_GetList",
"value": [
{
"Guid": "3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f"
}
]
}
listWebClientBookmarkTiles

Queries the WebClientBookmarkTiles collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListWebClientBookmarkTilesHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListWebClientBookmarkTilesQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: WebClientBookmarkTilesCollectionResponse|error

Sample code:

WebClientBookmarkTilesCollectionResponse result = check client->listWebClientBookmarkTiles();

Sample response:

{
"odata.metadata": "$metadata#WebClientBookmarkTiles",
"value": [
{
"UrlTarget": "_blank",
"Endpoint": "https://example.com/tile",
"Title": "Open Orders",
"Guid": "3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f",
"Info": "Shows open sales orders",
"BindType": "static",
"SubTitle": "Sales"
}
],
"odata.nextLink": "WebClientBookmarkTiles?$skip=20"
}
createWebClientBookmarkTiles

Creates a new WebClientBookmarkTile entity.

Parameters:

NameTypeRequiredDescription
payloadWebClientBookmarkTileYesRequest payload describing the bookmark tile to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: WebClientBookmarkTile|error

Sample code:

WebClientBookmarkTile result = check client->createWebClientBookmarkTiles(payload);

Sample response:

{
"UrlTarget": "_blank",
"Endpoint": "https://example.com/tile",
"Title": "Open Orders",
"Guid": "3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f",
"Info": "Shows open sales orders",
"BindType": "static",
"SubTitle": "Sales"
}
getWebClientBookmarkTiles

Retrieves a single WebClientBookmarkTile entity identified by its Guid key.

Parameters:

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

Returns: WebClientBookmarkTile|error

Sample code:

WebClientBookmarkTile result = check client->getWebClientBookmarkTiles("3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f");

Sample response:

{
"UrlTarget": "_blank",
"Endpoint": "https://example.com/tile",
"Title": "Open Orders",
"Guid": "3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f",
"Info": "Shows open sales orders",
"BindType": "static",
"SubTitle": "Sales"
}
deleteWebClientBookmarkTiles

Deletes a WebClientBookmarkTile entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientBookmarkTiles("3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f");
updateWebClientBookmarkTiles

Partially updates a WebClientBookmarkTile entity (PATCH/MERGE semantics) identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientBookmarkTileYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientBookmarkTiles("3c9f6a1e-7b2d-4e2a-9c4e-1a2b3c4d5e6f", payload);

WebClientVariantGroups

webClientVariantGroupServiceGetList

Returns a lightweight list of web client variant groups (GUID only) via the WebClientVariantGroupService function import.

Parameters:

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

Returns: inline_response_200_54|error

Sample code:

inline_response_200_54 result = check client->webClientVariantGroupServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientVariantGroupService_GetList",
"value": [
{
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
]
}
listWebClientVariantGroups

Queries the WebClientVariantGroups collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListWebClientVariantGroupsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListWebClientVariantGroupsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: WebClientVariantGroupsCollectionResponse|error

Sample code:

WebClientVariantGroupsCollectionResponse result = check client->listWebClientVariantGroups();

Sample response:

{
"odata.metadata": "$metadata#WebClientVariantGroups",
"value": [
{
"UserId": 1,
"ViewId": "V1",
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"DefaultVariant": "Default",
"ViewType": "Grid",
"ObjectName": "Invoices"
}
],
"odata.nextLink": "WebClientVariantGroups?$skip=20"
}
createWebClientVariantGroups

Creates a new WebClientVariantGroup entity.

Parameters:

NameTypeRequiredDescription
payloadWebClientVariantGroupYesRequest payload describing the variant group to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: WebClientVariantGroup|error

Sample code:

WebClientVariantGroup result = check client->createWebClientVariantGroups(payload);

Sample response:

{
"UserId": 1,
"ViewId": "V1",
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"DefaultVariant": "Default",
"ViewType": "Grid",
"ObjectName": "Invoices"
}
getWebClientVariantGroups

Retrieves a single WebClientVariantGroup entity identified by its Guid key.

Parameters:

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

Returns: WebClientVariantGroup|error

Sample code:

WebClientVariantGroup result = check client->getWebClientVariantGroups("a1b2c3d4-e5f6-7890-abcd-ef1234567890");

Sample response:

{
"UserId": 1,
"ViewId": "V1",
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"DefaultVariant": "Default",
"ViewType": "Grid",
"ObjectName": "Invoices"
}
deleteWebClientVariantGroups

Deletes a WebClientVariantGroup entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientVariantGroups("a1b2c3d4-e5f6-7890-abcd-ef1234567890");
updateWebClientVariantGroups

Partially updates a WebClientVariantGroup entity (PATCH/MERGE semantics) identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientVariantGroupYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientVariantGroups("a1b2c3d4-e5f6-7890-abcd-ef1234567890", payload);

ExceptionalEvents

exceptionalEventServiceGetExceptionalEventList

Returns a lightweight list of exceptional events (code only) via the ExceptionalEventService function import.

Parameters:

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

Returns: inline_response_200_20|error

Sample code:

inline_response_200_20 result = check client->exceptionalEventServiceGetExceptionalEventList();

Sample response:

{
"odata.metadata": "$metadata#ExceptionalEventService_GetExceptionalEventList",
"value": [
{
"Code": "EE01"
}
]
}
listExceptionalEvents

Queries the ExceptionalEvents collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListExceptionalEventsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListExceptionalEventsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: ExceptionalEventsCollectionResponse|error

Sample code:

ExceptionalEventsCollectionResponse result = check client->listExceptionalEvents();

Sample response:

{
"odata.metadata": "$metadata#ExceptionalEvents",
"value": [
{
"Description": "Failed authorization event",
"Code": "EE01"
}
],
"odata.nextLink": "ExceptionalEvents?$skip=20"
}
createExceptionalEvents

Creates a new ExceptionalEvent entity.

Parameters:

NameTypeRequiredDescription
payloadExceptionalEventYesRequest payload describing the exceptional event to create
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: ExceptionalEvent|error

Sample code:

ExceptionalEvent result = check client->createExceptionalEvents(payload);

Sample response:

{
"Description": "Failed authorization event",
"Code": "EE01"
}
getExceptionalEvents

Retrieves a single ExceptionalEvent entity identified by its Code key.

Parameters:

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

Returns: ExceptionalEvent|error

Sample code:

ExceptionalEvent result = check client->getExceptionalEvents("EE01");

Sample response:

{
"Description": "Failed authorization event",
"Code": "EE01"
}
deleteExceptionalEvents

Deletes an ExceptionalEvent entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteExceptionalEvents("EE01");
updateExceptionalEvents

Partially updates an ExceptionalEvent entity (PATCH/MERGE semantics) identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->updateExceptionalEvents("EE01", payload);

SingleUserConnections

listSingleUserConnections

Queries the SingleUserConnections collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListSingleUserConnectionsHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListSingleUserConnectionsQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: SingleUserConnectionsCollectionResponse|error

Sample code:

SingleUserConnectionsCollectionResponse result = check client->listSingleUserConnections();

Sample response:

{
"odata.metadata": "$metadata#SingleUserConnections",
"value": [
{
"Action": "sucaWarning",
"Code": 1
}
],
"odata.nextLink": "SingleUserConnections?$skip=20"
}
createSingleUserConnections

Creates a new SingleUserConnection entity, controlling whether a second concurrent login by the same user is blocked or only produces a warning.

Parameters:

NameTypeRequiredDescription
payloadSingleUserConnectionYesRequest payload describing the single-user-connection rule to create. Action accepts sucaWarning or sucaBlock
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: SingleUserConnection|error

Sample code:

SingleUserConnection result = check client->createSingleUserConnections(payload);

Sample response:

{
"Action": "sucaWarning",
"Code": 1
}
getSingleUserConnections

Retrieves a single SingleUserConnection entity identified by its Code key.

Parameters:

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

Returns: SingleUserConnection|error

Sample code:

SingleUserConnection result = check client->getSingleUserConnections(1);

Sample response:

{
"Action": "sucaWarning",
"Code": 1
}
deleteSingleUserConnections

Deletes a SingleUserConnection entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteSingleUserConnections(1);
updateSingleUserConnections

Partially updates a SingleUserConnection entity (PATCH/MERGE semantics) identified by its Code key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
payloadSingleUserConnectionYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateSingleUserConnections(1, payload);

UserPermissionTree

listUserPermissionTree

Queries the UserPermissionTree collection and returns a page of entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListUserPermissionTreeHeadersNoOptional Prefer header for server-side paging control (e.g. odata.maxpagesize=100)
queriesListUserPermissionTreeQueriesNoOData query options: $skip, $top, $filter, $orderby, $expand, $inlinecount (allpages

Returns: UserPermissionTreeCollectionResponse|error

Sample code:

UserPermissionTreeCollectionResponse result = check client->listUserPermissionTree();

Sample response:

{
"odata.metadata": "$metadata#UserPermissionTree",
"value": [
{
"UserSignature": 1,
"DisplayOrder": 1,
"PermissionID": "3073",
"Options": "bou_FullReadNone",
"Name": "Administration",
"Levels": 0,
"IsItem": "tNO",
"ParentID": ""
}
],
"odata.nextLink": "UserPermissionTree?$skip=20"
}
createUserPermissionTree

Creates a new UserPermissionTree entity, assigning a permission node (and its access level) to a user.

Parameters:

NameTypeRequiredDescription
payloadUserPermissionTreeYesRequest payload describing the permission node to create. Options accepts bou_FullNone or bou_FullReadNone
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: UserPermissionTree|error

Sample code:

UserPermissionTree result = check client->createUserPermissionTree(payload);

Sample response:

{
"UserSignature": 1,
"DisplayOrder": 1,
"PermissionID": "3073",
"Options": "bou_FullReadNone",
"Name": "Administration",
"Levels": 0,
"IsItem": "tNO",
"ParentID": ""
}
getUserPermissionTree

Retrieves a single UserPermissionTree entity identified by its PermissionID key.

Parameters:

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

Returns: UserPermissionTree|error

Sample code:

UserPermissionTree result = check client->getUserPermissionTree("3073");

Sample response:

{
"UserSignature": 1,
"DisplayOrder": 1,
"PermissionID": "3073",
"Options": "bou_FullReadNone",
"Name": "Administration",
"Levels": 0,
"IsItem": "tNO",
"ParentID": ""
}
deleteUserPermissionTree

Deletes a UserPermissionTree entity identified by its PermissionID key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteUserPermissionTree("3073");
updateUserPermissionTree

Partially updates a UserPermissionTree entity (PATCH/MERGE semantics) identified by its PermissionID key.

Parameters:

NameTypeRequiredDescription
permissionIDstringYesKey property 'PermissionID' (Edm.String)
payloadUserPermissionTreeYesRequest payload with the fields to update
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateUserPermissionTree("3073", payload);

ReportFilter

listReportFilter

Queries the ReportFilter collection and returns a page of TaxReportFilter entities.

Parameters:

NameTypeRequiredDescription
headersListReportFilterHeadersNoHeaders to be sent with the request
queriesListReportFilterQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ReportFilterCollectionResponse|error

Sample code:

ReportFilterCollectionResponse result = check administrationClient->listReportFilter();

Sample response:

{
"odata.metadata": "$metadata#ReportFilter",
"value": [
{
"Code": 1,
"Name": "VAT Q1 Filter",
"Quarter": 1,
"IncludeCustomers": "tYES",
"IncludeVendors": "tYES"
}
]
}
createReportFilter

Creates a new TaxReportFilter entity in the ReportFilter collection.

Parameters:

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

Returns: TaxReportFilter|error

Sample code:

TaxReportFilter result = check administrationClient->createReportFilter(payload);

Sample response:

{
"Code": 1,
"Name": "VAT Q1 Filter",
"Quarter": 1,
"IncludeCustomers": "tYES",
"IncludeGLAccounts": "tNO",
"IncludeVendors": "tYES",
"RoundAmount": "tNO"
}
getReportFilter

Retrieves a single TaxReportFilter entity from the ReportFilter collection by its key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetReportFilterQueriesNoQueries to be sent with the request ($expand, $select)

Returns: TaxReportFilter|error

Sample code:

TaxReportFilter result = check administrationClient->getReportFilter(code);

Sample response:

{
"Code": 1,
"Name": "VAT Q1 Filter",
"Quarter": 1,
"IncludeCustomers": "tYES"
}
deleteReportFilter

Deletes a TaxReportFilter entity from the ReportFilter collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteReportFilter(code);
updateReportFilter

Partially updates a TaxReportFilter entity (PATCH/MERGE semantics) in the ReportFilter collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateReportFilter(code, payload);
reportFilterServiceGetTaxReportFilterList

Invokes the ReportFilterService_GetTaxReportFilterList function-import to retrieve a list of tax report filter parameters.

Parameters:

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

Returns: inline_response_200_33|error

Sample code:

inline_response_200_33 result = check administrationClient->reportFilterServiceGetTaxReportFilterList(payload);

Sample response:

{
"odata.metadata": "$metadata#ReportFilterService_GetTaxReportFilterList",
"value": [
{
"FilterType": "trft_VAT",
"Code": 1,
"Name": "VAT Q1 Filter"
}
]
}

ExtendedTranslations

listExtendedTranslations

Queries the ExtendedTranslations collection and returns a page of ExtendedTranslation entities.

Parameters:

NameTypeRequiredDescription
headersListExtendedTranslationsHeadersNoHeaders to be sent with the request
queriesListExtendedTranslationsQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ExtendedTranslationsCollectionResponse|error

Sample code:

ExtendedTranslationsCollectionResponse result = check administrationClient->listExtendedTranslations();

Sample response:

{
"odata.metadata": "$metadata#ExtendedTranslations",
"value": [
{
"DocEntry": 1,
"ID": "ITM001",
"Category": "asMenuItem",
"SourceLanguage": 23,
"SecondaryID": "SEC1"
}
]
}
createExtendedTranslations

Creates a new ExtendedTranslation entity in the ExtendedTranslations collection.

Parameters:

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

Returns: ExtendedTranslation|error

Sample code:

ExtendedTranslation result = check administrationClient->createExtendedTranslations(payload);

Sample response:

{
"DocEntry": 1,
"ID": "ITM001",
"Category": "asMenuItem",
"SourceLanguage": 23,
"CreateDate": "2026-07-01",
"UpdateDate": "2026-07-01"
}
getExtendedTranslations

Retrieves a single ExtendedTranslation entity from the ExtendedTranslations collection by its key.

Parameters:

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

Returns: ExtendedTranslation|error

Sample code:

ExtendedTranslation result = check administrationClient->getExtendedTranslations(docEntry);

Sample response:

{
"DocEntry": 1,
"ID": "ITM001",
"Category": "asMenuItem"
}
deleteExtendedTranslations

Deletes a ExtendedTranslation entity from the ExtendedTranslations collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteExtendedTranslations(docEntry);
updateExtendedTranslations

Partially updates a ExtendedTranslation entity (PATCH/MERGE semantics) in the ExtendedTranslations collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateExtendedTranslations(docEntry, payload);
extendedTranslationsServiceGetExtendedTranslationList

Invokes the ExtendedTranslationsService_GetExtendedTranslationList function-import to retrieve the list of extended translation parameters.

Parameters:

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

Returns: inline_response_200_21|error

Sample code:

inline_response_200_21 result = check administrationClient->extendedTranslationsServiceGetExtendedTranslationList();

Sample response:

{
"odata.metadata": "$metadata#ExtendedTranslationsService_GetExtendedTranslationList",
"value": [
{
"DocEntry": 1,
"ID": "ITM001",
"Category": "asMenuItem",
"SecondaryID": "SEC1"
}
]
}

Messages

listMessages

Queries the Messages collection and returns a page of Message entities.

Parameters:

NameTypeRequiredDescription
headersListMessagesHeadersNoHeaders to be sent with the request
queriesListMessagesQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: MessagesCollectionResponse|error

Sample code:

MessagesCollectionResponse result = check administrationClient->listMessages();

Sample response:

{
"odata.metadata": "$metadata#Messages",
"value": [
{
"Code": 1,
"Subject": "System Notice",
"Text": "Backup completed",
"User": 1,
"Priority": "mp_Normal"
}
]
}
createMessages

Creates a new Message entity in the Messages collection.

Parameters:

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

Returns: Message|error

Sample code:

Message result = check administrationClient->createMessages(payload);

Sample response:

{
"Code": 1,
"Subject": "System Notice",
"Text": "Backup completed",
"User": 1,
"Priority": "mp_Normal",
"RecipientCollection": [
{
"SendInternally": "tYES"
}
]
}
getMessages

Retrieves a single Message entity from the Messages collection by its key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetMessagesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: Message|error

Sample code:

Message result = check administrationClient->getMessages(code);

Sample response:

{
"Code": 1,
"Subject": "System Notice",
"Text": "Backup completed"
}
deleteMessages

Deletes a Message entity from the Messages collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteMessages(code);
updateMessages

Partially updates a Message entity (PATCH/MERGE semantics) in the Messages collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateMessages(code, payload);
messagesServiceGetInbox

Invokes the MessagesService_GetInbox function-import to retrieve the current user's inbox message headers.

Parameters:

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

Returns: inline_response_200_25|error

Sample code:

inline_response_200_25 result = check administrationClient->messagesServiceGetInbox();

Sample response:

{
"odata.metadata": "$metadata#MessagesService_GetInbox",
"value": [
{
"Read": "tNO",
"Received": "tYES",
"ReceivedDate": "2026-07-10",
"SentDate": "2026-07-10",
"SentTime": "10:00:00"
}
]
}
messagesServiceGetOutbox

Invokes the MessagesService_GetOutbox function-import to retrieve the current user's outbox message headers.

Parameters:

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

Returns: inline_response_200_26|error

Sample code:

inline_response_200_26 result = check administrationClient->messagesServiceGetOutbox();

Sample response:

{
"odata.metadata": "$metadata#MessagesService_GetOutbox",
"value": [
{
"Read": "tNO",
"Received": "tNO",
"SentDate": "2026-07-10",
"SentTime": "10:00:00"
}
]
}
messagesServiceGetSentMessages

Invokes the MessagesService_GetSentMessages function-import to retrieve the list of message headers the current user has sent.

Parameters:

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

Returns: inline_response_200_27|error

Sample code:

inline_response_200_27 result = check administrationClient->messagesServiceGetSentMessages();

Sample response:

{
"odata.metadata": "$metadata#MessagesService_GetSentMessages",
"value": [
{
"Read": "tYES",
"Received": "tYES",
"SentDate": "2026-07-09",
"SentTime": "14:32:00"
}
]
}

States

listStates

Queries the States collection and returns a page of State entities.

Parameters:

NameTypeRequiredDescription
headersListStatesHeadersNoHeaders to be sent with the request
queriesListStatesQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: StatesCollectionResponse|error

Sample code:

StatesCollectionResponse result = check administrationClient->listStates();

Sample response:

{
"odata.metadata": "$metadata#States",
"value": [
{
"Code": "CA",
"Country": "US",
"Name": "California",
"IsUnionTerritory": "tNO"
}
]
}
createStates

Creates a new State entity in the States collection.

Parameters:

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

Returns: State|error

Sample code:

State result = check administrationClient->createStates(payload);

Sample response:

{
"Code": "CA",
"Country": "US",
"Name": "California",
"GSTCode": "",
"IsUnionTerritory": "tNO"
}
getStates

Retrieves a single State entity from the States collection by its composite key (Code, Country).

Parameters:

NameTypeRequiredDescription
codestringYesComposite key part 'Code' (Edm.String)
countrystringYesComposite key part 'Country' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetStatesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: State|error

Sample code:

State result = check administrationClient->getStates(code, country);

Sample response:

{
"Code": "CA",
"Country": "US",
"Name": "California"
}
deleteStates

Deletes a State entity from the States collection by its composite key (Code, Country).

Parameters:

NameTypeRequiredDescription
codestringYesComposite key part 'Code' (Edm.String)
countrystringYesComposite key part 'Country' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->deleteStates(code, country);
updateStates

Partially updates a State entity (PATCH/MERGE semantics) in the States collection by its composite key.

Parameters:

NameTypeRequiredDescription
codestringYesComposite key part 'Code' (Edm.String)
countrystringYesComposite key part 'Country' (Edm.String)
payloadStateYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->updateStates(code, country, payload);
statesServiceGetStateList

Invokes the StatesService_GetStateList function-import to retrieve the list of state parameters.

Parameters:

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

Returns: inline_response_200_39|error

Sample code:

inline_response_200_39 result = check administrationClient->statesServiceGetStateList();

Sample response:

{
"odata.metadata": "$metadata#StatesService_GetStateList",
"value": [
{
"Code": "CA",
"Country": "US",
"Name": "California"
}
]
}

Branches

listBranches

Queries the Branches collection and returns a page of Branch entities.

Parameters:

NameTypeRequiredDescription
headersListBranchesHeadersNoHeaders to be sent with the request
queriesListBranchesQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: BranchesCollectionResponse|error

Sample code:

BranchesCollectionResponse result = check administrationClient->listBranches();

Sample response:

{
"odata.metadata": "$metadata#Branches",
"value": [
{
"Code": 1,
"Name": "Head Office",
"Description": "Main branch"
}
]
}
createBranches

Creates a new Branch entity in the Branches collection.

Parameters:

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

Returns: Branch|error

Sample code:

Branch result = check administrationClient->createBranches(payload);

Sample response:

{
"Code": 1,
"Name": "Head Office",
"Description": "Main branch",
"Users": [
{
"UserCode": 1
}
]
}
getBranches

Retrieves a single Branch entity from the Branches collection by its key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetBranchesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: Branch|error

Sample code:

Branch result = check administrationClient->getBranches(code);

Sample response:

{
"Code": 1,
"Name": "Head Office",
"Description": "Main branch"
}
deleteBranches

Deletes a Branch entity from the Branches collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteBranches(code);
updateBranches

Partially updates a Branch entity (PATCH/MERGE semantics) in the Branches collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateBranches(code, payload);
branchesServiceGetBranchList

Invokes the BranchesService_GetBranchList function-import to retrieve the list of branch parameters.

Parameters:

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

Returns: inline_response_200_6|error

Sample code:

inline_response_200_6 result = check administrationClient->branchesServiceGetBranchList();

Sample response:

{
"odata.metadata": "$metadata#BranchesService_GetBranchList",
"value": [
{
"Code": 1,
"Name": "Head Office"
}
]
}

QueryCategories

listQueryCategories

Queries the QueryCategories collection and returns a page of QueryCategory entities.

Parameters:

NameTypeRequiredDescription
headersListQueryCategoriesHeadersNoHeaders to be sent with the request
queriesListQueryCategoriesQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: QueryCategoriesCollectionResponse|error

Sample code:

QueryCategoriesCollectionResponse result = check administrationClient->listQueryCategories();

Sample response:

{
"odata.metadata": "$metadata#QueryCategories",
"value": [
{
"Code": 1,
"Name": "Sales Queries",
"Permissions": "pFull"
}
]
}
createQueryCategories

Creates a new QueryCategory entity in the QueryCategories collection.

Parameters:

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

Returns: QueryCategory|error

Sample code:

QueryCategory result = check administrationClient->createQueryCategories(payload);

Sample response:

{
"Code": 1,
"Name": "Sales Queries",
"Permissions": "pFull",
"UserQueries": []
}
getQueryCategories

Retrieves a single QueryCategory entity from the QueryCategories collection by its key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetQueryCategoriesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: QueryCategory|error

Sample code:

QueryCategory result = check administrationClient->getQueryCategories(code);

Sample response:

{
"Code": 1,
"Name": "Sales Queries",
"Permissions": "pFull"
}
deleteQueryCategories

Deletes a QueryCategory entity from the QueryCategories collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteQueryCategories(code);
updateQueryCategories

Partially updates a QueryCategory entity (PATCH/MERGE semantics) in the QueryCategories collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateQueryCategories(code, payload);

WebClientLaunchpads

webClientLaunchpadServiceGetList

Invokes the WebClientLaunchpadService_GetList function-import to retrieve the list of web client launchpad parameters.

Parameters:

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

Returns: inline_response_200_49|error

Sample code:

inline_response_200_49 result = check administrationClient->webClientLaunchpadServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#WebClientLaunchpadService_GetList",
"value": [
{
"Guid": "550e8400-e29b-41d4-a716-446655440000"
}
]
}
listWebClientLaunchpads

Queries the WebClientLaunchpads collection and returns a page of WebClientLaunchpad entities.

Parameters:

NameTypeRequiredDescription
headersListWebClientLaunchpadsHeadersNoHeaders to be sent with the request
queriesListWebClientLaunchpadsQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: WebClientLaunchpadsCollectionResponse|error

Sample code:

WebClientLaunchpadsCollectionResponse result = check administrationClient->listWebClientLaunchpads();

Sample response:

{
"odata.metadata": "$metadata#WebClientLaunchpads",
"value": [
{
"Guid": "550e8400-e29b-41d4-a716-446655440000",
"ThemeId": "default",
"UserId": 1,
"DisplayQuickView": "tYES"
}
]
}
createWebClientLaunchpads

Creates a new WebClientLaunchpad entity in the WebClientLaunchpads collection.

Parameters:

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

Returns: WebClientLaunchpad|error

Sample code:

WebClientLaunchpad result = check administrationClient->createWebClientLaunchpads(payload);

Sample response:

{
"Guid": "550e8400-e29b-41d4-a716-446655440000",
"ThemeId": "default",
"UserId": 1,
"NotificationShowDays": 7,
"DisplayQuickView": "tYES",
"WebClientLaunchpadGroups": []
}
getWebClientLaunchpads

Retrieves a single WebClientLaunchpad entity from the WebClientLaunchpads collection by its key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientLaunchpadsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: WebClientLaunchpad|error

Sample code:

WebClientLaunchpad result = check administrationClient->getWebClientLaunchpads(guid);

Sample response:

{
"Guid": "550e8400-e29b-41d4-a716-446655440000",
"ThemeId": "default",
"UserId": 1
}
deleteWebClientLaunchpads

Deletes a WebClientLaunchpad entity from the WebClientLaunchpads collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteWebClientLaunchpads(guid);
updateWebClientLaunchpads

Partially updates a WebClientLaunchpad entity (PATCH/MERGE semantics) in the WebClientLaunchpads collection.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientLaunchpadYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->updateWebClientLaunchpads(guid, payload);

B1Sessions

listB1Sessions

Queries the B1Sessions collection and returns a page of B1Session entities.

Parameters:

NameTypeRequiredDescription
headersListB1SessionsHeadersNoHeaders to be sent with the request
queriesListB1SessionsQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: B1SessionsCollectionResponse|error

Sample code:

B1SessionsCollectionResponse result = check administrationClient->listB1Sessions();

Sample response:

{
"odata.metadata": "$metadata#B1Sessions",
"value": [
{
"SessionId": "9d8f2b1c-...",
"Version": "10.0",
"SessionTimeout": 30
}
]
}
createB1Sessions

Creates a new B1Session entity in the B1Sessions collection.

Parameters:

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

Returns: B1Session|error

Sample code:

B1Session result = check administrationClient->createB1Sessions(payload);

Sample response:

{
"SessionId": "9d8f2b1c-...",
"Version": "10.0",
"SessionTimeout": 30
}
getB1Sessions

Retrieves a single B1Session entity from the B1Sessions collection by its key.

Parameters:

NameTypeRequiredDescription
sessionIdstringYesKey property 'SessionId' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetB1SessionsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: B1Session|error

Sample code:

B1Session result = check administrationClient->getB1Sessions(sessionId);

Sample response:

{
"SessionId": "9d8f2b1c-...",
"Version": "10.0"
}
deleteB1Sessions

Deletes a B1Session entity from the B1Sessions collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteB1Sessions(sessionId);
updateB1Sessions

Partially updates a B1Session entity (PATCH/MERGE semantics) in the B1Sessions collection.

Parameters:

NameTypeRequiredDescription
sessionIdstringYesKey property 'SessionId' (Edm.String)
payloadB1SessionYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->updateB1Sessions(sessionId, payload);

Holidays

holidayServiceGetHolidayList

Invokes the HolidayService_GetHolidayList function-import to retrieve the list of holiday parameters.

Parameters:

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

Returns: inline_response_200_22|error

Sample code:

inline_response_200_22 result = check administrationClient->holidayServiceGetHolidayList();

Sample response:

{
"odata.metadata": "$metadata#HolidayService_GetHolidayList",
"value": [
{
"HolidayCode": "NEWYEAR"
}
]
}
listHolidays

Queries the Holidays collection and returns a page of Holiday entities.

Parameters:

NameTypeRequiredDescription
headersListHolidaysHeadersNoHeaders to be sent with the request
queriesListHolidaysQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: HolidaysCollectionResponse|error

Sample code:

HolidaysCollectionResponse result = check administrationClient->listHolidays();

Sample response:

{
"odata.metadata": "$metadata#Holidays",
"value": [
{
"HolidayCode": "NEWYEAR",
"ValidForOneYearOnly": "tNO",
"HolidayDates": [
{
"Date": "2026-01-01"
}
]
}
]
}
createHolidays

Creates a new Holiday entity in the Holidays collection.

Parameters:

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

Returns: Holiday|error

Sample code:

Holiday result = check administrationClient->createHolidays(payload);

Sample response:

{
"HolidayCode": "NEWYEAR",
"ValidForOneYearOnly": "tNO",
"SetWeekendsAsWorkDays": "tNO",
"WeekendFrom": "wSaturday",
"WeekendTO": "wSunday"
}
getHolidays

Retrieves a single Holiday entity from the Holidays collection by its key.

Parameters:

NameTypeRequiredDescription
holidayCodestringYesKey property 'HolidayCode' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetHolidaysQueriesNoQueries to be sent with the request ($expand, $select)

Returns: Holiday|error

Sample code:

Holiday result = check administrationClient->getHolidays(holidayCode);

Sample response:

{
"HolidayCode": "NEWYEAR",
"ValidForOneYearOnly": "tNO"
}
deleteHolidays

Deletes a Holiday entity from the Holidays collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteHolidays(holidayCode);
updateHolidays

Partially updates a Holiday entity (PATCH/MERGE semantics) in the Holidays collection.

Parameters:

NameTypeRequiredDescription
holidayCodestringYesKey property 'HolidayCode' (Edm.String)
payloadHolidayYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->updateHolidays(holidayCode, payload);

UserDefaultGroups

listUserDefaultGroups

Queries the UserDefaultGroups collection and returns a page of UserDefaultGroup entities.

Parameters:

NameTypeRequiredDescription
headersListUserDefaultGroupsHeadersNoHeaders to be sent with the request
queriesListUserDefaultGroupsQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserDefaultGroupsCollectionResponse|error

Sample code:

UserDefaultGroupsCollectionResponse result = check administrationClient->listUserDefaultGroups();

Sample response:

{
"odata.metadata": "$metadata#UserDefaultGroups",
"value": [
{
"Code": "MAIN",
"Name": "Main Default Group",
"Warehouse": "01",
"SalesEmployee": 1
}
]
}
createUserDefaultGroups

Creates a new UserDefaultGroup entity in the UserDefaultGroups collection.

Parameters:

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

Returns: UserDefaultGroup|error

Sample code:

UserDefaultGroup result = check administrationClient->createUserDefaultGroups(payload);

Sample response:

{
"Code": "MAIN",
"Name": "Main Default Group",
"Warehouse": "01",
"SalesEmployee": 1,
"CashAccount": "_SYS00000001"
}
getUserDefaultGroups

Retrieves a single UserDefaultGroup entity from the UserDefaultGroups collection by its key.

Parameters:

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

Returns: UserDefaultGroup|error

Sample code:

UserDefaultGroup result = check administrationClient->getUserDefaultGroups(code);

Sample response:

{
"Code": "MAIN",
"Name": "Main Default Group",
"Warehouse": "01"
}
deleteUserDefaultGroups

Deletes a UserDefaultGroup entity from the UserDefaultGroups collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteUserDefaultGroups(code);
updateUserDefaultGroups

Partially updates a UserDefaultGroup entity (PATCH/MERGE semantics) in the UserDefaultGroups collection.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->updateUserDefaultGroups(code, payload);

UserTablesMD

listUserTablesMD

Queries the UserTablesMD collection and returns a page of UserTablesMD entities.

Parameters:

NameTypeRequiredDescription
headersListUserTablesMDHeadersNoHeaders to be sent with the request
queriesListUserTablesMDQueriesNoQueries to be sent with the request ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserTablesMDCollectionResponse|error

Sample code:

UserTablesMDCollectionResponse result = check administrationClient->listUserTablesMD();

Sample response:

{
"odata.metadata": "$metadata#UserTablesMD",
"value": [
{
"TableName": "MY_TABLE",
"TableDescription": "Custom table",
"TableType": "bott_MasterData",
"Archivable": "tNO"
}
]
}
createUserTablesMD

Creates a new UserTablesMD entity in the UserTablesMD collection.

Parameters:

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

Returns: UserTablesMD|error

Sample code:

UserTablesMD result = check administrationClient->createUserTablesMD(payload);

Sample response:

{
"TableName": "MY_TABLE",
"TableDescription": "Custom table",
"TableType": "bott_MasterData",
"Archivable": "tNO",
"DisplayMenu": "tYES",
"ApplyAuthorization": "tNO"
}
getUserTablesMD

Retrieves a single UserTablesMD entity from the UserTablesMD collection by its key.

Parameters:

NameTypeRequiredDescription
tableNamestringYesKey property 'TableName' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetUserTablesMDQueriesNoQueries to be sent with the request ($expand, $select)

Returns: UserTablesMD|error

Sample code:

UserTablesMD result = check administrationClient->getUserTablesMD(tableName);

Sample response:

{
"TableName": "MY_TABLE",
"TableDescription": "Custom table",
"TableType": "bott_MasterData"
}
deleteUserTablesMD

Deletes a UserTablesMD entity from the UserTablesMD collection by its key.

Parameters:

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

Returns: error?

Sample code:

error? result = check administrationClient->deleteUserTablesMD(tableName);
updateUserTablesMD

Partially updates a UserTablesMD entity (PATCH/MERGE semantics) in the UserTablesMD collection.

Parameters:

NameTypeRequiredDescription
tableNamestringYesKey property 'TableName' (Edm.String)
payloadUserTablesMDYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

error? result = check administrationClient->updateUserTablesMD(tableName, payload);

ReportTypes

listReportTypes

Queries the ReportTypes collection and returns a page of report type entities, optionally filtered, sorted, or paged via OData query options.

Parameters:

NameTypeRequiredDescription
headersListReportTypesHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListReportTypesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ReportTypesCollectionResponse|error

Sample code:

ReportTypesCollectionResponse result = check client->listReportTypes();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#ReportTypes",
"value": [
{
"TypeName": "Sales Analysis",
"MenuID": "3073",
"TypeCode": "SA_REPORT",
"AddonName": "",
"AddonFormType": "",
"DefaultReportLayout": ""
}
]
}
createReportTypes

Creates a new ReportType entity in SAP Business One.

Parameters:

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

Returns: ReportType|error

Sample code:

ReportType result = check client->createReportTypes(payload);

Sample response:

{
"TypeName": "Sales Analysis",
"MenuID": "3073",
"TypeCode": "SA_REPORT",
"AddonName": "",
"AddonFormType": "",
"DefaultReportLayout": ""
}
getReportTypes

Retrieves a single ReportType entity identified by its TypeCode key.

Parameters:

NameTypeRequiredDescription
typeCodestringYesKey property 'TypeCode' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetReportTypesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: ReportType|error

Sample code:

ReportType result = check client->getReportTypes(typeCode);

Sample response:

{
"TypeName": "Sales Analysis",
"MenuID": "3073",
"TypeCode": "SA_REPORT",
"AddonName": "",
"AddonFormType": "",
"DefaultReportLayout": ""
}
deleteReportTypes

Deletes the ReportType entity identified by its TypeCode key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteReportTypes(typeCode);
updateReportTypes

Partially updates a ReportType entity using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
typeCodestringYesKey property 'TypeCode' (Edm.String)
payloadReportTypeYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateReportTypes(typeCode, payload);
reportTypesServiceGetReportTypeList

Invokes the ReportTypesService_GetReportTypeList unbound function to retrieve the report type list.

Parameters:

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

Returns: inline_response_200_35|error

Sample code:

inline_response_200_35 result = check client->reportTypesServiceGetReportTypeList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#ReportTypesService_GetReportTypeList",
"value": [
{
"TypeName": "Sales Analysis",
"MenuID": "3073",
"TypeCode": "SA_REPORT",
"AddonName": "",
"AddonFormType": ""
}
]
}

DistributionLists

listDistributionLists

Queries the DistributionLists collection and returns a page of distribution list entities.

Parameters:

NameTypeRequiredDescription
headersListDistributionListsHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListDistributionListsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: DistributionListsCollectionResponse|error

Sample code:

DistributionListsCollectionResponse result = check client->listDistributionLists();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#DistributionLists",
"value": [
{
"Code": 1,
"Name": "Finance Approvals",
"DistributionListLines": [
{
"LineNumber": 0,
"DistributionType": "dt_InternalUser",
"DistributionCode": "manager",
"Email": "[email protected]"
}
]
}
]
}
createDistributionLists

Creates a new DistributionList entity.

Parameters:

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

Returns: DistributionList|error

Sample code:

DistributionList result = check client->createDistributionLists(payload);

Sample response:

{
"Code": 1,
"Name": "Finance Approvals",
"DistributionListLines": [
{
"LineNumber": 0,
"DistributionType": "dt_InternalUser",
"DistributionCode": "manager",
"Email": "[email protected]"
}
]
}
getDistributionLists

Retrieves a single DistributionList entity identified by its Code key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetDistributionListsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: DistributionList|error

Sample code:

DistributionList result = check client->getDistributionLists(code);

Sample response:

{
"Code": 1,
"Name": "Finance Approvals",
"DistributionListLines": []
}
deleteDistributionLists

Deletes the DistributionList entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteDistributionLists(code);
updateDistributionLists

Partially updates a DistributionList entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateDistributionLists(code, payload);
distributionListsCancel

Invokes the bound action Cancel on a DistributionList entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->distributionListsCancel(code);
distributionListsClose

Invokes the bound action Close on a DistributionList entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->distributionListsClose(code);
distributionListsReopen

Invokes the bound action Reopen on a DistributionList entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->distributionListsReopen(code);
distributionListsServiceGetList

Invokes the DistributionListsService_GetList unbound function to retrieve the distribution list summary list.

Parameters:

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

Returns: inline_response_200_18|error

Sample code:

inline_response_200_18 result = check client->distributionListsServiceGetList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#DistributionListsService_GetList",
"value": [
{
"Code": 1,
"Name": "Finance Approvals"
}
]
}

ValueMappingCommunication

listValueMappingCommunication

Queries the ValueMappingCommunication collection and returns a page of value mapping communication log entities.

Parameters:

NameTypeRequiredDescription
headersListValueMappingCommunicationHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListValueMappingCommunicationQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ValueMappingCommunicationCollectionResponse|error

Sample code:

ValueMappingCommunicationCollectionResponse result = check client->listValueMappingCommunication();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#ValueMappingCommunication",
"value": [
{
"AbsEntry": 1,
"ThirdPartySystemId": 2,
"ObjectId": 17,
"CommunicationType": "vmct_MasterData",
"Status": "vmcs_Successful",
"StartDate": "2026-07-01",
"EndDate": "2026-07-01"
}
]
}
createValueMappingCommunication

Creates a new ValueMappingCommunicationData entity.

Parameters:

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

Returns: ValueMappingCommunicationData|error

Sample code:

ValueMappingCommunicationData result = check client->createValueMappingCommunication(payload);

Sample response:

{
"AbsEntry": 1,
"ThirdPartySystemId": 2,
"ObjectId": 17,
"CommunicationType": "vmct_MasterData",
"Status": "vmcs_Pending",
"StartDate": "2026-07-01",
"EndDate": "2026-07-01"
}
getValueMappingCommunication

Retrieves a single ValueMappingCommunicationData entity identified by its AbsEntry key.

Parameters:

NameTypeRequiredDescription
absEntryint:Signed32YesKey property 'AbsEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetValueMappingCommunicationQueriesNoQueries to be sent with the request ($expand, $select)

Returns: ValueMappingCommunicationData|error

Sample code:

ValueMappingCommunicationData result = check client->getValueMappingCommunication(absEntry);

Sample response:

{
"AbsEntry": 1,
"ThirdPartySystemId": 2,
"ObjectId": 17,
"CommunicationType": "vmct_MasterData",
"Status": "vmcs_Error",
"Message": "Mapping value not found"
}
deleteValueMappingCommunication

Deletes the ValueMappingCommunicationData entity identified by its AbsEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteValueMappingCommunication(absEntry);
updateValueMappingCommunication

Partially updates a ValueMappingCommunicationData entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateValueMappingCommunication(absEntry, payload);

SQLViews

listSQLViews

Queries the SQLViews collection and returns a page of SQL view entities.

Parameters:

NameTypeRequiredDescription
headersListSQLViewsHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListSQLViewsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: SQLViewsCollectionResponse|error

Sample code:

SQLViewsCollectionResponse result = check client->listSQLViews();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#SQLViews",
"value": [
{
"Name": "OpenInvoicesView",
"DBType": "dt_SQLServer",
"SchemaName": "dbo",
"CreateDate": "2026-01-15"
}
]
}
createSQLViews

Creates a new SQLView entity.

Parameters:

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

Returns: SQLView|error

Sample code:

SQLView result = check client->createSQLViews(payload);

Sample response:

{
"Name": "OpenInvoicesView",
"DBType": "dt_SQLServer",
"SchemaName": "dbo",
"CreateDate": "2026-01-15"
}
getSQLViews

Retrieves a single SQLView entity identified by its Name key.

Parameters:

NameTypeRequiredDescription
namestringYesKey property 'Name' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetSQLViewsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: SQLView|error

Sample code:

SQLView result = check client->getSQLViews(name);

Sample response:

{
"Name": "OpenInvoicesView",
"DBType": "dt_SQLServer",
"SchemaName": "dbo",
"CreateDate": "2026-01-15"
}
deleteSQLViews

Deletes the SQLView entity identified by its Name key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteSQLViews(name);
updateSQLViews

Partially updates a SQLView entity using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
namestringYesKey property 'Name' (Edm.String)
payloadSQLViewYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateSQLViews(name, payload);
sQLViewsExpose

Invokes the bound action Expose on a SQLView entity identified by its Name key, publishing the view for OData access.

Parameters:

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

Returns: error?

Sample code:

check client->sQLViewsExpose(name);
sQLViewsUnexpose

Invokes the bound action Unexpose on a SQLView entity identified by its Name key, removing the view's OData exposure.

Parameters:

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

Returns: error?

Sample code:

check client->sQLViewsUnexpose(name);

ApprovalTemplates

listApprovalTemplates

Queries the ApprovalTemplates collection and returns a page of approval template entities.

Parameters:

NameTypeRequiredDescription
headersListApprovalTemplatesHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListApprovalTemplatesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ApprovalTemplatesCollectionResponse|error

Sample code:

ApprovalTemplatesCollectionResponse result = check client->listApprovalTemplates();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#ApprovalTemplates",
"value": [
{
"Code": 1,
"Name": "Purchase Order Approval",
"IsActive": "tYES",
"UseTerms": "tNO",
"IsActiveWhenUpdatingDocuments": "tNO"
}
]
}
createApprovalTemplates

Creates a new ApprovalTemplate entity.

Parameters:

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

Returns: ApprovalTemplate|error

Sample code:

ApprovalTemplate result = check client->createApprovalTemplates(payload);

Sample response:

{
"Code": 1,
"Name": "Purchase Order Approval",
"IsActive": "tYES",
"UseTerms": "tNO",
"Remarks": "Requires manager sign-off"
}
getApprovalTemplates

Retrieves a single ApprovalTemplate entity identified by its Code key.

Parameters:

NameTypeRequiredDescription
codeint:Signed32YesKey property 'Code' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetApprovalTemplatesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: ApprovalTemplate|error

Sample code:

ApprovalTemplate result = check client->getApprovalTemplates(code);

Sample response:

{
"Code": 1,
"Name": "Purchase Order Approval",
"IsActive": "tYES",
"UseTerms": "tNO"
}
deleteApprovalTemplates

Deletes the ApprovalTemplate entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteApprovalTemplates(code);
updateApprovalTemplates

Partially updates an ApprovalTemplate entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateApprovalTemplates(code, payload);
approvalTemplatesServiceGetApprovalTemplateList

Invokes the ApprovalTemplatesService_GetApprovalTemplateList unbound function to retrieve the approval template summary list.

Parameters:

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

Returns: inline_response_200_5|error

Sample code:

inline_response_200_5 result = check client->approvalTemplatesServiceGetApprovalTemplateList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#ApprovalTemplatesService_GetApprovalTemplateList",
"value": [
{
"Code": 1,
"Name": "Purchase Order Approval"
}
]
}

IntegrationPackagesConfigure

listIntegrationPackagesConfigure

Queries the IntegrationPackagesConfigure collection and returns a page of integration package configuration entities.

Parameters:

NameTypeRequiredDescription
headersListIntegrationPackagesConfigureHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListIntegrationPackagesConfigureQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: IntegrationPackagesConfigureCollectionResponse|error

Sample code:

IntegrationPackagesConfigureCollectionResponse result = check client->listIntegrationPackagesConfigure();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#IntegrationPackagesConfigure",
"value": [
{
"AbsEntry": 1,
"Code": "B1i_INT_01",
"Name": "SFTP Integration Package",
"IsEnable": "tYES"
}
]
}
createIntegrationPackagesConfigure

Creates a new IntegrationPackageConfigure entity.

Parameters:

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

Returns: IntegrationPackageConfigure|error

Sample code:

IntegrationPackageConfigure result = check client->createIntegrationPackagesConfigure(payload);

Sample response:

{
"AbsEntry": 1,
"Code": "B1i_INT_01",
"Name": "SFTP Integration Package",
"IsEnable": "tYES"
}
getIntegrationPackagesConfigure

Retrieves a single IntegrationPackageConfigure entity identified by its AbsEntry key.

Parameters:

NameTypeRequiredDescription
absEntryint:Signed32YesKey property 'AbsEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetIntegrationPackagesConfigureQueriesNoQueries to be sent with the request ($expand, $select)

Returns: IntegrationPackageConfigure|error

Sample code:

IntegrationPackageConfigure result = check client->getIntegrationPackagesConfigure(absEntry);

Sample response:

{
"AbsEntry": 1,
"Code": "B1i_INT_01",
"Name": "SFTP Integration Package",
"IsEnable": "tYES"
}
deleteIntegrationPackagesConfigure

Deletes the IntegrationPackageConfigure entity identified by its AbsEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteIntegrationPackagesConfigure(absEntry);
updateIntegrationPackagesConfigure

Partially updates an IntegrationPackageConfigure entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateIntegrationPackagesConfigure(absEntry, payload);
integrationPackagesConfigureServiceGetList

Invokes the IntegrationPackagesConfigureService_GetList unbound function to retrieve the integration package configuration summary list.

Parameters:

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

Returns: inline_response_200_23|error

Sample code:

inline_response_200_23 result = check client->integrationPackagesConfigureServiceGetList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#IntegrationPackagesConfigureService_GetList",
"value": [
{
"AbsEntry": 1
}
]
}

WebClientFormSettings

webClientFormSettingServiceGetList

Invokes the WebClientFormSettingService_GetList unbound function to retrieve the web client form setting summary list.

Parameters:

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

Returns: inline_response_200_48|error

Sample code:

inline_response_200_48 result = check client->webClientFormSettingServiceGetList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#WebClientFormSettingService_GetList",
"value": [
{
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
]
}
listWebClientFormSettings

Queries the WebClientFormSettings collection and returns a page of web client form setting entities.

Parameters:

NameTypeRequiredDescription
headersListWebClientFormSettingsHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListWebClientFormSettingsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: WebClientFormSettingsCollectionResponse|error

Sample code:

WebClientFormSettingsCollectionResponse result = check client->listWebClientFormSettings();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#WebClientFormSettings",
"value": [
{
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"FormId": "133",
"DocObjectCode": "17",
"UserId": 1,
"WebClientFormSettingItems": []
}
]
}
createWebClientFormSettings

Creates a new WebClientFormSetting entity.

Parameters:

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

Returns: WebClientFormSetting|error

Sample code:

WebClientFormSetting result = check client->createWebClientFormSettings(payload);

Sample response:

{
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"FormId": "133",
"DocObjectCode": "17",
"UserId": 1
}
getWebClientFormSettings

Retrieves a single WebClientFormSetting entity identified by its Guid key.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetWebClientFormSettingsQueriesNoQueries to be sent with the request ($expand, $select)

Returns: WebClientFormSetting|error

Sample code:

WebClientFormSetting result = check client->getWebClientFormSettings(guid);

Sample response:

{
"Guid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"FormId": "133",
"DocObjectCode": "17",
"UserId": 1
}
deleteWebClientFormSettings

Deletes the WebClientFormSetting entity identified by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientFormSettings(guid);
updateWebClientFormSettings

Partially updates a WebClientFormSetting entity using PATCH/MERGE semantics.

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientFormSettingYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientFormSettings(guid, payload);

Attachments2

listAttachments2

Queries the Attachments2 collection and returns a page of attachment entities.

Parameters:

NameTypeRequiredDescription
headersListAttachments2HeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListAttachments2QueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: Attachments2CollectionResponse|error

Sample code:

Attachments2CollectionResponse result = check client->listAttachments2();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#Attachments2",
"value": [
{
"AbsoluteEntry": 1,
"Attachments2_Lines": [
{
"FileName": "invoice",
"FileExtension": "pdf"
}
]
}
]
}
createAttachments2

Creates a new Attachments2 entity.

Parameters:

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

Returns: Attachments2|error

Sample code:

Attachments2 result = check client->createAttachments2(payload);

Sample response:

{
"AbsoluteEntry": 1,
"Attachments2_Lines": [
{
"FileName": "invoice",
"FileExtension": "pdf"
}
]
}
getAttachments2

Retrieves a single Attachments2 entity identified by its AbsoluteEntry key.

Parameters:

NameTypeRequiredDescription
absoluteEntryint:Signed32YesKey property 'AbsoluteEntry' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetAttachments2QueriesNoQueries to be sent with the request ($expand, $select)

Returns: Attachments2|error

Sample code:

Attachments2 result = check client->getAttachments2(absoluteEntry);

Sample response:

{
"AbsoluteEntry": 1,
"Attachments2_Lines": [
{
"FileName": "invoice",
"FileExtension": "pdf"
}
]
}
deleteAttachments2

Deletes the Attachments2 entity identified by its AbsoluteEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteAttachments2(absoluteEntry);
updateAttachments2

Partially updates an Attachments2 entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateAttachments2(absoluteEntry, payload);

FormPreferences

listFormPreferences

Queries the FormPreferences collection and returns a page of column preference entities.

Parameters:

NameTypeRequiredDescription
headersListFormPreferencesHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListFormPreferencesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: FormPreferencesCollectionResponse|error

Sample code:

FormPreferencesCollectionResponse result = check client->listFormPreferences();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#FormPreferences",
"value": [
{
"User": 1,
"FormID": "133",
"ItemNumber": "1",
"Column": "ItemCode",
"Width": 100,
"VisibleInExpanded": "tYES",
"EditableInForm": "tYES"
}
]
}
createFormPreferences

Creates a new ColumnPreferences entity under the FormPreferences collection.

Parameters:

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

Returns: ColumnPreferences|error

Sample code:

ColumnPreferences result = check client->createFormPreferences(payload);

Sample response:

{
"User": 1,
"FormID": "133",
"ItemNumber": "1",
"Column": "ItemCode",
"Width": 100,
"VisibleInExpanded": "tYES",
"EditableInForm": "tYES"
}
getFormPreferences

Retrieves a single ColumnPreferences entity identified by the composite key User/FormID/ItemNumber/Column.

Parameters:

NameTypeRequiredDescription
userint:Signed32YesComposite key part 'User' (Edm.Int32)
formIDstringYesComposite key part 'FormID' (Edm.String)
itemNumberstringYesComposite key part 'ItemNumber' (Edm.String)
columnstringYesComposite key part 'Column' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetFormPreferencesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: ColumnPreferences|error

Sample code:

ColumnPreferences result = check client->getFormPreferences(user, formID, itemNumber, column);

Sample response:

{
"User": 1,
"FormID": "133",
"ItemNumber": "1",
"Column": "ItemCode",
"Width": 100
}
deleteFormPreferences

Deletes the ColumnPreferences entity identified by the composite key User/FormID/ItemNumber/Column.

Parameters:

NameTypeRequiredDescription
userint:Signed32YesComposite key part 'User' (Edm.Int32)
formIDstringYesComposite key part 'FormID' (Edm.String)
itemNumberstringYesComposite key part 'ItemNumber' (Edm.String)
columnstringYesComposite key part 'Column' (Edm.String)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteFormPreferences(user, formID, itemNumber, column);
updateFormPreferences

Partially updates a ColumnPreferences entity using PATCH/MERGE semantics, identified by the composite key User/FormID/ItemNumber/Column.

Parameters:

NameTypeRequiredDescription
userint:Signed32YesComposite key part 'User' (Edm.Int32)
formIDstringYesComposite key part 'FormID' (Edm.String)
itemNumberstringYesComposite key part 'ItemNumber' (Edm.String)
columnstringYesComposite key part 'Column' (Edm.String)
payloadColumnPreferencesYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateFormPreferences(user, formID, itemNumber, column, payload);

TSRExceptionalEvents

tSRExceptionalEventServiceGetList

Invokes the TSRExceptionalEventService_GetList unbound function to retrieve the TSR exceptional event summary list.

Parameters:

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

Returns: inline_response_200_40|error

Sample code:

inline_response_200_40 result = check client->tSRExceptionalEventServiceGetList();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#TSRExceptionalEventService_GetList",
"value": [
{
"Code": "HOLIDAY"
}
]
}
listTSRExceptionalEvents

Queries the TSRExceptionalEvents collection and returns a page of TSR exceptional event entities.

Parameters:

NameTypeRequiredDescription
headersListTSRExceptionalEventsHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListTSRExceptionalEventsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: TSRExceptionalEventsCollectionResponse|error

Sample code:

TSRExceptionalEventsCollectionResponse result = check client->listTSRExceptionalEvents();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#TSRExceptionalEvents",
"value": [
{
"Code": "HOLIDAY",
"Description": "Public Holiday"
}
]
}
createTSRExceptionalEvents

Creates a new TSRExceptionalEvent entity.

Parameters:

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

Returns: TSRExceptionalEvent|error

Sample code:

TSRExceptionalEvent result = check client->createTSRExceptionalEvents(payload);

Sample response:

{
"Code": "HOLIDAY",
"Description": "Public Holiday"
}
getTSRExceptionalEvents

Retrieves a single TSRExceptionalEvent entity identified by its Code key.

Parameters:

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

Returns: TSRExceptionalEvent|error

Sample code:

TSRExceptionalEvent result = check client->getTSRExceptionalEvents(code);

Sample response:

{
"Code": "HOLIDAY",
"Description": "Public Holiday"
}
deleteTSRExceptionalEvents

Deletes the TSRExceptionalEvent entity identified by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteTSRExceptionalEvents(code);
updateTSRExceptionalEvents

Partially updates a TSRExceptionalEvent entity using PATCH/MERGE semantics.

Parameters:

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

Returns: error?

Sample code:

check client->updateTSRExceptionalEvents(code, payload);

UserQueries

listUserQueries

Queries the UserQueries collection and returns a page of user query entities.

Parameters:

NameTypeRequiredDescription
headersListUserQueriesHeadersNoHeaders to be sent with the request (e.g. Prefer for server-side paging control)
queriesListUserQueriesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserQueriesCollectionResponse|error

Sample code:

UserQueriesCollectionResponse result = check client->listUserQueries();

Sample response:

{
"odata.metadata": "https://server:50000/b1s/v1/$metadata#UserQueries",
"value": [
{
"InternalKey": 1,
"QueryCategory": 1,
"QueryDescription": "Open Orders by Customer",
"Query": "SELECT * FROM ORDR WHERE DocStatus = 'O'",
"QueryType": "uqtRegular",
"MenuCaption": "Open Orders"
}
]
}
createUserQueries

Creates a new UserQuery entity.

Parameters:

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

Returns: UserQuery|error

Sample code:

UserQuery result = check client->createUserQueries(payload);

Sample response:

{
"InternalKey": 1,
"QueryCategory": 1,
"QueryDescription": "Open Orders by Customer",
"Query": "SELECT * FROM ORDR WHERE DocStatus = 'O'",
"QueryType": "uqtRegular",
"MenuCaption": "Open Orders"
}
getUserQueries

Retrieves a single UserQuery entity identified by the composite key InternalKey/QueryCategory.

Parameters:

NameTypeRequiredDescription
internalKeyint:Signed32YesComposite key part 'InternalKey' (Edm.Int32)
queryCategoryint:Signed32YesComposite key part 'QueryCategory' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request
queriesGetUserQueriesQueriesNoQueries to be sent with the request ($expand, $select)

Returns: UserQuery|error

Sample code:

UserQuery result = check client->getUserQueries(internalKey, queryCategory);

Sample response:

{
"InternalKey": 1,
"QueryCategory": 1,
"QueryDescription": "Open Orders by Customer",
"Query": "SELECT * FROM ORDR WHERE DocStatus = 'O'",
"QueryType": "uqtRegular"
}
deleteUserQueries

Deletes the UserQuery entity identified by the composite key InternalKey/QueryCategory.

Parameters:

NameTypeRequiredDescription
internalKeyint:Signed32YesComposite key part 'InternalKey' (Edm.Int32)
queryCategoryint:Signed32YesComposite key part 'QueryCategory' (Edm.Int32)
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->deleteUserQueries(internalKey, queryCategory);
updateUserQueries

Partially updates a UserQuery entity using PATCH/MERGE semantics, identified by the composite key InternalKey/QueryCategory.

Parameters:

NameTypeRequiredDescription
internalKeyint:Signed32YesComposite key part 'InternalKey' (Edm.Int32)
queryCategoryint:Signed32YesComposite key part 'QueryCategory' (Edm.Int32)
payloadUserQueryYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateUserQueries(internalKey, queryCategory, payload);

EventSubscriptions

listEventSubscriptions

Queries the EventSubscriptions collection and returns a page of webhook subscription entities.

Parameters:

NameTypeRequiredDescription
headersListEventSubscriptionsHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListEventSubscriptionsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: EventSubscriptionsCollectionResponse|error

Sample code:

EventSubscriptionsCollectionResponse result = check client->listEventSubscriptions();

Sample response:

{
"odata.metadata": "$metadata#EventSubscriptions",
"value": [
{
"WebhookID": "WH-001",
"WebhookURL": "https://example.com/hook",
"State": "Active",
"AuthenticationType": "None",
"WorkMode": "Sync"
}
],
"odata.nextLink": "EventSubscriptions?$skip=20"
}
createEventSubscriptions

Creates a new EventSubscription (webhook registration) entity.

Parameters:

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

Returns: EventSubscription|error

Sample code:

EventSubscription result = check client->createEventSubscriptions(payload);

Sample response:

{
"WebhookID": "WH-001",
"WebhookURL": "https://example.com/hook",
"State": "Active",
"Handshake": "tYES",
"AuthenticationType": "None",
"WorkMode": "Sync"
}
getEventSubscriptions

Gets a single EventSubscription by its WebhookID key.

Parameters:

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

Returns: EventSubscription|error

Sample code:

EventSubscription result = check client->getEventSubscriptions(webhookID);

Sample response:

{
"WebhookID": "WH-001",
"WebhookURL": "https://example.com/hook",
"State": "Active",
"AuthenticationType": "None",
"WorkMode": "Sync"
}
deleteEventSubscriptions

Deletes an EventSubscription by its WebhookID key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteEventSubscriptions(webhookID);
updateEventSubscriptions

Partially updates an EventSubscription (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
webhookIDstringYesKey property 'WebhookID' (Edm.String)
payloadEventSubscriptionYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateEventSubscriptions(webhookID, payload);
eventSubscriptionsHandshake

Invokes the bound action Handshake on an EventSubscription to verify webhook endpoint connectivity.

Parameters:

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

Returns: error?

Sample code:

check client->eventSubscriptionsHandshake(webhookID);
eventSubscriptionsPause

Invokes the bound action Pause on an EventSubscription to temporarily stop event delivery.

Parameters:

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

Returns: error?

Sample code:

check client->eventSubscriptionsPause(webhookID);
eventSubscriptionsReplay

Invokes the bound action Replay on an EventSubscription to resend previously missed events.

Parameters:

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

Returns: error?

Sample code:

check client->eventSubscriptionsReplay(webhookID);
eventSubscriptionsResume

Invokes the bound action Resume on an EventSubscription to restart event delivery after a pause.

Parameters:

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

Returns: error?

Sample code:

check client->eventSubscriptionsResume(webhookID);
eventSubscriptionsServiceGetEventCatalog

Retrieves the catalog of events that can be subscribed to via webhooks.

Parameters:

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

Returns: EventCatagory|error

Sample code:

EventCatagory result = check client->eventSubscriptionsServiceGetEventCatalog();

Sample response:

{
"Description": "Standard event catalog",
"Version": "1.0",
"Events": [
{
"EventName": "Invoice.Created"
}
]
}

ApprovalRequests

listApprovalRequests

Queries the ApprovalRequests collection and returns a page of approval request entities.

Parameters:

NameTypeRequiredDescription
headersListApprovalRequestsHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListApprovalRequestsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ApprovalRequestsCollectionResponse|error

Sample code:

ApprovalRequestsCollectionResponse result = check client->listApprovalRequests();

Sample response:

{
"odata.metadata": "$metadata#ApprovalRequests",
"value": [
{
"Code": 1,
"Status": "ars_Pending",
"IsDraft": "tYES",
"OriginatorID": 1,
"ObjectType": "17"
}
],
"odata.nextLink": "ApprovalRequests?$skip=20"
}
createApprovalRequests

Creates a new ApprovalRequest entity.

Parameters:

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

Returns: ApprovalRequest|error

Sample code:

ApprovalRequest result = check client->createApprovalRequests(payload);

Sample response:

{
"Code": 1,
"Status": "ars_Pending",
"IsDraft": "tYES",
"OriginatorID": 1,
"ObjectType": "17",
"CurrentStage": 1
}
getApprovalRequests

Gets a single ApprovalRequest by its Code key.

Parameters:

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

Returns: ApprovalRequest|error

Sample code:

ApprovalRequest result = check client->getApprovalRequests(code);

Sample response:

{
"Code": 1,
"Status": "ars_Pending",
"IsDraft": "tYES",
"OriginatorID": 1,
"ObjectType": "17"
}
deleteApprovalRequests

Deletes an ApprovalRequest by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteApprovalRequests(code);
updateApprovalRequests

Partially updates an ApprovalRequest (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateApprovalRequests(code, payload);
approvalRequestsCancelApprovalRequest

Invokes the bound action CancelApprovalRequest on an ApprovalRequest to cancel it.

Parameters:

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

Returns: error?

Sample code:

check client->approvalRequestsCancelApprovalRequest(code);
approvalRequestsRestoreApprovalRequest

Invokes the bound action RestoreApprovalRequest on an ApprovalRequest to restore a previously cancelled/rejected request.

Parameters:

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

Returns: error?

Sample code:

check client->approvalRequestsRestoreApprovalRequest(code);
approvalRequestsServiceGetAllApprovalRequestsList

Gets the list of all approval requests visible to the current user.

Parameters:

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

Returns: inline_response_200_1|error

Sample code:

inline_response_200_1 result = check client->approvalRequestsServiceGetAllApprovalRequestsList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Status": "ars_Pending",
"Remarks": "Awaiting manager approval",
"Code": 1
}
]
}
approvalRequestsServiceGetApprovalRequestList

Gets the list of approval requests assigned to the current user.

Parameters:

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

Returns: inline_response_200_2|error

Sample code:

inline_response_200_2 result = check client->approvalRequestsServiceGetApprovalRequestList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Status": "ars_Pending",
"Remarks": "Awaiting manager approval",
"Code": 1
}
]
}
approvalRequestsServiceGetOpenApprovalRequestList

Gets the list of open (unresolved) approval requests for the current user.

Parameters:

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

Returns: inline_response_200_3|error

Sample code:

inline_response_200_3 result = check client->approvalRequestsServiceGetOpenApprovalRequestList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Status": "ars_Pending",
"Remarks": "Awaiting manager approval",
"Code": 1
}
]
}

UserLanguages

listUserLanguages

Queries the UserLanguages collection and returns a page of user language entities.

Parameters:

NameTypeRequiredDescription
headersListUserLanguagesHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListUserLanguagesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserLanguagesCollectionResponse|error

Sample code:

UserLanguagesCollectionResponse result = check client->listUserLanguages();

Sample response:

{
"odata.metadata": "$metadata#UserLanguages",
"value": [
{
"Code": 1,
"LanguageShortName": "EN",
"LanguageFullName": "English",
"RelatedSystemLanguage": 23
}
],
"odata.nextLink": "UserLanguages?$skip=20"
}
createUserLanguages

Creates a new UserLanguage entity.

Parameters:

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

Returns: UserLanguage|error

Sample code:

UserLanguage result = check client->createUserLanguages(payload);

Sample response:

{
"Code": 1,
"LanguageShortName": "EN",
"LanguageFullName": "English",
"RelatedSystemLanguage": 23
}
getUserLanguages

Gets a single UserLanguage by its Code key.

Parameters:

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

Returns: UserLanguage|error

Sample code:

UserLanguage result = check client->getUserLanguages(code);

Sample response:

{
"Code": 1,
"LanguageShortName": "EN",
"LanguageFullName": "English",
"RelatedSystemLanguage": 23
}
deleteUserLanguages

Deletes a UserLanguage by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteUserLanguages(code);
updateUserLanguages

Partially updates a UserLanguage (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateUserLanguages(code, payload);

BusinessPlaces

listBusinessPlaces

Queries the BusinessPlaces collection and returns a page of business place entities.

Parameters:

NameTypeRequiredDescription
headersListBusinessPlacesHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListBusinessPlacesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: BusinessPlacesCollectionResponse|error

Sample code:

BusinessPlacesCollectionResponse result = check client->listBusinessPlaces();

Sample response:

{
"odata.metadata": "$metadata#BusinessPlaces",
"value": [
{
"BPLID": 1,
"BPLName": "Head Office",
"MainBPL": "tYES",
"Disabled": "tNO",
"City": "Colombo",
"Country": "LK"
}
],
"odata.nextLink": "BusinessPlaces?$skip=20"
}
createBusinessPlaces

Creates a new BusinessPlace entity.

Parameters:

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

Returns: BusinessPlace|error

Sample code:

BusinessPlace result = check client->createBusinessPlaces(payload);

Sample response:

{
"BPLID": 1,
"BPLName": "Head Office",
"MainBPL": "tYES",
"Disabled": "tNO",
"City": "Colombo",
"Country": "LK"
}
getBusinessPlaces

Gets a single BusinessPlace by its BPLID key.

Parameters:

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

Returns: BusinessPlace|error

Sample code:

BusinessPlace result = check client->getBusinessPlaces(bPLID);

Sample response:

{
"BPLID": 1,
"BPLName": "Head Office",
"MainBPL": "tYES",
"Disabled": "tNO",
"City": "Colombo",
"Country": "LK"
}
deleteBusinessPlaces

Deletes a BusinessPlace by its BPLID key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteBusinessPlaces(bPLID);
updateBusinessPlaces

Partially updates a BusinessPlace (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateBusinessPlaces(bPLID, payload);

AlertManagements

listAlertManagements

Queries the AlertManagements collection and returns a page of alert management entities.

Parameters:

NameTypeRequiredDescription
headersListAlertManagementsHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListAlertManagementsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: AlertManagementsCollectionResponse|error

Sample code:

AlertManagementsCollectionResponse result = check client->listAlertManagements();

Sample response:

{
"odata.metadata": "$metadata#AlertManagements",
"value": [
{
"Code": 1,
"Name": "Low Stock Alert",
"Type": "att_User",
"Priority": "atp_High",
"Active": "tYES",
"FrequencyType": "atfi_Days"
}
],
"odata.nextLink": "AlertManagements?$skip=20"
}
createAlertManagements

Creates a new AlertManagement entity.

Parameters:

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

Returns: AlertManagement|error

Sample code:

AlertManagement result = check client->createAlertManagements(payload);

Sample response:

{
"Code": 1,
"Name": "Low Stock Alert",
"Type": "att_User",
"Priority": "atp_High",
"Active": "tYES",
"FrequencyType": "atfi_Days"
}
getAlertManagements

Gets a single AlertManagement by its Code key.

Parameters:

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

Returns: AlertManagement|error

Sample code:

AlertManagement result = check client->getAlertManagements(code);

Sample response:

{
"Code": 1,
"Name": "Low Stock Alert",
"Type": "att_User",
"Priority": "atp_High",
"Active": "tYES",
"FrequencyType": "atfi_Days"
}
deleteAlertManagements

Deletes an AlertManagement by its Code key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteAlertManagements(code);
updateAlertManagements

Partially updates an AlertManagement (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateAlertManagements(code, payload);
alertManagementsGetAlertManagementList

Invokes the bound function GetAlertManagementList on an AlertManagement to retrieve a simplified list representation.

Parameters:

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

Returns: inline_response_200|error

Sample code:

inline_response_200 result = check client->alertManagementsGetAlertManagementList(code);

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Type": "att_User",
"Code": 1,
"Name": "Low Stock Alert"
}
]
}

Counties

listCounties

Queries the Counties collection and returns a page of county entities.

Parameters:

NameTypeRequiredDescription
headersListCountiesHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListCountiesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: CountiesCollectionResponse|error

Sample code:

CountiesCollectionResponse result = check client->listCounties();

Sample response:

{
"odata.metadata": "$metadata#Counties",
"value": [
{
"AbsId": 1,
"Code": "07",
"Country": "BR",
"State": "SP",
"Name": "Sao Paulo",
"TaxZone": "tYES"
}
],
"odata.nextLink": "Counties?$skip=20"
}
createCounties

Creates a new County entity.

Parameters:

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

Returns: County|error

Sample code:

County result = check client->createCounties(payload);

Sample response:

{
"AbsId": 1,
"Code": "07",
"Country": "BR",
"State": "SP",
"Name": "Sao Paulo",
"TaxZone": "tYES"
}
getCounties

Gets a single County by its AbsId key.

Parameters:

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

Returns: County|error

Sample code:

County result = check client->getCounties(absId);

Sample response:

{
"AbsId": 1,
"Code": "07",
"Country": "BR",
"State": "SP",
"Name": "Sao Paulo",
"TaxZone": "tYES"
}
deleteCounties

Deletes a County by its AbsId key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteCounties(absId);
updateCounties

Partially updates a County (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateCounties(absId, payload);
countiesServiceGetCountyList

Gets a simplified list of counties (code/name pairs) from the CountiesService.

Parameters:

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

Returns: inline_response_200_15|error

Sample code:

inline_response_200_15 result = check client->countiesServiceGetCountyList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Code": "07",
"AbsId": 1,
"Name": "Sao Paulo"
}
]
}

SQLQueries

listSQLQueries

Queries the SQLQueries collection and returns a page of stored SQL query entities.

Parameters:

NameTypeRequiredDescription
headersListSQLQueriesHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListSQLQueriesQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: SQLQueriesCollectionResponse|error

Sample code:

SQLQueriesCollectionResponse result = check client->listSQLQueries();

Sample response:

{
"odata.metadata": "$metadata#SQLQueries",
"value": [
{
"SqlCode": "SQ001",
"SqlName": "Open Orders",
"SqlText": "SELECT * FROM ORDR WHERE DocStatus='O'",
"ParamList": ""
}
],
"odata.nextLink": "SQLQueries?$skip=20"
}
createSQLQueries

Creates a new SQLQuery entity.

Parameters:

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

Returns: SQLQuery|error

Sample code:

SQLQuery result = check client->createSQLQueries(payload);

Sample response:

{
"SqlCode": "SQ001",
"SqlName": "Open Orders",
"SqlText": "SELECT * FROM ORDR WHERE DocStatus='O'",
"ParamList": ""
}
getSQLQueries

Gets a single SQLQuery by its SqlCode key.

Parameters:

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

Returns: SQLQuery|error

Sample code:

SQLQuery result = check client->getSQLQueries(sqlCode);

Sample response:

{
"SqlCode": "SQ001",
"SqlName": "Open Orders",
"SqlText": "SELECT * FROM ORDR WHERE DocStatus='O'",
"ParamList": ""
}
deleteSQLQueries

Deletes a SQLQuery by its SqlCode key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteSQLQueries(sqlCode);
updateSQLQueries

Partially updates a SQLQuery (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
sqlCodestringYesKey property 'SqlCode' (Edm.String)
payloadSQLQueryYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateSQLQueries(sqlCode, payload);
sQLQueriesList2

Invokes the bound action List on a SQLQuery to execute it (with an optional parameter list) and return its result set.

Parameters:

NameTypeRequiredDescription
sqlCodestringYesKey property 'SqlCode' (Edm.String)
payloadSQLQueriessqlCode_List_bodyYesRequest payload containing paramList
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: SQLQueryResult|error

Sample code:

SQLQueryResult result = check client->sQLQueriesList2(sqlCode, payload);

Sample response:

{
"SqlText": "SELECT * FROM ORDR WHERE DocStatus='O'"
}

WebClientListviewFilters

webClientListviewFilterServiceGetList

Gets a simplified list (GUIDs) of web client list-view filters via the WebClientListviewFilterService.

Parameters:

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

Returns: inline_response_200_50|error

Sample code:

inline_response_200_50 result = check client->webClientListviewFilterServiceGetList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"Guid": "3F2504E0-4F89-11D3-9A0C-0305E82C3301"
}
]
}
listWebClientListviewFilters

Queries the WebClientListviewFilters collection and returns a page of saved list-view filter entities.

Parameters:

NameTypeRequiredDescription
headersListWebClientListviewFiltersHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListWebClientListviewFiltersQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: WebClientListviewFiltersCollectionResponse|error

Sample code:

WebClientListviewFiltersCollectionResponse result = check client->listWebClientListviewFilters();

Sample response:

{
"odata.metadata": "$metadata#WebClientListviewFilters",
"value": [
{
"Guid": "3F2504E0-4F89-11D3-9A0C-0305E82C3301",
"TableName": "OITM",
"UserId": 1,
"FilterName": "Active Items"
}
],
"odata.nextLink": "WebClientListviewFilters?$skip=20"
}
createWebClientListviewFilters

Creates a new WebClientListviewFilter entity.

Parameters:

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

Returns: WebClientListviewFilter|error

Sample code:

WebClientListviewFilter result = check client->createWebClientListviewFilters(payload);

Sample response:

{
"Guid": "3F2504E0-4F89-11D3-9A0C-0305E82C3301",
"TableName": "OITM",
"UserId": 1,
"FilterName": "Active Items"
}
getWebClientListviewFilters

Gets a single WebClientListviewFilter by its Guid key.

Parameters:

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

Returns: WebClientListviewFilter|error

Sample code:

WebClientListviewFilter result = check client->getWebClientListviewFilters(guid);

Sample response:

{
"Guid": "3F2504E0-4F89-11D3-9A0C-0305E82C3301",
"TableName": "OITM",
"UserId": 1,
"FilterName": "Active Items"
}
deleteWebClientListviewFilters

Deletes a WebClientListviewFilter by its Guid key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteWebClientListviewFilters(guid);
updateWebClientListviewFilters

Partially updates a WebClientListviewFilter (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
guidstringYesKey property 'Guid' (Edm.String)
payloadWebClientListviewFilterYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateWebClientListviewFilters(guid, payload);

ChooseFromList

listChooseFromList

Queries the ChooseFromList collection and returns a page of choose-from-list configuration entities.

Parameters:

NameTypeRequiredDescription
headersListChooseFromListHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListChooseFromListQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ChooseFromListCollectionResponse|error

Sample code:

ChooseFromListCollectionResponse result = check client->listChooseFromList();

Sample response:

{
"odata.metadata": "$metadata#ChooseFromList",
"value": [
{
"ObjectName": "2",
"ChooseFromList_Lines": [
{
"FieldIndex": 1,
"FieldNo": "CardCode",
"DisplayedName": "Customer Code",
"Visible": "tYES"
}
]
}
],
"odata.nextLink": "ChooseFromList?$skip=20"
}
createChooseFromList

Creates a new ChooseFromList entity.

Parameters:

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

Returns: ChooseFromList|error

Sample code:

ChooseFromList result = check client->createChooseFromList(payload);

Sample response:

{
"ObjectName": "2",
"ChooseFromList_Lines": [
{
"FieldIndex": 1,
"FieldNo": "CardCode",
"DisplayedName": "Customer Code",
"Visible": "tYES"
}
]
}
getChooseFromList

Gets a single ChooseFromList by its ObjectName key.

Parameters:

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

Returns: ChooseFromList|error

Sample code:

ChooseFromList result = check client->getChooseFromList(objectName);

Sample response:

{
"ObjectName": "2",
"ChooseFromList_Lines": [
{
"FieldIndex": 1,
"FieldNo": "CardCode",
"DisplayedName": "Customer Code",
"Visible": "tYES"
}
]
}
deleteChooseFromList

Deletes a ChooseFromList by its ObjectName key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteChooseFromList(objectName);
updateChooseFromList

Partially updates a ChooseFromList (PATCH/MERGE semantics).

Parameters:

NameTypeRequiredDescription
objectNamestringYesKey property 'ObjectName' (Edm.String)
payloadChooseFromListYesRequest payload
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->updateChooseFromList(objectName, payload);

MultiLanguageTranslations

listMultiLanguageTranslations

Queries the MultiLanguageTranslations collection and returns a page of multi-language translation entities.

Parameters:

NameTypeRequiredDescription
headersListMultiLanguageTranslationsHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListMultiLanguageTranslationsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: MultiLanguageTranslationsCollectionResponse|error

Sample code:

MultiLanguageTranslationsCollectionResponse result = check client->listMultiLanguageTranslations();

Sample response:

{
"odata.metadata": "$metadata#MultiLanguageTranslations",
"value": [
{
"Numerator": 1,
"TableName": "OITM",
"FieldAlias": "ItemName",
"PrimaryKeyofobject": "A0001"
}
],
"odata.nextLink": "MultiLanguageTranslations?$skip=20"
}
createMultiLanguageTranslations

Creates a new MultiLanguageTranslation entity.

Parameters:

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

Returns: MultiLanguageTranslation|error

Sample code:

MultiLanguageTranslation result = check client->createMultiLanguageTranslations(payload);

Sample response:

{
"Numerator": 1,
"TableName": "OITM",
"FieldAlias": "ItemName",
"PrimaryKeyofobject": "A0001"
}
getMultiLanguageTranslations

Gets a single MultiLanguageTranslation by its Numerator key.

Parameters:

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

Returns: MultiLanguageTranslation|error

Sample code:

MultiLanguageTranslation result = check client->getMultiLanguageTranslations(numerator);

Sample response:

{
"Numerator": 1,
"TableName": "OITM",
"FieldAlias": "ItemName",
"PrimaryKeyofobject": "A0001"
}
deleteMultiLanguageTranslations

Deletes a MultiLanguageTranslation by its Numerator key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteMultiLanguageTranslations(numerator);
updateMultiLanguageTranslations

Partially updates a MultiLanguageTranslation (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateMultiLanguageTranslations(numerator, payload);

UserGroups

userGroupServiceGetUserGroupList

Gets a simplified list of user groups (id/name pairs) via the UserGroupService.

Parameters:

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

Returns: inline_response_200_41|error

Sample code:

inline_response_200_41 result = check client->userGroupServiceGetUserGroupList();

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"UserGroupId": 1,
"UserGroupName": "Sales"
}
]
}
listUserGroups

Queries the UserGroups collection and returns a page of user group entities.

Parameters:

NameTypeRequiredDescription
headersListUserGroupsHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListUserGroupsQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: UserGroupsCollectionResponse|error

Sample code:

UserGroupsCollectionResponse result = check client->listUserGroups();

Sample response:

{
"odata.metadata": "$metadata#UserGroups",
"value": [
{
"UserGroupId": 1,
"UserGroupName": "Sales",
"UserGroupType": "gc_Authorization"
}
],
"odata.nextLink": "UserGroups?$skip=20"
}
createUserGroups

Creates a new UserGroup entity.

Parameters:

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

Returns: UserGroup|error

Sample code:

UserGroup result = check client->createUserGroups(payload);

Sample response:

{
"UserGroupId": 1,
"UserGroupName": "Sales",
"UserGroupType": "gc_Authorization"
}
getUserGroups

Gets a single UserGroup by its UserGroupId key.

Parameters:

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

Returns: UserGroup|error

Sample code:

UserGroup result = check client->getUserGroups(userGroupId);

Sample response:

{
"UserGroupId": 1,
"UserGroupName": "Sales",
"UserGroupType": "gc_Authorization"
}
deleteUserGroups

Deletes a UserGroup by its UserGroupId key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteUserGroups(userGroupId);
updateUserGroups

Partially updates a UserGroup (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateUserGroups(userGroupId, payload);

ValueMapping

listValueMapping

Queries the ValueMapping collection and returns a page of B1-side value mapping entities.

Parameters:

NameTypeRequiredDescription
headersListValueMappingHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListValueMappingQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ValueMappingCollectionResponse|error

Sample code:

ValueMappingCollectionResponse result = check client->listValueMapping();

Sample response:

{
"odata.metadata": "$metadata#ValueMapping",
"value": [
{
"AbsEntry": 1,
"ObjectId": 2,
"ObjectAbsEntry": "1",
"VM_ThirdPartyValuesCollection": [
{
"ThirdPartySystemId": 1,
"LineId": 1,
"ThirdPartyValue": "EXT-001"
}
]
}
],
"odata.nextLink": "ValueMapping?$skip=20"
}
createValueMapping

Creates a new VM_B1ValuesData entity mapping a B1 value to one or more third-party values.

Parameters:

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

Returns: VMB1ValuesData|error

Sample code:

VMB1ValuesData result = check client->createValueMapping(payload);

Sample response:

{
"AbsEntry": 1,
"ObjectId": 2,
"ObjectAbsEntry": "1",
"VM_ThirdPartyValuesCollection": [
{
"ThirdPartySystemId": 1,
"LineId": 1,
"ThirdPartyValue": "EXT-001"
}
]
}
getValueMapping

Gets a single VM_B1ValuesData entity by its AbsEntry key.

Parameters:

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

Returns: VMB1ValuesData|error

Sample code:

VMB1ValuesData result = check client->getValueMapping(absEntry);

Sample response:

{
"AbsEntry": 1,
"ObjectId": 2,
"ObjectAbsEntry": "1",
"VM_ThirdPartyValuesCollection": [
{
"ThirdPartySystemId": 1,
"LineId": 1,
"ThirdPartyValue": "EXT-001"
}
]
}
deleteValueMapping

Deletes a VM_B1ValuesData entity by its AbsEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteValueMapping(absEntry);
updateValueMapping

Partially updates a VM_B1ValuesData entity (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateValueMapping(absEntry, payload);
listValueMappingCommunication

Queries the ValueMappingCommunication collection and returns a page of value-mapping communication log entities.

Parameters:

NameTypeRequiredDescription
headersListValueMappingCommunicationHeadersNoHeaders to be sent with the request (e.g. Prefer for server paging control)
queriesListValueMappingCommunicationQueriesNoOData query options ($skip, $top, $filter, $orderby, $expand, $inlinecount, $select)

Returns: ValueMappingCommunicationCollectionResponse|error

Sample code:

ValueMappingCommunicationCollectionResponse result = check client->listValueMappingCommunication();

Sample response:

{
"odata.metadata": "$metadata#ValueMappingCommunication",
"value": [
{
"AbsEntry": 1,
"ThirdPartySystemId": 1,
"ObjectId": 2,
"Status": "vmcs_Success",
"CommunicationType": "vmct_Export"
}
],
"odata.nextLink": "ValueMappingCommunication?$skip=20"
}
createValueMappingCommunication

Creates a new ValueMappingCommunicationData entity to log a value-mapping communication event.

Parameters:

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

Returns: ValueMappingCommunicationData|error

Sample code:

ValueMappingCommunicationData result = check client->createValueMappingCommunication(payload);

Sample response:

{
"AbsEntry": 1,
"ThirdPartySystemId": 1,
"ObjectId": 2,
"Status": "vmcs_Success",
"CommunicationType": "vmct_Export"
}
getValueMappingCommunication

Gets a single ValueMappingCommunicationData entity by its AbsEntry key.

Parameters:

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

Returns: ValueMappingCommunicationData|error

Sample code:

ValueMappingCommunicationData result = check client->getValueMappingCommunication(absEntry);

Sample response:

{
"AbsEntry": 1,
"ThirdPartySystemId": 1,
"ObjectId": 2,
"Status": "vmcs_Success",
"CommunicationType": "vmct_Export"
}
deleteValueMappingCommunication

Deletes a ValueMappingCommunicationData entity by its AbsEntry key.

Parameters:

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

Returns: error?

Sample code:

check client->deleteValueMappingCommunication(absEntry);
updateValueMappingCommunication

Partially updates a ValueMappingCommunicationData entity (PATCH/MERGE semantics).

Parameters:

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

Returns: error?

Sample code:

check client->updateValueMappingCommunication(absEntry, payload);
valueMappingServiceGetMappedB1Value

Looks up the B1 value mapped to a given third-party value via the ValueMappingService.

Parameters:

NameTypeRequiredDescription
payloadValueMappingService_GetMappedB1Value_bodyYesRequest payload containing vMB1ValuesData
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_44|error

Sample code:

inline_response_200_44 result = check client->valueMappingServiceGetMappedB1Value(payload);

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"AbsEntry": 1,
"ObjectId": 2,
"ObjectAbsEntry": "1"
}
]
}
valueMappingServiceGetThirdPartyValuesForB1Value

Looks up the third-party values mapped to a given B1 value via the ValueMappingService.

Parameters:

NameTypeRequiredDescription
payloadValueMappingService_GetThirdPartyValuesForB1Value_bodyYesRequest payload containing vMB1ValuesData
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: inline_response_200_45|error

Sample code:

inline_response_200_45 result = check client->valueMappingServiceGetThirdPartyValuesForB1Value(payload);

Sample response:

{
"odata.metadata": "$metadata#Edm.String",
"value": [
{
"ThirdPartySystemId": 1,
"LineId": 1,
"ThirdPartyValue": "EXT-001",
"AbsEntry": 1
}
]
}
valueMappingServiceRemoveMappedValue

Removes a third-party value mapping via the ValueMappingService.

Parameters:

NameTypeRequiredDescription
payloadValueMappingService_RemoveMappedValue_bodyYesRequest payload containing vMThirdPartyValuesData
headersmap<string|string[]>NoHeaders to be sent with the request

Returns: error?

Sample code:

check client->valueMappingServiceRemoveMappedValue(payload);