Autotask icon

Autotask

Interact with Kaseya's Autotask PSA REST API to manage companies, tickets, contracts, and more.

Actions524

Contract Charge → Get Many (Advanced)

AI-generated

Overview

This node operation retrieves multiple contract charge records from the Autotask PSA system using advanced filtering criteria. It is useful for scenarios where users need to query contract charges with complex filters, such as specific date ranges, statuses, or other custom conditions. For example, a user might want to fetch all contract charges related to a particular contract or within a certain billing period.

Use Case Examples

  1. Retrieve all contract charges for a specific contract using a JSON filter.
  2. Fetch contract charges with a limit on the number of records returned.
  3. Return all contract charges without limiting the number of results.

Properties

Name Meaning
Get All Whether to return all results or only up to a given limit.
Max Records Maximum number of contract charge records to return when not returning all.
Advanced Filter A JSON string containing a "filter" array with Autotask API query criteria to filter contract charges.
Add Picklist Labels Whether to automatically add "_label" fields for picklist fields with human-readable values.
Add Reference Labels Whether to automatically add "_label" fields for reference fields with human-readable values.
Select Columns Names or IDs. Choose which fields to include in the response. If no fields are selected, all fields will be returned. The ID field is always included.
Flatten User-Defined Fields Whether to bring user-defined fields up to the top level of each object for easier access.

Output

JSON

  • id - Unique identifier of the contract charge record.
  • contractId - Identifier of the associated contract.
  • chargeAmount - The amount charged in the contract charge record.
  • chargeDate - The date when the charge was applied.
  • description - Description or details of the contract charge.
  • status - Current status of the contract charge.
  • userDefinedFields - Custom user-defined fields related to the contract charge, if not flattened.
  • picklistLabels - Human-readable labels for picklist fields, if enabled.
  • referenceLabels - Human-readable labels for reference fields, if enabled.

Dependencies

  • Autotask PSA REST API
  • API authentication credentials

Troubleshooting

  • Ensure the JSON filter in the Advanced Filter property is correctly formatted and valid according to Autotask API specifications.
  • If no records are returned, verify that the filter criteria match existing contract charges.
  • Check API credentials and permissions to ensure access to contract charge data.
  • If the node fails, enable 'Continue On Fail' to handle errors gracefully and inspect error messages for details.

Links

Discussion