Actions43
- Earning Types Actions
- Email Templates Actions
- Employee Types Actions
- Employees Actions
- Entities Actions
- Classes Actions
- Contacts Actions
- Department Groups Actions
- Exchange Rate Lines Actions
- Exchange Rate Types Actions
- Exchange Rates Actions
- Attachment Folders Actions
- Get Next Value Actions
- Location Groups Actions
- Locations Actions
- Roles Actions
- User Groups Actions
- Users Actions
- Affiliate Entity Groups Actions
- Attachments Actions
- Departments Actions
- Document Sequences Actions
Overview
This node is designed to create a new employee type configuration within a company's settings in the Sage Intacct system via the AvantGuard API. It allows users to define unique employee types with various attributes such as identifiers, hierarchy (parent types), tax form details, status, and associated entity information.
Common scenarios for this node include:
- Automating the setup of employee classifications during company onboarding.
- Managing and updating employee type hierarchies programmatically.
- Integrating HR or payroll systems with Sage Intacct by syncing employee type configurations.
For example, a payroll automation workflow could use this node to add a new "Contractor" employee type with specific 1099 tax form details and link it to a parent employee type for organizational structure.
Properties
| Name | Meaning |
|---|---|
| Id | Unique identifier for the employee type. This is a required string that distinguishes the employee type in the system. |
| Additional Body Fields | Optional additional fields to customize the employee type creation. These include: - Key: System-assigned unique key for the employee type. - Href: URL endpoint for this employee type. - Parent: JSON object defining the parent employee type for hierarchical relationships. - Form 1099: JSON object detailing 1099 tax form specifics (e.g., type and box number). - Status: Object status, either "Active" or "Inactive". Active means fully functional; inactive means hidden and unusable. - Audit: JSON object containing audit metadata like creation and modification timestamps and user IDs. - Entity: JSON object representing the associated entity with keys like key, id, name, and href. Top-level objects may have null values here. |
Output
The node outputs JSON data representing the created employee type object as returned by the API. This typically includes all properties sent in the request along with any additional metadata assigned by the backend system, such as unique keys, timestamps, and URLs.
There is no indication that the node outputs binary 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 the
@avantguardllc/n8n-openapi-nodepackage and an OpenAPI specification (openapi.json) bundled internally to build its properties and handle requests.
Troubleshooting
- Authentication errors: Ensure the API key credential is correctly set up and has sufficient permissions.
- Invalid input data: Required fields like "Id" must be provided and valid JSON must be used for complex fields such as "Parent", "Form 1099", "Audit", and "Entity".
- Status field issues: Only "active" or "inactive" are accepted; other values will cause errors.
- API connectivity problems: Verify the base URL and network access to the AvantGuard Sage Intacct API endpoint.
- Parsing JSON fields: When entering JSON in fields like "Parent" or "Form 1099", ensure proper JSON syntax to avoid parsing errors.
Links and References
- Sage Intacct API Documentation
- AvantGuard API Documentation (hypothetical link based on vendor name)
- n8n documentation on creating custom nodes