@ixiam/n8n-nodes-civicrm 0.4.1 → 0.4.4

package/dist/nodes/CiviCrm/CiviCrm.node.js

@@ -16,6 +16,41 @@ const ENTITY_MAP = {
     email: 'Email',
     activity: 'Activity',
 };
+/**
+ * Caché global de location types
+ * Se rellena la primera vez que se usa y dura hasta que se reinicia n8n.
+ * key: normalizado (lowercase, sin espacios/ símbolos)
+ * value: option_value.name (para usar en location_type_id:name)
+ */
+let locationTypeCache = null;
+function normalizeLocationKey(s) {
+    return String(s || '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '');
+}
+async function getLocationTypeMap() {
+    if (locationTypeCache)
+        return locationTypeCache;
+    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/OptionValue/get', {
+        where: [['option_group_id:name', '=', 'location_type']],
+        select: ['name', 'label'],
+        limit: 0,
+    });
+    const values = (res?.values || []);
+    const map = {};
+    for (const v of values) {
+        const name = v.name || '';
+        const label = v.label || '';
+        const normName = normalizeLocationKey(name);
+        const normLabel = normalizeLocationKey(label);
+        if (normName)
+            map[normName] = name;
+        if (normLabel)
+            map[normLabel] = name;
+    }
+    locationTypeCache = map;
+    return map;
+}
 /**
  * Nodo principal CiviCRM para n8n
  */
@@ -27,7 +62,36 @@ class CiviCrm {
             icon: 'file:civicrm.svg',
             group: ['transform'],
             version: 1,
-            description: 'Interact with CiviCRM API v4 (Civi-Go compatible)',
+            description: 'Interact with CiviCRM API v4 (Civi-Go compatible).\\n\\n' +
+                'Email / Phone / Address mapping:\\n' +
+                '- You can send simple fields: email, phone, address.city, address.country_id, etc.\\n' +
+                '- You can also use dynamic prefixes based on real CiviCRM Location Types.\\n' +
+                '  Example prefixes (from Location Types): Home, Work, Billing, Mobile, Oficina, etc.\\n' +
+                '- Prefix format: <location-prefix>.<entity>[.<subfield>]\\n' +
+                '  Examples:\\n' +
+                '    email = test@ixiam.com\\n' +
+                '    phone = 600123123\\n' +
+                '    address.city = Barcelona\\n' +
+                '    work.email = test@company.com  (Location Type = Work)\\n' +
+                '    billing.address.postal_code = 28010  (Location Type = Billing)\\n' +
+                '    home.phone.phone_type_id = 2  (Location Type = Home)\\n\\n' +
+                'Subfields examples:\\n' +
+                '- email.is_primary, email.signature_html, email.signature_text\\n' +
+                '- phone.phone_type_id, phone.phone_ext\\n' +
+                '- address.country_id, address.state_province_id, address.postal_code, address.street_address\\n\\n' +
+                'Prefixes and Location Types:\\n' +
+                '- The prefix (e.g. work, home, billing, oficina) is matched against CiviCRM Location Types (name/label).\\n' +
+                '- If the prefix matches, the node sets location_type_id:name automatically.\\n' +
+                '- If no prefix is used (e.g. email, phone, address.city), the node uses the Location Type selectors.\\n\\n' +
+                'birth_date:\\n' +
+                '- Accepted formats: YYYY-MM-DD, DD/MM/YYYY, DD-MM-YYYY, YYYY/MM/DD, YYYY.MM.DD.\\n' +
+                '- The node normalizes and validates the date before sending it to CiviCRM.\\n\\n' +
+                'Filters in GET MANY:\\n' +
+                '- Use API4 "where" JSON array format, e.g.:\\n' +
+                '  [ ["contact_type","=","Individual"] ]\\n' +
+                '  [ ["first_name","LIKE","Jul%"] ]\\n' +
+                '  [ ["birth_date",">","1990-01-01"] ]\\n' +
+                '  [ ["gender_id","IN",[1,2]] ]',
             defaults: { name: 'CiviCRM' },
             inputs: ['main'],
             outputs: ['main'],
@@ -46,7 +110,8 @@ class CiviCrm {
                         { name: 'Household', value: 'Household' },
                     ],
                     displayOptions: { show: { resource: ['contact'] } },
-                    description: 'Filter or assign contact type',
+                    description: 'Contact type to filter (GET MANY) or assign (CREATE/UPDATE). ' +
+                        'For GET MANY, if set, a condition [ "contact_type", "=", selectedType ] is added to the where.',
                 },
                 {
                     displayName: 'Email Location Type',
@@ -59,6 +124,10 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+                    description: 'Default Location Type used for email when no prefix is provided.\\n' +
+                        '- If you use "email" or "email.xxx" as field name, this Location Type will be used.\\n' +
+                        '- If you use a prefixed field like "work.email", "home.email", etc., ' +
+                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
                 {
                     displayName: 'Phone Location Type',
@@ -72,6 +141,10 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+                    description: 'Default Location Type used for phone when no prefix is provided.\\n' +
+                        '- If you use "phone" or "phone.xxx" as field name, this Location Type will be used.\\n' +
+                        '- If you use a prefixed field like "mobile.phone", "work.phone", etc., ' +
+                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
                 {
                     displayName: 'Address Location Type',
@@ -85,6 +158,10 @@ class CiviCrm {
                         { name: 'Other', value: 'Other' },
                     ],
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+                    description: 'Default Location Type used for address when no prefix is provided.\\n' +
+                        '- If you use "address.city", "address.country_id", etc., this Location Type will be used.\\n' +
+                        '- If you use a prefixed field like "billing.address.postal_code", "home.address.city", etc., ' +
+                        'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
                 },
                 {
                     displayName: 'Mark as Primary',
@@ -92,7 +169,8 @@ class CiviCrm {
                     type: 'boolean',
                     default: true,
                     displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-                    description: 'If enabled, replaces previous primary email/phone/address with this one',
+                    description: 'If enabled, previous primary email/phone/address for this contact are deleted before creating the new ones. ' +
+                        'Useful when you want to replace existing primary contact details.',
                 },
                 {
                     displayName: 'ID',
@@ -101,6 +179,7 @@ class CiviCrm {
                     default: 0,
                     required: true,
                     displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+                    description: 'Record ID of the selected entity (Contact, Event, Case, etc.).',
                 },
                 ...generic_1.genericFields,
                 ...generic_1.upsertFields,
@@ -137,31 +216,42 @@ class CiviCrm {
         const operation = this.getNodeParameter('operation', 0);
         const entity = ENTITY_MAP[resource];
         for (let i = 0; i < items.length; i++) {
-            const emailLocation = this.getNodeParameter('emailLocation', i, 'Work');
-            const phoneLocation = this.getNodeParameter('phoneLocation', i, 'Work');
-            const addressLocation = this.getNodeParameter('addressLocation', i, 'Home');
+            const emailLocationParam = this.getNodeParameter('emailLocation', i, 'Work');
+            const phoneLocationParam = this.getNodeParameter('phoneLocation', i, 'Work');
+            const addressLocationParam = this.getNodeParameter('addressLocation', i, 'Home');
             const isPrimary = this.getNodeParameter('isPrimary', i, true);
-            // === GET ===
+            // Valores de location type efectivos (pueden ser sobreescritos por prefijo)
+            let emailLocationName = emailLocationParam;
+            let phoneLocationName = phoneLocationParam;
+            let addressLocationName = addressLocationParam;
+            // =========== GET ===========
             if (operation === 'get') {
                 const id = this.getNodeParameter('id', i);
                 const where = [['id', '=', id]];
-                // Solo para Contact → usar chain
                 if (resource === 'contact') {
                     const params = {
                         where,
                         limit: 1,
-                        select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
+                        select: [
+                            'id',
+                            'display_name',
+                            'first_name',
+                            'last_name',
+                            'contact_type',
+                            'gender_id',
+                            'gender_id:name',
+                            'birth_date',
+                        ],
                         chain: {
                             emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
                             phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
                             addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
                         },
                     };
-                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Contact/get`, params);
+                    const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/get', params);
                     out.push({ json: (res?.values?.[0] ?? {}) });
                 }
                 else {
-                    // Otras entidades → select estándar
                     const params = {
                         where,
                         limit: 1,
@@ -171,7 +261,7 @@ class CiviCrm {
                     out.push({ json: (res?.values?.[0] ?? {}) });
                 }
             }
-            // === GET MANY ===
+            // =========== GET MANY ===========
             if (operation === 'getMany') {
                 const returnAll = this.getNodeParameter('returnAll', i, false);
                 const limit = this.getNodeParameter('limit', i, 100);
@@ -186,7 +276,16 @@ class CiviCrm {
                 if (resource === 'contact') {
                     baseParams = {
                         where,
-                        select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
+                        select: [
+                            'id',
+                            'display_name',
+                            'first_name',
+                            'last_name',
+                            'contact_type',
+                            'gender_id',
+                            'gender_id:name',
+                            'birth_date',
+                        ],
                         chain: {
                             emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
                             phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
@@ -220,7 +319,7 @@ class CiviCrm {
                         out.push({ json: v });
                 }
             }
-            // === CREATE y UPDATE ===
+            // =========== CREATE / UPDATE ===========
             const isCreate = operation === 'create';
             if (isCreate || operation === 'update') {
                 const id = !isCreate ? this.getNodeParameter('id', i) : undefined;
@@ -229,26 +328,150 @@ class CiviCrm {
                 const emailData = {};
                 const phoneData = {};
                 const addressData = {};
+                // Normaliza birth_date a YYYY-MM-DD con validación
+                function normalizeBirthDate(input) {
+                    if (!input)
+                        return input;
+                    let val = input.trim();
+                    // YYYY-MM-DD
+                    if (/^\d{4}-\d{2}-\d{2}$/.test(val))
+                        return val;
+                    // DD/MM/YYYY
+                    if (/^\d{2}\/\d{2}\/\d{4}$/.test(val)) {
+                        const [d, m, y] = val.split('/');
+                        val = `${y}-${m}-${d}`;
+                    }
+                    // DD-MM-YYYY
+                    else if (/^\d{2}-\d{2}-\d{4}$/.test(val)) {
+                        const [d, m, y] = val.split('-');
+                        val = `${y}-${m}-${d}`;
+                    }
+                    // YYYY/MM/DD
+                    else if (/^\d{4}\/\d{2}\/\d{2}$/.test(val)) {
+                        val = val.replace(/\//g, '-');
+                    }
+                    // YYYY.MM.DD
+                    else if (/^\d{4}\.\d{2}\.\d{2}$/.test(val)) {
+                        val = val.replace(/\./g, '-');
+                    }
+                    const date = new Date(val);
+                    if (isNaN(date.getTime())) {
+                        throw new Error(`Invalid birth_date format: ${input}`);
+                    }
+                    return val;
+                }
+                // Cargar mapa de location types solo si estamos en contacto
+                let locationTypeMap = {};
+                if (resource === 'contact') {
+                    locationTypeMap = await getLocationTypeMap.call(this);
+                }
+                // Field mapping con soporte para:
+                // - email, email.xxx
+                // - phone, phone.xxx
+                // - address.xxx
+                // - <prefix>.email[.field]
+                // - <prefix>.phone[.field]
+                // - <prefix>.address[.field]
                 for (const p of pairs) {
                     if (!p.fieldName)
                         continue;
                     const key = p.fieldName.trim();
-                    const val = convertValue(p.fieldValue);
-                    if (key.startsWith('email.'))
+                    const rawVal = convertValue(p.fieldValue);
+                    const val = rawVal;
+                    // 1) Casos simples sin prefijo: email / email.xxx / phone / phone.xxx / address.xxx
+                    // Email simple
+                    if (key === 'email') {
+                        emailData.email = val;
+                        continue;
+                    }
+                    if (key.startsWith('email.')) {
                         emailData[key.replace(/^email\./, '')] = val;
-                    else if (key.startsWith('phone.'))
+                        continue;
+                    }
+                    // Phone simple
+                    if (key === 'phone') {
+                        phoneData.phone = val;
+                        continue;
+                    }
+                    if (key.startsWith('phone.')) {
                         phoneData[key.replace(/^phone\./, '')] = val;
-                    else if (key.startsWith('address.'))
+                        continue;
+                    }
+                    // Address simple
+                    if (key.startsWith('address.')) {
                         addressData[key.replace(/^address\./, '')] = val;
-                    else
-                        values[key] = val;
+                        continue;
+                    }
+                    // 2) Prefijo dinámico: <prefix>.email[.field], <prefix>.phone[.field], <prefix>.address[.field]
+                    const segments = key.split('.');
+                    if (segments.length >= 2 && resource === 'contact') {
+                        const prefixRaw = segments[0];
+                        const root = segments[1]; // email / phone / address
+                        const subfield = segments.slice(2).join('.') || '';
+                        const normalizedPrefix = normalizeLocationKey(prefixRaw);
+                        const mappedLocationName = locationTypeMap[normalizedPrefix];
+                        if (root === 'email' || root === 'phone' || root === 'address') {
+                            // Si el prefijo coincide con un location type, sobreescribir el locationName correspondiente
+                            if (mappedLocationName) {
+                                if (root === 'email')
+                                    emailLocationName = mappedLocationName;
+                                if (root === 'phone')
+                                    phoneLocationName = mappedLocationName;
+                                if (root === 'address')
+                                    addressLocationName = mappedLocationName;
+                            }
+                            // Asignar campo
+                            if (root === 'email') {
+                                if (!subfield) {
+                                    emailData.email = val;
+                                }
+                                else {
+                                    emailData[subfield] = val;
+                                }
+                                continue;
+                            }
+                            if (root === 'phone') {
+                                if (!subfield) {
+                                    phoneData.phone = val;
+                                }
+                                else {
+                                    phoneData[subfield] = val;
+                                }
+                                continue;
+                            }
+                            if (root === 'address') {
+                                if (!subfield) {
+                                    // No existe campo address "plano", así que ignoramos si no hay subfield
+                                }
+                                else {
+                                    addressData[subfield] = val;
+                                }
+                                continue;
+                            }
+                        }
+                    }
+                    // 3) gender
+                    if (key === 'gender' || key === 'gender_id') {
+                        values.gender_id = val;
+                        continue;
+                    }
+                    // 4) birth_date
+                    if (key === 'birth_date' || key === 'birth') {
+                        values.birth_date = normalizeBirthDate(String(val));
+                        continue;
+                    }
+                    // 5) default → campo de Contact o de la entidad
+                    values[key] = val;
                 }
+                // contact_type
                 const contactType = this.getNodeParameter('contactType', i, '');
-                if (resource === 'contact' && contactType)
+                if (resource === 'contact' && contactType) {
                     values.contact_type = contactType;
+                }
+                // --- CREATE / UPDATE CONTACT ---
                 let contactId = id;
                 if (isCreate) {
-                    const contactRes = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Contact/create`, { values });
+                    const contactRes = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Contact/create', { values });
                     contactId = contactRes?.values?.[0]?.id;
                     if (!contactId)
                         throw new Error('Failed to create contact.');
@@ -259,34 +482,76 @@ class CiviCrm {
                         where: [['id', '=', contactId]],
                     });
                 }
+                // --- SUBENTITIES (solo para contact) ---
                 if (resource === 'contact') {
+                    // Si es primary, limpiar anteriores
                     if (isPrimary) {
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Email/delete`, {
-                            where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/delete', {
+                            where: [
+                                ['contact_id', '=', contactId],
+                                ['is_primary', '=', true],
+                            ],
                         });
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Phone/delete`, {
-                            where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/delete', {
+                            where: [
+                                ['contact_id', '=', contactId],
+                                ['is_primary', '=', true],
+                            ],
                         });
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Address/delete`, {
-                            where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/delete', {
+                            where: [
+                                ['contact_id', '=', contactId],
+                                ['is_primary', '=', true],
+                            ],
                         });
                     }
-                    if (Object.keys(emailData).length)
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Email/create`, {
-                            values: { ...emailData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': emailLocation },
+                    // Email
+                    if (Object.keys(emailData).length) {
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Email/create', {
+                            values: {
+                                ...emailData,
+                                contact_id: contactId,
+                                is_primary: isPrimary,
+                                'location_type_id:name': emailLocationName,
+                            },
                         });
-                    if (Object.keys(phoneData).length)
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Phone/create`, {
-                            values: { ...phoneData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': phoneLocation },
+                    }
+                    // Phone
+                    if (Object.keys(phoneData).length) {
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Phone/create', {
+                            values: {
+                                ...phoneData,
+                                contact_id: contactId,
+                                is_primary: isPrimary,
+                                'location_type_id:name': phoneLocationName,
+                            },
                         });
-                    if (Object.keys(addressData).length)
-                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Address/create`, {
-                            values: { ...addressData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': addressLocation },
+                    }
+                    // Address
+                    if (Object.keys(addressData).length) {
+                        await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/Address/create', {
+                            values: {
+                                ...addressData,
+                                contact_id: contactId,
+                                is_primary: isPrimary,
+                                'location_type_id:name': addressLocationName,
+                            },
                         });
+                    }
                 }
+                // --- FINAL GET (con gender + birth_date + chain) ---
                 const res = await GenericFunctions_1.civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, {
                     where: [['id', '=', contactId]],
-                    select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
+                    select: [
+                        'id',
+                        'display_name',
+                        'first_name',
+                        'last_name',
+                        'contact_type',
+                        'gender_id',
+                        'gender_id:name',
+                        'birth_date',
+                    ],
                     ...(resource === 'contact'
                         ? {
                             chain: {

package/nodes/CiviCrm/CiviCrm.node.ts

@@ -1,3 +1,4 @@
+
 import type {
 	IExecuteFunctions,
 	ILoadOptionsFunctions,
@@ -42,6 +43,47 @@ const ENTITY_MAP: Record<Resource, string> = {
 
 type Operation = 'get' | 'getMany' | 'create' | 'update' | 'delete';
 
+/**
+ * Caché global de location types
+ * Se rellena la primera vez que se usa y dura hasta que se reinicia n8n.
+ * key: normalizado (lowercase, sin espacios/ símbolos)
+ * value: option_value.name (para usar en location_type_id:name)
+ */
+let locationTypeCache: Record<string, string> | null = null;
+
+function normalizeLocationKey(s: string): string {
+	return String(s || '')
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, '');
+}
+
+async function getLocationTypeMap(this: IExecuteFunctions): Promise<Record<string, string>> {
+	if (locationTypeCache) return locationTypeCache;
+
+	const res = await civicrmApiRequest.call(this, 'POST', '/civicrm/ajax/api4/OptionValue/get', {
+		where: [['option_group_id:name', '=', 'location_type']],
+		select: ['name', 'label'],
+		limit: 0,
+	});
+
+	const values = (res?.values || []) as Array<{ name?: string; label?: string }>;
+	const map: Record<string, string> = {};
+
+	for (const v of values) {
+		const name = v.name || '';
+		const label = v.label || '';
+
+		const normName = normalizeLocationKey(name);
+		const normLabel = normalizeLocationKey(label);
+
+		if (normName) map[normName] = name;
+		if (normLabel) map[normLabel] = name;
+	}
+
+	locationTypeCache = map;
+	return map;
+}
+
 /**
  * Nodo principal CiviCRM para n8n
  */
@@ -52,7 +94,37 @@ export class CiviCrm implements INodeType {
 		icon: 'file:civicrm.svg',
 		group: ['transform'],
 		version: 1,
-		description: 'Interact with CiviCRM API v4 (Civi-Go compatible)',
+		description:
+			'Interact with CiviCRM API v4 (Civi-Go compatible).\\n\\n' +
+			'Email / Phone / Address mapping:\\n' +
+			'- You can send simple fields: email, phone, address.city, address.country_id, etc.\\n' +
+			'- You can also use dynamic prefixes based on real CiviCRM Location Types.\\n' +
+			'  Example prefixes (from Location Types): Home, Work, Billing, Mobile, Oficina, etc.\\n' +
+			'- Prefix format: <location-prefix>.<entity>[.<subfield>]\\n' +
+			'  Examples:\\n' +
+			'    email = test@ixiam.com\\n' +
+			'    phone = 600123123\\n' +
+			'    address.city = Barcelona\\n' +
+			'    work.email = test@company.com  (Location Type = Work)\\n' +
+			'    billing.address.postal_code = 28010  (Location Type = Billing)\\n' +
+			'    home.phone.phone_type_id = 2  (Location Type = Home)\\n\\n' +
+			'Subfields examples:\\n' +
+			'- email.is_primary, email.signature_html, email.signature_text\\n' +
+			'- phone.phone_type_id, phone.phone_ext\\n' +
+			'- address.country_id, address.state_province_id, address.postal_code, address.street_address\\n\\n' +
+			'Prefixes and Location Types:\\n' +
+			'- The prefix (e.g. work, home, billing, oficina) is matched against CiviCRM Location Types (name/label).\\n' +
+			'- If the prefix matches, the node sets location_type_id:name automatically.\\n' +
+			'- If no prefix is used (e.g. email, phone, address.city), the node uses the Location Type selectors.\\n\\n' +
+			'birth_date:\\n' +
+			'- Accepted formats: YYYY-MM-DD, DD/MM/YYYY, DD-MM-YYYY, YYYY/MM/DD, YYYY.MM.DD.\\n' +
+			'- The node normalizes and validates the date before sending it to CiviCRM.\\n\\n' +
+			'Filters in GET MANY:\\n' +
+			'- Use API4 "where" JSON array format, e.g.:\\n' +
+			'  [ ["contact_type","=","Individual"] ]\\n' +
+			'  [ ["first_name","LIKE","Jul%"] ]\\n' +
+			'  [ ["birth_date",">","1990-01-01"] ]\\n' +
+			'  [ ["gender_id","IN",[1,2]] ]',
 		defaults: { name: 'CiviCRM' },
 		inputs: ['main'],
 		outputs: ['main'],
@@ -71,7 +143,9 @@ export class CiviCrm implements INodeType {
 					{ name: 'Household', value: 'Household' },
 				],
 				displayOptions: { show: { resource: ['contact'] } },
-				description: 'Filter or assign contact type',
+				description:
+					'Contact type to filter (GET MANY) or assign (CREATE/UPDATE). ' +
+					'For GET MANY, if set, a condition [ "contact_type", "=", selectedType ] is added to the where.',
 			},
 			{
 				displayName: 'Email Location Type',
@@ -84,6 +158,11 @@ export class CiviCrm implements INodeType {
 					{ name: 'Other', value: 'Other' },
 				],
 				displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+				description:
+					'Default Location Type used for email when no prefix is provided.\\n' +
+					'- If you use "email" or "email.xxx" as field name, this Location Type will be used.\\n' +
+					'- If you use a prefixed field like "work.email", "home.email", etc., ' +
+					'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
 			},
 			{
 				displayName: 'Phone Location Type',
@@ -97,6 +176,11 @@ export class CiviCrm implements INodeType {
 					{ name: 'Other', value: 'Other' },
 				],
 				displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+				description:
+					'Default Location Type used for phone when no prefix is provided.\\n' +
+					'- If you use "phone" or "phone.xxx" as field name, this Location Type will be used.\\n' +
+					'- If you use a prefixed field like "mobile.phone", "work.phone", etc., ' +
+					'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
 			},
 			{
 				displayName: 'Address Location Type',
@@ -110,6 +194,11 @@ export class CiviCrm implements INodeType {
 					{ name: 'Other', value: 'Other' },
 				],
 				displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
+				description:
+					'Default Location Type used for address when no prefix is provided.\\n' +
+					'- If you use "address.city", "address.country_id", etc., this Location Type will be used.\\n' +
+					'- If you use a prefixed field like "billing.address.postal_code", "home.address.city", etc., ' +
+					'the prefix overrides this selector and maps to the matching CiviCRM Location Type.',
 			},
 			{
 				displayName: 'Mark as Primary',
@@ -117,7 +206,9 @@ export class CiviCrm implements INodeType {
 				type: 'boolean',
 				default: true,
 				displayOptions: { show: { resource: ['contact'], operation: ['create', 'update'] } },
-				description: 'If enabled, replaces previous primary email/phone/address with this one',
+				description:
+					'If enabled, previous primary email/phone/address for this contact are deleted before creating the new ones. ' +
+					'Useful when you want to replace existing primary contact details.',
 			},
 			{
 				displayName: 'ID',
@@ -126,6 +217,7 @@ export class CiviCrm implements INodeType {
 				default: 0,
 				required: true,
 				displayOptions: { show: { operation: ['get', 'update', 'delete'] } },
+				description: 'Record ID of the selected entity (Contact, Event, Case, etc.).',
 			},
 			...genericFields,
 			...upsertFields,
@@ -161,193 +253,463 @@ export class CiviCrm implements INodeType {
 		},
 	};
 
-async execute(this: IExecuteFunctions) {
-	const items = this.getInputData();
-	const out: INodeExecutionData[] = [];
-
-	const resource = this.getNodeParameter('resource', 0) as Resource;
-	const operation = this.getNodeParameter('operation', 0) as Operation;
-	const entity = ENTITY_MAP[resource];
-
-	for (let i = 0; i < items.length; i++) {
-		const emailLocation = this.getNodeParameter('emailLocation', i, 'Work') as string;
-		const phoneLocation = this.getNodeParameter('phoneLocation', i, 'Work') as string;
-		const addressLocation = this.getNodeParameter('addressLocation', i, 'Home') as string;
-		const isPrimary = this.getNodeParameter('isPrimary', i, true) as boolean;
-
-		// === GET ===
-		if (operation === 'get') {
-			const id = this.getNodeParameter('id', i) as number;
-			const where = [['id', '=', id]];
-
-			// Solo para Contact → usar chain
-			if (resource === 'contact') {
-				const params = {
-					where,
-					limit: 1,
-					select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
-					chain: {
-						emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
-						phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
-						addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
-					},
-				};
-				const res = await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Contact/get`, params);
-				out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
-			} else {
-				// Otras entidades → select estándar
-				const params = {
-					where,
-					limit: 1,
-					select: ['id', 'name', 'title', 'subject', 'display_name'],
-				};
-				const res = await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, params);
-				out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
-			}
-		}
+	async execute(this: IExecuteFunctions) {
+		const items = this.getInputData();
+		const out: INodeExecutionData[] = [];
 
-		// === GET MANY ===
-		if (operation === 'getMany') {
-			const returnAll = this.getNodeParameter('returnAll', i, false) as boolean;
-			const limit = this.getNodeParameter('limit', i, 100) as number;
-			const whereJson = this.getNodeParameter('whereJson', i, '') as string;
+		const resource = this.getNodeParameter('resource', 0) as Resource;
+		const operation = this.getNodeParameter('operation', 0) as Operation;
+		const entity = ENTITY_MAP[resource];
 
-			let where = whereJson ? JSON.parse(whereJson) : [];
+		for (let i = 0; i < items.length; i++) {
+			const emailLocationParam = this.getNodeParameter('emailLocation', i, 'Work') as string;
+			const phoneLocationParam = this.getNodeParameter('phoneLocation', i, 'Work') as string;
+			const addressLocationParam = this.getNodeParameter('addressLocation', i, 'Home') as string;
+			const isPrimary = this.getNodeParameter('isPrimary', i, true) as boolean;
 
-			if (resource === 'contact') {
-				const contactType = this.getNodeParameter('contactType', i, '') as string;
-				if (contactType) where.push(['contact_type', '=', contactType]);
-			}
+			// Valores de location type efectivos (pueden ser sobreescritos por prefijo)
+			let emailLocationName = emailLocationParam;
+			let phoneLocationName = phoneLocationParam;
+			let addressLocationName = addressLocationParam;
 
-			let baseParams: Record<string, unknown>;
+			// =========== GET ===========
+			if (operation === 'get') {
+				const id = this.getNodeParameter('id', i) as number;
+				const where = [['id', '=', id]];
 
-			if (resource === 'contact') {
-				baseParams = {
-					where,
-					select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
-					chain: {
-						emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
-						phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
-						addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
-					},
-				};
-			} else {
-				baseParams = {
-					where,
-					select: ['id', 'name', 'title', 'subject', 'display_name'],
-				};
+				if (resource === 'contact') {
+					const params = {
+						where,
+						limit: 1,
+						select: [
+							'id',
+							'display_name',
+							'first_name',
+							'last_name',
+							'contact_type',
+							'gender_id',
+							'gender_id:name',
+							'birth_date',
+						],
+						chain: {
+							emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
+							phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
+							addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
+						},
+					};
+					const res = await civicrmApiRequest.call(
+						this,
+						'POST',
+						'/civicrm/ajax/api4/Contact/get',
+						params,
+					);
+					out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
+				} else {
+					const params = {
+						where,
+						limit: 1,
+						select: ['id', 'name', 'title', 'subject', 'display_name'],
+					};
+					const res = await civicrmApiRequest.call(
+						this,
+						'POST',
+						`/civicrm/ajax/api4/${entity}/get`,
+						params,
+					);
+					out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
+				}
 			}
 
-			if (returnAll) {
-				let offset = 0;
-				const page = 500;
-				while (true) {
+			// =========== GET MANY ===========
+			if (operation === 'getMany') {
+				const returnAll = this.getNodeParameter('returnAll', i, false) as boolean;
+				const limit = this.getNodeParameter('limit', i, 100) as number;
+				const whereJson = this.getNodeParameter('whereJson', i, '') as string;
+
+				let where = whereJson ? JSON.parse(whereJson) : [];
+
+				if (resource === 'contact') {
+					const contactType = this.getNodeParameter('contactType', i, '') as string;
+					if (contactType) where.push(['contact_type', '=', contactType]);
+				}
+
+				let baseParams: Record<string, unknown>;
+
+				if (resource === 'contact') {
+					baseParams = {
+						where,
+						select: [
+							'id',
+							'display_name',
+							'first_name',
+							'last_name',
+							'contact_type',
+							'gender_id',
+							'gender_id:name',
+							'birth_date',
+						],
+						chain: {
+							emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
+							phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
+							addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
+						},
+					};
+				} else {
+					baseParams = {
+						where,
+						select: ['id', 'name', 'title', 'subject', 'display_name'],
+					};
+				}
+
+				if (returnAll) {
+					let offset = 0;
+					const page = 500;
+
+					while (true) {
+						const res = await civicrmApiRequest.call(
+							this,
+							'POST',
+							`/civicrm/ajax/api4/${entity}/get`,
+							{ ...baseParams, limit: page, offset },
+						);
+
+						const vals = (res?.values ?? []) as IDataObject[];
+						for (const v of vals) out.push({ json: v });
+
+						if (vals.length < page) break;
+						offset += page;
+					}
+				} else {
 					const res = await civicrmApiRequest.call(
 						this,
 						'POST',
 						`/civicrm/ajax/api4/${entity}/get`,
-						{ ...baseParams, limit: page, offset },
+						{ ...baseParams, limit },
 					);
 					const vals = (res?.values ?? []) as IDataObject[];
 					for (const v of vals) out.push({ json: v });
-					if (vals.length < page) break;
-					offset += page;
 				}
-			} else {
-				const res = await civicrmApiRequest.call(
-					this,
-					'POST',
-					`/civicrm/ajax/api4/${entity}/get`,
-					{ ...baseParams, limit },
-				);
-				const vals = (res?.values ?? []) as IDataObject[];
-				for (const v of vals) out.push({ json: v });
 			}
-		}
 
-		// === CREATE y UPDATE ===
-		const isCreate = operation === 'create';
-		if (isCreate || operation === 'update') {
-			const id = !isCreate ? (this.getNodeParameter('id', i) as number) : undefined;
-			const pairs = this.getNodeParameter('fields.field', i, []) as Array<{ fieldName: string; fieldValue: string }>;
-			const values: Record<string, unknown> = {};
-			const emailData: Record<string, unknown> = {};
-			const phoneData: Record<string, unknown> = {};
-			const addressData: Record<string, unknown> = {};
-
-			for (const p of pairs) {
-				if (!p.fieldName) continue;
-				const key = p.fieldName.trim();
-				const val = convertValue(p.fieldValue);
-				if (key.startsWith('email.')) emailData[key.replace(/^email\./, '')] = val;
-				else if (key.startsWith('phone.')) phoneData[key.replace(/^phone\./, '')] = val;
-				else if (key.startsWith('address.')) addressData[key.replace(/^address\./, '')] = val;
-				else values[key] = val;
-			}
+			// =========== CREATE / UPDATE ===========
+			const isCreate = operation === 'create';
+			if (isCreate || operation === 'update') {
+				const id = !isCreate ? (this.getNodeParameter('id', i) as number) : undefined;
 
-			const contactType = this.getNodeParameter('contactType', i, '') as string;
-			if (resource === 'contact' && contactType) values.contact_type = contactType;
-
-			let contactId = id;
-			if (isCreate) {
-				const contactRes = await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Contact/create`, { values });
-				contactId = contactRes?.values?.[0]?.id;
-				if (!contactId) throw new Error('Failed to create contact.');
-			} else {
-				await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/update`, {
-					values,
-					where: [['id', '=', contactId]],
-				});
-			}
+				const pairs = this.getNodeParameter('fields.field', i, []) as Array<{
+					fieldName: string;
+					fieldValue: string;
+				}>;
+
+				const values: Record<string, unknown> = {};
+				const emailData: Record<string, unknown> = {};
+				const phoneData: Record<string, unknown> = {};
+				const addressData: Record<string, unknown> = {};
 
-			if (resource === 'contact') {
-				if (isPrimary) {
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Email/delete`, {
-						where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
-					});
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Phone/delete`, {
-						where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
-					});
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Address/delete`, {
-						where: [['contact_id', '=', contactId], ['is_primary', '=', true]],
-					});
+				// Normaliza birth_date a YYYY-MM-DD con validación
+				function normalizeBirthDate(input: string): string {
+					if (!input) return input;
+
+					let val = input.trim();
+
+					// YYYY-MM-DD
+					if (/^\d{4}-\d{2}-\d{2}$/.test(val)) return val;
+
+					// DD/MM/YYYY
+					if (/^\d{2}\/\d{2}\/\d{4}$/.test(val)) {
+						const [d, m, y] = val.split('/');
+						val = `${y}-${m}-${d}`;
+					}
+					// DD-MM-YYYY
+					else if (/^\d{2}-\d{2}-\d{4}$/.test(val)) {
+						const [d, m, y] = val.split('-');
+						val = `${y}-${m}-${d}`;
+					}
+					// YYYY/MM/DD
+					else if (/^\d{4}\/\d{2}\/\d{2}$/.test(val)) {
+						val = val.replace(/\//g, '-');
+					}
+					// YYYY.MM.DD
+					else if (/^\d{4}\.\d{2}\.\d{2}$/.test(val)) {
+						val = val.replace(/\./g, '-');
+					}
+
+					const date = new Date(val);
+					if (isNaN(date.getTime())) {
+						throw new Error(`Invalid birth_date format: ${input}`);
+					}
+
+					return val;
 				}
 
-				if (Object.keys(emailData).length)
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Email/create`, {
-						values: { ...emailData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': emailLocation },
-					});
-				if (Object.keys(phoneData).length)
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Phone/create`, {
-						values: { ...phoneData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': phoneLocation },
-					});
-				if (Object.keys(addressData).length)
-					await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/Address/create`, {
-						values: { ...addressData, contact_id: contactId, is_primary: isPrimary, 'location_type_id:name': addressLocation },
-					});
-			}
+				// Cargar mapa de location types solo si estamos en contacto
+				let locationTypeMap: Record<string, string> = {};
+				if (resource === 'contact') {
+					locationTypeMap = await getLocationTypeMap.call(this);
+				}
+
+				// Field mapping con soporte para:
+				// - email, email.xxx
+				// - phone, phone.xxx
+				// - address.xxx
+				// - <prefix>.email[.field]
+				// - <prefix>.phone[.field]
+				// - <prefix>.address[.field]
+				for (const p of pairs) {
+					if (!p.fieldName) continue;
+
+					const key = p.fieldName.trim();
+					const rawVal = convertValue(p.fieldValue);
+					const val = rawVal;
+
+					// 1) Casos simples sin prefijo: email / email.xxx / phone / phone.xxx / address.xxx
+
+					// Email simple
+					if (key === 'email') {
+						emailData.email = val;
+						continue;
+					}
+					if (key.startsWith('email.')) {
+						emailData[key.replace(/^email\./, '')] = val;
+						continue;
+					}
+
+					// Phone simple
+					if (key === 'phone') {
+						phoneData.phone = val;
+						continue;
+					}
+					if (key.startsWith('phone.')) {
+						phoneData[key.replace(/^phone\./, '')] = val;
+						continue;
+					}
+
+					// Address simple
+					if (key.startsWith('address.')) {
+						addressData[key.replace(/^address\./, '')] = val;
+						continue;
+					}
+
+					// 2) Prefijo dinámico: <prefix>.email[.field], <prefix>.phone[.field], <prefix>.address[.field]
+					const segments = key.split('.');
+					if (segments.length >= 2 && resource === 'contact') {
+						const prefixRaw = segments[0];
+						const root = segments[1]; // email / phone / address
+						const subfield = segments.slice(2).join('.') || '';
+
+						const normalizedPrefix = normalizeLocationKey(prefixRaw);
+						const mappedLocationName = locationTypeMap[normalizedPrefix];
 
-			const res = await civicrmApiRequest.call(this, 'POST', `/civicrm/ajax/api4/${entity}/get`, {
-				where: [['id', '=', contactId]],
-				select: ['id', 'display_name', 'first_name', 'last_name', 'contact_type'],
-				...(resource === 'contact'
-					? {
-							chain: {
-								emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
-								phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
-								addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
+						if (root === 'email' || root === 'phone' || root === 'address') {
+							// Si el prefijo coincide con un location type, sobreescribir el locationName correspondiente
+							if (mappedLocationName) {
+								if (root === 'email') emailLocationName = mappedLocationName;
+								if (root === 'phone') phoneLocationName = mappedLocationName;
+								if (root === 'address') addressLocationName = mappedLocationName;
+							}
+
+							// Asignar campo
+							if (root === 'email') {
+								if (!subfield) {
+									emailData.email = val;
+								} else {
+									emailData[subfield] = val;
+								}
+								continue;
+							}
+
+							if (root === 'phone') {
+								if (!subfield) {
+									phoneData.phone = val;
+								} else {
+									phoneData[subfield] = val;
+								}
+								continue;
+							}
+
+							if (root === 'address') {
+								if (!subfield) {
+									// No existe campo address "plano", así que ignoramos si no hay subfield
+								} else {
+									addressData[subfield] = val;
+								}
+								continue;
+							}
+						}
+					}
+
+					// 3) gender
+					if (key === 'gender' || key === 'gender_id') {
+						values.gender_id = val;
+						continue;
+					}
+
+					// 4) birth_date
+					if (key === 'birth_date' || key === 'birth') {
+						values.birth_date = normalizeBirthDate(String(val));
+						continue;
+					}
+
+					// 5) default → campo de Contact o de la entidad
+					values[key] = val;
+				}
+
+				// contact_type
+				const contactType = this.getNodeParameter('contactType', i, '') as string;
+				if (resource === 'contact' && contactType) {
+					values.contact_type = contactType;
+				}
+
+				// --- CREATE / UPDATE CONTACT ---
+				let contactId = id;
+				if (isCreate) {
+					const contactRes = await civicrmApiRequest.call(
+						this,
+						'POST',
+						'/civicrm/ajax/api4/Contact/create',
+						{ values },
+					);
+
+					contactId = contactRes?.values?.[0]?.id;
+					if (!contactId) throw new Error('Failed to create contact.');
+				} else {
+					await civicrmApiRequest.call(
+						this,
+						'POST',
+						`/civicrm/ajax/api4/${entity}/update`,
+						{
+							values,
+							where: [['id', '=', contactId]],
+						},
+					);
+				}
+
+				// --- SUBENTITIES (solo para contact) ---
+				if (resource === 'contact') {
+					// Si es primary, limpiar anteriores
+					if (isPrimary) {
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Email/delete',
+							{
+								where: [
+									['contact_id', '=', contactId],
+									['is_primary', '=', true],
+								],
 							},
-					  }
-					: {}),
-			});
-			out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
-		}
-	}
+						);
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Phone/delete',
+							{
+								where: [
+									['contact_id', '=', contactId],
+									['is_primary', '=', true],
+								],
+							},
+						);
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Address/delete',
+							{
+								where: [
+									['contact_id', '=', contactId],
+									['is_primary', '=', true],
+								],
+							},
+						);
+					}
 
-	return [out];
-}
+					// Email
+					if (Object.keys(emailData).length) {
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Email/create',
+							{
+								values: {
+									...emailData,
+									contact_id: contactId,
+									is_primary: isPrimary,
+									'location_type_id:name': emailLocationName,
+								},
+							},
+						);
+					}
+
+					// Phone
+					if (Object.keys(phoneData).length) {
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Phone/create',
+							{
+								values: {
+									...phoneData,
+									contact_id: contactId,
+									is_primary: isPrimary,
+									'location_type_id:name': phoneLocationName,
+								},
+							},
+						);
+					}
 
+					// Address
+					if (Object.keys(addressData).length) {
+						await civicrmApiRequest.call(
+							this,
+							'POST',
+							'/civicrm/ajax/api4/Address/create',
+							{
+								values: {
+									...addressData,
+									contact_id: contactId,
+									is_primary: isPrimary,
+									'location_type_id:name': addressLocationName,
+								},
+							},
+						);
+					}
+				}
+
+				// --- FINAL GET (con gender + birth_date + chain) ---
+				const res = await civicrmApiRequest.call(
+					this,
+					'POST',
+					`/civicrm/ajax/api4/${entity}/get`,
+					{
+						where: [['id', '=', contactId]],
+						select: [
+							'id',
+							'display_name',
+							'first_name',
+							'last_name',
+							'contact_type',
+							'gender_id',
+							'gender_id:name',
+							'birth_date',
+						],
+						...(resource === 'contact'
+							? {
+									chain: {
+										emails: ['Email', 'get', { where: [['contact_id', '=', '$id']] }],
+										phones: ['Phone', 'get', { where: [['contact_id', '=', '$id']] }],
+										addresses: ['Address', 'get', { where: [['contact_id', '=', '$id']] }],
+									},
+							  }
+							: {}),
+					},
+				);
 
+				out.push({ json: (res?.values?.[0] ?? {}) as IDataObject });
+			}
+		}
+
+		return [out];
+	}
 }
 
 function convertValue(val: string): unknown {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ixiam/n8n-nodes-civicrm",
-  "version": "0.4.1",
+  "version": "0.4.4",
   "description": "CiviCRM API v4",
   "license": "MIT",
   "keywords": [