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 integrates with the AvantGuard Sage Intacct Company Configuration API to create a new exchange rate configuration between two currencies. It is useful for automating financial workflows where currency conversion rates need to be programmatically set or updated in the company's accounting system.
Typical use cases include:
- Automatically updating exchange rates based on external data feeds.
- Setting up initial exchange rate configurations during company setup.
- Managing multiple currency conversions for international transactions.
For example, you might use this node to create an exchange rate from USD to GBP with a specific exchange rate type and additional metadata such as effective dates and audit information.
Properties
| Name | Meaning |
|---|---|
| From Currency | The transaction currency to convert from (e.g., "USD"). |
| To Currency | The transaction currency to convert to (e.g., "GBP"). |
| Exchange Rate Type | JSON object defining the type of exchange rate, including key, id, name, and href URL endpoint. |
| Additional Body Fields | Optional collection of extra fields to include in the request body: |
| - Key | System-assigned key for the exchange rate. |
| - Id | Unique identifier for the exchange rate, typically same as key. |
| - Href | URL endpoint for the exchange rate resource. |
| - Lines | JSON array representing exchange rate lines; each line includes rate, reciprocal rate, effective start date, and audit info. |
| - Audit | JSON object containing audit details like created/modified timestamps and user IDs. |
Output
The node outputs JSON data representing the newly created exchange rate configuration as returned by the API. This typically includes all properties sent plus any additional metadata assigned by the server, such as unique identifiers or timestamps.
If the API supports binary data output (not indicated here), it would represent related files or attachments, but this node primarily deals with JSON data.
Dependencies
- Requires an API key credential for authenticating with the AvantGuard Sage Intacct API.
- The base URL for the API must be configured in the node credentials.
- Uses HTTP headers
Accept: application/jsonandContent-Type: application/json. - Depends on the
@avantguardllc/n8n-openapi-nodepackage for building request properties from the OpenAPI specification.
Troubleshooting
- Authentication errors: Ensure the API key credential is correctly configured and has necessary permissions.
- Invalid JSON in Exchange Rate Type or Lines: The node expects valid JSON strings for these fields; malformed JSON will cause errors.
- Missing required fields: The node requires
From Currency,To Currency, andExchange Rate Type. Omitting these will result in validation errors. - API endpoint issues: Verify that the base URL and endpoints are correct and accessible from your environment.
- Date format errors: The
effectiveStartDatein lines should be in ISO date format (YYYY-MM-DD).