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 or configure earning types within a company's configuration in an accounting or payroll system. It allows users to define specific earning type keys with associated details such as general ledger accounts, rate multipliers, and calculation methods. This is useful for automating payroll setups, ensuring consistent accounting entries, and managing different types of employee earnings like overtime, bonuses, or salary components.
Practical examples:
- Automatically adding a new "Overtime" earning type with specified billing and non-billing GL accounts.
- Defining a custom earning type with a specific rate multiplier and calculation method (hourly or salary).
- Updating audit information related to who created or modified the earning type and when.
Properties
| Name | Meaning |
|---|---|
| Id | The name or identifier of the earning type (e.g., "Over time"). |
| Additional Body Fields | Optional additional fields to customize the earning type: |
| - Key | The key identifier for the earning type. |
| - Billable GL Account | JSON object representing the general ledger account used for billable earnings. |
| - Non Billable GL Account | JSON object representing the general ledger account used for non-billable earnings. |
| - Rate Multiplier | A string representing the multiplier applied to the base rate for this earning type (e.g., "2"). |
| - Calculation Method | The method used to calculate earnings; options are "Hourly" or "Salary". |
| - Audit | JSON object containing audit metadata such as creation/modification timestamps and user IDs. |
Output
The node outputs JSON data representing the newly created or updated earning type object. This includes all properties sent in the request, potentially enriched with server-generated fields such as unique identifiers or timestamps.
If binary data were involved (not indicated here), it would typically represent files or attachments related to the earning type, but this node focuses on JSON structured data only.
Dependencies
- Requires an API key credential for authenticating requests to the AvantGuard Sage Intacct Company Configuration API.
- The base URL for the API must be configured in the node credentials.
- Uses JSON format for sending and receiving data.
- Depends on the
@avantguardllc/n8n-openapi-nodepackage for building request properties from the OpenAPI specification.
Troubleshooting
Common issues:
- Missing required "Id" property will cause the request to fail.
- Incorrect JSON formatting in fields like "Billable GL Account" or "Audit" may result in parsing errors.
- Authentication failures if the API key or base URL is not correctly set.
- Invalid values for "Calculation Method" will be rejected by the API.
Error messages and resolutions:
- 400 Bad Request: Check that all required fields are provided and correctly formatted.
- 401 Unauthorized: Verify that the API key credential is valid and has necessary permissions.
- Parsing errors: Ensure JSON fields are properly escaped and valid JSON strings.
- Validation errors: Confirm that options like "Calculation Method" use allowed values ("hourly" or "salary").