Arivo CRM icon

Arivo CRM

Create and edit data in Arivo CRM

Actions68

Overview

The "Deal Item" resource with the "Get Many" operation in this node allows users to retrieve multiple items associated with a specific deal from Arivo CRM. This is useful when you want to list or analyze all products or services linked to a particular deal, such as for reporting, inventory checks, or order fulfillment.

Typical scenarios include:

  • Fetching all line items of a sales deal to review quantities and prices.
  • Filtering deal items by product or name to find specific entries.
  • Sorting deal items by creation date, price, or quantity to prioritize processing.

For example, a sales manager might use this node to get all items in a deal to verify pricing before finalizing an invoice.

Properties

Name Meaning
Deal ID The unique identifier of the deal from which to retrieve items. (Required)
Return All Whether to return all matching deal items or limit the number of results returned.
Limit Maximum number of deal items to return if not returning all. Minimum is 1, default is 50.
Filters Criteria to filter deal items:
  Name Filter deal items by their name (supports partial matches).
  Product ID Filter deal items by a specific product ID (selectable from available products).
Options Additional options for sorting the results:
  Sort By Field to sort the results by. Options include Created At, Name, Price, Quantity, Total Price, Updated At. Default is Updated At.
  Sort Order Sort direction: Ascending or Descending. Default is Descending.

Output

The output is an array of JSON objects, each representing a deal item retrieved from the specified deal. Each object contains details about the deal item such as its name, associated product, quantity, price, total price, creation and update timestamps, and other relevant fields defined by the Arivo CRM API.

The output does not include binary data.

Each output item is paired with the input item it corresponds to, allowing traceability in workflows.

Dependencies

  • Requires an active connection to Arivo CRM via an API key credential configured in n8n.
  • The node depends on the Arivo CRM API endpoints for deal items.
  • The "Product ID" filter option dynamically loads available products from Arivo CRM.

Troubleshooting

  • Common issues:

    • Invalid or missing Deal ID will cause the request to fail.
    • If the API key credential is incorrect or expired, authentication errors will occur.
    • Using filters with invalid product IDs or names that do not match any deal items will result in empty outputs.
    • Exceeding API rate limits may cause temporary failures.

  • Error messages:

    • "error": "Invalid Deal ID" — Verify the deal ID exists and is correctly formatted.
    • "error": "Authentication failed" — Check the API key credential configuration.
    • "error": "Request limit exceeded" — Wait and retry later or contact support for higher limits.

  • To resolve errors, ensure all required parameters are set correctly, credentials are valid, and network connectivity to Arivo CRM is stable.

Links and References

Discussion