QonektoInstall

Summary

Filters Kunden (customers) using the provided filter criteria and returns matching records.

Inputs

• Filters — Collection of filter fields; only non-empty values are applied. Each sub‑field maps to a column in the Kunde table and is sent in the request body as a JSON property with the same name. Example sub‑fields are: Vermittler ID (resourceLocator, 6‑char alphanumeric), Anrede ID (resourceLocator), Vorname (string, max 255), Nachname (string, max 255), Titel (string, max 255), Strasse (string, max 255), Plz (string, 4‑5 chars), Ort (string, max 255), Land ID (resourceLocator), Geburtsdatum (dateTime, formats Y‑m‑d or d.m.Y), Beruf (string, max 255), Per Du (boolean), Nationalitaet (string, max 255), Rechtsform ID (resourceLocator), Benutzername Simplr (string, max 255), Verstorben (boolean), Kommunikation (JSON object), Details (JSON object).
• Pagination Fields — Controls pagination of the result set. Skip (number, default 0) defines how many records to skip; Limit (number, default 25, max 100) defines the maximum number of records to return. Both are sent as body properties _skip and _limit.
• Request Options — Node‑level settings for the HTTP request. Includes Batching (fixed collection with batchSize and batchInterval), AllowUnauthorizedCerts (boolean), Proxy (string), and Timeout (number, ms).

Output shape

Array of customer objects (JSON). Each object contains the fields returned by the Qonekto /kunde/filter endpoint, such as ameise_id, vorname, nachname, vermittler_id, etc., exactly as the API provides them.

If no customers match the filters, an empty array is returned. The node does not transform the response data; it passes through the raw API response body.

Examples

Example 1: Return all customers with nachname 'Miller' and limit to 10.

Set Nachname = Miller, set Pagination Fields → Limit = 10.

Example 2: Get first page of customers from a specific Vermittler (ID 'ABC123').

Set Vermittler ID = ABC123 (via resource selector), keep default pagination (Skip 0, Limit 25).