AvantGuard - Sage Intacct (Company Configuration)

Actions43

Location Groups Actions
- Update Company Config Location Group Key
- Create Company Config Location Group
Locations Actions
- Create Company Config Location
- Update Company Config Location Key
Roles Actions
- Create Company Config Role
- Update Company Config Role Key
User Groups Actions
- Create Company Config User Group
- Update Company Config User Group Key
Users Actions
- Create Company Config User
- Update Company Config User Key
Affiliate Entity Groups Actions
- Create Company Config Affiliate Entity Group
- Update Company Config Affiliate Entity Group Key
Attachments Actions
- Create Company Config Attachment
- Update Company Config Attachment Key
Classes Actions
- Create Company Config Class
- Update Company Config Class Key
Contacts Actions
- Create Company Config Contact
- Update Company Config Contact Key
Department Groups Actions
- Create Company Config Department Group
- Update Company Config Department Group Key
Departments Actions
- Create Company Config Department
- Update Company Config Department Key
Document Sequences Actions
- Create Company Config Document Sequence
- Update Company Config Document Sequence Key
Earning Types Actions
- Create Objects Company Config Earning Type Key
- Patch Objects Company Config Earning Type Key
Email Templates Actions
- Create Company Config Email Template
- Update Company Config Email Template Key
Employee Types Actions
- Create Company Config Employee Type
- Update Company Config Employee Type Key
Employees Actions
- Create Company Config Employee
- Update Company Config Employee Key
Entities Actions
- Create Company Config Entity
- Update Company Config Entity Key
Exchange Rate Lines Actions
- Create Company Config Exchange Rate Line
- Update Company Config Exchange Rate Line Key
Exchange Rate Types Actions
- Create Company Config Exchange Rate Type
- Update Company Config Exchange Rate Type Key
Exchange Rates Actions
- Create Company Config Exchange Rate
- Update Company Config Exchange Rate Key
Attachment Folders Actions
- Create Company Config Folder
- Update Company Config Folder Key
Get Next Value Actions
- Get Next Sequence Value

Overview

This node is designed to create a new department within a company's configuration in the Sage Intacct system via the AvantGuard API. It allows users to define key attributes of a department such as its unique identifier, name, hierarchical parent, supervisor, status, and other optional metadata fields.

Typical use cases include automating the setup of organizational structures during company onboarding, synchronizing department data from HR or ERP systems, or programmatically managing departmental hierarchies and reporting structures.

For example, a user might create a "Software Development" department with a specific ID and assign a supervisor employee reference, enabling purchase approval routing and accurate reporting within Sage Intacct.

Properties

Name	Meaning
Id	Unique identifier for the department (string). Required.
Name	Department name (string). Required.
Additional Body Fields	Optional additional fields to enrich the department object:
- Key	System-assigned unique key for the department (string).
- Number	Department number (string).
- Report Title	Department title displayed in reports (string).
- Parent	JSON object representing the parent department for hierarchy purposes. Example structure includes keys like `key`, `id`, `name`, and `href`.
- Supervisor	JSON object referencing the employee who supervises the department, used for routing approvals. Includes keys like `key`, `id`, `name`, and `href`.
- Status	Status of the department, controlling transaction posting and reporting usage. Options are: • Active — transactions can be posted and used in reports. • Active Non Posting — cannot post transactions but usable in reports. • Inactive — cannot be used for transactions or reports.
- Audit	JSON object containing audit information such as creation and modification timestamps and user IDs.
- Href	URL endpoint string for the department resource.

Output

The node outputs JSON data representing the newly created department object as returned by the API. This typically includes all submitted fields along with any server-generated metadata such as unique keys, timestamps, or links.

No binary data output is involved.

Dependencies

Requires an API key credential for authenticating with the AvantGuard Sage Intacct Company Configuration API.
The base URL for the API must be configured in the node credentials.
The node uses HTTP requests with JSON payloads to communicate with the external service.

Troubleshooting

Authentication errors: Ensure that the API key credential is correctly configured and has sufficient permissions to create departments.
Validation errors: Missing required fields like Id or Name will cause the API to reject the request. Verify all mandatory properties are provided.
Invalid JSON in complex fields: Fields like Parent, Supervisor, and Audit expect valid JSON objects. Malformed JSON strings will cause parsing errors.
Status field misuse: Using an unsupported status value may result in errors; only the documented options should be used.
API connectivity issues: Confirm network access to the configured base URL and that the API endpoint /ia/api/v1 is reachable.

Links and References

Sage Intacct Official Documentation
AvantGuard API Documentation (hypothetical link based on vendor name)