When you have several allocations that run on the same interval (for example, at month end), creating an allocation group allows you to process these allocations efficiently. You can also order the members of an allocation group in the sequence they need to be processed in, for example, if an allocation is dependent on a different allocation being processed first.
Returns a collection with a key, ID, and link for each account allocation group. This operation is mostly for use in testing; use the query service to find allocation groups that meet specific criteria and to specify the properties that you want in the response.
OK
Bad Request
{- "ia::result": [
- {
- "key": "1",
- "id": "1",
- "href": "/objects/general-ledger/account-allocation-group/1"
}, - {
- "key": "2",
- "id": "2",
- "href": "/objects/general-ledger/account-allocation-group/2"
}
], - "ia::meta": {
- "totalCount": 2,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new account allocation group.
Create a new account allocation group.
name required | string Name of the account allocation group (20 characters max). Example: "Month End" | ||||||
description required | string Description of the account allocation group. Example: "All month end allocations" | ||||||
errorProcessingMethod required | string How to handle any errors encountered when processing the group allocation members.
Example: "stop" | ||||||
required | Array of objects non-empty Account allocation group members. If one allocation is dependent on the completion of a previous allocation, order the members accordingly. | ||||||
Array (non-empty)
| |||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" |
Created
Bad Request
{- "name": "Month end",
- "description": "All month end allocations for the company.",
- "errorProcessingMethod": "skipAndContinue",
- "lines": [
- {
- "glAccountAllocation": {
- "id": "1"
}
}
]
}
{- "ia::result": {
- "key": "28",
- "id": "28",
- "href": "/objects/general-ledger/account-allocation-group/28"
}, - "ia::meta": {
- "totalCount": 1
}
}
Returns detailed information for a specified account allocation group.
key required | string System-assigned key for the account allocation group. Example: 178 |
OK
Bad Request
{- "ia::result": {
- "key": "5",
- "id": "5",
- "name": "Month end",
- "description": "All month end allocations for the company.",
- "status": "active",
- "errorProcessingMethod": "skipAndContinue",
- "audit": {
- "createdDateTime": "2024-10-08T13:29:18Z",
- "modifiedDateTime": "2024-10-08T13:29:18Z",
- "createdByUser": {
- "key": "34",
- "id": "Admin",
- "href": "/objects/company-config/user/34"
}, - "modifiedByUser": {
- "key": "1",
- "id": "Aman",
- "href": "/objects/company-config/user/1"
}
}, - "lines": [
- {
- "key": "6",
- "id": "6",
- "glAccountAllocationGroup": {
- "id": "Month end",
- "key": "5",
- "href": "/objects/general-ledger/account-allocation-group/5"
}, - "glAccountAllocation": {
- "id": "8",
- "key": "8",
- "href": "/objects/general-ledger/account-allocation/8"
}, - "status": "active",
- "audit": {
- "createdDateTime": "2024-10-08T13:29:18Z",
- "modifiedDateTime": "2024-10-08T13:29:18Z",
- "createdByUser": {
- "key": "34",
- "id": "Admin",
- "href": "/objects/company-config/user/34"
}, - "modifiedByUser": {
- "key": "1",
- "id": "Aman",
- "href": "/objects/company-config/user/1"
}
}, - "href": "/objects/general-ledger/account-allocation-group-member/6"
}
], - "href": "/objects/general-ledger/account-allocation-group/5"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing account allocation group by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned key for the account allocation group. Example: 178 |
name | string Name of the account allocation group (20 characters max). Example: "Month End" | ||||||
description | string Description of the account allocation group. Example: "All month end allocations" | ||||||
errorProcessingMethod | string How to handle any errors encountered when processing the group allocation members.
Example: "stop" | ||||||
Array of objects non-empty Account allocation group members. If one allocation is dependent on the completion of a previous allocation, order the members accordingly. | |||||||
Array (non-empty)
| |||||||
status | string Default: "active" Object status. Active objects are fully functional. Inactive objects are essentially hidden and cannot be used or referenced. Example: "active" |
OK
Bad Request
{- "name": "Interest allocation",
- "description": "Compute interest allocation."
}
{- "ia::result": {
- "key": "21",
- "id": "21",
- "href": "/objects/general-ledger/account-allocation-group/21"
}, - "ia::meta": {
- "totalCount": 1
}
}
Deletes an account allocation group.
key required | string System-assigned key for the account allocation group. Example: 178 |
No Content
Bad Request
{- "ia::result": {
- "ia::error": {
- "code": "invalidRequest",
- "message": "A POST request requires a payload",
- "errorId": "REST-1028",
- "additionalInfo": {
- "messageId": "IA.REQUEST_REQUIRES_A_PAYLOAD",
- "placeholders": {
- "OPERATION": "POST"
}, - "propertySet": { }
}, - "supportId": "Kxi78%7EZuyXBDEGVHD2UmO1phYXDQAAAAo"
}
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 0,
- "totalError": 1
}
}