Tax Code¶
Tax Code - Get¶
HTTP Request
GET /api/v1/tax-codes/{id}
📋 Description: Retrieves detailed information about a specific tax code within the financial organization structure, identified by its unique ID, to facilitate compliance and reporting within the organizational hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "procedure": "string",
22 "countryId": 0,
23 "countryDisplayId": "string"
24 }
25}
Tax Code - Update¶
HTTP Request
PUT /api/v1/tax-codes/{id}
📋 Description: Updates the specified tax code within the financial organization structure, allowing for modifications to its attributes to reflect changes in the hierarchy of the financial entity.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
body |
body |
true |
Request body containing the updated tax code information, including attributes relevant to the financial organization structure and hierarchy. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "procedure": "string",
9 "countryId": 0,
10 "countryDisplayId": "string"
11}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "procedure": "string",
22 "countryId": 0,
23 "countryDisplayId": "string"
24 }
25}
Tax Code - Delete¶
HTTP Request
DELETE /api/v1/tax-codes/{id}
📋 Description: Deletes a specified tax code from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for the financial entity.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Delete Or Decommission¶
HTTP Request
PUT /api/v1/tax-codes/remove/{id}
📋 Description: Removes a specified tax code from the financial organization structure, ensuring the hierarchy remains accurate and compliant with organizational standards.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Delete Or Decommission All¶
HTTP Request
PUT /api/v1/tax-codes/remove/bulk
📋 Description: Removes multiple tax codes in bulk from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective financial entity management.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list of tax code identifiers to be removed in bulk from the financial organization’s structure, ensuring streamlined management of the entity’s hierarchical tax classifications. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Decommission¶
HTTP Request
PUT /api/v1/tax-codes/decommission/{id}
📋 Description: Decommissions a specified tax code within the financial organization structure, effectively removing it from active use in the hierarchy of financial entities. This operation ensures that outdated or unnecessary tax codes are no longer applied in financial transactions.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "procedure": "string",
22 "countryId": 0,
23 "countryDisplayId": "string"
24 }
25}
Tax Code - Decommission By Modification Date Before¶
HTTP Request
PUT /api/v1/tax-codes/decommission/modified-before/{modified_before}
📋 Description: Decommissions tax codes that were modified before the specified date, allowing organizations to maintain an updated financial structure and hierarchy. This operation ensures that obsolete tax codes are effectively removed from the financial entity’s records.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
modified_before |
path |
string(date-time) |
true |
Specifies the cutoff date for decommissioning tax codes that were modified before the given date, ensuring alignment with the organization’s financial structure and hierarchy. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Decommission Before Now¶
HTTP Request
PUT /api/v1/tax-codes/decommission/modified-before-now
📋 Description: Decommissions tax codes that have been modified before the current date, ensuring the financial organization structure remains up-to-date and compliant with regulatory standards. This operation is essential for maintaining an accurate hierarchy within the financial entity.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Decommission All¶
HTTP Request
PUT /api/v1/tax-codes/decommission/bulk
📋 Description: Decommissions multiple tax codes in bulk, allowing financial organizations to efficiently manage their organizational structure and hierarchy by removing obsolete or redundant tax classifications.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list of tax codes to be decommissioned in bulk, ensuring alignment with the organization’s financial structure and hierarchy. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/tax-codes/createOrUpdate/bulk
📋 Description: Creates or updates multiple tax codes in bulk within the financial organization structure, ensuring accurate alignment with the hierarchy of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a bulk array of tax code data, including identifiers and attributes, to facilitate the creation or updating of tax codes within the financial organization structure. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "procedure": "string",
10 "countryId": 0,
11 "countryDisplayId": "string"
12 }
13]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Create Or Update¶
HTTP Request
PUT /api/v1/tax-codes/createOrUpdate
📋 Description: Creates or updates tax codes within the financial organization structure, ensuring accurate representation of the hierarchy and compliance for financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the tax code details, including identifiers and attributes necessary for creating or updating financial entities within the organizational structure. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "procedure": "string",
9 "countryId": 0,
10 "countryDisplayId": "string"
11}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "procedure": "string",
22 "countryId": 0,
23 "countryDisplayId": "string"
24 }
25}
Tax Code - Bulk Update¶
HTTP Request
PUT /api/v1/tax-codes/bulk
📋 Description: Updates multiple tax codes in bulk for financial entities within the organizational structure, ensuring alignment with the latest regulatory requirements and internal hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of tax code entries to be updated in the financial organization structure, including relevant identifiers and attributes for each code. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "procedure": "string",
10 "countryId": 0,
11 "countryDisplayId": "string"
12 }
13]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Bulk Create¶
HTTP Request
POST /api/v1/tax-codes/bulk
📋 Description: Submits a bulk upload of tax codes to enhance the financial organization structure, enabling efficient management of hierarchical relationships within financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of tax code entries, each associated with the financial organization’s structure and hierarchy, to facilitate bulk updates within the financial entity. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "procedure": "string",
10 "countryId": 0,
11 "countryDisplayId": "string"
12 }
13]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": [
15 {
16 "id": 0,
17 "status": "CREATED",
18 "displayId": "string",
19 "erpSystemId": 0,
20 "erpSystemDisplayId": "string",
21 "name": "string",
22 "procedure": "string",
23 "countryId": 0,
24 "countryDisplayId": "string"
25 }
26 ]
27}
Tax Code - Bulk Delete¶
HTTP Request
DELETE /api/v1/tax-codes/bulk
📋 Description: Deletes multiple tax codes in a single operation, streamlining the management of financial entities within the organizational structure and hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of tax code identifiers to be deleted in bulk from the financial organization structure. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Search¶
HTTP Request
POST /api/v1/tax-codes/search
📋 Description: Submits a request to search for tax codes within the financial organization structure, enabling users to efficiently locate relevant codes based on specified criteria.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
page |
query |
integer |
false |
Zero-based page index (0..N) |
size |
query |
integer |
false |
The size of the page to be returned |
sort |
query |
array[string] |
false |
Sorting criteria in the format: property,(asc|desc). Default sort order is ascending. Multiple sort criteria are supported. |
body |
body |
false |
Request body containing the search criteria for tax codes relevant to the financial organization structure, including parameters for organization hierarchy and entity classification. |
Default Values¶
Parameter |
Default |
Type |
|---|---|---|
page |
|
query |
size |
|
query |
sort |
|
query |
Parameter Constraints¶
Parameter |
Constraints |
|---|---|
page |
Min: 0 |
size |
Min: 1 |
Body Parameters
1{
2 "idIn": [
3 0
4 ],
5 "idEqual": 0,
6 "idLike": "string",
7 "createdAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
8 "createdAtLessThanOrEqual": "2019-08-24T14:15:22Z",
9 "createdByLike": "string",
10 "createdByEqual": "string",
11 "modifiedAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
12 "modifiedAtLessThanOrEqual": "2019-08-24T14:15:22Z",
13 "modifiedByLike": "string",
14 "modifiedByEqual": "string",
15 "statusEqual": "CREATED",
16 "statusIn": [
17 "CREATED"
18 ],
19 "displayIdIn": [
20 "string"
21 ],
22 "displayIdLike": "string",
23 "erpSystemIdEqual": 0,
24 "erpSystemIdIn": [
25 0
26 ],
27 "erpSystemDisplayIdLike": "string",
28 "uiSelector": "string",
29 "nameLike": "string",
30 "procedureEqual": "string",
31 "procedureLike": "string",
32 "countryIdEqual": 0,
33 "countryDisplayIdEqual": "string"
34}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "paged": true,
7 "pageSize": 0,
8 "unpaged": true,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "status": "CREATED",
22 "displayId": "string",
23 "erpSystemId": 0,
24 "erpSystemDisplayId": "string",
25 "name": "string",
26 "procedure": "string",
27 "countryId": 0,
28 "countryDisplayId": "string"
29 }
30 ],
31 "number": 0,
32 "sort": {
33 "unsorted": true,
34 "sorted": true,
35 "empty": true
36 },
37 "first": true,
38 "last": true,
39 "empty": true
40}
Tax Code - Detach Country¶
HTTP Request
POST /api/v1/tax-codes/detach/country/{country_id}
📋 Description: Detaches a specified tax code from the financial entity associated with the given country ID, facilitating updates to the organization’s financial structure and hierarchy. This operation ensures accurate alignment of tax codes within the financial organization framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
country_id |
path |
integer(int64) |
true |
Unique identifier for the country within the financial organization structure, used to detach associated tax codes. |
body |
body |
true |
Request body containing the financial entity’s tax code details to be detached from the specified country, ensuring accurate organizational structure and compliance. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "procedure": "string",
10 "countryId": 0,
11 "countryDisplayId": "string"
12 }
13]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Attach Country¶
HTTP Request
POST /api/v1/tax-codes/attach/country/{country_id}
📋 Description: Attaches tax codes to a specified country within the financial organization structure, facilitating the alignment of tax regulations with the hierarchical framework of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
country_id |
path |
integer(int64) |
true |
Unique identifier for the country associated with the tax code attachment within the financial organization structure. |
body |
body |
true |
Request body containing the tax code details to be associated with the specified country, facilitating the alignment of financial entities within the organizational structure. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "procedure": "string",
10 "countryId": 0,
11 "countryDisplayId": "string"
12 }
13]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {}
15}
Tax Code - Find All¶
HTTP Request
GET /api/v1/tax-codes
📋 Description: Retrieves a list of tax codes associated with the financial organization structure, providing insights into the hierarchical categorization of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the response should be paginated, facilitating efficient retrieval of tax codes within the financial organization structure. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "paged": true,
7 "pageSize": 0,
8 "unpaged": true,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "status": "CREATED",
22 "displayId": "string",
23 "erpSystemId": 0,
24 "erpSystemDisplayId": "string",
25 "name": "string",
26 "procedure": "string",
27 "countryId": 0,
28 "countryDisplayId": "string"
29 }
30 ],
31 "number": 0,
32 "sort": {
33 "unsorted": true,
34 "sorted": true,
35 "empty": true
36 },
37 "first": true,
38 "last": true,
39 "empty": true
40}
Tax Code - Create¶
HTTP Request
POST /api/v1/tax-codes
📋 Description: Creates a new tax code within the financial organization structure, enabling the establishment of hierarchical tax classifications for financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the tax code details, including attributes necessary for defining the financial entity’s organizational structure and hierarchy. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "procedure": "string",
9 "countryId": 0,
10 "countryDisplayId": "string"
11}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "code": "UPDATED",
3 "errors": {
4 "all": [
5 {
6 "type": "GENERIC",
7 "errorMessage": "string",
8 "source": {},
9 "field": "string",
10 "errorKey": "string"
11 }
12 ]
13 },
14 "object": {
15 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "procedure": "string",
22 "countryId": 0,
23 "countryDisplayId": "string"
24 }
25}
Tax Code - Get Metadata¶
HTTP Request
GET /api/v1/tax-codes/meta
📋 Description: Retrieves metadata for tax codes within the financial organization structure, providing insights into the hierarchy and classification of financial entities.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "NAME"
3]
Response Schema
Tax Code - Find All By System ID¶
HTTP Request
GET /api/v1/tax-codes/erp-system/{systemId}
📋 Description: Retrieves tax codes associated with a specified ERP system, facilitating the management of financial entities within the organizational structure and hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
systemId |
path |
integer(int64) |
true |
Unique identifier for the system |
pageable |
query |
true |
Indicates whether the response should be paginated, facilitating the retrieval of tax codes within the specified financial organization structure for the given ERP system. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "paged": true,
7 "pageSize": 0,
8 "unpaged": true,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "status": "CREATED",
22 "displayId": "string",
23 "erpSystemId": 0,
24 "erpSystemDisplayId": "string",
25 "name": "string",
26 "procedure": "string",
27 "countryId": 0,
28 "countryDisplayId": "string"
29 }
30 ],
31 "number": 0,
32 "sort": {
33 "unsorted": true,
34 "sorted": true,
35 "empty": true
36 },
37 "first": true,
38 "last": true,
39 "empty": true
40}
Tax Code - Get All By Country¶
HTTP Request
GET /api/v1/tax-codes/country/{country_id}
📋 Description: Retrieves tax codes associated with a specified country, facilitating the alignment of financial entities within the organizational structure and hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
country_id |
path |
integer(int64) |
true |
Unique identifier for the country within the financial organization structure, used to retrieve associated tax codes. |
pageable |
query |
true |
Indicates whether the results should be paginated, allowing users to retrieve tax codes for a specified country in a structured manner within the financial organization hierarchy. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "paged": true,
7 "pageSize": 0,
8 "unpaged": true,
9 "offset": 0,
10 "sort": {
11 "unsorted": true,
12 "sorted": true,
13 "empty": true
14 }
15 },
16 "numberOfElements": 0,
17 "size": 0,
18 "content": [
19 {
20 "id": 0,
21 "status": "CREATED",
22 "displayId": "string",
23 "erpSystemId": 0,
24 "erpSystemDisplayId": "string",
25 "name": "string",
26 "procedure": "string",
27 "countryId": 0,
28 "countryDisplayId": "string"
29 }
30 ],
31 "number": 0,
32 "sort": {
33 "unsorted": true,
34 "sorted": true,
35 "empty": true
36 },
37 "first": true,
38 "last": true,
39 "empty": true
40}