ROSE Developers - Web API Reference

Master Data Business Entities | Taxonomy Class

A Taxonomy Class represents a set of taxonomies which share the same accounting classification such as SNC Micro-entities.

Overview


URL api/{tenantKey}/{orgKey}/businessCore/taxonomyClasses
Methods Supported GET

All Operations

This service includes the following operations:

All Resources

This service uses the following resources:

GET Operations

GET TaxonomyClasses

Returns the list of all the entity records available.

Response:

When successful, the response body contains the list of records available. See TaxonomyClassResource.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.

Resource URL:

GET /businessCore/taxonomyClasses

GET TaxonomyClasses (paged)

Returns a page of the list of all the entity records available.

The following elements are optional:

page (int) The index of the page of the list that should be returned. This is a query string parameter.
pageSize (int) The number of page elements that should be returned (max. is 1000). This is a query string parameter.

Response:

When successful, the response body contains the list of records available. See TaxonomyClassResource.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.

Resource URL:

GET /businessCore/taxonomyClasses?page={page}&pageSize={pageSize}

GET TaxonomyClass by identifier

Returns the entity record that matches the specified identifier.

The following elements are required:

id (string) The record identifier.

Response:

When successful, the response body contains the entity record. See TaxonomyClassResource.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.
404 NotFound. The specified record does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{id}

GET TaxonomyClass by key

Returns the entity record that matches the specified key.

The following elements are required:

taxonomyClassKey (string) The taxonomy class key.

Response:

When successful, the response body contains the entity record. See TaxonomyClassResource.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.
404 NotFound. The specified record does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{taxonomyClassKey}

GET Print TaxonomyClass by identifier

Prints the specified entity record.

The following elements are required:

id (string) The record identifier.

The following elements are optional:

template (string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200 OK. The operation was completed successfully.
404 NotFound. The specified resord does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{id}/print?template={template}

GET Print TaxonomyClass by key

Prints the specified entity record.

The following elements are required:

taxonomyClassKey (string) The taxonomy class key.

The following elements are optional:

template (string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.
404 NotFound. The specified record does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{taxonomyClassKey}/print

GET Original Print TaxonomyClassOriginal by identifier

Prints the specified entity record.

The following elements are required:

id (string) The record identifier.

The following elements are optional:

template (string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200 OK. The operation was completed successfully.
404 NotFound. The specified resord does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{id}/printOriginal?template={template}

GET Original Print TaxonomyClass by key

Prints the specified entity record.

The following elements are required:

taxonomyClassKey (string) The taxonomy class key.

The following elements are optional:

template (string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.
404 NotFound. The specified record does not exist.

Resource URL:

GET /businessCore/taxonomyClasses/{taxonomyClassKey}/printOriginal

PUT Operations

PUT Set Custom Attribute TaxonomyClass

Updates the value of 'CustomAttribute' in the specified entity record.

The following elements are required:

taxonomyClassKey (string) The taxonomy class key.
customAttributeName (string) The custom attribute name.
value (ExtensibilityCustomAttributeValueResource) The request body should contain the new value for the custom attribute.
See ExtensibilityCustomAttributeValueResource.

Response:

When successful, the response body is empty.

Response status codes:

200 OK. The operation was completed successfully.
400 BadRequest. The request parameters are invalid.
404 NotFound. The specified record does not exist.

Resource URL:

PUT /businessCore/taxonomyClasses/{taxonomyClassKey}/{customAttributeName}

Resources


TaxonomyClassResource

The following elements are required:

taxonomyClassKey (string) The taxonomy class key.

The following elements are optional:

description (string) The description of the taxonomy class key.