Tax Group
POST /tax-group/entity/<entity_id>
DELETE /tax-group/entity/<entity_id>
POST /tax-group/updateEntitiesWithDependencies
PATCH /tax-group/document/<_id>
DELETE /tax-group/document/<_id>
GET /tax-group/mapping/entity/<entity_id>
POST /tax-group/mapping/entity/<entity_id>
Endpoints
GET /tax-group/master
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | A filter expression in OData v4 format |
query |
| string | No | An order by expression in OData v4 format |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| boolean | No | Include the mappings for the document in the response |
query |
| [ csv of string ] | No | Specifies |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a tax group.
The name of the tax group. |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /tax-group/current
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| boolean | No | Include the mappings for the document in the response |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
query |
| [ csv of string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a tax group |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /tax-group/list
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
query |
| string | No | A filter expression in OData v4 format |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | An order by expression in OData v4 format |
query |
| string | Yes | The date and time to query against |
query |
| [ string ] | No | An array of entity identifiers |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
query |
| boolean | No | Adds audit fields to each document when returning a result ( |
query |
| boolean | No | Includes the documents that are inactive for the current sites |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a tax group |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /tax-group
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
body |
| Yes | The JSON formatted request |
Request Body
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time (date-time) the document was created |
| string | The last date and time (date-time) the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /tax-group/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| Yes | The JSON formatted request |
Request Body
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned (UID) of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
DELETE /tax-group/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the entity |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /tax-group/updateEntitiesWithDependencies
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
body |
| Yes | Supports the mappings field (array/boolean) for each document. With mappings: True mappings are created for the current date and sites from the |
Request Body
Field Name | Type | Description |
|---|---|---|
[ array, object ] | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | Stores the definition of a tax group |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /tax-group/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
query |
| [ csv of string ] | No | Specifies entity types for which mappings are presented as a part of the response (For example, |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| boolean | |
| boolean | Marking property is the essence of active documents. Sets in |
| string | |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time the document was created |
| string | The last date and time the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
PATCH /tax-group/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
query |
| boolean | No | Hydrates-related nested objects when returning a result (For example, populate a menu with menu categories and menu groups) |
query |
| [ csv of string ] | No | Specifies |
body |
| Yes | The JSON of the category being patched |
Request Body
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
object | Stores the definition of a tax group | |
| string | The name of the tax group |
| string | The tax code |
| string |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
DELETE /tax-group/document/<_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
path |
| string | Yes | The identifier of the document |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
GET /tax-group/mapping/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
query |
| int32 | No | The maximum documents to return |
query |
| int32 | No | The documents to skip before returning |
query |
| string | No | A filter expression in OData v4 format |
query |
| string | No | An order by expression in OData v4 format |
query |
| boolean | No | Includes the documents that inactive for the current sites |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The identifier of the site associated with the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| string | The identifier of the document in the collection the mapping refers to |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time (date-time) the document was created |
| string | The last date and time (date-time) the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /tax-group/mapping/entity/<entity_id>
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
header |
| [ csv of string ] | No | The unique identifiers (UIDs) of the site to manage data for |
path |
| string | Yes | The identifier of the entity |
body |
| Yes | The array of the tax definition mappings being added |
Request Body
[ array ] (unspecified type)
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The identifier of the site associated with the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| string | The identifier of the document in the collection the mapping refers to |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time (date-time) the document was created |
| string | The last date and time (date-time) the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
POST /tax-group/mapping
Request Parameters
In | Field Name | Type | Required | Description |
|---|---|---|---|---|
header |
| string | Yes | The identifier of the company to manage data for |
body |
| Yes | The JSON of the tax definition mapping being added |
Request Body
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the document in the collection the mapping refers to |
| string | The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same |
| string | The date and time (date-time) the document becomes "current" |
| [ string ] | The identifier of the site associated with the document |
Response: 200 OK
Schema
Field Name | Type | Description |
|---|---|---|
| integer | |
| [ array, object ] | |
| string | The auto-assigned system document identifier |
| string | The identifier of the company that owns the document |
| string | The identifier of the site associated with the document |
| string | The auto-assigned UID of the entity, set on creation. All future versions of the entity share the same |
| string | The identifier of the document in the collection the mapping refers to |
| string | The identifier of the OPRA user or site that created the document |
| string | The identifier of the OPRA user or site that last updated the document |
| string | The date and time (date-time) the document was created |
| string | The last date and time (date-time) the document was updated |
Response Codes
Response | Description |
|---|---|
200 OK | Success |
400 Bad Request | Bad request, for more information look at body error |
403 Forbidden | Invalid token |
404 Not Found | Not found |
422 Unprocessable Entity | Unprocessable error |
Default | Unexpected error |
Data Models
tax_group
Stores the definition of a tax group.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | The name of the tax group |
| string | Yes |
|
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
| No |
| |
|
|
tax_group_create
Stores the definition of a tax group.
Field Name | Type | Required | Description |
|---|---|---|---|
| string | Yes | The name of the tax group |
| string | Yes |
|
| No |
| |
| No |
|
tax_group_edit
Stores the definition of a tax group.
Field Name | Type | Description |
|---|---|---|
| string | The name of the tax group |
| string |
|
|
|
tax_group_list
Field Name | Type | Description |
|---|---|---|
| integer |
|
| [tax_group ] |
|
name
Field Name | Type | Description |
|---|---|---|
| string |
_id
The auto-assigned system document identifier.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned system document identifier |
company_id
The identifier of the company that owns the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the company that owns the document |
entity_id
The auto-assigned unique identifier (UID) of the entity, set on creation. All future versions of the entity share the same entity_id.
Field Name | Type | Description |
|---|---|---|
| string | The auto-assigned unique ID of this entity, set on creation. All future versions of this entity will share the same |
is_master
Field Name | Type | Description |
|---|---|---|
| boolean |
is_active
Marking property is the essence of active documents. Sets in true by default.
Field Name | Type | Description |
|---|---|---|
| boolean | Marking property is the essence of active documents. Sets in true by default. |
external_id
Field Name | Type | Description |
|---|---|---|
| string |
created_by
The identifier of the OPRA user or site that created the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that created the document |
updated_by
The identifier of the OPRA user or site that last updated the document.
Field Name | Type | Description |
|---|---|---|
| string | The identifier of the OPRA user or site that last updated the document |
created_at
The date and time the document was created.
Field Name | Type | Description |
|---|---|---|
| string | The date and time (date-time) the document was created |
updated_at
The last date and time the document was updated.
Field Name | Type | Description |
|---|---|---|
| string | The last date and time (date-time) the document was updated |