Fatture in Cloud: Create Invoice

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

Descrizione

Crea una nuova fattura su Fatture in Cloud (REST API v2, auth Bearer access-token OAuth2 scope invoices.write). Input: clientId (lookup upstream), righe articoli (qty/unit/price/vat%), payment method codici SDI standard, termine pagamento in giorni (paymentDays → scadenza, inclusa se il totale è calcolabile dalle righe), codice destinatario SDI o PEC. Output normalizzato: { invoiceId, number, pdfUrl, sdiStatus, raw }. Invio SDI separato (PEC o Aruba). Use case: fatturazione automatica post-ordine e-commerce, fatturazione ricorrente abbonamenti, fatturazione massiva fine mese per studio commercialista, integrazione checkout B2B.

⚙️ 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	—	Ottienilo da fattureincloud.it → Impostazioni → API → "Crea Token". Scope necessari: invoices.write, clients.read.
`companyId` ID Azienda	`string`	si	— es. 123456	ID numerico dell'azienda su Fatture in Cloud. Lo trovi in URL: secure.fattureincloud.it/dashboard/COMPANY_ID/...
`clientId` ID Cliente	`expression`	si	— {{$node.LookupClient.json.id}}	ID cliente FIC. Tipicamente dinamico — usa il bottone {{ }} per inserire l'ID dal nodo "Fatture in Cloud: Lookup/Create Client" a monte.
`itemsJson` Righe fattura	`invoice-lines`	si	—	Aggiungi una riga per ciascun articolo o servizio fatturato. IVA in % (es. 22 per 22%).
`paymentDays` Termine pagamento (giorni)	`number`	no	`30`	Giorni dalla data fattura entro cui pagare.
`paymentMethod` Metodo pagamento	`enum` `MP01 - ContantiMP05 - BonificoMP08 - CartaMP19 - SDD`	no	`MP05 - Bonifico`	Codici standard SDI per fatturazione elettronica.
`sdiCode` Codice destinatario SDI	`expression`	no	— {{input.sdiCode}}	7 caratteri alfanumerici del codice destinatario PA/B2B. Tipicamente dinamico (dal form o da DB cliente). Usa "0000000" se il cliente fornisce PEC invece di codice SDI.

💡 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_invoice-1",
  "defId": "italia_fatture_in_cloud_invoice",
  "label": "Fatture in Cloud: Create Invoice",
  "config": {
    "apiToken": "<apiToken>",
    "companyId": "es. 123456",
    "clientId": "{{$node.LookupClient.json.id}}",
    "itemsJson": "<itemsJson>",
    "paymentDays": 30,
    "paymentMethod": "MP05 - Bonifico"
  }
}

🔗 Nodi correlati nella stessa categoria

Pronto a usare Fatture in Cloud: Create Invoice?

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

Inizia gratis Sfoglia tutti i nodi