Department is an optional dimension that can be used for tagging, filtering, and categorizing data in many areas of Sage Intacct.
The list of departments is shared by all entities in a company. Users can be restricted to only work with and see specific departments, which might affect what data they can see in reports, transactions, and other data records.
You can create a hierarchy of departments to reflect how departments are organized within a company. To set up a hierarchy, create the parent departments first and then specify the parent department when adding child departments.
Returns up to 100 department references from the collection with a key, ID, and link for each department. This operation is mostly for use in testing; use the query service to find departments that meet certain criteria and to specify the properties that are returned.
OK
Created
Bad Request
{- "ia::result": [
- {
- "key": "11",
- "id": "Eng",
- "href": "/objects/company-config/department/1"
}, - {
- "key": "2",
- "id": "Fin",
- "href": "/objects/company-config/department/2"
}, - {
- "key": "3",
- "id": "HR",
- "href": "/objects/company-config/department/3"
}
], - "ia::meta": {
- "totalCount": 3,
- "start": 1,
- "pageSize": 100,
- "next": null,
- "previous": null
}
}
Creates a new department.
Department to create
id required | string Unique identifier for the department. Example: "SW" |
name required | string Department name. Example: "Software Dev" |
number | string Deprecated Department number. |
reportTitle | string or null Default: null Department title displayed in reports. Example: "Software Engineering" |
status | string Default: "active" Status of the dimension object:
Example: "active" |
Created
Bad Request
{- "id": "ENG",
- "name": "Engineering",
- "reportTitle": "Engineering",
- "status": "active",
- "supervisor": {
- "key": "16"
}
}
{- "ia::result": {
- "key": "12",
- "id": "ENG",
- "href": "/objects/company-config/department/12"
}, - "ia::meta": {
- "totalCount": 1
}
}
Returns detailed information for a specified department.
key required | string System-assigned key for the department. Example: 28 |
OK
Bad Request
{- "ia::result": {
- "id": "PS",
- "key": "28",
- "name": "Professional Services",
- "parent": {
- "key": "7",
- "id": "CS--Client Services",
- "name": "Client Services",
- "href": "/objects/company-config/department/7"
}, - "supervisor": {
- "key": "5",
- "id": "MGR1--PS Dept - Manager",
- "name": "PS Dept - Manager",
- "href": "/objects/company-config/employee/5"
}, - "audit": {
- "createdDateTime": "2023-01-08T11:28:12Z",
- "modifiedDateTime": "2023-01-08T11:28:12Z",
- "createdBy": "1",
- "modifiedBy": "95",
- "createdByUser": {
- "key": "1",
- "id": "Admin",
- "href": "/objects/company-config/user/1"
}, - "modifiedByUser": {
- "key": "95",
- "id": "Aman",
- "href": "/objects/company-config/user/95"
}
}, - "status": "active",
- "reportTitle": "Professional Services",
- "href": "/objects/company-config/department/28"
}, - "ia::meta": {
- "totalCount": 1,
- "totalSuccess": 1,
- "totalError": 0
}
}
Updates an existing department by setting field values. Any fields not provided remain unchanged.
key required | string System-assigned key for the department. Example: 28 |
name | string Department name. Example: "Software Dev" |
number | string Deprecated Department number. |
reportTitle | string or null Default: null Department title displayed in reports. Example: "Software Engineering" |
status | string Default: "active" Status of the dimension object:
Example: "active" |
OK
Bad Request
{- "supervisor": {
- "key": "99"
}
}
{- "ia::result": {
- "key": "1",
- "id": "SW",
- "href": "/objects/company-config/department/1"
}, - "ia::meta": {
- "totalCount": 1
}
}
Deletes a department. You can delete a department if it is not being used or referenced. Deleted departments cannot be recovered.
key required | string System-assigned key for the department. Example: 28 |
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
}
}