AvantGuard - Sage Intacct (Company Configuration)

Actions43

Earning Types Actions
- Patch Objects Company Config Earning Type Key
- Create 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
Classes Actions
- Update Company Config Class Key
- Create Company Config Class
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
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
Location Groups Actions
- Create Company Config Location Group
- Update Company Config Location Group Key
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
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

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, and hierarchical relationships. This node is beneficial for automating organizational setup or updates in financial or ERP systems where departmental structures are critical.

Practical examples:

Automatically adding a new software development department when onboarding a new team.
Creating hierarchical department structures by specifying parent departments.
Assigning supervisors to departments for routing approvals or workflows.

Properties

Name	Meaning
Id	Unique identifier for the department (string). Required.
Name	Department name (string). Required.
Additional Body Fields	Optional additional fields that can be included in the department creation request: - Key: System-assigned unique key for the department (string). - Number: Department number (string). - Report Title: Title displayed in reports (string). - Parent: JSON object representing the parent department for hierarchy. - Supervisor: JSON object referencing the employee who supervises the department. - Status: Status of the department with options: • Active • Active Non Posting • Inactive - Audit: JSON object containing audit information like created/modified timestamps and user IDs. - Href: URL endpoint for the department (string).

Output

The node outputs JSON data representing the newly created department object as returned by the API. This typically includes all properties sent in the request along with any additional metadata or identifiers assigned by the backend system.

If binary data were involved (not indicated here), it would represent attachments or files related to the department, but this node focuses solely on JSON data.

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 headers to accept and send JSON content.
No other external dependencies are indicated.

Troubleshooting

Common issues:
- Missing required fields (Id or Name) will likely cause validation errors.
- Incorrect JSON formatting in fields like Parent, Supervisor, or Audit may cause parsing errors.
- Invalid status values outside the provided options will be rejected.
- Network or authentication failures if API credentials or base URL are misconfigured.
Error messages and resolutions:
- "Missing required property" — Ensure Id and Name are provided.
- "Invalid JSON format" — Verify JSON fields are correctly formatted and parsable.
- "Unauthorized" or "Authentication failed" — Check API key credentials and permissions.
- "Resource not found" — Confirm that referenced parent or supervisor objects exist.
- "Bad Request" — Review all field values for correctness and adherence to expected types.

Links and References

Sage Intacct API Documentation
AvantGuard API Reference (hypothetical link based on vendor name)
n8n Documentation on Creating Custom Nodes