Internal Order¶
Internal Order - Get¶
HTTP Request
GET /api/v1/internal-orders/{id}
📋 Description: Retrieves detailed information about a specific internal order within the financial organization structure, identified by the provided order ID, to facilitate effective management and oversight of organizational hierarchy and 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 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "internalOrderTypeId": 0,
22 "internalOrderTypeDisplayId": "string",
23 "controllingAreaId": 0,
24 "controllingAreaDisplayId": "string"
25 }
26}
Internal Order - Update¶
HTTP Request
PUT /api/v1/internal-orders/{id}
📋 Description: Updates the details of a specific internal order identified by its unique ID, allowing for modifications within the financial organization structure to reflect changes in hierarchy or entity requirements.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
body |
body |
true |
Request body containing updated financial entity details, including organizational structure and hierarchy information for the specified internal order. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "internalOrderTypeId": 0,
9 "internalOrderTypeDisplayId": "string",
10 "controllingAreaId": 0,
11 "controllingAreaDisplayId": "string"
12}
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 "internalOrderTypeId": 0,
22 "internalOrderTypeDisplayId": "string",
23 "controllingAreaId": 0,
24 "controllingAreaDisplayId": "string"
25 }
26}
Internal Order - Delete¶
HTTP Request
DELETE /api/v1/internal-orders/{id}
📋 Description: Deletes a specified internal order from the financial organization structure, ensuring the hierarchy remains accurate and up-to-date.
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}
Internal Order - Delete Or Decommission¶
HTTP Request
PUT /api/v1/internal-orders/remove/{id}
📋 Description: Removes a specified internal order 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}
Internal Order - Delete Or Decommission All¶
HTTP Request
PUT /api/v1/internal-orders/remove/bulk
📋 Description: Removes multiple internal orders from the financial organization structure, facilitating the management of organizational hierarchy and ensuring accurate representation of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of financial entity identifiers for bulk removal from the organizational structure 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}
Internal Order - Decommission¶
HTTP Request
PUT /api/v1/internal-orders/decommission/{id}
📋 Description: Decommissions an internal order within the financial organization structure by updating its status, thereby reflecting changes in the organizational hierarchy and financial entity 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 "id": 0,
16 "status": "CREATED",
17 "displayId": "string",
18 "erpSystemId": 0,
19 "erpSystemDisplayId": "string",
20 "name": "string",
21 "internalOrderTypeId": 0,
22 "internalOrderTypeDisplayId": "string",
23 "controllingAreaId": 0,
24 "controllingAreaDisplayId": "string"
25 }
26}
Internal Order - Decommission By Modification Date Before¶
HTTP Request
PUT /api/v1/internal-orders/decommission/modified-before/{modified_before}
📋 Description: Updates the status of internal orders within the financial organization structure that were modified before the specified date, facilitating the management of organizational hierarchy and ensuring accurate financial entity representation.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
modified_before |
path |
string(date-time) |
true |
Specifies the cutoff date for decommissioning internal orders 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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Decommission Before Now¶
HTTP Request
PUT /api/v1/internal-orders/decommission/modified-before-now
📋 Description: Updates the status of internal orders that were modified before the current date, facilitating the management of financial entity hierarchies within the organization’s structure.
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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Decommission All¶
HTTP Request
PUT /api/v1/internal-orders/decommission/bulk
📋 Description: Updates the status of multiple internal orders to ‘decommission’ within the financial organization structure, facilitating efficient management of organizational hierarchy and resource allocation.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list of internal orders to be decommissioned in bulk, including their identifiers and relevant financial entity details for effective organizational structure management. |
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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/internal-orders/createOrUpdate/bulk
📋 Description: Updates or creates multiple internal orders in bulk within the financial organization structure, ensuring alignment with the established hierarchy and organizational needs.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing bulk data for creating or updating internal orders, including details on organizational structure and financial entity hierarchy. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Create Or Update¶
HTTP Request
PUT /api/v1/internal-orders/createOrUpdate
📋 Description: Creates or updates internal orders within the financial organization structure, ensuring alignment with the established hierarchy and organizational needs.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the financial entity’s organizational structure data, including hierarchy details and relevant attributes for creating or updating internal orders. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "internalOrderTypeId": 0,
9 "internalOrderTypeDisplayId": "string",
10 "controllingAreaId": 0,
11 "controllingAreaDisplayId": "string"
12}
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 "internalOrderTypeId": 0,
22 "internalOrderTypeDisplayId": "string",
23 "controllingAreaId": 0,
24 "controllingAreaDisplayId": "string"
25 }
26}
Internal Order - Bulk Update¶
HTTP Request
PUT /api/v1/internal-orders/bulk
📋 Description: Updates multiple internal orders within the financial organization structure, allowing for efficient management of hierarchical relationships and organizational adjustments.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of internal order data, including hierarchical relationships and financial entity details for bulk processing within the 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 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Bulk Create¶
HTTP Request
POST /api/v1/internal-orders/bulk
📋 Description: Submits multiple internal orders in bulk to streamline the management of financial entities within the organizational structure and hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a collection of internal order data, including details on financial entities and their hierarchical relationships within the 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 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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 "internalOrderTypeId": 0,
23 "internalOrderTypeDisplayId": "string",
24 "controllingAreaId": 0,
25 "controllingAreaDisplayId": "string"
26 }
27 ]
28}
Internal Order - Bulk Delete¶
HTTP Request
DELETE /api/v1/internal-orders/bulk
📋 Description: Deletes multiple internal orders within the financial organization structure, enabling efficient management of organizational hierarchy and financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of internal order identifiers to be deleted, reflecting the organizational structure and 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}
Internal Order - Search¶
HTTP Request
POST /api/v1/internal-orders/search
📋 Description: Submits a search request for internal orders within the financial organization structure, allowing users to filter results based on organizational hierarchy and financial entity attributes.
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 and filters for retrieving internal orders within the financial organization structure, reflecting the hierarchical relationships of financial entities. |
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 "internalOrderTypeIdEqual": 0,
31 "internalOrderTypeDisplayIdLike": "string",
32 "controllingAreaIdEqual": 0,
33 "controllingAreaDisplayIdLike": "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 "internalOrderTypeId": 0,
27 "internalOrderTypeDisplayId": "string",
28 "controllingAreaId": 0,
29 "controllingAreaDisplayId": "string"
30 }
31 ],
32 "number": 0,
33 "sort": {
34 "unsorted": true,
35 "sorted": true,
36 "empty": true
37 },
38 "first": true,
39 "last": true,
40 "empty": true
41}
Internal Order - Detach Internal Order Type¶
HTTP Request
POST /api/v1/internal-orders/detach/internal-order-type/{internalOrderTypeId}
📋 Description: Detaches the specified internal order type from the financial organization structure, facilitating the reorganization of hierarchy within the financial entity. This operation ensures that the internal order type is no longer associated with the current organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
internalOrderTypeId |
path |
integer(int64) |
true |
Unique identifier for the internal order type |
body |
body |
true |
Request body containing the details necessary to detach a specified internal order type from the financial organization structure, including relevant identifiers and metadata. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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}
Internal Order - Detach Controlling Area¶
HTTP Request
POST /api/v1/internal-orders/detach/controlling-area/{controllingAreaId}
📋 Description: Detaches a specified controlling area from the internal order structure, facilitating adjustments to the financial organization hierarchy within the enterprise. This operation ensures accurate alignment of financial entities within the organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
controllingAreaId |
path |
integer(int64) |
true |
Unique identifier for the controlling area |
body |
body |
true |
Request body containing the details of the internal order to be detached from the specified controlling area, including relevant identifiers and metadata for accurate processing 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 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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}
Internal Order - Attach Internal Order Type¶
HTTP Request
POST /api/v1/internal-orders/attach/internal-order-type/{internalOrderTypeId}
📋 Description: Attaches a specified internal order type to the financial organization structure, facilitating the alignment of organizational hierarchy with financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
internalOrderTypeId |
path |
integer(int64) |
true |
Unique identifier for the internal order type |
body |
body |
true |
Request body containing the details for attaching an internal order type, including relevant attributes and identifiers necessary for aligning with the organization’s financial structure and hierarchy. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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}
Internal Order - Attach Controlling Area¶
HTTP Request
POST /api/v1/internal-orders/attach/controlling-area/{controllingAreaId}
📋 Description: Attaches a specified controlling area to internal orders within the financial organization structure, facilitating enhanced management of financial entities and their hierarchical relationships.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
controllingAreaId |
path |
integer(int64) |
true |
Unique identifier for the controlling area |
body |
body |
true |
Request body containing the financial entity’s internal order details, including associated metadata and hierarchical structure information for the specified controlling area. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "internalOrderTypeId": 0,
10 "internalOrderTypeDisplayId": "string",
11 "controllingAreaId": 0,
12 "controllingAreaDisplayId": "string"
13 }
14]
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}
Internal Order - Find All¶
HTTP Request
GET /api/v1/internal-orders
📋 Description: Retrieves a list of internal orders within the financial organization structure, providing insights into the hierarchical relationships and financial entities involved.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the response should be paginated, facilitating the retrieval of internal orders 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 "internalOrderTypeId": 0,
27 "internalOrderTypeDisplayId": "string",
28 "controllingAreaId": 0,
29 "controllingAreaDisplayId": "string"
30 }
31 ],
32 "number": 0,
33 "sort": {
34 "unsorted": true,
35 "sorted": true,
36 "empty": true
37 },
38 "first": true,
39 "last": true,
40 "empty": true
41}
Internal Order - Create¶
HTTP Request
POST /api/v1/internal-orders
📋 Description: Creates a new internal order within the financial organization structure, enabling the establishment of hierarchical relationships and management of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the internal order details, including organizational hierarchy and financial entity attributes, necessary for processing and managing internal transactions. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "internalOrderTypeId": 0,
9 "internalOrderTypeDisplayId": "string",
10 "controllingAreaId": 0,
11 "controllingAreaDisplayId": "string"
12}
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 "internalOrderTypeId": 0,
22 "internalOrderTypeDisplayId": "string",
23 "controllingAreaId": 0,
24 "controllingAreaDisplayId": "string"
25 }
26}
Internal Order - Get Metadata¶
HTTP Request
GET /api/v1/internal-orders/meta
📋 Description: Retrieves metadata related to internal orders within the financial organization structure, providing insights into the hierarchy and relationships of financial entities. This operation supports informed decision-making and enhances organizational transparency.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "NAME"
3]
Response Schema
Internal Order - Get All By Internal Order Type¶
HTTP Request
GET /api/v1/internal-orders/internal-order-type/{internalOrderTypeId}
📋 Description: Retrieves detailed information about a specific internal order type within the financial organization structure, identified by the provided internalOrderTypeId. This operation supports the management of organizational hierarchy and structure for financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
internalOrderTypeId |
path |
integer(int64) |
true |
Unique identifier for the internal order type |
pageable |
query |
true |
Indicates whether the results should be returned in a paginated format, facilitating efficient data retrieval within the financial organization structure 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 "internalOrderTypeId": 0,
27 "internalOrderTypeDisplayId": "string",
28 "controllingAreaId": 0,
29 "controllingAreaDisplayId": "string"
30 }
31 ],
32 "number": 0,
33 "sort": {
34 "unsorted": true,
35 "sorted": true,
36 "empty": true
37 },
38 "first": true,
39 "last": true,
40 "empty": true
41}
Internal Order - Find All By System ID¶
HTTP Request
GET /api/v1/internal-orders/erp-system/{systemId}
📋 Description: Retrieves internal order details for a specified ERP system identified by {systemId}, facilitating the understanding of the organization’s financial structure and hierarchy. This operation supports effective management of financial entities within the organization.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
systemId |
path |
integer(int64) |
true |
Unique identifier for the system |
pageable |
query |
true |
Indicates whether the results of the internal orders query should be paginated, 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 "name": "string",
26 "internalOrderTypeId": 0,
27 "internalOrderTypeDisplayId": "string",
28 "controllingAreaId": 0,
29 "controllingAreaDisplayId": "string"
30 }
31 ],
32 "number": 0,
33 "sort": {
34 "unsorted": true,
35 "sorted": true,
36 "empty": true
37 },
38 "first": true,
39 "last": true,
40 "empty": true
41}