Partner¶
Partner - Get¶
HTTP Request
GET /api/v1/partners/{id}
📋 Description: Retrieves detailed information about a specific financial entity within the organizational structure by its unique identifier, facilitating insights into the hierarchy and relationships of partners.
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 "fax": "string",
22 "phone": "string",
23 "parentId": 0,
24 "parentName": "string",
25 "parentDisplayId": "string",
26 "companyId": 0,
27 "partnerRoleId": 0,
28 "partnerContactId": 0
29 }
30}
Partner - Update¶
HTTP Request
PUT /api/v1/partners/{id}
📋 Description: Updates the details of a specified financial partner within the organization’s structure, allowing for modifications to the hierarchy and attributes 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 financial entity details, including organizational structure and hierarchy information for the specified partner. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "fax": "string",
9 "phone": "string",
10 "parentId": 0,
11 "parentName": "string",
12 "parentDisplayId": "string",
13 "companyId": 0,
14 "partnerRoleId": 0,
15 "partnerContactId": 0
16}
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 "fax": "string",
22 "phone": "string",
23 "parentId": 0,
24 "parentName": "string",
25 "parentDisplayId": "string",
26 "companyId": 0,
27 "partnerRoleId": 0,
28 "partnerContactId": 0
29 }
30}
Partner - Delete¶
HTTP Request
DELETE /api/v1/partners/{id}
📋 Description: Deletes a specified financial entity partner from the organization’s 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}
Partner - Delete Or Decommission¶
HTTP Request
PUT /api/v1/partners/remove/{id}
📋 Description: Removes a specified partner from the financial organization structure, ensuring the integrity of the hierarchy and maintaining accurate records 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}
Partner - Delete Or Decommission All¶
HTTP Request
PUT /api/v1/partners/remove/bulk
📋 Description: Removes multiple partners from the financial organization structure in a single operation, ensuring efficient management of the entity’s hierarchical relationships.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list 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}
Partner - Decommission¶
HTTP Request
PUT /api/v1/partners/decommission/{id}
📋 Description: Decommissions a specified financial entity within the organizational structure, effectively removing it from the hierarchy. This operation ensures that the financial organization remains accurate and up-to-date by eliminating inactive or obsolete partners.
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 "fax": "string",
22 "phone": "string",
23 "parentId": 0,
24 "parentName": "string",
25 "parentDisplayId": "string",
26 "companyId": 0,
27 "partnerRoleId": 0,
28 "partnerContactId": 0
29 }
30}
Partner - Decommission By Modification Date Before¶
HTTP Request
PUT /api/v1/partners/decommission/modified-before/{modified_before}
📋 Description: Decommissions financial entities in the organizational structure that were modified before the specified date, ensuring the hierarchy remains current and aligned with business objectives. This operation helps maintain an accurate representation of the financial organization by removing outdated entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
modified_before |
path |
string(date-time) |
true |
Specifies the cutoff date for decommissioning partners, ensuring that only those modified before this date are processed within the financial organization 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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Decommission Before Now¶
HTTP Request
PUT /api/v1/partners/decommission/modified-before-now
📋 Description: Decommissions financial entities within the organization structure that have been modified before the current date, ensuring the hierarchy remains up-to-date and aligned with business requirements.
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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Decommission All¶
HTTP Request
PUT /api/v1/partners/decommission/bulk
📋 Description: Decommissions multiple partners within the financial organization structure, enabling the effective 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 entities to be decommissioned in bulk, including their organizational hierarchy and structural identifiers. |
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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/partners/createOrUpdate/bulk
📋 Description: Creates or updates multiple partner records within the financial organization structure, enabling efficient management of organizational hierarchy and relationships with financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing bulk 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 "name": "string",
9 "fax": "string",
10 "phone": "string",
11 "parentId": 0,
12 "parentName": "string",
13 "parentDisplayId": "string",
14 "companyId": 0,
15 "partnerRoleId": 0,
16 "partnerContactId": 0
17 }
18]
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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Create Or Update¶
HTTP Request
PUT /api/v1/partners/createOrUpdate
📋 Description: Creates or updates a financial entity within the organizational structure, allowing for the seamless integration and management of partner relationships in the hierarchy.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the financial entity details necessary for creating or updating the organization structure and hierarchy of partners. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "fax": "string",
9 "phone": "string",
10 "parentId": 0,
11 "parentName": "string",
12 "parentDisplayId": "string",
13 "companyId": 0,
14 "partnerRoleId": 0,
15 "partnerContactId": 0
16}
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 "fax": "string",
22 "phone": "string",
23 "parentId": 0,
24 "parentName": "string",
25 "parentDisplayId": "string",
26 "companyId": 0,
27 "partnerRoleId": 0,
28 "partnerContactId": 0
29 }
30}
Partner - Bulk Update¶
HTTP Request
PUT /api/v1/partners/bulk
📋 Description: Updates the financial organization structure by allowing the bulk modification of partner entities, ensuring alignment with the hierarchical framework of the financial entity.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a bulk update of partner information, including organizational structure and hierarchy details relevant to financial entities. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "fax": "string",
10 "phone": "string",
11 "parentId": 0,
12 "parentName": "string",
13 "parentDisplayId": "string",
14 "companyId": 0,
15 "partnerRoleId": 0,
16 "partnerContactId": 0
17 }
18]
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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Bulk Create¶
HTTP Request
POST /api/v1/partners/bulk
📋 Description: Submits a bulk upload of partner entities to establish or update the financial organization structure, ensuring accurate representation of the hierarchy within the financial entity.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing a bulk upload of financial entity data, including organizational structure and hierarchy details for partner integration. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "fax": "string",
10 "phone": "string",
11 "parentId": 0,
12 "parentName": "string",
13 "parentDisplayId": "string",
14 "companyId": 0,
15 "partnerRoleId": 0,
16 "partnerContactId": 0
17 }
18]
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 "fax": "string",
23 "phone": "string",
24 "parentId": 0,
25 "parentName": "string",
26 "parentDisplayId": "string",
27 "companyId": 0,
28 "partnerRoleId": 0,
29 "partnerContactId": 0
30 }
31 ]
32}
Partner - Bulk Delete¶
HTTP Request
DELETE /api/v1/partners/bulk
📋 Description: Deletes multiple partner entries from the financial organization structure, allowing for streamlined management of organizational hierarchies and relationships within the financial entity.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing an array of financial entity identifiers for bulk deletion within 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}
Partner - Search¶
HTTP Request
POST /api/v1/partners/search
📋 Description: Submits a request to search for financial entities within the organizational structure, allowing users to identify and analyze hierarchical relationships among partners.
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 identifying financial entities within the organizational structure and hierarchy. |
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 "notIdIn": [
29 0
30 ],
31 "uiSelector": "string",
32 "nameLike": "string",
33 "faxLike": "string",
34 "phoneLike": "string",
35 "parentIdEqual": 0,
36 "parentNameEqual": "string",
37 "parentDisplayIdLike": "string",
38 "companyIdEqual": 0,
39 "companyIdIn": [
40 0
41 ],
42 "partnerRoleIdEqual": 0,
43 "partnerContactIdEqual": 0
44}
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 "fax": "string",
27 "phone": "string",
28 "parentId": 0,
29 "parentName": "string",
30 "parentDisplayId": "string",
31 "companyId": 0,
32 "partnerRoleId": 0,
33 "partnerContactId": 0
34 }
35 ],
36 "number": 0,
37 "sort": {
38 "unsorted": true,
39 "sorted": true,
40 "empty": true
41 },
42 "first": true,
43 "last": true,
44 "empty": true
45}
Partner - Detach Company¶
HTTP Request
POST /api/v1/partners/detach/company/{company_id}
📋 Description: Detaches a specified company from the financial organization structure, thereby updating the hierarchy and relationships within the financial entity. This operation ensures accurate representation of organizational changes in the system.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
company_id |
path |
integer(int64) |
true |
Unique identifier for the financial entity within the organizational structure, used to detach a partner from the specified company. |
body |
body |
true |
Request body containing the details necessary to detach a financial entity from the organizational structure, including the company ID and relevant metadata. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "fax": "string",
10 "phone": "string",
11 "parentId": 0,
12 "parentName": "string",
13 "parentDisplayId": "string",
14 "companyId": 0,
15 "partnerRoleId": 0,
16 "partnerContactId": 0
17 }
18]
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}
Partner - Attach Company¶
HTTP Request
POST /api/v1/partners/attach/company/{company_id}
📋 Description: Attaches a specified company to the financial organization structure, facilitating the integration of the company’s hierarchy within the broader organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
company_id |
path |
integer(int64) |
true |
Unique identifier for the financial entity within the organization’s structure, used to attach a partner to the specified company. |
body |
body |
true |
Request body containing the financial entity details required to attach a partner to the specified company within the organizational hierarchy. |
Body Parameters
1[
2 {
3 "id": 0,
4 "status": "CREATED",
5 "displayId": "string",
6 "erpSystemId": 0,
7 "erpSystemDisplayId": "string",
8 "name": "string",
9 "fax": "string",
10 "phone": "string",
11 "parentId": 0,
12 "parentName": "string",
13 "parentDisplayId": "string",
14 "companyId": 0,
15 "partnerRoleId": 0,
16 "partnerContactId": 0
17 }
18]
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}
Partner - Find All¶
HTTP Request
GET /api/v1/partners
📋 Description: Retrieves a list of financial entities within the organizational structure, providing insights into the hierarchy and relationships among partners.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the response should be paginated, facilitating efficient retrieval of partner data 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 "fax": "string",
27 "phone": "string",
28 "parentId": 0,
29 "parentName": "string",
30 "parentDisplayId": "string",
31 "companyId": 0,
32 "partnerRoleId": 0,
33 "partnerContactId": 0
34 }
35 ],
36 "number": 0,
37 "sort": {
38 "unsorted": true,
39 "sorted": true,
40 "empty": true
41 },
42 "first": true,
43 "last": true,
44 "empty": true
45}
Partner - Create¶
HTTP Request
POST /api/v1/partners
📋 Description: Creates a new partner entry within the financial organization structure, enabling the establishment of hierarchical relationships and enhancing the overall organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the organizational structure data for a financial entity, including hierarchy details and partner information. |
Body Parameters
1{
2 "id": 0,
3 "status": "CREATED",
4 "displayId": "string",
5 "erpSystemId": 0,
6 "erpSystemDisplayId": "string",
7 "name": "string",
8 "fax": "string",
9 "phone": "string",
10 "parentId": 0,
11 "parentName": "string",
12 "parentDisplayId": "string",
13 "companyId": 0,
14 "partnerRoleId": 0,
15 "partnerContactId": 0
16}
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 "fax": "string",
22 "phone": "string",
23 "parentId": 0,
24 "parentName": "string",
25 "parentDisplayId": "string",
26 "companyId": 0,
27 "partnerRoleId": 0,
28 "partnerContactId": 0
29 }
30}
Partner - Get Metadata¶
HTTP Request
GET /api/v1/partners/meta
📋 Description: Retrieves metadata related to the financial organization structure, including details on partners and their hierarchical relationships within the financial entity.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "NAME"
3]
Response Schema
Partner - Find All By System ID¶
HTTP Request
GET /api/v1/partners/erp-system/{systemId}
📋 Description: Retrieves the details of a specified ERP system within the financial organization structure, providing insights into the organization’s hierarchy and financial entity relationships.
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 financial organization structure data for 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 "name": "string",
26 "fax": "string",
27 "phone": "string",
28 "parentId": 0,
29 "parentName": "string",
30 "parentDisplayId": "string",
31 "companyId": 0,
32 "partnerRoleId": 0,
33 "partnerContactId": 0
34 }
35 ],
36 "number": 0,
37 "sort": {
38 "unsorted": true,
39 "sorted": true,
40 "empty": true
41 },
42 "first": true,
43 "last": true,
44 "empty": true
45}
Partner - Get All By Company¶
HTTP Request
GET /api/v1/partners/company/{company_id}
📋 Description: Retrieves detailed information about a specific financial entity within the organizational structure by its unique company identifier, facilitating insights into the hierarchy and relationships of partners.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
company_id |
path |
integer(int64) |
true |
Unique identifier for the financial entity within the organization structure, used to retrieve partner information associated with the specified company. |
pageable |
query |
true |
Indicates whether the results should be returned in a paginated format, facilitating the retrieval of hierarchical data related to financial entities within the organization. |
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 "fax": "string",
27 "phone": "string",
28 "parentId": 0,
29 "parentName": "string",
30 "parentDisplayId": "string",
31 "companyId": 0,
32 "partnerRoleId": 0,
33 "partnerContactId": 0
34 }
35 ],
36 "number": 0,
37 "sort": {
38 "unsorted": true,
39 "sorted": true,
40 "empty": true
41 },
42 "first": true,
43 "last": true,
44 "empty": true
45}