Ploomes CRMInstall

Summary

Retrieve contact product records from Ploomes CRM's /Contacts@Products endpoint with optional OData filtering, field selection, sorting, and related-entity expansion. By default, return at most one record containing only Id.

Inputs

• cacheStrategy — Choose Disabled (default), Cache First, or Fallback Only. Enabled strategies store responses in memory; Cache First checks cache before requesting, while Fallback Only checks it after a request fails.
• cacheTtl — Cache validity in seconds when caching is enabled; defaults to 300.
• top — Maximum records requested through $top; defaults to 1.
• skip — Records to skip for manual pagination; defaults to 0.
• select — Comma-separated fields to return; defaults to Id. An empty value omits $select.
• orderby — OData sort expression with optional asc/desc directions; defaults to Id.
• useFilterBuilder — Use visual filter collections (default true), or disable to supply filterRaw.
• filterRaw — Optional raw OData $filter expression, used only when the filter builder is disabled.
• filterConditions — Optional field comparisons or contains/startswith/endswith conditions, joined with AND/OR. Each condition supplies a field, operator, value, and value type; Auto leaves unsigned numeric values unquoted and quotes other values.
• customPropertyFilters — Optional OtherProperties/any filters specifying a custom field ID, value property, comparison operator, value, and whether to leave the value unquoted. Joined with AND to each other and the main filter.
• collectionFilters — Optional navigation filters using collection any() or direct property paths. Specify navigation property, field, operator, value, and AND/OR joins; these are appended with AND to existing filters.
• useExpandBuilder — Use visual expansion collections (default true), or disable to supply expandRaw.
• expandRaw — Optional raw OData $expand expression, used only when the expand builder is disabled.
• expandRelations — Optional navigation properties to expand. Each expansion can select nested fields and enable a raw nested filter or nested expansion.
• expandNestedFilters — Optional visual comparisons targeting matching properties in Expand Relations. Conditions use numeric or quoted values and AND/OR joins; combined with any raw nested filter using AND.

Output shape

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

Makes one query per incoming item without automatic pagination. A response value array is split into items, discarding its surrounding envelope; an empty array emits no items. Other response bodies are returned as a single item, and an empty body produces a success acknowledgement. Cached items include _fromCache: true; fallback items also include _fallback: true. Error payloads contain error, statusCode, isTimeout, resource, operation, and timestamp. HTTP 408/504 errors go to Timeout; other errors stop execution unless Continue On Fail is enabled. Cache keys use the URL and query parameters without credential identity.

Links

• n8n community nodes installation guide