Ploomes CRMInstall

Summary

Retrieve deal status records from Ploomes CRM with optional OData filtering, field selection, sorting, and relation expansion. By default, fetch one record containing only Id, sorted by Id.

Inputs

• cacheStrategy — Choose disabled (default), cacheFirst, or fallbackOnly. Cache First uses a valid cached response before requesting the API; Fallback Only requests the API first and uses valid cache if it fails.
• cacheTtl — Cache validity in seconds when caching is enabled; defaults to 300. Cache is held in memory.
• top — Maximum records per request; defaults to 1.
• skip — Records to skip for manual pagination; defaults to 0.
• select — Comma-separated fields to return; defaults to Id. An empty string omits $select.
• orderby — OData sort expression, optionally including asc or desc; defaults to Id. An empty string omits $orderby.
• useFilterBuilder — Use visual filter collections (default true) or a raw OData filter.
• filterRaw — Optional raw $filter expression, used when the filter builder is disabled.
• filterConditions — Optional visual conditions with field, operator, value, value type, and AND/OR connector. Supports comparisons and contains/startswith/endswith; auto typing leaves unsigned numeric values unquoted and quotes other values.
• customPropertyFilters — Optional OtherProperties/any filters specifying field ID, value property, comparison operator, value, and whether to leave the value unquoted. Joined with AND and appended to the main filter in builder mode.
• collectionFilters — Optional navigation filters using collection any() or direct property paths. Specify navigation property, field, operator, value, and AND/OR connector; appended to the main filter with AND in builder mode.
• useExpandBuilder — Use visual relation expansions (default true) or a raw OData expansion.
• expandRaw — Optional raw $expand expression, used when the expand builder is disabled.
• expandRelations — Optional relations to expand by property name, with nested field selection, an enabled raw nested filter, and an enabled nested expansion.
• expandNestedFilters — Optional visual filters targeting matching properties in Expand Relations. Specify field, operator, value, numeric flag, and AND/OR connector; combined with any raw nested filter using AND.

Output shape

Three output branches: Success contains one JSON item per returned deal status record; Error and Timeout contain error records.

Requests /Deals@Status once per incoming item; no automatic pagination. An API value array is flattened into items, discarding its surrounding metadata; other response bodies are returned as one item. An empty value array produces no items, while an empty body produces a success acknowledgement. Cached items include _fromCache: true, plus _fallback: true when served after request failure. HTTP 408/504 errors go to Timeout; other errors go to Error only when Continue On Fail is enabled, otherwise execution throws. Error records include error, statusCode, isTimeout, resource, operation, and timestamp.

Links

• n8n community nodes installation guide