Ploomes CRMInstall

Summary

Retrieve country records from Ploomes CRM's /Cities@Countries endpoint with optional OData filtering, sorting, field selection, and relation expansion. By default, retrieve at most one record containing only Id.

Inputs

• cacheStrategy — Choose disabled (default), cacheFirst, or fallbackOnly. Enabled strategies store responses in memory; cacheFirst checks the cache before requesting, while fallbackOnly uses 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. Leave empty to omit $select.
• orderby — OData sort expression, optionally including asc or desc; defaults to Id. Leave empty to omit $orderby.
• useFilterBuilder — Use visual filter collections (default true), or disable to supply filterRaw.
• filterRaw — Optional raw OData $filter expression used when the filter builder is disabled.
• filterConditions — Optional standard conditions specifying field, operator, value, value type, and AND/OR connectors. Supports comparisons and contains, startswith, and endswith; strings are quoted and escaped.
• customPropertyFilters — Optional OtherProperties/any conditions specifying custom field ID, value property, comparison, value, and whether to leave it unquoted. Conditions are joined with AND and appended to the main filter.
• collectionFilters — Optional navigation filters specifying collection-any or direct navigation, property, field, comparison, value, and AND/OR connectors. Numeric-looking values are unquoted; this group is appended to other filters with AND.
• useExpandBuilder — Use visual relation expansions (default true), or disable to supply expandRaw.
• expandRaw — Optional raw OData $expand expression used when the expand builder is disabled.
• expandRelations — Optional navigation properties to expand, each with optional nested field selection, enabled raw nested filter, and enabled nested expansion.
• expandNestedFilters — Optional comparison conditions targeting matching properties in Expand Relations. Specify field, operator, value, numeric handling, and AND/OR connectors; these combine with any raw nested filter using AND.

Output shape

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

Makes one query per input item without automatically fetching further pages. Fields and expanded relations depend on the query and API support. An empty value array produces no success items; a response without a value array is returned as one item, and an empty body produces a success marker. Cached items include _fromCache: true; fallback items also include _fallback: true. HTTP 408/504 errors go to Timeout. Other errors go to Error 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