Posting Job Task¶
Posting Job Task - Get¶
HTTP Request
GET /api/v1/sap-posting-bot/posting/tasks/{id}
📋 Description: Retrieves the details of a specific ledger entry transaction by its unique identifier, facilitating access to financial records associated with the General Ledger.
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 "queueTime": "2019-08-24T14:15:22Z",
17 "startTime": "2019-08-24T14:15:22Z",
18 "endTime": "2019-08-24T14:15:22Z",
19 "interruptedAt": "2019-08-24T14:15:22Z",
20 "recoveredAt": "2019-08-24T14:15:22Z",
21 "status": "CREATED",
22 "recover": true,
23 "interrupted": true,
24 "interruptionMessage": "string",
25 "errorMessage": "string",
26 "erpSystem": {
27 "id": 0,
28 "displayId": "string"
29 },
30 "ledgerTransactionIds": [
31 0
32 ],
33 "postingTypes": [
34 "PAYMENT"
35 ],
36 "jobPostingStatuses": [
37 "NA"
38 ],
39 "totalPostingCount": 0,
40 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
41 "sapPostBapi": "string",
42 "sapReversalBapi": "string",
43 "failedTransactionIds": [
44 0
45 ],
46 "jobTaskReports": [
47 {
48 "id": 0,
49 "postingType": "PAYMENT",
50 "scheduledItemCount": {
51 "postCount": 0,
52 "reverseCount": 0
53 },
54 "processingItemCount": {
55 "postCount": 0,
56 "reverseCount": 0
57 },
58 "doneItemCount": {
59 "postCount": 0,
60 "reverseCount": 0
61 },
62 "failedItemCount": {
63 "postCount": 0,
64 "reverseCount": 0
65 },
66 "cancelledItemCount": {
67 "postCount": 0,
68 "reverseCount": 0
69 },
70 "skippedItemCount": {
71 "postCount": 0,
72 "reverseCount": 0
73 },
74 "totalItemCount": {
75 "postCount": 0,
76 "reverseCount": 0
77 },
78 "jobTaskId": 0
79 }
80 ],
81 "jobTaskFailureReports": [
82 {
83 "id": 0,
84 "detail1": "string",
85 "detail2": "string",
86 "systemId": 0,
87 "systemDisplayId": "string",
88 "jobId": 0,
89 "internalDocumentNumber": "string",
90 "postingType": "PAYMENT",
91 "ledgerTransactionId": 0,
92 "failureReason": "string",
93 "taskId": 0
94 }
95 ],
96 "jobId": 0
97 }
98}
Posting Job Task - Update¶
HTTP Request
PUT /api/v1/sap-posting-bot/posting/tasks/{id}
📋 Description: Updates the specified ledger entry task in the General Ledger system, allowing for modifications to transaction details and associated financial records.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
body |
body |
true |
Request body containing the updated ledger entry data, including transaction details, account information, and financial record attributes for the specified task. |
Body Parameters
1{
2 "id": 0,
3 "queueTime": "2019-08-24T14:15:22Z",
4 "startTime": "2019-08-24T14:15:22Z",
5 "endTime": "2019-08-24T14:15:22Z",
6 "interruptedAt": "2019-08-24T14:15:22Z",
7 "recoveredAt": "2019-08-24T14:15:22Z",
8 "status": "CREATED",
9 "recover": true,
10 "interrupted": true,
11 "interruptionMessage": "string",
12 "errorMessage": "string",
13 "erpSystem": {
14 "id": 0,
15 "displayId": "string"
16 },
17 "ledgerTransactionIds": [
18 0
19 ],
20 "postingTypes": [
21 "PAYMENT"
22 ],
23 "jobPostingStatuses": [
24 "NA"
25 ],
26 "totalPostingCount": 0,
27 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
28 "sapPostBapi": "string",
29 "sapReversalBapi": "string",
30 "failedTransactionIds": [
31 0
32 ],
33 "jobTaskReports": [
34 {
35 "id": 0,
36 "postingType": "PAYMENT",
37 "scheduledItemCount": {
38 "postCount": 0,
39 "reverseCount": 0
40 },
41 "processingItemCount": {
42 "postCount": 0,
43 "reverseCount": 0
44 },
45 "doneItemCount": {
46 "postCount": 0,
47 "reverseCount": 0
48 },
49 "failedItemCount": {
50 "postCount": 0,
51 "reverseCount": 0
52 },
53 "cancelledItemCount": {
54 "postCount": 0,
55 "reverseCount": 0
56 },
57 "skippedItemCount": {
58 "postCount": 0,
59 "reverseCount": 0
60 },
61 "totalItemCount": {
62 "postCount": 0,
63 "reverseCount": 0
64 },
65 "jobTaskId": 0
66 }
67 ],
68 "jobTaskFailureReports": [
69 {
70 "id": 0,
71 "detail1": "string",
72 "detail2": "string",
73 "systemId": 0,
74 "systemDisplayId": "string",
75 "jobId": 0,
76 "internalDocumentNumber": "string",
77 "postingType": "PAYMENT",
78 "ledgerTransactionId": 0,
79 "failureReason": "string",
80 "taskId": 0
81 }
82 ],
83 "jobId": 0
84}
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 "queueTime": "2019-08-24T14:15:22Z",
17 "startTime": "2019-08-24T14:15:22Z",
18 "endTime": "2019-08-24T14:15:22Z",
19 "interruptedAt": "2019-08-24T14:15:22Z",
20 "recoveredAt": "2019-08-24T14:15:22Z",
21 "status": "CREATED",
22 "recover": true,
23 "interrupted": true,
24 "interruptionMessage": "string",
25 "errorMessage": "string",
26 "erpSystem": {
27 "id": 0,
28 "displayId": "string"
29 },
30 "ledgerTransactionIds": [
31 0
32 ],
33 "postingTypes": [
34 "PAYMENT"
35 ],
36 "jobPostingStatuses": [
37 "NA"
38 ],
39 "totalPostingCount": 0,
40 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
41 "sapPostBapi": "string",
42 "sapReversalBapi": "string",
43 "failedTransactionIds": [
44 0
45 ],
46 "jobTaskReports": [
47 {
48 "id": 0,
49 "postingType": "PAYMENT",
50 "scheduledItemCount": {
51 "postCount": 0,
52 "reverseCount": 0
53 },
54 "processingItemCount": {
55 "postCount": 0,
56 "reverseCount": 0
57 },
58 "doneItemCount": {
59 "postCount": 0,
60 "reverseCount": 0
61 },
62 "failedItemCount": {
63 "postCount": 0,
64 "reverseCount": 0
65 },
66 "cancelledItemCount": {
67 "postCount": 0,
68 "reverseCount": 0
69 },
70 "skippedItemCount": {
71 "postCount": 0,
72 "reverseCount": 0
73 },
74 "totalItemCount": {
75 "postCount": 0,
76 "reverseCount": 0
77 },
78 "jobTaskId": 0
79 }
80 ],
81 "jobTaskFailureReports": [
82 {
83 "id": 0,
84 "detail1": "string",
85 "detail2": "string",
86 "systemId": 0,
87 "systemDisplayId": "string",
88 "jobId": 0,
89 "internalDocumentNumber": "string",
90 "postingType": "PAYMENT",
91 "ledgerTransactionId": 0,
92 "failureReason": "string",
93 "taskId": 0
94 }
95 ],
96 "jobId": 0
97 }
98}
Posting Job Task - Create Or Update¶
HTTP Request
PUT /api/v1/sap-posting-bot/posting/tasks/createOrUpdate
📋 Description: Creates or updates ledger entries in the General Ledger by processing transaction details and associated accounts, ensuring accurate financial records are maintained.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing the ledger entry data, including transaction details, account information, and relevant financial record attributes for creating or updating posting tasks. |
Body Parameters
1{
2 "id": 0,
3 "queueTime": "2019-08-24T14:15:22Z",
4 "startTime": "2019-08-24T14:15:22Z",
5 "endTime": "2019-08-24T14:15:22Z",
6 "interruptedAt": "2019-08-24T14:15:22Z",
7 "recoveredAt": "2019-08-24T14:15:22Z",
8 "status": "CREATED",
9 "recover": true,
10 "interrupted": true,
11 "interruptionMessage": "string",
12 "errorMessage": "string",
13 "erpSystem": {
14 "id": 0,
15 "displayId": "string"
16 },
17 "ledgerTransactionIds": [
18 0
19 ],
20 "postingTypes": [
21 "PAYMENT"
22 ],
23 "jobPostingStatuses": [
24 "NA"
25 ],
26 "totalPostingCount": 0,
27 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
28 "sapPostBapi": "string",
29 "sapReversalBapi": "string",
30 "failedTransactionIds": [
31 0
32 ],
33 "jobTaskReports": [
34 {
35 "id": 0,
36 "postingType": "PAYMENT",
37 "scheduledItemCount": {
38 "postCount": 0,
39 "reverseCount": 0
40 },
41 "processingItemCount": {
42 "postCount": 0,
43 "reverseCount": 0
44 },
45 "doneItemCount": {
46 "postCount": 0,
47 "reverseCount": 0
48 },
49 "failedItemCount": {
50 "postCount": 0,
51 "reverseCount": 0
52 },
53 "cancelledItemCount": {
54 "postCount": 0,
55 "reverseCount": 0
56 },
57 "skippedItemCount": {
58 "postCount": 0,
59 "reverseCount": 0
60 },
61 "totalItemCount": {
62 "postCount": 0,
63 "reverseCount": 0
64 },
65 "jobTaskId": 0
66 }
67 ],
68 "jobTaskFailureReports": [
69 {
70 "id": 0,
71 "detail1": "string",
72 "detail2": "string",
73 "systemId": 0,
74 "systemDisplayId": "string",
75 "jobId": 0,
76 "internalDocumentNumber": "string",
77 "postingType": "PAYMENT",
78 "ledgerTransactionId": 0,
79 "failureReason": "string",
80 "taskId": 0
81 }
82 ],
83 "jobId": 0
84}
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 "queueTime": "2019-08-24T14:15:22Z",
17 "startTime": "2019-08-24T14:15:22Z",
18 "endTime": "2019-08-24T14:15:22Z",
19 "interruptedAt": "2019-08-24T14:15:22Z",
20 "recoveredAt": "2019-08-24T14:15:22Z",
21 "status": "CREATED",
22 "recover": true,
23 "interrupted": true,
24 "interruptionMessage": "string",
25 "errorMessage": "string",
26 "erpSystem": {
27 "id": 0,
28 "displayId": "string"
29 },
30 "ledgerTransactionIds": [
31 0
32 ],
33 "postingTypes": [
34 "PAYMENT"
35 ],
36 "jobPostingStatuses": [
37 "NA"
38 ],
39 "totalPostingCount": 0,
40 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
41 "sapPostBapi": "string",
42 "sapReversalBapi": "string",
43 "failedTransactionIds": [
44 0
45 ],
46 "jobTaskReports": [
47 {
48 "id": 0,
49 "postingType": "PAYMENT",
50 "scheduledItemCount": {
51 "postCount": 0,
52 "reverseCount": 0
53 },
54 "processingItemCount": {
55 "postCount": 0,
56 "reverseCount": 0
57 },
58 "doneItemCount": {
59 "postCount": 0,
60 "reverseCount": 0
61 },
62 "failedItemCount": {
63 "postCount": 0,
64 "reverseCount": 0
65 },
66 "cancelledItemCount": {
67 "postCount": 0,
68 "reverseCount": 0
69 },
70 "skippedItemCount": {
71 "postCount": 0,
72 "reverseCount": 0
73 },
74 "totalItemCount": {
75 "postCount": 0,
76 "reverseCount": 0
77 },
78 "jobTaskId": 0
79 }
80 ],
81 "jobTaskFailureReports": [
82 {
83 "id": 0,
84 "detail1": "string",
85 "detail2": "string",
86 "systemId": 0,
87 "systemDisplayId": "string",
88 "jobId": 0,
89 "internalDocumentNumber": "string",
90 "postingType": "PAYMENT",
91 "ledgerTransactionId": 0,
92 "failureReason": "string",
93 "taskId": 0
94 }
95 ],
96 "jobId": 0
97 }
98}
Posting Job Task - Create Or Update Bulk¶
HTTP Request
PUT /api/v1/sap-posting-bot/posting/tasks/createOrUpdate/bulk
📋 Description: Creates or updates multiple ledger entries in bulk, facilitating efficient management of financial records and transactions within the General Ledger.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing bulk ledger entry data, including transaction details, account identifiers, and associated financial records for creating or updating tasks. |
Body Parameters
1[
2 {
3 "id": 0,
4 "queueTime": "2019-08-24T14:15:22Z",
5 "startTime": "2019-08-24T14:15:22Z",
6 "endTime": "2019-08-24T14:15:22Z",
7 "interruptedAt": "2019-08-24T14:15:22Z",
8 "recoveredAt": "2019-08-24T14:15:22Z",
9 "status": "CREATED",
10 "recover": true,
11 "interrupted": true,
12 "interruptionMessage": "string",
13 "errorMessage": "string",
14 "erpSystem": {
15 "id": 0,
16 "displayId": "string"
17 },
18 "ledgerTransactionIds": [
19 0
20 ],
21 "postingTypes": [
22 "PAYMENT"
23 ],
24 "jobPostingStatuses": [
25 "NA"
26 ],
27 "totalPostingCount": 0,
28 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
29 "sapPostBapi": "string",
30 "sapReversalBapi": "string",
31 "failedTransactionIds": [
32 0
33 ],
34 "jobTaskReports": [
35 {
36 "id": 0,
37 "postingType": "PAYMENT",
38 "scheduledItemCount": {
39 "postCount": 0,
40 "reverseCount": 0
41 },
42 "processingItemCount": {
43 "postCount": 0,
44 "reverseCount": 0
45 },
46 "doneItemCount": {
47 "postCount": 0,
48 "reverseCount": 0
49 },
50 "failedItemCount": {
51 "postCount": 0,
52 "reverseCount": 0
53 },
54 "cancelledItemCount": {
55 "postCount": 0,
56 "reverseCount": 0
57 },
58 "skippedItemCount": {
59 "postCount": 0,
60 "reverseCount": 0
61 },
62 "totalItemCount": {
63 "postCount": 0,
64 "reverseCount": 0
65 },
66 "jobTaskId": 0
67 }
68 ],
69 "jobTaskFailureReports": [
70 {
71 "id": 0,
72 "detail1": "string",
73 "detail2": "string",
74 "systemId": 0,
75 "systemDisplayId": "string",
76 "jobId": 0,
77 "internalDocumentNumber": "string",
78 "postingType": "PAYMENT",
79 "ledgerTransactionId": 0,
80 "failureReason": "string",
81 "taskId": 0
82 }
83 ],
84 "jobId": 0
85 }
86]
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 "queueTime": "2019-08-24T14:15:22Z",
18 "startTime": "2019-08-24T14:15:22Z",
19 "endTime": "2019-08-24T14:15:22Z",
20 "interruptedAt": "2019-08-24T14:15:22Z",
21 "recoveredAt": "2019-08-24T14:15:22Z",
22 "status": "CREATED",
23 "recover": true,
24 "interrupted": true,
25 "interruptionMessage": "string",
26 "errorMessage": "string",
27 "erpSystem": {
28 "id": 0,
29 "displayId": "string"
30 },
31 "ledgerTransactionIds": [
32 0
33 ],
34 "postingTypes": [
35 "PAYMENT"
36 ],
37 "jobPostingStatuses": [
38 "NA"
39 ],
40 "totalPostingCount": 0,
41 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
42 "sapPostBapi": "string",
43 "sapReversalBapi": "string",
44 "failedTransactionIds": [
45 0
46 ],
47 "jobTaskReports": [
48 {
49 "id": 0,
50 "postingType": "PAYMENT",
51 "scheduledItemCount": {
52 "postCount": 0,
53 "reverseCount": 0
54 },
55 "processingItemCount": {
56 "postCount": 0,
57 "reverseCount": 0
58 },
59 "doneItemCount": {
60 "postCount": 0,
61 "reverseCount": 0
62 },
63 "failedItemCount": {
64 "postCount": 0,
65 "reverseCount": 0
66 },
67 "cancelledItemCount": {
68 "postCount": 0,
69 "reverseCount": 0
70 },
71 "skippedItemCount": {
72 "postCount": 0,
73 "reverseCount": 0
74 },
75 "totalItemCount": {
76 "postCount": 0,
77 "reverseCount": 0
78 },
79 "jobTaskId": 0
80 }
81 ],
82 "jobTaskFailureReports": [
83 {
84 "id": 0,
85 "detail1": "string",
86 "detail2": "string",
87 "systemId": 0,
88 "systemDisplayId": "string",
89 "jobId": 0,
90 "internalDocumentNumber": "string",
91 "postingType": "PAYMENT",
92 "ledgerTransactionId": 0,
93 "failureReason": "string",
94 "taskId": 0
95 }
96 ],
97 "jobId": 0
98 }
99 ]
100}
Posting Job Task - Bulk Update¶
HTTP Request
PUT /api/v1/sap-posting-bot/posting/tasks/bulk
📋 Description: Updates multiple ledger entries in bulk for financial transactions, ensuring accurate and efficient management of account records within the General Ledger.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
true |
Request body containing bulk ledger entry data, including transaction details, account information, and associated financial records for processing in the General Ledger. |
Body Parameters
1[
2 {
3 "id": 0,
4 "queueTime": "2019-08-24T14:15:22Z",
5 "startTime": "2019-08-24T14:15:22Z",
6 "endTime": "2019-08-24T14:15:22Z",
7 "interruptedAt": "2019-08-24T14:15:22Z",
8 "recoveredAt": "2019-08-24T14:15:22Z",
9 "status": "CREATED",
10 "recover": true,
11 "interrupted": true,
12 "interruptionMessage": "string",
13 "errorMessage": "string",
14 "erpSystem": {
15 "id": 0,
16 "displayId": "string"
17 },
18 "ledgerTransactionIds": [
19 0
20 ],
21 "postingTypes": [
22 "PAYMENT"
23 ],
24 "jobPostingStatuses": [
25 "NA"
26 ],
27 "totalPostingCount": 0,
28 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
29 "sapPostBapi": "string",
30 "sapReversalBapi": "string",
31 "failedTransactionIds": [
32 0
33 ],
34 "jobTaskReports": [
35 {
36 "id": 0,
37 "postingType": "PAYMENT",
38 "scheduledItemCount": {
39 "postCount": 0,
40 "reverseCount": 0
41 },
42 "processingItemCount": {
43 "postCount": 0,
44 "reverseCount": 0
45 },
46 "doneItemCount": {
47 "postCount": 0,
48 "reverseCount": 0
49 },
50 "failedItemCount": {
51 "postCount": 0,
52 "reverseCount": 0
53 },
54 "cancelledItemCount": {
55 "postCount": 0,
56 "reverseCount": 0
57 },
58 "skippedItemCount": {
59 "postCount": 0,
60 "reverseCount": 0
61 },
62 "totalItemCount": {
63 "postCount": 0,
64 "reverseCount": 0
65 },
66 "jobTaskId": 0
67 }
68 ],
69 "jobTaskFailureReports": [
70 {
71 "id": 0,
72 "detail1": "string",
73 "detail2": "string",
74 "systemId": 0,
75 "systemDisplayId": "string",
76 "jobId": 0,
77 "internalDocumentNumber": "string",
78 "postingType": "PAYMENT",
79 "ledgerTransactionId": 0,
80 "failureReason": "string",
81 "taskId": 0
82 }
83 ],
84 "jobId": 0
85 }
86]
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 "queueTime": "2019-08-24T14:15:22Z",
18 "startTime": "2019-08-24T14:15:22Z",
19 "endTime": "2019-08-24T14:15:22Z",
20 "interruptedAt": "2019-08-24T14:15:22Z",
21 "recoveredAt": "2019-08-24T14:15:22Z",
22 "status": "CREATED",
23 "recover": true,
24 "interrupted": true,
25 "interruptionMessage": "string",
26 "errorMessage": "string",
27 "erpSystem": {
28 "id": 0,
29 "displayId": "string"
30 },
31 "ledgerTransactionIds": [
32 0
33 ],
34 "postingTypes": [
35 "PAYMENT"
36 ],
37 "jobPostingStatuses": [
38 "NA"
39 ],
40 "totalPostingCount": 0,
41 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
42 "sapPostBapi": "string",
43 "sapReversalBapi": "string",
44 "failedTransactionIds": [
45 0
46 ],
47 "jobTaskReports": [
48 {
49 "id": 0,
50 "postingType": "PAYMENT",
51 "scheduledItemCount": {
52 "postCount": 0,
53 "reverseCount": 0
54 },
55 "processingItemCount": {
56 "postCount": 0,
57 "reverseCount": 0
58 },
59 "doneItemCount": {
60 "postCount": 0,
61 "reverseCount": 0
62 },
63 "failedItemCount": {
64 "postCount": 0,
65 "reverseCount": 0
66 },
67 "cancelledItemCount": {
68 "postCount": 0,
69 "reverseCount": 0
70 },
71 "skippedItemCount": {
72 "postCount": 0,
73 "reverseCount": 0
74 },
75 "totalItemCount": {
76 "postCount": 0,
77 "reverseCount": 0
78 },
79 "jobTaskId": 0
80 }
81 ],
82 "jobTaskFailureReports": [
83 {
84 "id": 0,
85 "detail1": "string",
86 "detail2": "string",
87 "systemId": 0,
88 "systemDisplayId": "string",
89 "jobId": 0,
90 "internalDocumentNumber": "string",
91 "postingType": "PAYMENT",
92 "ledgerTransactionId": 0,
93 "failureReason": "string",
94 "taskId": 0
95 }
96 ],
97 "jobId": 0
98 }
99 ]
100}
Posting Job Task - Search¶
HTTP Request
POST /api/v1/sap-posting-bot/posting/tasks/search
📋 Description: Submits a request to search for ledger entries and financial records related to specific transactions and accounts, facilitating efficient retrieval of relevant posting tasks.
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 locating specific ledger entries and financial records related to transactions and accounts. |
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 "queueTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
16 "queueTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
17 "startTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
18 "startTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
19 "endTimeGreaterThanOrEqual": "2019-08-24T14:15:22Z",
20 "endTimeLessThanOrEqual": "2019-08-24T14:15:22Z",
21 "statusIn": [
22 "CREATED"
23 ],
24 "statusEqual": "CREATED",
25 "systemIdEqual": 0,
26 "systemDisplayIdLike": "string",
27 "jobIdEqual": 0
28}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
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 "erpSystem": {
32 "id": 0,
33 "displayId": "string"
34 },
35 "ledgerTransactionIds": [
36 0
37 ],
38 "postingTypes": [
39 "PAYMENT"
40 ],
41 "jobPostingStatuses": [
42 "NA"
43 ],
44 "totalPostingCount": 0,
45 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
46 "sapPostBapi": "string",
47 "sapReversalBapi": "string",
48 "failedTransactionIds": [
49 0
50 ],
51 "jobTaskReports": [
52 {
53 "id": 0,
54 "postingType": "PAYMENT",
55 "scheduledItemCount": {
56 "postCount": 0,
57 "reverseCount": 0
58 },
59 "processingItemCount": {
60 "postCount": 0,
61 "reverseCount": 0
62 },
63 "doneItemCount": {
64 "postCount": 0,
65 "reverseCount": 0
66 },
67 "failedItemCount": {
68 "postCount": 0,
69 "reverseCount": 0
70 },
71 "cancelledItemCount": {
72 "postCount": 0,
73 "reverseCount": 0
74 },
75 "skippedItemCount": {
76 "postCount": 0,
77 "reverseCount": 0
78 },
79 "totalItemCount": {
80 "postCount": 0,
81 "reverseCount": 0
82 },
83 "jobTaskId": 0
84 }
85 ],
86 "jobTaskFailureReports": [
87 {
88 "id": 0,
89 "detail1": "string",
90 "detail2": "string",
91 "systemId": 0,
92 "systemDisplayId": "string",
93 "jobId": 0,
94 "internalDocumentNumber": "string",
95 "postingType": "PAYMENT",
96 "ledgerTransactionId": 0,
97 "failureReason": "string",
98 "taskId": 0
99 }
100 ],
101 "jobId": 0
102 }
103 ],
104 "number": 0,
105 "sort": {
106 "unsorted": true,
107 "sorted": true,
108 "empty": true
109 },
110 "first": true,
111 "last": true,
112 "empty": true
113}
Posting Job Task - Find Posting Task Failure Reports¶
HTTP Request
POST /api/v1/sap-posting-bot/posting/tasks/failure-report-by-filters
📋 Description: Submits a failure report for ledger entry tasks based on specified filters, enabling users to efficiently track and manage transaction discrepancies within financial records.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
object |
true |
Request body containing the failure report data for ledger entries filtered by specific transaction and account criteria to facilitate accurate financial record management. |
» filter |
body |
false |
Data transfer object representing a filter for generating reports on posting task failures within the General Ledger, facilitating the analysis of ledger entries, transactions, accounts, and financial records. |
|
»» 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 |
»» detail1Like |
body |
string |
false |
Filter by partial match of detail1 |
»» detail2Like |
body |
string |
false |
Filter by partial match of detail2 |
»» systemIdEqual |
body |
integer(int64) |
false |
Filter by exact match of system id |
»» systemDisplayIdLike |
body |
string |
false |
Filter by partial match of system display id |
»» internalDocumentNumberLike |
body |
string |
false |
Filter by partial match of internal document number |
»» postingTypeEqual |
body |
string |
false |
Filter by exact match of posting type |
»» ledgerTransactionIdLike |
body |
string |
false |
Filter by partial match of ledger transaction id |
»» taskIdEqual |
body |
integer(int64) |
false |
Filter by exact match of task id |
» pageable |
body |
false |
Data transfer object representing a paginated collection of ledger entries, facilitating efficient retrieval and management of financial records, transactions, and account details within the General Ledger domain. |
|
»» 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 |
|---|---|
»» postingTypeEqual |
ACCRUAL, CHARGE, DEPRECIATION, FX_REMEASUREMENT, INVOICE_POSTING, MODIFICATION_RECOGNITION, PAYMENT, PROVISIONING, RECOGNITION, TERMINATION, VOUCHER |
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 "detail1Like": "string",
9 "detail2Like": "string",
10 "systemIdEqual": 0,
11 "systemDisplayIdLike": "string",
12 "internalDocumentNumberLike": "string",
13 "postingTypeEqual": "PAYMENT",
14 "ledgerTransactionIdLike": "string",
15 "taskIdEqual": 0
16 },
17 "pageable": {
18 "page": 0,
19 "size": 1,
20 "sort": [
21 "string"
22 ]
23 }
24}
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
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 "detail1": "string",
22 "detail2": "string",
23 "systemId": 0,
24 "systemDisplayId": "string",
25 "jobId": 0,
26 "internalDocumentNumber": "string",
27 "postingType": "PAYMENT",
28 "ledgerTransactionId": 0,
29 "failureReason": "string",
30 "taskId": 0
31 }
32 ],
33 "number": 0,
34 "sort": {
35 "unsorted": true,
36 "sorted": true,
37 "empty": true
38 },
39 "first": true,
40 "last": true,
41 "empty": true
42}
Posting Job Task - Cancel¶
HTTP Request
POST /api/v1/sap-posting-bot/posting/tasks/cancel/{id}
📋 Description: Cancels a specific ledger entry transaction identified by the provided ID, ensuring the integrity of financial records within the General Ledger. This operation is essential for managing account adjustments and maintaining accurate financial documentation.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
id |
path |
integer(int64) |
true |
Unique identifier for the resource |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
None |
Posting Job Task - Bulk Cancel¶
HTTP Request
POST /api/v1/sap-posting-bot/posting/tasks/cancel/bulk
📋 Description: Submits a bulk request to cancel multiple ledger entries, ensuring the accurate management of financial records and transactions within the General Ledger.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
body |
body |
array[integer] |
true |
Request body containing a collection of transaction identifiers and associated metadata for bulk cancellation of ledger entries within the General Ledger. |
Body Parameters
1[
2 0
3]
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
None |
Posting Job Task - Find All¶
HTTP Request
GET /api/v1/sap-posting-bot/posting/tasks
📋 Description: Retrieves a list of posting tasks related to ledger entries, transactions, and accounts within the General Ledger, enabling users to manage and review financial records efficiently.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
pageable |
query |
true |
Indicates whether the results of the ledger entry tasks should be returned in a paginated format, facilitating efficient retrieval of transaction data within financial records. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
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 "erpSystem": {
32 "id": 0,
33 "displayId": "string"
34 },
35 "ledgerTransactionIds": [
36 0
37 ],
38 "postingTypes": [
39 "PAYMENT"
40 ],
41 "jobPostingStatuses": [
42 "NA"
43 ],
44 "totalPostingCount": 0,
45 "jobExecutionDateTime": "2019-08-24T14:15:22Z",
46 "sapPostBapi": "string",
47 "sapReversalBapi": "string",
48 "failedTransactionIds": [
49 0
50 ],
51 "jobTaskReports": [
52 {
53 "id": 0,
54 "postingType": "PAYMENT",
55 "scheduledItemCount": {
56 "postCount": 0,
57 "reverseCount": 0
58 },
59 "processingItemCount": {
60 "postCount": 0,
61 "reverseCount": 0
62 },
63 "doneItemCount": {
64 "postCount": 0,
65 "reverseCount": 0
66 },
67 "failedItemCount": {
68 "postCount": 0,
69 "reverseCount": 0
70 },
71 "cancelledItemCount": {
72 "postCount": 0,
73 "reverseCount": 0
74 },
75 "skippedItemCount": {
76 "postCount": 0,
77 "reverseCount": 0
78 },
79 "totalItemCount": {
80 "postCount": 0,
81 "reverseCount": 0
82 },
83 "jobTaskId": 0
84 }
85 ],
86 "jobTaskFailureReports": [
87 {
88 "id": 0,
89 "detail1": "string",
90 "detail2": "string",
91 "systemId": 0,
92 "systemDisplayId": "string",
93 "jobId": 0,
94 "internalDocumentNumber": "string",
95 "postingType": "PAYMENT",
96 "ledgerTransactionId": 0,
97 "failureReason": "string",
98 "taskId": 0
99 }
100 ],
101 "jobId": 0
102 }
103 ],
104 "number": 0,
105 "sort": {
106 "unsorted": true,
107 "sorted": true,
108 "empty": true
109 },
110 "first": true,
111 "last": true,
112 "empty": true
113}
Posting Job Task - Get Posting Task Failure Reports By Task ID¶
HTTP Request
GET /api/v1/sap-posting-bot/posting/tasks/failure-report/{taskId}
📋 Description: Retrieves the failure report for a specific posting task identified by the {taskId}, providing insights into issues encountered during ledger entry transactions within the General Ledger. This operation aids in the resolution of discrepancies in financial records and enhances account management efficiency.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
taskId |
path |
integer(int64) |
true |
Unique identifier for the task |
pageable |
query |
true |
Indicates whether the response should be paginated, allowing users to efficiently retrieve financial records related to ledger entries and transaction failures for a specified task. |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
Example Responses
1{
2 "totalElements": 0,
3 "totalPages": 0,
4 "pageable": {
5 "pageNumber": 0,
6 "unpaged": true,
7 "paged": true,
8 "pageSize": 0,
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 "detail1": "string",
22 "detail2": "string",
23 "systemId": 0,
24 "systemDisplayId": "string",
25 "jobId": 0,
26 "internalDocumentNumber": "string",
27 "postingType": "PAYMENT",
28 "ledgerTransactionId": 0,
29 "failureReason": "string",
30 "taskId": 0
31 }
32 ],
33 "number": 0,
34 "sort": {
35 "unsorted": true,
36 "sorted": true,
37 "empty": true
38 },
39 "first": true,
40 "last": true,
41 "empty": true
42}
Posting Job Task - Download Xlsx Report¶
HTTP Request
GET /api/v1/sap-posting-bot/posting/tasks/download_xlsx_report/{taskId}
📋 Description: Downloads the XLSX report for a specified ledger entry task, providing a comprehensive overview of financial records and transactions associated with the given task ID.
Parameters
Name |
In |
Type |
Required |
Description |
|---|---|---|---|---|
taskId |
path |
integer(int64) |
true |
Unique identifier for the task |
Responses
Status |
Meaning |
Description |
Schema |
|---|---|---|---|
200 |
OK |
None |