Odoo: Trova Cliente

Descrizione

Wrapper enterprise specializzato sopra action_odoo_rpc che incapsula la ricerca di una res.partner in Odoo con strategia multi-campo deterministica nel rispetto della cascata di affidabilità tipica di un'anagrafica commerciale italiana: cerca prima per Partita IVA (univoco per legge, formato IT99999999999 con validazione checksum), poi per codice fiscale persona fisica (16 char alphanumeric con check), poi per email business (univoca nel 95% dei casi), poi per numero di telefono normalizzato E.164 (rimuovendo spazi e prefissi duplicati), infine per nome aziendale con similarity matching ilike (last resort, sensibile a typos). Riduce drasticamente la complessità di configurazione del nodo generico action_odoo_rpc: dai 15+ campi tecnici (model, operation, domain JSON con triple [campo, operatore, valore], fields array, limit, order, ecc.) a soli 4-5 campi human-readable inseribili in 30 secondi da un commercialista non-developer. Opzione createIfMissing: se la ricerca non produce match, crea atomicamente il partner con i dati forniti in input (1 chiamata RPC aggiuntiva nell'esecuzione, transazione atomica server-side Odoo — nessun rischio di partial state); senza questa opzione semplicemente ritorna found=false per gestione downstream esplicita. Output strutturato pronto per workflow downstream: { found, partnerId, name, email, phone, vat, fiscalCode, companyId, customerRank, supplierRank, isCompany, createdNow, matchedBy }. Vantaggio vs n8n/Make/Zapier: in quelle piattaforme servono un SET node che costruisce il domain JSON + un Odoo node configurato a mano con sintassi domain complessa + un IF node per createIfMissing branch — totale 3-4 nodi ingestibili da un commercialista. Qui è un nodo singolo con audit del campo che ha matchato. Use case: lookup automatico cliente da PEC ricevuta (parse mittente → cerca P.IVA in firma PEC → match in Odoo o crea nuovo prospect), normalizzazione anagrafica da form web e-commerce verso CRM Odoo, lookup partner per associare una fattura elettronica SDI in ingresso al cliente corretto via Codice Destinatario, dedup contatti tra Pipedrive imported e Odoo nativo (match per email + check ulteriore per VAT), arricchimento email entry-form prima di trasferimento contabile (recupera storico ordini precedenti).

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-action_odoo_lookup_partner-1",
  "defId": "action_odoo_lookup_partner",
  "label": "Odoo: Trova Cliente",
  "config": {
    "baseUrl": "https://miostudio.odoo.com",
    "database": "miostudio-prod",
    "login": "[email protected]",
    "password": "<password>",
    "createIfMissing": false,
    "returnFields": "id,name,email,phone,vat,company_id,user_id",
    "timeoutMs": 60000,
    "followRedirects": true
  }
}

🔗 Nodi correlati nella stessa categoria