FOS Export Job¶
FOS Export Job - Get¶
HTTP Request
GET /api/v1/exports/{id}
📋 Description: Retrieves detailed information about a specific financial entity’s organizational structure and hierarchy using the provided identifier.
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 "taskCount": 0,
17 "failedTaskCount": 0,
18 "doneTaskCount": 0,
19 "inProgressTaskCount": 0,
20 "cancelledTaskCount": 0,
21 "errorMessage": "string",
22 "batchSize": 1000,
23 "totalObjectCount": 0,
24 "queueTime": "2019-08-24T14:15:22Z",
25 "startTime": "2019-08-24T14:15:22Z",
26 "endTime": "2019-08-24T14:15:22Z",
27 "status": "CREATED",
28 "fileStorageId": "string",
29 "generatingExportFile": true,
30 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
31 "version": 0,
32 "readOnly": true,
33 "docStoreId": 0,
34 "erpSystemId": 0,
35 "category": "NON_ERP",
36 "items": [
37 "INTERNAL_ASSET_CLASS"
38 ]
39 }
40}
FOS Export Job - Update¶
HTTP Request
PUT /api/v1/exports/{id}
📋 Description: Updates the financial organization structure for a specified entity, allowing users to modify the hierarchy and relationships within the organization.
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 organization structure data, including hierarchy details and attributes for the specified financial entity. |
Body Parameters
1{
2 "id": 0,
3 "taskCount": 0,
4 "failedTaskCount": 0,
5 "doneTaskCount": 0,
6 "inProgressTaskCount": 0,
7 "cancelledTaskCount": 0,
8 "errorMessage": "string",
9 "batchSize": 1000,
10 "totalObjectCount": 0,
11 "queueTime": "2019-08-24T14:15:22Z",
12 "startTime": "2019-08-24T14:15:22Z",
13 "endTime": "2019-08-24T14:15:22Z",
14 "status": "CREATED",
15 "fileStorageId": "string",
16 "generatingExportFile": true,
17 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
18 "version": 0,
19 "readOnly": true,
20 "docStoreId": 0,
21 "erpSystemId": 0,
22 "category": "NON_ERP",
23 "items": [
24 "INTERNAL_ASSET_CLASS"
25 ]
26}
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 "taskCount": 0,
17 "failedTaskCount": 0,
18 "doneTaskCount": 0,
19 "inProgressTaskCount": 0,
20 "cancelledTaskCount": 0,
21 "errorMessage": "string",
22 "batchSize": 1000,
23 "totalObjectCount": 0,
24 "queueTime": "2019-08-24T14:15:22Z",
25 "startTime": "2019-08-24T14:15:22Z",
26 "endTime": "2019-08-24T14:15:22Z",
27 "status": "CREATED",
28 "fileStorageId": "string",
29 "generatingExportFile": true,
30 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
31 "version": 0,
32 "readOnly": true,
33 "docStoreId": 0,
34 "erpSystemId": 0,
35 "category": "NON_ERP",
36 "items": [
37 "INTERNAL_ASSET_CLASS"
38 ]
39 }
40}
FOS Export Job - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/exports/createOrUpdate/bulk
📋 Description: Creates or updates multiple financial entities within the organizational structure, allowing for efficient management of hierarchy and relationships in a bulk operation.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing bulk data for creating or updating financial organization structures, including details on hierarchy and associated financial entities. |
Body Parameters
1[
2 {
3 "id": 0,
4 "taskCount": 0,
5 "failedTaskCount": 0,
6 "doneTaskCount": 0,
7 "inProgressTaskCount": 0,
8 "cancelledTaskCount": 0,
9 "errorMessage": "string",
10 "batchSize": 1000,
11 "totalObjectCount": 0,
12 "queueTime": "2019-08-24T14:15:22Z",
13 "startTime": "2019-08-24T14:15:22Z",
14 "endTime": "2019-08-24T14:15:22Z",
15 "status": "CREATED",
16 "fileStorageId": "string",
17 "generatingExportFile": true,
18 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
19 "version": 0,
20 "readOnly": true,
21 "docStoreId": 0,
22 "erpSystemId": 0,
23 "category": "NON_ERP",
24 "items": [
25 "INTERNAL_ASSET_CLASS"
26 ]
27 }
28]
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 "taskCount": 0,
18 "failedTaskCount": 0,
19 "doneTaskCount": 0,
20 "inProgressTaskCount": 0,
21 "cancelledTaskCount": 0,
22 "errorMessage": "string",
23 "batchSize": 1000,
24 "totalObjectCount": 0,
25 "queueTime": "2019-08-24T14:15:22Z",
26 "startTime": "2019-08-24T14:15:22Z",
27 "endTime": "2019-08-24T14:15:22Z",
28 "status": "CREATED",
29 "fileStorageId": "string",
30 "generatingExportFile": true,
31 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
32 "version": 0,
33 "readOnly": true,
34 "docStoreId": 0,
35 "erpSystemId": 0,
36 "category": "NON_ERP",
37 "items": [
38 "INTERNAL_ASSET_CLASS"
39 ]
40 }
41 ]
42}
FOS Export Job - Create Or Update¶
HTTP Request
PUT /api/v1/exports/createOrUpdate
📋 Description: Creates or updates the financial organization structure by submitting a comprehensive hierarchy of financial entities, ensuring accurate representation and alignment within the organizational framework.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the financial organization structure data, including details on the hierarchy and attributes of the financial entities to be created or updated. |
Body Parameters
1{
2 "id": 0,
3 "taskCount": 0,
4 "failedTaskCount": 0,
5 "doneTaskCount": 0,
6 "inProgressTaskCount": 0,
7 "cancelledTaskCount": 0,
8 "errorMessage": "string",
9 "batchSize": 1000,
10 "totalObjectCount": 0,
11 "queueTime": "2019-08-24T14:15:22Z",
12 "startTime": "2019-08-24T14:15:22Z",
13 "endTime": "2019-08-24T14:15:22Z",
14 "status": "CREATED",
15 "fileStorageId": "string",
16 "generatingExportFile": true,
17 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
18 "version": 0,
19 "readOnly": true,
20 "docStoreId": 0,
21 "erpSystemId": 0,
22 "category": "NON_ERP",
23 "items": [
24 "INTERNAL_ASSET_CLASS"
25 ]
26}
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 "taskCount": 0,
17 "failedTaskCount": 0,
18 "doneTaskCount": 0,
19 "inProgressTaskCount": 0,
20 "cancelledTaskCount": 0,
21 "errorMessage": "string",
22 "batchSize": 1000,
23 "totalObjectCount": 0,
24 "queueTime": "2019-08-24T14:15:22Z",
25 "startTime": "2019-08-24T14:15:22Z",
26 "endTime": "2019-08-24T14:15:22Z",
27 "status": "CREATED",
28 "fileStorageId": "string",
29 "generatingExportFile": true,
30 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
31 "version": 0,
32 "readOnly": true,
33 "docStoreId": 0,
34 "erpSystemId": 0,
35 "category": "NON_ERP",
36 "items": [
37 "INTERNAL_ASSET_CLASS"
38 ]
39 }
40}
FOS Export Job - Bulk Update¶
HTTP Request
PUT /api/v1/exports/bulk
📋 Description: Updates the financial organization structure in bulk, allowing for the efficient modification of hierarchies and relationships among financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the hierarchical structure data of financial entities for bulk export, including organization details and associated metadata. |
Body Parameters
1[
2 {
3 "id": 0,
4 "taskCount": 0,
5 "failedTaskCount": 0,
6 "doneTaskCount": 0,
7 "inProgressTaskCount": 0,
8 "cancelledTaskCount": 0,
9 "errorMessage": "string",
10 "batchSize": 1000,
11 "totalObjectCount": 0,
12 "queueTime": "2019-08-24T14:15:22Z",
13 "startTime": "2019-08-24T14:15:22Z",
14 "endTime": "2019-08-24T14:15:22Z",
15 "status": "CREATED",
16 "fileStorageId": "string",
17 "generatingExportFile": true,
18 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
19 "version": 0,
20 "readOnly": true,
21 "docStoreId": 0,
22 "erpSystemId": 0,
23 "category": "NON_ERP",
24 "items": [
25 "INTERNAL_ASSET_CLASS"
26 ]
27 }
28]
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 "taskCount": 0,
18 "failedTaskCount": 0,
19 "doneTaskCount": 0,
20 "inProgressTaskCount": 0,
21 "cancelledTaskCount": 0,
22 "errorMessage": "string",
23 "batchSize": 1000,
24 "totalObjectCount": 0,
25 "queueTime": "2019-08-24T14:15:22Z",
26 "startTime": "2019-08-24T14:15:22Z",
27 "endTime": "2019-08-24T14:15:22Z",
28 "status": "CREATED",
29 "fileStorageId": "string",
30 "generatingExportFile": true,
31 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
32 "version": 0,
33 "readOnly": true,
34 "docStoreId": 0,
35 "erpSystemId": 0,
36 "category": "NON_ERP",
37 "items": [
38 "INTERNAL_ASSET_CLASS"
39 ]
40 }
41 ]
42}
FOS Export Job - List Export Types¶
HTTP Request
POST /api/v1/exports/types
📋 Description: Creates a new export type for the financial organization structure, enabling the definition and management of hierarchical relationships within financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the financial organization structure data, including details on hierarchy and entity classifications. |
Body Parameters
1{
2 "id": 0,
3 "taskCount": 0,
4 "failedTaskCount": 0,
5 "doneTaskCount": 0,
6 "inProgressTaskCount": 0,
7 "cancelledTaskCount": 0,
8 "errorMessage": "string",
9 "batchSize": 1000,
10 "totalObjectCount": 0,
11 "queueTime": "2019-08-24T14:15:22Z",
12 "startTime": "2019-08-24T14:15:22Z",
13 "endTime": "2019-08-24T14:15:22Z",
14 "status": "CREATED",
15 "fileStorageId": "string",
16 "generatingExportFile": true,
17 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
18 "version": 0,
19 "readOnly": true,
20 "docStoreId": 0,
21 "erpSystemId": 0,
22 "category": "NON_ERP",
23 "items": [
24 "INTERNAL_ASSET_CLASS"
25 ]
26}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "INTERNAL_ASSET_CLASS"
3]
Response Schema
FOS Export Job - Search Tasks¶
HTTP Request
POST /api/v1/exports/tasks/search
📋 Description: Submits a request to search for financial entity tasks within the organizational structure, allowing users to efficiently navigate and manage hierarchical relationships.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
object |
false |
Request body containing search criteria for financial organization tasks, including parameters to filter by organizational structure and hierarchy. |
» filter |
body |
false |
Data transfer object representing a filter for export tasks within the financial organization structure, enabling users to refine and manage hierarchical data related to financial entities. |
|
»» idIn |
body |
[integer] |
false |
Filter by multiple values of id |
»» idEqual |
body |
integer(int64) |
false |
Filter by exact match of id |
»» idLike |
body |
string |
false |
Filter by partial match of id |
»» createdAtGreaterThanOrEqual |
body |
string(date-time) |
false |
Filter where created at is greater than or equal to specified value |
»» createdAtLessThanOrEqual |
body |
string(date-time) |
false |
Filter where created at is less than or equal to specified value |
»» createdByLike |
body |
string |
false |
Filter by partial match of created by |
»» createdByEqual |
body |
string |
false |
Filter by exact match of created by |
»» modifiedAtGreaterThanOrEqual |
body |
string(date-time) |
false |
Filter where modified at is greater than or equal to specified value |
»» modifiedAtLessThanOrEqual |
body |
string(date-time) |
false |
Filter where modified at is less than or equal to specified value |
»» modifiedByLike |
body |
string |
false |
Filter by partial match of modified by |
»» modifiedByEqual |
body |
string |
false |
Filter by exact match of modified by |
»» queueTimeGreaterThanOrEqual |
body |
string(date-time) |
false |
Filter where queue time is greater than or equal to specified value |
»» queueTimeLessThanOrEqual |
body |
string(date-time) |
false |
Filter where queue time is less than or equal to specified value |
»» startTimeGreaterThanOrEqual |
body |
string(date-time) |
false |
Filter where start time is greater than or equal to specified value |
»» startTimeLessThanOrEqual |
body |
string(date-time) |
false |
Filter where start time is less than or equal to specified value |
»» endTimeGreaterThanOrEqual |
body |
string(date-time) |
false |
Filter where end time is greater than or equal to specified value |
»» endTimeLessThanOrEqual |
body |
string(date-time) |
false |
Filter where end time is less than or equal to specified value |
»» statusIn |
body |
[string] |
false |
Filter by multiple values of status |
»» statusEqual |
body |
string |
false |
Filter by exact match of status |
»» jobIdEqual |
body |
integer(int64) |
false |
Filter by exact match of job id |
»» itemsExcelItemTypeIn |
body |
[string] |
false |
Filter by multiple values of items excel item type |
» pageable |
body |
false |
Data transfer object representing a paginated collection of financial entities within an organization’s hierarchical structure, facilitating efficient retrieval and management of organizational data. |
|
»» page |
body |
integer(int32) |
false |
Page number for pagination |
»» size |
body |
integer(int32) |
false |
Number of items per page |
»» sort |
body |
[string] |
false |
Sort order specification |
Enumerated Values
Attribute |
Value |
|---|---|
»» itemsExcelItemTypeIn |
ACCOUNTING_STANDARD, ACCOUNTING_STANDARD_DETERMINATION, AGREEMENT_GROUP, ALTERNATE_EXCHANGE_RATE, ASSET, ASSET_CLASS, ASSET_CLASS_DETERMINATION, ASSET_TRANSACTION_TYPE_DETERMINATION, BUSINESS_AREA, BUSINESS_UNIT, BUSINESS_UNIT_TO_COMPANY, CHART_OF_ACCOUNT, CHART_OF_DEPRECIATION, COMPANY, COMPANY_FINANCIAL_SETTING, COMPANY_TO_ACCOUNTING_STANDARD, COMPANY_TO_CONSUMER_PRICE_INDEX_CATEGORY, COMPANY_TO_COST_CENTER, COMPANY_TO_DEPARTMENT, COMPANY_TO_GENERAL_LEDGER_ACCOUNT, COMPANY_TO_PARTNER, COMPANY_TO_PROJECT, COMPANY_TO_TRANSFER_VARIANT, CONSUMER_PRICE_INDEX_CATEGORY, CONSUMER_PRICE_INDEX_VALUE, CONTACT_ROLE, CONTRACT_CATEGORY_GROUP, CONTRACT_GROUP_1, CONTRACT_GROUP_2, CONTROLLING_AREA, COST_CENTER, COST_CENTER_TO_PROFIT_CENTER, COUNTRY, CURRENCY, DEPARTMENT, DEPARTMENT_TO_LEASE_GROUP, DEPRECIATION_AREA, DEPRECIATION_AREA_DETERMINATION, DOCUMENT_TYPE, DOCUMENT_TYPE_DETERMINATION, END_OF_TERM_DETERMINATION, END_OF_TERM_MAPPING, ERP_SYSTEM, EXCHANGE_RATE, EXCHANGE_RATE_TYPE, EXPENSE_ACCOUNT_DETERMINATION, EXPENSE_CATEGORY, FISCAL_PERIOD, FISCAL_VARIANT, FUNCTIONAL_AREA, GENERAL_LEDGER_ACCOUNT, GENERAL_SETTING, INCREMENTAL_BORROWING_RATE, INTERNAL_ASSET_CLASS, INTERNAL_ORDER, INTERNAL_ORDER_TYPE, INVOICE_REJECTION_REASON, LEASE_AREA, LEASE_AREA_TO_BUSINESS_UNIT, LEASE_GROUP, LESSEE_ACCOUNT_DETERMINATION, LESSEE_ACCOUNT_MAPPING, LESSEE_ASSET_TRANSACTION_TYPE_MAPPING, LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LESSOR_ACCOUNT_DETERMINATION, LESSOR_ACCOUNT_MAPPING, LESSOR_ASSET_TRANSACTION_TYPE_MAPPING, LESSOR_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LOCATION, MODULE_MANAGEMENT, NAKISA_COMPANY, NETWORK, NON_LEASE_DOCUMENT_TYPE_DETERMINATION, NON_LEASE_LESSEE_ACCOUNT_DETERMINATION, NON_LEASE_LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, NON_LEASE_LESSEE_GL_ACCOUNT_MAPPING, NON_LEASE_LESSOR_ACCOUNT_DETERMINATION, NON_LEASE_LESSOR_ACCOUNT_MAPPING, NUMBER_RANGE_CONFIG, PARTNER, PARTNER_CONTACT, PARTNER_CONTACT_TO_CONTACT_ROLE, PARTNER_ROLE, PARTNER_TO_PARTNER_CONTACT, PARTNER_TO_PARTNER_ROLE, PAYMENT_BLOCK, PAYMENT_METHOD, PAYMENT_TERM, PLANT, POSTING_PERIOD_CONTROL, POSTING_PERIOD_VARIANT, PROFILE, PROFIT_CENTER, PROJECT, PURCHASE_ORDER, PURCHASING_ORGANIZATION, REGION, REVERSAL_REASON, SEGMENT, SYSTEM_FINANCIAL_SETTING, TAX_CODE, TAX_CODE_DETERMINATION, TAX_CODE_EXPENSE_CATEGORY_MAPPING, TAX_JURISDICTION, TAX_RATE_DETERMINATION, TAX_RATE_MAPPING, TRADING_PARTNER, TRANSACTION_TYPE, TRANSFER_VARIANT, UNIT_OF_MEASURE, USER_PROFILE, VENDOR_GENERAL_LEDGER_DETERMINATION, VENDOR_GENERAL_LEDGER_EXPENSE_CATEGORY_ACCOUNT_MAPPING, VENDOR_SECURITY_PROFILE, WORK_BREAKDOWN_STRUCTURE |
»» statusEqual |
CANCELLED, CANCELLING, CREATED, CREATING, DONE, FAILED, INTERRUPTED, INTERRUPTING, KILLING, PENDING, PROCESSING, SCHEDULED |
»» statusIn |
CANCELLED, CANCELLING, CREATED, CREATING, DONE, FAILED, INTERRUPTED, INTERRUPTING, KILLING, PENDING, PROCESSING, SCHEDULED |
Parameter Constraints¶
Parameter |
Constraints |
|---|---|
»» page |
Min: 0 |
»» size |
Min: 1 |
Body Parameters
1{
2 "filter": {
3 "idIn": [
4 0
5 ],
6 "idEqual": 0,
7 "idLike": "string",
8 "createdAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
9 "createdAtLessThanOrEqual": "2019-08-24T14:15:22Z",
10 "createdByLike": "string",
11 "createdByEqual": "string",
12 "modifiedAtGreaterThanOrEqual": "2019-08-24T14:15:22Z",
13 "modifiedAtLessThanOrEqual": "2019-08-24T14:15:22Z",
14 "modifiedByLike": "string",
15 "modifiedByEqual": "string",
16 "queueTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
17 "queueTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
18 "startTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
19 "startTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
20 "endTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
21 "endTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
22 "statusIn": [
23 "CREATED"
24 ],
25 "statusEqual": "CREATED",
26 "jobIdEqual": 0,
27 "itemsExcelItemTypeIn": [
28 "INTERNAL_ASSET_CLASS"
29 ]
30 },
31 "pageable": {
32 "page": 0,
33 "size": 1,
34 "sort": [
35 "string"
36 ]
37 }
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 "queueTime": "2019-08-24T14:15:22Z",
22 "startTime": "2019-08-24T14:15:22Z",
23 "endTime": "2019-08-24T14:15:22Z",
24 "interruptedAt": "2019-08-24T14:15:22Z",
25 "recoveredAt": "2019-08-24T14:15:22Z",
26 "status": "CREATED",
27 "recover": true,
28 "interrupted": true,
29 "interruptionMessage": "string",
30 "errorMessage": "string",
31 "totalObjectCount": 0,
32 "jobId": 0,
33 "erpSystemId": 0,
34 "items": [
35 {
36 "id": 0,
37 "exportTaskId": 0,
38 "excelItemType": "INTERNAL_ASSET_CLASS",
39 "startedAt": "2019-08-24T14:15:22Z",
40 "finishedAt": "2019-08-24T14:15:22Z",
41 "doneItemCount": 0,
42 "failedItemCount": 0,
43 "cancelledItemCount": 0,
44 "totalItemCount": 0
45 }
46 ]
47 }
48 ],
49 "number": 0,
50 "sort": {
51 "unsorted": true,
52 "sorted": true,
53 "empty": true
54 },
55 "first": true,
56 "last": true,
57 "empty": true
58}
FOS Export Job - Search¶
HTTP Request
POST /api/v1/exports/search
📋 Description: Submits a request to export search results related to the financial organization structure, enabling users to analyze and retrieve hierarchical data of financial entities.
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 and filters for retrieving financial organization structure data, including hierarchy and entity 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 "erpSystemIdIn": [
16 0
17 ],
18 "categoryIn": [
19 "NON_ERP"
20 ],
21 "itemsIn": [
22 "INTERNAL_ASSET_CLASS"
23 ]
24}
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 "taskCount": 0,
22 "failedTaskCount": 0,
23 "doneTaskCount": 0,
24 "inProgressTaskCount": 0,
25 "cancelledTaskCount": 0,
26 "errorMessage": "string",
27 "batchSize": 1000,
28 "totalObjectCount": 0,
29 "queueTime": "2019-08-24T14:15:22Z",
30 "startTime": "2019-08-24T14:15:22Z",
31 "endTime": "2019-08-24T14:15:22Z",
32 "status": "CREATED",
33 "fileStorageId": "string",
34 "generatingExportFile": true,
35 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
36 "version": 0,
37 "readOnly": true,
38 "docStoreId": 0,
39 "erpSystemId": 0,
40 "category": "NON_ERP",
41 "items": [
42 "INTERNAL_ASSET_CLASS"
43 ]
44 }
45 ],
46 "number": 0,
47 "sort": {
48 "unsorted": true,
49 "sorted": true,
50 "empty": true
51 },
52 "first": true,
53 "last": true,
54 "empty": true
55}
FOS Export Job - Search Details¶
HTTP Request
POST /api/v1/exports/reports/details/search
📋 Description: Submits a request to search for detailed reports within the financial organization structure, allowing users to explore the hierarchy and relationships of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
object |
false |
Request body containing detailed search criteria for financial entity reports, including organization structure and hierarchy parameters. |
» filter |
body |
false |
Data transfer object representing a filter for generating export reports related to financial entities within an organization’s structure and hierarchy. |
|
»» reportTypeEqual |
body |
string |
false |
Filter by exact match of report type |
»» itemIdIn |
body |
[integer] |
false |
Filter by multiple values of item id |
» pageable |
body |
false |
Data transfer object representing a paginated collection of financial entities within an organization’s hierarchical structure, facilitating efficient retrieval and management of organizational data. |
|
»» page |
body |
integer(int32) |
false |
Page number for pagination |
»» size |
body |
integer(int32) |
false |
Number of items per page |
»» sort |
body |
[string] |
false |
Sort order specification |
Enumerated Values
Attribute |
Value |
|---|---|
»» reportTypeEqual |
ERROR, SKIPPED, SUCCESS, WARNING |
Parameter Constraints¶
Parameter |
Constraints |
|---|---|
»» page |
Min: 0 |
»» size |
Min: 1 |
Body Parameters
1{
2 "filter": {
3 "reportTypeEqual": "SUCCESS",
4 "itemIdIn": [
5 0
6 ]
7 },
8 "pageable": {
9 "page": 0,
10 "size": 1,
11 "sort": [
12 "string"
13 ]
14 }
15}
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 "rowIdentifier": "string",
21 "reportType": "SUCCESS",
22 "message": "string",
23 "itemId": 0
24 }
25 ],
26 "number": 0,
27 "sort": {
28 "unsorted": true,
29 "sorted": true,
30 "empty": true
31 },
32 "first": true,
33 "last": true,
34 "empty": true
35}
FOS Export Job - Cancel¶
HTTP Request
POST /api/v1/exports/cancel/{id}
📋 Description: Cancels a specified export operation within the financial organization structure, allowing for the effective management of organizational hierarchies 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 |
None |
FOS Export Job - Cancel All¶
HTTP Request
POST /api/v1/exports/cancel/bulk
📋 Description: Initiates the cancellation of multiple export requests within the financial organization structure, allowing users to efficiently manage and adjust their hierarchical data operations.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a list of financial entity identifiers for bulk cancellation of export requests within the organizational structure. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
None |
FOS Export Job - Find All¶
HTTP Request
GET /api/v1/exports
📋 Description: Retrieves the organizational structure and hierarchy of financial entities, providing insights into the relationships and classifications within the financial organization.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the results of the financial organization structure export should be returned in a paginated format, facilitating efficient data retrieval for large hierarchies. |
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 "taskCount": 0,
22 "failedTaskCount": 0,
23 "doneTaskCount": 0,
24 "inProgressTaskCount": 0,
25 "cancelledTaskCount": 0,
26 "errorMessage": "string",
27 "batchSize": 1000,
28 "totalObjectCount": 0,
29 "queueTime": "2019-08-24T14:15:22Z",
30 "startTime": "2019-08-24T14:15:22Z",
31 "endTime": "2019-08-24T14:15:22Z",
32 "status": "CREATED",
33 "fileStorageId": "string",
34 "generatingExportFile": true,
35 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
36 "version": 0,
37 "readOnly": true,
38 "docStoreId": 0,
39 "erpSystemId": 0,
40 "category": "NON_ERP",
41 "items": [
42 "INTERNAL_ASSET_CLASS"
43 ]
44 }
45 ],
46 "number": 0,
47 "sort": {
48 "unsorted": true,
49 "sorted": true,
50 "empty": true
51 },
52 "first": true,
53 "last": true,
54 "empty": true
55}
FOS Export Job - Create¶
HTTP Request
POST /api/v1/exports
📋 Description: Creates a new financial organization structure export, allowing users to define and manage the hierarchy of financial entities within their organization.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the hierarchical structure and details of financial entities within the organization for export purposes. |
Body Parameters
1{
2 "id": 0,
3 "taskCount": 0,
4 "failedTaskCount": 0,
5 "doneTaskCount": 0,
6 "inProgressTaskCount": 0,
7 "cancelledTaskCount": 0,
8 "errorMessage": "string",
9 "batchSize": 1000,
10 "totalObjectCount": 0,
11 "queueTime": "2019-08-24T14:15:22Z",
12 "startTime": "2019-08-24T14:15:22Z",
13 "endTime": "2019-08-24T14:15:22Z",
14 "status": "CREATED",
15 "fileStorageId": "string",
16 "generatingExportFile": true,
17 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
18 "version": 0,
19 "readOnly": true,
20 "docStoreId": 0,
21 "erpSystemId": 0,
22 "category": "NON_ERP",
23 "items": [
24 "INTERNAL_ASSET_CLASS"
25 ]
26}
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 "taskCount": 0,
17 "failedTaskCount": 0,
18 "doneTaskCount": 0,
19 "inProgressTaskCount": 0,
20 "cancelledTaskCount": 0,
21 "errorMessage": "string",
22 "batchSize": 1000,
23 "totalObjectCount": 0,
24 "queueTime": "2019-08-24T14:15:22Z",
25 "startTime": "2019-08-24T14:15:22Z",
26 "endTime": "2019-08-24T14:15:22Z",
27 "status": "CREATED",
28 "fileStorageId": "string",
29 "generatingExportFile": true,
30 "startedGeneratingExportFileAt": "2019-08-24T14:15:22Z",
31 "version": 0,
32 "readOnly": true,
33 "docStoreId": 0,
34 "erpSystemId": 0,
35 "category": "NON_ERP",
36 "items": [
37 "INTERNAL_ASSET_CLASS"
38 ]
39 }
40}
FOS Export Job - Report By Task¶
HTTP Request
GET /api/v1/exports/reports/task/{taskId}
📋 Description: Retrieves the detailed report associated with a specific task identified by the {taskId} parameter, providing insights into the financial organization structure and hierarchy relevant to the task.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
taskId |
path |
integer(int64) |
true |
Unique identifier for the task |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 {
3 "id": 0,
4 "exportTaskId": 0,
5 "excelItemType": "INTERNAL_ASSET_CLASS",
6 "startedAt": "2019-08-24T14:15:22Z",
7 "finishedAt": "2019-08-24T14:15:22Z",
8 "doneItemCount": 0,
9 "failedItemCount": 0,
10 "cancelledItemCount": 0,
11 "totalItemCount": 0
12 }
13]
Response Schema
Status Code 200
Name |
Type |
Required |
Restrictions |
Description |
|---|---|---|---|---|
anonymous |
false |
none |
[Data transfer object representing an export item within the financial organization structure, encapsulating essential details about the entity’s hierarchy and organizational relationships.] |
|
» id |
integer(int64) |
false |
none |
Unique identifier for the resource |
» exportTaskId |
integer(int64) |
false |
none |
Unique identifier for the export task |
» excelItemType |
string |
false |
none |
Type of the excel item |
» startedAt |
string(date-time) |
false |
none |
Represents the date and time when the financial entity’s organizational structure was initiated, providing essential context for hierarchy and reporting purposes. |
» finishedAt |
string(date-time) |
false |
none |
Timestamp indicating when the financial entity’s export process was completed within the organizational structure. |
» doneItemCount |
integer(int32) |
false |
none |
Count of done item |
» failedItemCount |
integer(int32) |
false |
none |
Count of failed item |
» cancelledItemCount |
integer(int32) |
false |
none |
Count of cancelled item |
» totalItemCount |
integer(int32) |
false |
none |
Count of total item |
Enumerated Values
Attribute |
Value |
|---|---|
excelItemType |
ACCOUNTING_STANDARD, ACCOUNTING_STANDARD_DETERMINATION, AGREEMENT_GROUP, ALTERNATE_EXCHANGE_RATE, ASSET, ASSET_CLASS, ASSET_CLASS_DETERMINATION, ASSET_TRANSACTION_TYPE_DETERMINATION, BUSINESS_AREA, BUSINESS_UNIT, BUSINESS_UNIT_TO_COMPANY, CHART_OF_ACCOUNT, CHART_OF_DEPRECIATION, COMPANY, COMPANY_FINANCIAL_SETTING, COMPANY_TO_ACCOUNTING_STANDARD, COMPANY_TO_CONSUMER_PRICE_INDEX_CATEGORY, COMPANY_TO_COST_CENTER, COMPANY_TO_DEPARTMENT, COMPANY_TO_GENERAL_LEDGER_ACCOUNT, COMPANY_TO_PARTNER, COMPANY_TO_PROJECT, COMPANY_TO_TRANSFER_VARIANT, CONSUMER_PRICE_INDEX_CATEGORY, CONSUMER_PRICE_INDEX_VALUE, CONTACT_ROLE, CONTRACT_CATEGORY_GROUP, CONTRACT_GROUP_1, CONTRACT_GROUP_2, CONTROLLING_AREA, COST_CENTER, COST_CENTER_TO_PROFIT_CENTER, COUNTRY, CURRENCY, DEPARTMENT, DEPARTMENT_TO_LEASE_GROUP, DEPRECIATION_AREA, DEPRECIATION_AREA_DETERMINATION, DOCUMENT_TYPE, DOCUMENT_TYPE_DETERMINATION, END_OF_TERM_DETERMINATION, END_OF_TERM_MAPPING, ERP_SYSTEM, EXCHANGE_RATE, EXCHANGE_RATE_TYPE, EXPENSE_ACCOUNT_DETERMINATION, EXPENSE_CATEGORY, FISCAL_PERIOD, FISCAL_VARIANT, FUNCTIONAL_AREA, GENERAL_LEDGER_ACCOUNT, GENERAL_SETTING, INCREMENTAL_BORROWING_RATE, INTERNAL_ASSET_CLASS, INTERNAL_ORDER, INTERNAL_ORDER_TYPE, INVOICE_REJECTION_REASON, LEASE_AREA, LEASE_AREA_TO_BUSINESS_UNIT, LEASE_GROUP, LESSEE_ACCOUNT_DETERMINATION, LESSEE_ACCOUNT_MAPPING, LESSEE_ASSET_TRANSACTION_TYPE_MAPPING, LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LESSOR_ACCOUNT_DETERMINATION, LESSOR_ACCOUNT_MAPPING, LESSOR_ASSET_TRANSACTION_TYPE_MAPPING, LESSOR_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LOCATION, MODULE_MANAGEMENT, NAKISA_COMPANY, NETWORK, NON_LEASE_DOCUMENT_TYPE_DETERMINATION, NON_LEASE_LESSEE_ACCOUNT_DETERMINATION, NON_LEASE_LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, NON_LEASE_LESSEE_GL_ACCOUNT_MAPPING, NON_LEASE_LESSOR_ACCOUNT_DETERMINATION, NON_LEASE_LESSOR_ACCOUNT_MAPPING, NUMBER_RANGE_CONFIG, PARTNER, PARTNER_CONTACT, PARTNER_CONTACT_TO_CONTACT_ROLE, PARTNER_ROLE, PARTNER_TO_PARTNER_CONTACT, PARTNER_TO_PARTNER_ROLE, PAYMENT_BLOCK, PAYMENT_METHOD, PAYMENT_TERM, PLANT, POSTING_PERIOD_CONTROL, POSTING_PERIOD_VARIANT, PROFILE, PROFIT_CENTER, PROJECT, PURCHASE_ORDER, PURCHASING_ORGANIZATION, REGION, REVERSAL_REASON, SEGMENT, SYSTEM_FINANCIAL_SETTING, TAX_CODE, TAX_CODE_DETERMINATION, TAX_CODE_EXPENSE_CATEGORY_MAPPING, TAX_JURISDICTION, TAX_RATE_DETERMINATION, TAX_RATE_MAPPING, TRADING_PARTNER, TRANSACTION_TYPE, TRANSFER_VARIANT, UNIT_OF_MEASURE, USER_PROFILE, VENDOR_GENERAL_LEDGER_DETERMINATION, VENDOR_GENERAL_LEDGER_EXPENSE_CATEGORY_ACCOUNT_MAPPING, VENDOR_SECURITY_PROFILE, WORK_BREAKDOWN_STRUCTURE |
FOS Export Job - Report By Job¶
HTTP Request
GET /api/v1/exports/reports/job/{jobId}
📋 Description: Retrieves the export report associated with a specific job ID within the financial organization structure, providing insights into the hierarchy and organization of financial entities.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
jobId |
path |
integer(int64) |
true |
Unique identifier for the job |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 {
3 "ids": [
4 0
5 ],
6 "excelItemType": "INTERNAL_ASSET_CLASS",
7 "startedAt": "2019-08-24T14:15:22Z",
8 "finishedAt": "2019-08-24T14:15:22Z",
9 "doneItemCount": 0,
10 "failedItemCount": 0,
11 "cancelledItemCount": 0,
12 "totalItemCount": 0
13 }
14]
Response Schema
Status Code 200
Name |
Type |
Required |
Restrictions |
Description |
|---|---|---|---|---|
anonymous |
false |
none |
[Data transfer object representing an export item related to job roles within the financial organization structure, facilitating the organization and hierarchy of financial entities.] |
|
» ids |
[integer] |
false |
none |
List of ids items |
» excelItemType |
string |
false |
none |
Type of the excel item |
» startedAt |
string(date-time) |
false |
none |
Represents the date and time when the financial entity’s organizational structure was initiated, providing essential context for hierarchy and reporting purposes. |
» finishedAt |
string(date-time) |
false |
none |
Timestamp indicating when the financial entity’s job export process was completed within the organizational structure. |
» doneItemCount |
integer(int32) |
false |
none |
Count of done item |
» failedItemCount |
integer(int32) |
false |
none |
Count of failed item |
» cancelledItemCount |
integer(int32) |
false |
none |
Count of cancelled item |
» totalItemCount |
integer(int32) |
false |
none |
Count of total item |
Enumerated Values
Attribute |
Value |
|---|---|
excelItemType |
ACCOUNTING_STANDARD, ACCOUNTING_STANDARD_DETERMINATION, AGREEMENT_GROUP, ALTERNATE_EXCHANGE_RATE, ASSET, ASSET_CLASS, ASSET_CLASS_DETERMINATION, ASSET_TRANSACTION_TYPE_DETERMINATION, BUSINESS_AREA, BUSINESS_UNIT, BUSINESS_UNIT_TO_COMPANY, CHART_OF_ACCOUNT, CHART_OF_DEPRECIATION, COMPANY, COMPANY_FINANCIAL_SETTING, COMPANY_TO_ACCOUNTING_STANDARD, COMPANY_TO_CONSUMER_PRICE_INDEX_CATEGORY, COMPANY_TO_COST_CENTER, COMPANY_TO_DEPARTMENT, COMPANY_TO_GENERAL_LEDGER_ACCOUNT, COMPANY_TO_PARTNER, COMPANY_TO_PROJECT, COMPANY_TO_TRANSFER_VARIANT, CONSUMER_PRICE_INDEX_CATEGORY, CONSUMER_PRICE_INDEX_VALUE, CONTACT_ROLE, CONTRACT_CATEGORY_GROUP, CONTRACT_GROUP_1, CONTRACT_GROUP_2, CONTROLLING_AREA, COST_CENTER, COST_CENTER_TO_PROFIT_CENTER, COUNTRY, CURRENCY, DEPARTMENT, DEPARTMENT_TO_LEASE_GROUP, DEPRECIATION_AREA, DEPRECIATION_AREA_DETERMINATION, DOCUMENT_TYPE, DOCUMENT_TYPE_DETERMINATION, END_OF_TERM_DETERMINATION, END_OF_TERM_MAPPING, ERP_SYSTEM, EXCHANGE_RATE, EXCHANGE_RATE_TYPE, EXPENSE_ACCOUNT_DETERMINATION, EXPENSE_CATEGORY, FISCAL_PERIOD, FISCAL_VARIANT, FUNCTIONAL_AREA, GENERAL_LEDGER_ACCOUNT, GENERAL_SETTING, INCREMENTAL_BORROWING_RATE, INTERNAL_ASSET_CLASS, INTERNAL_ORDER, INTERNAL_ORDER_TYPE, INVOICE_REJECTION_REASON, LEASE_AREA, LEASE_AREA_TO_BUSINESS_UNIT, LEASE_GROUP, LESSEE_ACCOUNT_DETERMINATION, LESSEE_ACCOUNT_MAPPING, LESSEE_ASSET_TRANSACTION_TYPE_MAPPING, LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LESSOR_ACCOUNT_DETERMINATION, LESSOR_ACCOUNT_MAPPING, LESSOR_ASSET_TRANSACTION_TYPE_MAPPING, LESSOR_EXPENSE_CATEGORY_ACCOUNT_MAPPING, LOCATION, MODULE_MANAGEMENT, NAKISA_COMPANY, NETWORK, NON_LEASE_DOCUMENT_TYPE_DETERMINATION, NON_LEASE_LESSEE_ACCOUNT_DETERMINATION, NON_LEASE_LESSEE_EXPENSE_CATEGORY_ACCOUNT_MAPPING, NON_LEASE_LESSEE_GL_ACCOUNT_MAPPING, NON_LEASE_LESSOR_ACCOUNT_DETERMINATION, NON_LEASE_LESSOR_ACCOUNT_MAPPING, NUMBER_RANGE_CONFIG, PARTNER, PARTNER_CONTACT, PARTNER_CONTACT_TO_CONTACT_ROLE, PARTNER_ROLE, PARTNER_TO_PARTNER_CONTACT, PARTNER_TO_PARTNER_ROLE, PAYMENT_BLOCK, PAYMENT_METHOD, PAYMENT_TERM, PLANT, POSTING_PERIOD_CONTROL, POSTING_PERIOD_VARIANT, PROFILE, PROFIT_CENTER, PROJECT, PURCHASE_ORDER, PURCHASING_ORGANIZATION, REGION, REVERSAL_REASON, SEGMENT, SYSTEM_FINANCIAL_SETTING, TAX_CODE, TAX_CODE_DETERMINATION, TAX_CODE_EXPENSE_CATEGORY_MAPPING, TAX_JURISDICTION, TAX_RATE_DETERMINATION, TAX_RATE_MAPPING, TRADING_PARTNER, TRANSACTION_TYPE, TRANSFER_VARIANT, UNIT_OF_MEASURE, USER_PROFILE, VENDOR_GENERAL_LEDGER_DETERMINATION, VENDOR_GENERAL_LEDGER_EXPENSE_CATEGORY_ACCOUNT_MAPPING, VENDOR_SECURITY_PROFILE, WORK_BREAKDOWN_STRUCTURE |
FOS Export Job - Generate Export File¶
HTTP Request
GET /api/v1/exports/generate/{id}
📋 Description: Generates and retrieves the export file for a specified financial entity’s organizational structure, identified by the unique ID provided in the path. This operation facilitates the analysis and management of hierarchical relationships within the financial organization.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
None |
FOS Export Job - Get Excel Categories¶
HTTP Request
GET /api/v1/exports/excel-categories
📋 Description: Retrieves a list of financial entity categories in Excel format, providing insights into the organization’s structure and hierarchy.
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Inline |
Example Responses
1[
2 "NON_ERP"
3]
Response Schema
FOS Export Job - Download Export File¶
HTTP Request
GET /api/v1/exports/download/{id}
📋 Description: Downloads the specified financial organization structure export by its unique identifier, facilitating access to hierarchical data related to 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 |
None |