CRM in Cloud

Elenca i valori ammessi per lo stato, la fase, la categoria e il motivo di perdita di un'opportunità. Fasi, categorie e motivi sono letti dal vivo dal CRM (configurazione del tuo tenant, cache di un'ora); lo stato è l'enum ufficiale del prodotto, uguale per tutti. Usalo prima di crea_opportunita o a…

Lists the allowed values for the status, stage, category and loss reason of an opportunity. Stages, categories and reasons are read live from the CRM (your tenant's configuration, one-hour cache); the status is the product's official enum, the same for everyone. Use it before crea_opportunita or…

{
  "tool": "opzioni_opportunita",
  "parameters": {}
}

Elenca i valori ammessi per lo stadio, i termini di pagamento, le modalità di pagamento, le unità di misura e i template di stampa di un preventivo. Pagamenti, modalità, unità di misura e template sono letti dal vivo dal CRM (configurazione del tuo tenant, cache di un'ora); lo stadio è l'enum uffici…

Lists the allowed values for the stage, payment terms, payment methods, units of measure and print templates of a quote. Payments, methods, units of measure and templates are read live from the CRM (your tenant's configuration, one-hour cache); the stage is the official enum…

{
  "tool": "opzioni_preventivo",
  "parameters": {}
}

Cerca anagrafiche aziendali per ragione sociale, partita IVA e/o città (almeno un criterio). I risultati vengono riletti e verificati: se il CRM ignora il filtro (cosa che fa in silenzio) il tool solleva un errore invece di restituire una lista inaffidabile. Zero risultati è una risposta legittima.…

Searches company records by company name, VAT number and/or city (at least one criterion). Results are read back and verified: if the CRM ignores the filter (which it does silently) the tool raises an error instead of returning an unreliable list. Zero results is a legitimate answer.…

Puo’ usare: nome partitaIva citta limite

{
  "tool": "cerca_azienda",
  "parameters": {
    "nome": "<string>",
    "partitaIva": "<string>",
    "citta": "<string>"
  }
}

Legge la scheda completa di un'azienda: dati anagrafici, contatti collegati e opportunità collegate. È il dossier da consultare prima di proporre una nuova opportunità o preventivo su un'azienda esistente.

Reads the complete profile of a company: master data, linked contacts and linked opportunities. It is the dossier to consult before proposing a new opportunity or quote on an existing company.

Gli serve: aziendaIdinteger

{
  "tool": "leggi_azienda",
  "parameters": {
    "aziendaId": "<integer>"
  }
}

Crea un'anagrafica aziendale: ragione sociale, partita IVA e indirizzo. Controlla prima i duplicati per partita IVA (se fornita) e rifiuta di procedere se ne trova uno: usa quello esistente invece di crearne un altro. L'indirizzo conviene sempre compilarlo, perché è quello che il CRM stampa in testa…

Creates a company record: company name, VAT number and address. It first checks for duplicates by VAT number (if provided) and refuses to proceed if it finds one: use the existing record instead of creating another. Always fill in the address, because that is what the CRM prints at the top…

Gli serve: ragioneSocialestring

Puo’ usare: partitaIva codiceFiscale indirizzo citta provincia cap regione sitoWeb commerciale dry_run

{
  "tool": "crea_azienda",
  "parameters": {
    "ragioneSociale": "<string>"
  }
}

Aggiorna uno o più campi di un'anagrafica aziendale esistente: ragione sociale, codice fiscale, partita IVA, CAP, provincia, città, indirizzo, stato/paese, regione e sito web. Invia solo i campi passati: gli altri restano invariati. La scrittura viene riletta e confrontata perché il CRM può scartare…

Updates one or more fields of an existing company record: company name, tax code, VAT number, postal code, province, city, address, state/country, region and website. Only the fields you pass are sent: the others stay unchanged. The write is read back and compared because the CRM may discard…

Gli serve: aziendaIdinteger

Puo’ usare: ragioneSociale codiceFiscale partitaIva cap provincia citta indirizzo stato regione sitoWeb +1

{
  "tool": "aggiorna_azienda",
  "parameters": {
    "aziendaId": "<integer>"
  }
}

Cerca opportunità per stato, nome, azienda, fase e intervalli di data di creazione o chiusura (almeno un criterio). I risultati vengono riletti e verificati contro tutti i criteri richiesti prima di essere restituiti.

Searches opportunities by status, name, company, stage and creation or closing date ranges (at least one criterion). Results are read back and verified against all the requested criteria before being returned.

Puo’ usare: stato nome aziendaId fase creataDa creataA chiusaDa chiusaA limite

{
  "tool": "cerca_opportunita",
  "parameters": {
    "stato": "<integer>",
    "nome": "<string>",
    "aziendaId": "<integer>"
  }
}

Legge il dossier completo di un'opportunità: dati, azienda, prodotti, preventivi collegati e attività collegate. Con dettaglio "completo" i preventivi vengono espansi con le righe; con "sintetico" (default) solo un riepilogo. I testi lunghi vengono troncati con un marcatore esplicito.

Reads the complete dossier of an opportunity: data, company, products, linked quotes and linked activities. With "completo" detail the quotes are expanded with their lines; with "sintetico" (default) only a summary. Long texts are truncated with an explicit marker.

Gli serve: opportunitaIdinteger

Puo’ usare: dettaglio

{
  "tool": "leggi_opportunita",
  "parameters": {
    "opportunitaId": "<integer>"
  }
}

Crea un'opportunità su CRM in Cloud, collegata a un'azienda indicata per id. Se fase non è indicata, il CRM applica la fase di default configurata dal tuo tenant (vedi opzioni_opportunita per l'elenco). La scrittura viene riletta e confrontata campo per campo: eventuali campi scartati dal CRM vengon…

Creates an opportunity on CRM in Cloud, linked to a company identified by id. If no stage is given, the CRM applies the default stage configured by your tenant (see opzioni_opportunita for the list). The write is read back and compared field by field: any fields the CRM discards are…

Gli serve: aziendaIdinteger titolostring

Puo’ usare: descrizione fase stato categoria importo probabilita dataChiusura commerciale dry_run

{
  "tool": "crea_opportunita",
  "parameters": {
    "aziendaId": "<integer>",
    "titolo": "<string>"
  }
}

Aggiorna uno o più campi di un'opportunità esistente (titolo, descrizione, fase, stato, categoria, motivo di perdita, importo, probabilità, data di chiusura, commerciale). Invia solo i campi passati: CreateOrUpdate su un record esistente fa un merge parziale vero e non tocca gli altri (misurato il 2…

Updates one or more fields of an existing opportunity (title, description, stage, status, category, loss reason, amount, probability, closing date, sales rep). Only the fields you pass are sent: CreateOrUpdate on an existing record performs a real partial merge and leaves the others untouched (measured on 2…

Gli serve: opportunitaIdinteger

Puo’ usare: titolo descrizione fase stato categoria motivoPerdita importo probabilita dataChiusura commerciale +1

{
  "tool": "aggiorna_opportunita",
  "parameters": {
    "opportunitaId": "<integer>"
  }
}

Elenca i prodotti collegati a un'opportunità, con quantità, prezzo, sconto e totale di riga. Sono la base da cui il CRM precompila un preventivo (vedi crea_preventivo con daProdottiOpportunita).

Lists the products linked to an opportunity, with quantity, price, discount and line total. They are the basis the CRM uses to prefill a quote (see crea_preventivo with daProdottiOpportunita).

Gli serve: opportunitaIdinteger

{
  "tool": "prodotti_opportunita",
  "parameters": {
    "opportunitaId": "<integer>"
  }
}

Aggiunge un prodotto a un'opportunità, oppure ne modifica uno esistente se passi "prodottoId" (i campi non indicati restano quelli attuali). Il prodotto va indicato per codice di catalogo. La scrittura viene riletta: attenzione, il CRM NON salva l'id dell'unità di misura sui prodotti dell'opportunit…

Adds a product to an opportunity, or edits an existing one if you pass "prodottoId" (the fields you do not specify keep their current values). The product must be identified by catalog code. The write is read back: beware, the CRM does NOT save the unit of measure id on opportunity products…

Gli serve: opportunitaIdinteger

Puo’ usare: prodottoId codiceProdotto descrizione quantita prezzoUnitario scontoFormula unitaMisura dry_run

{
  "tool": "salva_prodotto_opportunita",
  "parameters": {
    "opportunitaId": "<integer>"
  }
}

Rimuove un prodotto da un'opportunità. Serve l'id della riga prodotto, che si ottiene da prodotti_opportunita. La cancellazione viene verificata rileggendo l'elenco. Usa dry_run: true per vedere cosa verrebbe eliminato.

Removes a product from an opportunity. You need the id of the product line, which you get from prodotti_opportunita. The deletion is verified by reading the list back. Use dry_run: true to see what would be deleted.

Gli serve: opportunitaIdinteger prodottoIdinteger

Puo’ usare: dry_run

{
  "tool": "elimina_prodotto_opportunita",
  "parameters": {
    "opportunitaId": "<integer>",
    "prodottoId": "<integer>"
  }
}

Cerca preventivi per azienda, opportunità, numero e/o stadio (almeno un criterio). "opportunityId" non è filtrabile lato server (limite noto dell'API): se lo passi senza aziendaId, il tool legge prima l'opportunità per risalire all'azienda, poi filtra i risultati in locale.

Searches quotes by company, opportunity, number and/or stage (at least one criterion). "opportunityId" is not filterable server-side (known API limitation): if you pass it without aziendaId, the tool first reads the opportunity to trace the company, then filters the results locally.

Puo’ usare: aziendaId opportunitaId numero stadio limite

{
  "tool": "cerca_preventivo",
  "parameters": {
    "aziendaId": "<integer>",
    "opportunitaId": "<integer>",
    "numero": "<string>"
  }
}

Rilegge un preventivo dal CRM e ne restituisce il contenuto effettivo: numero, stadio, totali e righe. Serve a confermare all'utente che cosa è stato scritto davvero, e come strumento di diagnosi.

Reads a quote back from the CRM and returns its actual content: number, stage, totals and lines. It serves to confirm to the user what was really written, and as a diagnostic tool.

Gli serve: preventivoIdinteger

{
  "tool": "leggi_preventivo",
  "parameters": {
    "preventivoId": "<integer>"
  }
}

Crea un preventivo (PR) su CRM in Cloud con le sue righe. È il tool principale. Compone ogni riga prodotto leggendo dal vivo il catalogo del tuo tenant (prezzo, aliquota, unità di misura dichiarata) e rifiuta di indovinare quello che non sa. Ammette tre tipi di riga: prodotto (con sconto percentuale…

Creates a quote (PR) on CRM in Cloud with its lines. This is the main tool. It builds every product line by reading your tenant's catalog live (price, VAT rate, declared unit of measure) and refuses to guess what it does not know. It supports three line types: product (with percentage discount…

Gli serve: aziendaIdinteger oggettostring

Puo’ usare: opportunitaId righe daProdottiOpportunita pagamentoId modalitaPagamentoId stage dataPreventivo dataScadenza commerciale dry_run

{
  "tool": "crea_preventivo",
  "parameters": {
    "aziendaId": "<integer>",
    "oggetto": "<string>"
  }
}

Aggiorna la testata di un preventivo esistente (oggetto, stadio, pagamento, modalità di pagamento, scadenza, commerciale) e, se fornite, SOSTITUISCE tutte le righe con quelle nuove — comprese quelle di sconto. Invia solo i campi passati: CreateOrUpdate su un record esistente fa un merge parziale ver…

Updates the header of an existing quote (subject, stage, payment term, payment method, expiry, sales rep) and, if provided, REPLACES all the lines with the new ones — discount lines included. Only the fields you pass are sent: CreateOrUpdate on an existing record performs a real partial mer…

Gli serve: preventivoIdinteger

Puo’ usare: oggetto stadio pagamentoId modalitaPagamentoId dataScadenza righe commerciale dry_run

{
  "tool": "aggiorna_preventivo",
  "parameters": {
    "preventivoId": "<integer>"
  }
}

Duplica un preventivo esistente. Con modo "copia" crea un record indipendente (Quote/{id}/Copy). Con modo "revisione" crea un nuovo record collegato tramite l'azione ufficiale di revisione del CRM (Quote/{id}/Review): in entrambi i casi l'originale resta invariato (misurato il 28/07/2026) e viene re…

Duplicates an existing quote. With mode "copia" it creates an independent record (Quote/{id}/Copy). With mode "revisione" it creates a new record linked through the CRM's official revision action (Quote/{id}/Review): in both cases the original stays unchanged (measured on 28/07/2026) and is…

Gli serve: preventivoIdinteger modostring

Puo’ usare: nuovoNumero dry_run

{
  "tool": "clona_preventivo",
  "parameters": {
    "preventivoId": "<integer>",
    "modo": "<string>"
  }
}

Restituisce il link per scaricare il PDF di un preventivo, già firmato e pronto da aprire o da mandare al cliente. Il template va scelto fra quelli configurati nel tenant (vedi opzioni_preventivo → templateStampa): ATTENZIONE, il CRM accetta anche un nome di template inesistente e stampa in silenzio…

Returns the link to download the PDF of a quote, already signed and ready to open or send to the customer. The template must be chosen among those configured in the tenant (see opzioni_preventivo → templateStampa): WARNING, the CRM also accepts a non-existent template name and silently prints…

Gli serve: preventivoIdinteger

Puo’ usare: template allegatiProdotto allegati

{
  "tool": "scarica_preventivo",
  "parameters": {
    "preventivoId": "<integer>"
  }
}

Cerca prodotti nel catalogo del CRM per codice, nome o categoria. Legge il catalogo dal vivo (cache di 10 minuti), quindi riflette sempre l'assortimento reale del tuo tenant. Restituisce anche l'unità di misura del prodotto, quando il catalogo la dichiara: per i prodotti che non ne hanno una va chie…

Searches products in the CRM catalog by code, name or category. It reads the catalog live (10-minute cache), so it always reflects your tenant's real assortment. It also returns the product's unit of measure, when the catalog declares one: for products that do not have one you must ask…

Puo’ usare: testo soloConUnitaMisura limite

{
  "tool": "cerca_prodotto",
  "parameters": {
    "testo": "<string>",
    "soloConUnitaMisura": "<boolean>",
    "limite": "<integer>"
  }
}

Legge la scheda di un singolo prodotto dal catalogo del CRM: prezzo di listino, aliquota IVA, sconto massimo consentito e unità di misura predefinita, quando il catalogo la dichiara.

Reads the record of a single product from the CRM catalog: list price, VAT rate, maximum allowed discount and default unit of measure, when the catalog declares it.

Gli serve: codicestring

{
  "tool": "leggi_prodotto",
  "parameters": {
    "codice": "<string>"
  }
}

Cerca attività (chiamate, appuntamenti, eventi) collegate a un'opportunità o a un'azienda, con filtro opzionale su intervallo di date. Sola lettura: questo tool non crea né modifica attività. Serve opportunitaId o aziendaId.

Searches activities (calls, appointments, events) linked to an opportunity or a company, with an optional filter on a date range. Read-only: this tool does not create or modify activities. Requires opportunitaId or aziendaId.

Puo’ usare: opportunitaId aziendaId dataDa dataA limite

{
  "tool": "cerca_attivita",
  "parameters": {
    "opportunitaId": "<integer>",
    "aziendaId": "<integer>",
    "dataDa": "<string>"
  }
}