Actions43
- Location Groups Actions
- Locations Actions
- Roles Actions
- User Groups Actions
- Users Actions
- Affiliate Entity Groups Actions
- Attachments Actions
- Classes Actions
- Contacts Actions
- Department Groups Actions
- Departments Actions
- Document Sequences Actions
- Earning Types Actions
- Email Templates Actions
- Employee Types Actions
- Employees Actions
- Entities Actions
- Exchange Rate Lines Actions
- Exchange Rate Types Actions
- Exchange Rates Actions
- Attachment Folders Actions
- Get Next Value Actions
Overview
This node is designed to create a new employee type configuration within a company's system, specifically under the "Employee Types" resource with the operation "Create Company Config Employee Type." It allows users to define unique employee types by specifying an identifier and various optional attributes that describe the employee type's characteristics and relationships.
Common scenarios for this node include:
- Adding new categories of employees such as contractors, full-time staff, or interns.
- Defining hierarchical relationships between employee types (e.g., subcontractor under contractor).
- Specifying tax form details relevant to the employee type (e.g., 1099 form information).
- Managing the status and audit metadata of employee types in company configurations.
Practical example:
A payroll administrator wants to add a new employee type "Contractor" with specific tax form details and link it to a parent employee type. This node facilitates creating that structured data entry programmatically.
Properties
| Name | Meaning |
|---|---|
| Id | Unique identifier for the employee type. This is a required string value that distinguishes the employee type in the system. |
| Additional Body Fields | Optional collection of additional fields to enrich the employee type definition: - 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 hierarchy. - Form 1099: JSON object detailing 1099 tax form specifics (type and box). - Status: Object status, either "Active" or "Inactive". Active means fully functional; inactive means hidden/unusable. - Audit: JSON object containing audit metadata like creation/modification timestamps and user IDs. - Entity: JSON object representing the associated entity with keys like key, id, name, and href. |
Output
The node outputs JSON data representing the newly created employee type object as returned from the API. This JSON includes all submitted fields and any additional metadata assigned by the backend service.
There is no indication that the node outputs binary data.
Dependencies
- Requires an API key credential for authentication to the AvantGuard Sage Intacct Company Configuration API.
- The base URL for the API must be configured in the credentials.
- The node uses JSON-formatted requests and expects JSON responses.
- No other external dependencies are indicated.
Troubleshooting
- Missing Required Id: If the "Id" property is not provided, the node will likely fail because this is mandatory to identify the employee type.
- Invalid JSON in Additional Fields: The properties like "parent", "form1099", "audit", and "entity" expect valid JSON strings. Malformed JSON will cause parsing errors.
- API Authentication Errors: Ensure the API key credential is correctly set up and has permissions to create employee types.
- Status Field Misuse: Setting the status to "inactive" will make the employee type unusable; verify if this is intended.
- Network or Endpoint Issues: Confirm the base URL and network connectivity to the API endpoint.
Links and References
- AvantGuard Sage Intacct API Documentation (hypothetical link based on context)
- n8n Documentation on Creating Custom Nodes
- JSON Syntax Guide