Fatture in Cloud: Lookup/Create Client

italia_fatture_in_cloud_client · action · Italia (PEC/SDI) · Disponibile · v0.3.0

Descrizione

Cerca un cliente Fatture in Cloud per partita IVA o codice fiscale; opzionalmente lo crea se non esiste (idempotent upsert). Lookup VAT 11 cifre (con/senza prefisso IT) o CF 16 char (persona fisica). Output normalizzato: { clientId, found: bool, created: bool, fullData }. Pair con italia_fatture_in_cloud_invoice downstream. Use case: onboarding lead → cliente FIC prima di emettere fattura, dedup clienti da import CSV, lookup automatico da form contact.

⚙️ Parametri di configurazione

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

Campo	Tipo	Required	Default	Descrizione
`apiToken` Access token OAuth2	`string (encrypted)`	si	—	Stesso token usato per le fatture (vedi nodo "Create Invoice").
`companyId` ID Azienda	`string`	si	— es. 123456	—
`vatNumber` Partita IVA	`expression`	no	— {{input.vatNumber}} o "IT12345678901"	11 cifre con o senza prefisso IT. Tipicamente dinamico dal form/CRM — usa {{ }} per inserire valore upstream.
`taxCode` Codice fiscale	`expression`	no	— {{input.taxCode}}	16 caratteri (persona fisica) o 11 cifre (azienda = P.IVA). Dinamico.
`createIfMissing` Crea se non trovato	`boolean`	no	`true`	Se on, crea un nuovo cliente con i dati passati in input quando non esiste. Se off, ritorna found=false.

💡 Esempio configurazione

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

{
  "id": "node-italia_fatture_in_cloud_client-1",
  "defId": "italia_fatture_in_cloud_client",
  "label": "Fatture in Cloud: Lookup/Create Client",
  "config": {
    "apiToken": "<apiToken>",
    "companyId": "es. 123456",
    "createIfMissing": true
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare Fatture in Cloud: Lookup/Create Client?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi