Location¶
Location - Get¶
HTTP Request
GET /api/v1/locations/{id}
📋 Description: Retrieves detailed information about a specific financial entity’s location within the organizational structure, identified by the provided ID.
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 "city": "string",
21 "cityOne": "string",
22 "country": "string",
23 "region": "string",
24 "street": "string",
25 "streetSupplimentoryOne": "string",
26 "streetSupplimentoryTwo": "string",
27 "houseNumber": "string",
28 "postalCode": "string",
29 "assetId": 0
30 }
31}
Location - Update¶
HTTP Request
PUT /api/v1/locations/{id}
📋 Description: Updates the details of a specified financial entity location within the organizational structure, allowing for adjustments to hierarchy and operational alignment.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
body |
body |
true |
Request body containing the updated financial entity location details, including hierarchical structure and organizational attributes. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "city": "string",
8 "cityOne": "string",
9 "country": "string",
10 "region": "string",
11 "street": "string",
12 "streetSupplimentoryOne": "string",
13 "streetSupplimentoryTwo": "string",
14 "houseNumber": "string",
15 "postalCode": "string",
16 "assetId": 0
17}
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 "city": "string",
21 "cityOne": "string",
22 "country": "string",
23 "region": "string",
24 "street": "string",
25 "streetSupplimentoryOne": "string",
26 "streetSupplimentoryTwo": "string",
27 "houseNumber": "string",
28 "postalCode": "string",
29 "assetId": 0
30 }
31}
Location - Delete¶
HTTP Request
DELETE /api/v1/locations/{id}
📋 Description: Deletes a specified location from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective organizational management.
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}
Location - Delete Or Decommission¶
HTTP Request
PUT /api/v1/locations/remove/{id}
📋 Description: Removes a specified location from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date for effective management of financial entities.
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}
Location - Delete Or Decommission All¶
HTTP Request
PUT /api/v1/locations/remove/bulk
📋 Description: Removes multiple locations from the financial organization structure in a single request, ensuring the hierarchy remains accurate and up-to-date.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of location identifiers to be removed in bulk from the financial organization structure, ensuring updates to the hierarchy of financial entities. |
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}
Location - Decommission¶
HTTP Request
PUT /api/v1/locations/decommission/{id}
📋 Description: Decommissions a specified financial entity location within the organizational structure, effectively removing it from the hierarchy and ensuring accurate representation of the current operational framework.
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 "city": "string",
21 "cityOne": "string",
22 "country": "string",
23 "region": "string",
24 "street": "string",
25 "streetSupplimentoryOne": "string",
26 "streetSupplimentoryTwo": "string",
27 "houseNumber": "string",
28 "postalCode": "string",
29 "assetId": 0
30 }
31}
Location - Decommission By Modification Date Before¶
HTTP Request
PUT /api/v1/locations/decommission/modified-before/{modified_before}
📋 Description: Decommissions financial organization locations that have been modified before the specified date, ensuring the integrity of the organizational structure and hierarchy within the financial entity. This operation helps maintain an up-to-date and efficient organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
modified_before |
path |
string(date-time) |
true |
Specifies the date and time before which the financial organization structure locations were modified, facilitating the decommissioning of outdated entries. |
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Decommission Before Now¶
HTTP Request
PUT /api/v1/locations/decommission/modified-before-now
📋 Description: Decommissions financial entity locations that have been modified before the current date, ensuring the organization’s structure remains up-to-date and aligned with operational needs.
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Decommission All¶
HTTP Request
PUT /api/v1/locations/decommission/bulk
📋 Description: Updates the status of multiple locations within the financial organization structure to ‘decommissioned,’ facilitating the management of organizational hierarchy and ensuring accurate representation of active financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list of financial entity locations to be decommissioned in bulk, including their identifiers and relevant metadata for organizational structure updates. |
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/locations/createOrUpdate/bulk
📋 Description: Creates or updates multiple financial entity locations within the organization structure in a single request, ensuring the hierarchy is accurately maintained.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a bulk array of location data for creating or updating financial entities within the organizational structure and hierarchy. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "city": "string",
9 "cityOne": "string",
10 "country": "string",
11 "region": "string",
12 "street": "string",
13 "streetSupplimentoryOne": "string",
14 "streetSupplimentoryTwo": "string",
15 "houseNumber": "string",
16 "postalCode": "string",
17 "assetId": 0
18 }
19]
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Create Or Update¶
HTTP Request
PUT /api/v1/locations/createOrUpdate
📋 Description: Creates or updates a financial entity’s location within the organizational structure, ensuring accurate hierarchy representation and alignment with business needs.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the details of the financial entity’s location, including hierarchical structure and organizational attributes for creation or update purposes. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "city": "string",
8 "cityOne": "string",
9 "country": "string",
10 "region": "string",
11 "street": "string",
12 "streetSupplimentoryOne": "string",
13 "streetSupplimentoryTwo": "string",
14 "houseNumber": "string",
15 "postalCode": "string",
16 "assetId": 0
17}
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 "city": "string",
21 "cityOne": "string",
22 "country": "string",
23 "region": "string",
24 "street": "string",
25 "streetSupplimentoryOne": "string",
26 "streetSupplimentoryTwo": "string",
27 "houseNumber": "string",
28 "postalCode": "string",
29 "assetId": 0
30 }
31}
Location - Bulk Update¶
HTTP Request
PUT /api/v1/locations/bulk
📋 Description: Updates multiple location records within the financial organization structure, allowing for efficient management of the hierarchy and relationships among financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a bulk update of financial entity location data, including organizational hierarchy and structural attributes. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "city": "string",
9 "cityOne": "string",
10 "country": "string",
11 "region": "string",
12 "street": "string",
13 "streetSupplimentoryOne": "string",
14 "streetSupplimentoryTwo": "string",
15 "houseNumber": "string",
16 "postalCode": "string",
17 "assetId": 0
18 }
19]
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Bulk Create¶
HTTP Request
POST /api/v1/locations/bulk
📋 Description: Submits a bulk upload of location data to establish or update the organizational structure of financial entities, ensuring accurate hierarchy representation within the system.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of financial entity location data, structured to facilitate the bulk creation or update of organizational hierarchy within the financial organization. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "city": "string",
9 "cityOne": "string",
10 "country": "string",
11 "region": "string",
12 "street": "string",
13 "streetSupplimentoryOne": "string",
14 "streetSupplimentoryTwo": "string",
15 "houseNumber": "string",
16 "postalCode": "string",
17 "assetId": 0
18 }
19]
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 "city": "string",
22 "cityOne": "string",
23 "country": "string",
24 "region": "string",
25 "street": "string",
26 "streetSupplimentoryOne": "string",
27 "streetSupplimentoryTwo": "string",
28 "houseNumber": "string",
29 "postalCode": "string",
30 "assetId": 0
31 }
32 ]
33}
Location - Bulk Delete¶
HTTP Request
DELETE /api/v1/locations/bulk
📋 Description: Deletes multiple locations within the financial organization structure, allowing for efficient management of the entity’s hierarchical framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of location identifiers to be deleted from the financial organization structure, reflecting changes in the hierarchy of the financial entity. |
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}
Location - Search¶
HTTP Request
POST /api/v1/locations/search
📋 Description: Submits a request to search for financial entities within the organizational structure, allowing users to identify and analyze hierarchical relationships effectively.
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 search criteria for financial entities within the organizational structure, including parameters for hierarchy and location details. |
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 "cityLike": "string",
29 "cityOneLike": "string",
30 "countryLike": "string",
31 "regionLike": "string",
32 "streetLike": "string",
33 "streetSupplimentoryOneLike": "string",
34 "streetSupplimentoryTwoLike": "string",
35 "houseNumberLike": "string",
36 "postalCodeLike": "string",
37 "assetIdEqual": 0
38}
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 "city": "string",
26 "cityOne": "string",
27 "country": "string",
28 "region": "string",
29 "street": "string",
30 "streetSupplimentoryOne": "string",
31 "streetSupplimentoryTwo": "string",
32 "houseNumber": "string",
33 "postalCode": "string",
34 "assetId": 0
35 }
36 ],
37 "number": 0,
38 "sort": {
39 "unsorted": true,
40 "sorted": true,
41 "empty": true
42 },
43 "first": true,
44 "last": true,
45 "empty": true
46}
Location - Find All¶
HTTP Request
GET /api/v1/locations
📋 Description: Retrieves a list of financial entities within the organizational structure, providing insights into the hierarchy and relationships among various locations.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the results for the financial organization structure locations should be returned in a paginated format, facilitating efficient data retrieval and management within the organizational 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 "city": "string",
26 "cityOne": "string",
27 "country": "string",
28 "region": "string",
29 "street": "string",
30 "streetSupplimentoryOne": "string",
31 "streetSupplimentoryTwo": "string",
32 "houseNumber": "string",
33 "postalCode": "string",
34 "assetId": 0
35 }
36 ],
37 "number": 0,
38 "sort": {
39 "unsorted": true,
40 "sorted": true,
41 "empty": true
42 },
43 "first": true,
44 "last": true,
45 "empty": true
46}
Location - Create¶
HTTP Request
POST /api/v1/locations
📋 Description: Creates a new location within the financial organization structure, enabling the establishment of hierarchical relationships among financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the hierarchical structure data for a financial organization, including details on locations and their relationships within the entity. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "city": "string",
8 "cityOne": "string",
9 "country": "string",
10 "region": "string",
11 "street": "string",
12 "streetSupplimentoryOne": "string",
13 "streetSupplimentoryTwo": "string",
14 "houseNumber": "string",
15 "postalCode": "string",
16 "assetId": 0
17}
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 "city": "string",
21 "cityOne": "string",
22 "country": "string",
23 "region": "string",
24 "street": "string",
25 "streetSupplimentoryOne": "string",
26 "streetSupplimentoryTwo": "string",
27 "houseNumber": "string",
28 "postalCode": "string",
29 "assetId": 0
30 }
31}
Location - Get Metadata¶
HTTP Request
GET /api/v1/locations/meta
📋 Description: Retrieves metadata related to the financial organization structure, including details about locations within the hierarchy of financial entities. This operation supports effective management and analysis of organizational configurations.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "CITY"
3]
Response Schema
Location - Find All By System ID¶
HTTP Request
GET /api/v1/locations/erp-system/{systemId}
📋 Description: Fetches the details of a specified financial entity’s organizational structure within the ERP system, enabling users to understand the hierarchy and relationships of various components.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
systemId |
path |
integer(int64) |
true |
Unique identifier for the system |
pageable |
query |
true |
Indicates whether the results should be returned in a paginated format, facilitating efficient navigation through the financial organization structure associated with the specified 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 "city": "string",
26 "cityOne": "string",
27 "country": "string",
28 "region": "string",
29 "street": "string",
30 "streetSupplimentoryOne": "string",
31 "streetSupplimentoryTwo": "string",
32 "houseNumber": "string",
33 "postalCode": "string",
34 "assetId": 0
35 }
36 ],
37 "number": 0,
38 "sort": {
39 "unsorted": true,
40 "sorted": true,
41 "empty": true
42 },
43 "first": true,
44 "last": true,
45 "empty": true
46}
Location - Get All By Asset¶
HTTP Request
GET /api/v1/locations/asset/{asset_id}
📋 Description: Retrieves detailed information about a specific asset within the financial organization structure, providing insights into its hierarchical positioning and associated organizational elements.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
asset_id |
path |
integer(int64) |
true |
Unique identifier for the financial asset within the organization’s structure, used to retrieve detailed information about its location in the hierarchy. |
pageable |
query |
true |
Indicates whether the results should be returned in a paginated format, facilitating efficient data retrieval 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 "city": "string",
26 "cityOne": "string",
27 "country": "string",
28 "region": "string",
29 "street": "string",
30 "streetSupplimentoryOne": "string",
31 "streetSupplimentoryTwo": "string",
32 "houseNumber": "string",
33 "postalCode": "string",
34 "assetId": 0
35 }
36 ],
37 "number": 0,
38 "sort": {
39 "unsorted": true,
40 "sorted": true,
41 "empty": true
42 },
43 "first": true,
44 "last": true,
45 "empty": true
46}