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 or configure earning types within a company's configuration in an accounting or payroll system. It allows users to define various attributes of an earning type, such as its identifier, associated general ledger accounts, calculation methods, and rate multipliers. This node is beneficial for automating the setup of payroll components like overtime, bonuses, or other compensation categories that require specific accounting treatment.
Practical examples:
- Automatically creating a new "Overtime" earning type with specified billing and non-billing ledger accounts.
- Setting up a "Holiday Pay" earning type with a salary-based calculation method and custom rate multiplier.
- Adding audit metadata to track creation and modification details of earning types programmatically.
Properties
| Name | Meaning |
|---|---|
| Id | The unique name or identifier of the earning type (e.g., "Over time"). |
| Additional Body Fields | Optional additional fields to customize the earning type further: |
| - Key | A key string representing the earning type key. |
| - Billable GL Account | JSON object defining the general ledger account used when the earning type is billable. |
| - Non Billable GL Account | JSON object defining the general ledger account used when the earning type is non-billable. |
| - 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 information such as creation/modification timestamps and user IDs. |
Output
The node outputs JSON data representing the created or updated earning type object. This includes all properties sent in the request, potentially enriched with server-generated metadata such as 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.
- The node uses JSON payloads to communicate with the external service endpoint.
Troubleshooting
Common issues:
- Missing required "Id" property will cause the API call to fail.
- Incorrect JSON formatting in fields like "Billable GL Account" or "Audit" may result in parsing errors.
- Invalid or expired API credentials will lead to authentication failures.
- Providing unsupported values for "Calculation Method" will cause validation errors.
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 not expired.
- "422 Unprocessable Entity" — Ensure that option values like "Calculation Method" are among the allowed choices ("hourly", "salary").
- JSON parse errors — Confirm that JSON input fields contain valid JSON strings.
Links and References
- AvantGuard Sage Intacct API Documentation (example placeholder link)
- General Ledger Accounts Setup Guide
- n8n Documentation on HTTP Request Nodes