Aziende accessibili con il token, con il loro id (da usare in company_id se ne gestisci più di una).

Richieste API rimaste nell'ora e nel mese (limiti di Fatture in Cloud condivisi tra le app private). Usalo prima di operazioni in blocco.

Dati dell'azienda (anagrafica, piano, impostazioni) e, se richiesto, l'uso del piano per categoria.

Tabelle di supporto: aliquote IVA (con id da usare nelle righe), metodi di pagamento, conti di saldo, centri di ricavo/costo, categorie, modelli grafici, valute, lingue, paesi, unità di misura, causali DDT.

Storico delle email inviate da Fatture in Cloud, con destinatari e stato di consegna.

Chiamata diretta all'API v2 per tutto ciò che non ha un tool dedicato (impostazioni, listini, webhook, documenti in attesa...). path relativo all'azienda (es. '/settings/payment_accounts') oppure assoluto se inizia con /user, /info o /c/. Riferimento: https://developers.fattureincloud.it/api-reference/

Elenca documento emesso (fattura, nota di credito, proforma, preventivo, ordine, DDT...). Risposta paginata con page, last_page, total.

Dettaglio completo di un documento emesso (fattura, nota di credito, proforma, preventivo, ordine, DDT...).

Crea un documento emesso (fattura, nota di credito, proforma, preventivo, ordine, DDT...). data segue lo schema dell'API v2 di Fatture in Cloud. Ometti number per la numerazione automatica. Per forfettari aggiungi stamp_duty: 2 sopra 77,47 €. Per ripetere un documento esistente usa duplicate_document.

Modifica un documento emesso (fattura, nota di credito, proforma, preventivo, ordine, DDT...): passa solo i campi da cambiare. Ometti number per la numerazione automatica. Per forfettari aggiungi stamp_duty: 2 sopra 77,47 €. Per ripetere un documento esistente usa duplicate_document.

Elimina un documento emesso (fattura, nota di credito, proforma, preventivo, ordine, DDT...). I documenti finiscono nel cestino e si recuperano con recover_document.

Elenca cliente. Risposta paginata con page, last_page, total.

Dettaglio completo di un cliente.

Crea un cliente. data segue lo schema dell'API v2 di Fatture in Cloud. Per la fattura elettronica servono vat_number o tax_code, address_* e ei_code (codice SDI) o certified_email (PEC).

Modifica un cliente: passa solo i campi da cambiare. Per la fattura elettronica servono vat_number o tax_code, address_* e ei_code (codice SDI) o certified_email (PEC).

Elimina un cliente.

Elenca fornitore. Risposta paginata con page, last_page, total.

Dettaglio completo di un fornitore.

Crea un fornitore. data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un fornitore: passa solo i campi da cambiare.

Elimina un fornitore.

Elenca prodotto o servizio a listino. Risposta paginata con page, last_page, total.

Dettaglio completo di un prodotto o servizio a listino.

Crea un prodotto o servizio a listino. data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un prodotto o servizio a listino: passa solo i campi da cambiare.

Elimina un prodotto o servizio a listino.

Elenca documento ricevuto (spesa, nota di credito passiva, DDT passivo). Risposta paginata con page, last_page, total.

Dettaglio completo di un documento ricevuto (spesa, nota di credito passiva, DDT passivo).

Crea un documento ricevuto (spesa, nota di credito passiva, DDT passivo). data segue lo schema dell'API v2 di Fatture in Cloud. L'API richiede payments_list che copra l'intero amount_gross anche per spese semplici.

Modifica un documento ricevuto (spesa, nota di credito passiva, DDT passivo): passa solo i campi da cambiare. L'API richiede payments_list che copra l'intero amount_gross anche per spese semplici.

Elimina un documento ricevuto (spesa, nota di credito passiva, DDT passivo). I documenti finiscono nel cestino e si recuperano con recover_document.

Elenca corrispettivo (scontrino / ricevuta giornaliera). Risposta paginata con page, last_page, total.

Dettaglio completo di un corrispettivo (scontrino / ricevuta giornaliera).

Crea un corrispettivo (scontrino / ricevuta giornaliera). data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un corrispettivo (scontrino / ricevuta giornaliera): passa solo i campi da cambiare.

Elimina un corrispettivo (scontrino / ricevuta giornaliera).

Elenca modello F24. Risposta paginata con page, last_page, total.

Dettaglio completo di un modello F24.

Crea un modello F24. data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un modello F24: passa solo i campi da cambiare.

Elimina un modello F24.

Elenca documento d'archivio. Risposta paginata con page, last_page, total.

Dettaglio completo di un documento d'archivio.

Crea un documento d'archivio. data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un documento d'archivio: passa solo i campi da cambiare.

Elimina un documento d'archivio. I documenti finiscono nel cestino e si recuperano con recover_document.

Elenca conto di saldo (banca, cassa, carta) su cui registrare incassi e pagamenti. Risposta paginata con page, last_page, total.

Dettaglio completo di un conto di saldo (banca, cassa, carta) su cui registrare incassi e pagamenti.

Crea un conto di saldo (banca, cassa, carta) su cui registrare incassi e pagamenti. data segue lo schema dell'API v2 di Fatture in Cloud. Campi: name, type (standard/bank), iban, sia, cuc, virtual.

Modifica un conto di saldo (banca, cassa, carta) su cui registrare incassi e pagamenti: passa solo i campi da cambiare. Campi: name, type (standard/bank), iban, sia, cuc, virtual.

Elimina un conto di saldo (banca, cassa, carta) su cui registrare incassi e pagamenti.

Elenca metodo di pagamento mostrato in fattura (es. bonifico con IBAN). Risposta paginata con page, last_page, total.

Dettaglio completo di un metodo di pagamento mostrato in fattura (es. bonifico con IBAN).

Crea un metodo di pagamento mostrato in fattura (es. bonifico con IBAN). data segue lo schema dell'API v2 di Fatture in Cloud. Per la fattura elettronica imposta ei_payment_method (es. MP05 bonifico) e i dettagli (details: [{title, description}]).

Modifica un metodo di pagamento mostrato in fattura (es. bonifico con IBAN): passa solo i campi da cambiare. Per la fattura elettronica imposta ei_payment_method (es. MP05 bonifico) e i dettagli (details: [{title, description}]).

Elimina un metodo di pagamento mostrato in fattura (es. bonifico con IBAN).

Elenca aliquota IVA o natura di esenzione. Risposta paginata con page, last_page, total.

Dettaglio completo di un aliquota IVA o natura di esenzione.

Crea un aliquota IVA o natura di esenzione. data segue lo schema dell'API v2 di Fatture in Cloud. Per operazioni senza IVA serve ei_type (natura, es. N2.2) e una descrizione/riferimento normativo.

Modifica un aliquota IVA o natura di esenzione: passa solo i campi da cambiare. Per operazioni senza IVA serve ei_type (natura, es. N2.2) e una descrizione/riferimento normativo.

Elimina un aliquota IVA o natura di esenzione.

Elenca movimento di prima nota (incassi e pagamenti). Risposta paginata con page, last_page, total.

Dettaglio completo di un movimento di prima nota (incassi e pagamenti).

Crea un movimento di prima nota (incassi e pagamenti). data segue lo schema dell'API v2 di Fatture in Cloud.

Modifica un movimento di prima nota (incassi e pagamenti): passa solo i campi da cambiare.

Elimina un movimento di prima nota (incassi e pagamenti).

Prossimi numeri liberi per sezionale, valori predefiniti, aliquote e modelli: utile prima di creare un documento.

Copia un documento esistente (come «Duplica», ma completo): stesso cliente, righe, bollo, metodo e conto di pagamento; nuova data, numero successivo, scadenze spostate dello stesso intervallo. La copia NON viene inviata allo SdI né per email. Usa dry_run=true per vedere il documento prima di crearlo.

Trasforma un documento in un altro tipo con il collegamento nativo di Fatture in Cloud: proforma → fattura, preventivo → ordine o fattura, ordine → DDT/fattura, DDT → fattura.

Raggruppa più DDT, ordini, preventivi o rapportini in un unico documento (es. fattura riepilogativa di fine mese).

Segna come saldate tutte le rate aperte di uno o più documenti. Se una rata non ha conto, usa payment_account_id o il primo conto configurato.

Riapre le rate saldate di un documento (annulla mark_paid).

Invia il documento per email al cliente, con link e PDF. Mittente, destinatario, oggetto e testo di default sono quelli impostati in Fatture in Cloud.

Verifica formale dell'XML della fattura elettronica: campi obbligatori e formati. Non invia nulla.

Verifica l'XML e invia la fattura elettronica allo SdI. IRREVERSIBILE: una fattura inviata si corregge solo con nota di credito. dry_run=true esegue tutti i controlli senza inviare.

Scarica l'XML FatturaPA di un documento. Con save_to lo salva su file (percorso o cartella), altrimenti lo restituisce.

Motivo dello scarto SdI di una fattura elettronica, con le indicazioni per correggerla.

Link al PDF del documento (anche DDT e fattura accompagnatoria). Con save_to scarica il PDF su file o in una cartella.

Carica un file locale come allegato e restituisce l'attachment_token. Poi collegalo con update_* passando { attachment_token }.

Documenti emessi o ricevuti nel cestino, recuperabili con recover_document.

Ripristina un documento dal cestino.

Fatture passive in attesa di registrazione (arrivate dallo SdI in «documenti ricevuti in attesa»): fornitore, data, numero, imponibile, IVA, totale, scadenza, disponibilità di XML e allegati, con i totali. Nel regime forfettario le fatture d'acquisto non hanno effetto fiscale (niente IVA detraibile né costi deducibili), ma si possono comunque archiviare.

Dettaglio completo di una fattura passiva in attesa di registrazione, con link temporaneo all'allegato (attachment_url).

Propone la categoria di spesa per le fatture passive in attesa (o per i documenti indicati): riusa la categoria già usata per lo stesso fornitore (P.IVA o nome) negli ultimi 24 mesi, altrimenti applica regole su nome e descrizione (utenze, telefono, software, carburante, consulenze, affitti...). Restituisce confidenza e motivo; non modifica nulla.

Registra le fatture passive in attesa come documenti ricevuti (spese), collegandole al documento in attesa (pending_id) così Fatture in Cloud mantiene XML e allegati. Le rate coprono sempre il totale lordo; con paid=true vengono segnate pagate. dry_run è TRUE per default: mostra le spese che verrebbero create, poi rilancia con dry_run=false. Nel regime forfettario le fatture d'acquisto non hanno effetto fiscale (niente IVA detraibile né costi deducibili), ma si possono comunque archiviare.

Spese ricorrenti dai documenti ricevuti degli ultimi N mesi: fornitori con almeno 3 fatture a cadenza regolare (mensile, bimestrale, trimestrale, semestrale, annuale), importo medio, ultima data, prossima attesa, totale annuo stimato. Segnala gli aumenti oltre la soglia rispetto alla media precedente e le fatture attese che non sono arrivate.

Copia molti documenti in una volta, es. tutte le fatture di settembre con data di oggi. dry_run è TRUE per default: controlla l'anteprima, poi rilancia con dry_run=false.

Verifica e invia allo SdI molte fatture. dry_run è TRUE per default (solo verifica). Le fatture con XML non valido vengono saltate e segnalate.

Invia per email molti documenti, ognuno al proprio cliente, con i testi di default. dry_run è TRUE per default: mostra destinatari e oggetti.

Crea una fattura ricorrente: a ogni scadenza copia source_document_id con la data del giorno e il numero successivo. action='create' la lascia da controllare e inviare (consigliato se l'importo varia); 'create_and_send_sdi' la verifica e la invia allo SdI. Si esegue con fattureincloud-mcp run-due (installabile con fattureincloud-mcp install-scheduler) o con schedule_run_due.

Elenca le fatture ricorrenti con prossime date ed esito dell'ultima esecuzione.

Dettaglio di una ricorrenza (id o nome), con storico e prossime N date.

Modifica una ricorrenza (solo i campi passati). Cambiare cadenza o date ricalcola la prossima esecuzione.

Elimina una ricorrenza. I documenti già creati restano.

Esegue le ricorrenze in scadenza (next_run <= oggi), come il job pianificato. dry_run è TRUE per default.

Esegue subito una ricorrenza fuori calendario, senza spostare la prossima esecuzione. dry_run è TRUE per default.

Crediti da incassare: rate non saldate, scaduto per fasce (1-30, 31-60, 61-90, oltre 90 giorni) e totali per cliente.

Fatturato e incassato dell'anno, per mese e per cliente. Per il regime forfettario mostra quanto manca alla soglia di 85.000 € (principio di cassa) e la proiezione a fine anno.

Controlli sui documenti dell'anno: fatture elettroniche create ma non inviate, scartate o rifiutate; bollo mancante su fatture senza IVA sopra 77,47 €; pagamenti scaduti; buchi, doppioni o date fuori ordine nella numerazione.

Estratto conto di un cliente: documenti, pagato, saldo aperto e scaduto.

Profilo fiscale usato per stimare le tasse (coefficiente, aliquota, previdenza) e regime registrato in Fatture in Cloud.

Imposta il profilo fiscale del forfettario: coefficiente di redditività (78% professionisti, 67% altre attività, 40% commercio, 86% costruzioni, 62% intermediari, secondo il codice ATECO: es. 62.x consulenza informatica = 67%, 70-75 e 85 = 78%), aliquota (15%, o 5% per i primi 5 anni), previdenza (gestione separata 26,07%, o 24% se hai già un'altra copertura; artigiani/commercianti; cassa), importi reali già versati per anno e pagamenti pianificati (rateizzazioni). I campi non passati restano invariati.

Stima imposta sostitutiva e contributi del forfettario: quanto pagare il 30 giugno (saldo + 1° acconto) e il 30 novembre (2° acconto), totale annuo di competenza, percentuale da accantonare. Usa gli incassi registrati in Fatture in Cloud e il profilo di tax_profile_set. Per l'anno in corso proietta gli incassi a fine anno (projection='linear') o usa solo quelli già avvenuti ('to_date').

Confronta forfettario, ordinario (ditta individuale) e SRL unipersonale: imposte, contributi e netto in tasca a parità di ricavi e costi, con la soglia di ricavi oltre cui il forfettario smette di convenire. Ricavi di default: proiezione dell'anno in corso dagli incassi in Fatture in Cloud; coefficiente, aliquota e INPS dal profilo fiscale. Mostra anche il forfettario al 15% (dopo i primi cinque anni).

Previsione di cassa mese per mese: incassi attesi dalle fatture aperte, fatture ricorrenti future, scadenze fiscali (30 giugno, 30 novembre) e spese fisse. Calcola quanto accantonare ogni mese per arrivare coperto a ogni scadenza e segnala i mesi con saldo negativo.

Porta le scadenze fiscali stimate (imposta sostitutiva e contributi, 30 giugno e 30 novembre) nel calendario e/o nello scadenziario F24 di Fatture in Cloud. ics_path crea un file .ics con promemoria 7 giorni e 1 giorno prima (importalo in Calendario, Google, Outlook). create_f24 crea o aggiorna gli F24 previsti, senza duplicarli; dry_run è TRUE per default.

Crea lo zip annuale per il commercialista: fatture.csv, incassi.csv, crediti_aperti.csv, spese.csv (formato italiano per Excel), PDF di tutte le fatture e note di credito, XML FatturaPA e riepilogo.md con ricavi, soglia del forfettario, stima delle tasse e controlli.

Banche e formati di estratto conto riconosciuti automaticamente nell'import.

Legge un estratto conto esportato dall'home banking (XLSX, XLS, CSV) e mostra banca riconosciuta, periodo, entrate e uscite.

Riconciliazione bancaria: abbina gli accrediti dell'estratto conto (file o conto collegato) alle fatture aperte per importo, numero fattura in causale, P.IVA e nome del cliente, e segna come pagate le rate abbinate con la data dell'accredito. dry_run è TRUE per default: mostra le proposte con il livello di confidenza; rilancia con dry_run=false per registrare quelle ≥ min_confidence.

Banche collegabili tramite Enable Banking (nome esatto da usare in bank_link_start).

Collega un conto corrente via Enable Banking (PSD2). Restituisce un link: aprilo, autorizza nella tua banca, poi copia l'indirizzo della pagina finale (anche se dà errore) e passalo a bank_link_finish. Il consenso dura fino a 180 giorni.

Completa il collegamento: passa l'URL di ritorno (contiene ?code=...&state=...) oppure il solo code.

Conti collegati con Enable Banking e scadenza del consenso.

Calcola con Fatture in Cloud i totali di un documento senza crearlo: imponibile, rivalsa, IVA, ritenute, bollo, totale e somma delle rate. Usalo per controllare una fattura prima di emetterla.

Crea la nota di credito di una fattura, totale o parziale, collegata alla fattura originale come richiede lo SdI (numero e data della fattura nei dati della fattura elettronica). È l'unico modo per correggere una fattura elettronica già inviata. dry_run è TRUE per default: mostra la nota e i suoi totali; non viene inviata allo SdI (usa poi send_einvoice).

Comuni italiani da CAP o nome: città, CAP e sigla della provincia corretti, necessari per le fatture elettroniche.

Prepara l'anagrafica di un cliente dalla partita IVA usando VIES (il registro europeo): ragione sociale e indirizzo, con città e provincia verificate. Il codice destinatario SDI non è pubblico: chiedilo al cliente o usa la sua PEC. Con create=true crea il cliente.

Listini prezzi configurati in Fatture in Cloud.

Prezzi dei prodotti in un listino.

Totali mensili dei corrispettivi (scontrini o ricevute) di un anno.

Bollo virtuale sulle fatture elettroniche: documenti con bollo e importo da versare per trimestre (F24 codici 2521-2524), con le scadenze (31/5, 30/9, 30/11, 28/2). Rientra anche nelle scadenze di tax_deadlines_export e cashflow_forecast.

Valori del quadro LM (regime forfettario) della dichiarazione per un anno chiuso: ricavi, reddito, contributi dedotti, imposta, acconti e saldo, dagli incassi in Fatture in Cloud e dal profilo fiscale. Da controllare col commercialista.