# Strumenti MCP > Tutti gli strumenti sul server TradeCatalog MCP, i loro input, chi può utilizzarli e cosa restituiscono. Gli strumenti utilizzano il ruolo del tuo workspace corrente in ogni chiamata. Le connessioni in sola lettura continuano a funzionare. Per effettuare modifiche è necessario lo scope aggiuntivo `tradecatalog:write`. Le azioni conseguenti mostrano una scheda Conferma/Annulla nei client compatibili, con un collegamento di revisione accesso effettuato come fallback, e vengono eseguite solo dopo la tua approvazione. I risultati sono testo JSON; il formato originale degli strumenti di ricerca prevede prezzi, mentre gli strumenti di gestione utilizzano unità minori di valuta intere e punti base (100 = 1%). La maggior parte degli strumenti richiede un `workspace`: l'indirizzo del workspace da `list_workspaces`, ad esempio `northgate`. L'app AI chiama normalmente `list_workspaces` per prima da sola. Quando uno strumento non può fare qualcosa, ad esempio non sei personale in quel workspace o il cliente non esiste, restituisce un messaggio di errore che l'app AI può leggere e agire, come "Nessun cliente \"OAK99\". Utilizza list_customers per i codici account." Quando il catalogo di un fornitore è prezzo solo per il cliente selezionato, `set_basket_quantity`, `send_order` e `reorder` restituiscono questo errore. `get_basket`, `list_buyer_orders` e `get_buyer_order` funzionano ancora, quindi gli ordini esistenti rimangono leggibili. Il fornitore lo imposta nelle Impostazioni e può sovrascriverlo per ogni cliente (`ordering`: `follow`, `prices_only` o `can_order` su `update_customer`). Quando il fornitore ha disattivato il download degli elenchi prezzi, `download_my_price_list` restituisce un errore e il collegamento CSV accesso effettuato risponde 403. `quote_configured_product` legge il prezzo di riga del conto acquirente selezionato per `productId`, `qty` e opzionale `configuration`, senza modificare un carrello. `set_configured_basket_line` crea una riga separata o aggiorna/rimuove la sua esatta `lineId` (`qty: 0` rimuove). Fornisci la specifica completa sulle modifiche. Rileggi `get_basket` dopo le modifiche e verifica tutte le selezioni, le misure e i prezzi correnti prima di `send_order`. Una modifica alla specifica o alla versione dei prezzi invalida la vecchia revisione anche se il totale non è cambiato. Il personale può utilizzare `save_product_family` per i metadati condivisi delle varianti e `save_ordering_draft` per un bozza avanzata di prezzo revisionata. Quest'ultimo richiede il piano Pro e l'autorizzazione al prezzo globale; la pubblicazione utilizza la revisione dei cambiamenti dei prezzi esistente. Gli import di prodotti accettano opzionalmente famiglia, incremento d'ordine e definizioni di ordinamento. Consulta [setup del catalogo commerciale](/docs/guides/trade-catalogues). ## Configura un workspace del fornitore `create_workspace` crea un'area di lavoro gratuita per fornitori per la persona autenticata e verificata, dopo che ha confermato una carta. Chiedi il nome dell'azienda, la valuta dei prodotti, il fuso orario e il paese. La persona ne diventa il proprietario. Non viene creato alcun abbonamento o pagamento. Poi richiama `list_workspaces` nuovamente e utilizza l'indirizzo restituito per la configurazione dei prodotti e dei clienti. Accessi di revisore e ospite non possono creare aree di lavoro. Free include fino a 100 prodotti e app AI collegate. Ogni SKU è contato, incluso prodotti nascosti e inattivi. Al raggiungimento del limite, i prodotti esistenti, modifiche e ordini continuano a funzionare; la creazione di ulteriori prodotti non è disponibile. Spiega questo diritto senza promuovere gli aggiornamenti o avviare il checkout dell'abbonamento nel plugin. ## list_workspaces Workspace dei fornitori in cui lavori, e portali di scambio dove acquisti. Inizia qui. **Chi:** chiunque sia connesso. **Input:** nessuno. ```json { "supplierWorkspaces": [ { "workspace": "northgate", "name": "Northgate Fixings", "role": "owner" } ], "tradePortals": [ { "workspace": "hartley-timber", "supplier": "Hartley Timber", "yourAccount": "Northgate Fixings", "accountId": "example-account-id" } ] } ``` ## search_products Cerca un catalogo per SKU, riferimento del produttore, nome, marca o categoria. Restituisce fino a **25** prodotti. **Chi:** personale e acquirenti. | Input | Tipo | Obbligatorio | Descrizione | | ----------- | ------ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workspace` | string | sì | Indirizzo del workspace. | | `query` | string | sì | Cosa cercare. Una lista vuota elenca i prodotti per nome. | | `accountId` | string | acquirenti con più di un account | Seleziona il tuo account esatto da `list_workspaces`. | | `customer` | string | no | Solo personale: il codice o il nome dell'account di un cliente, per visualizzare i loro prezzi e solo ciò che possono vedere. Ignorato per gli acquirenti. | - **Acquirenti** vedono sempre i prezzi del loro account e solo i prodotti attivi che possono vedere. - **Personale** vede i prezzi di listino e tutti i prodotti, o la visualizzazione di un cliente specifico. ```json { "supplier": "Northgate Fixings", "pricesFor": "Oakfield Joinery", "taxNote": "ex VAT", "products": [ { "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "unit": "Box of 100", "availability": "in_stock", "price": "£15.73", "listPrice": "£18.50", "why": "Brand discount −15%" } ] } ``` Quando il fornitore ha disattivato **Mostra ai clienti il prezzo standard accanto al loro prezzo**, i risultati dell'acquirente escludono `listPrice` e `why`, e `get_buyer_product`, `get_basket` e `get_buyer_order` non hanno né un prezzo di listino né una ragione del prezzo. Prova: "Cerca Northgate per viti M10 a sfera a prezzi di Oakfield." ## download_products_csv e download_my_price_list Questi strumenti restituiscono un collegamento a un download CSV esistente in TradeCatalog. Apri il file mentre sei connesso; restituire un collegamento non scarica o invia il file in chat. - `download_products_csv`: il personale sceglie `workspace` per scaricare l'elenco dei prodotti di quel fornitore. - `download_my_price_list`: gli acquirenti scelgono `workspace` e l'esatto `accountId` da `list_workspaces` per scaricare solo i prezzi concordati di quel account. - `download_my_price_list_pdf`: lo stesso account, in formato PDF marchiato (Pro). Entrambi gli strumenti sono bloccati quando il fornitore ha disattivato il download degli elenchi prezzi. ## check_price Quanto paga un cliente per un SKU in una quantità, e quale set di regole ha impostato il prezzo. **Chi:** solo personale. | Input | Tipo | Obbligatorio | Descrizione | | ----------- | ------- | ------------ | --------------------------------------- | | `workspace` | string | sì | Indirizzo del workspace. | | `customer` | string | sì | Codice o nome dell'account. | | `sku` | string | sì | SKU. | | `qty` | integer | no | Da 1 a 1.000.000. Valore predefinito 1. | ```json { "customer": "Oakfield Joinery", "sku": "HX-8510", "name": "Hex bolt M10 x 50 zinc", "qty": 20, "unitPrice": "£15.73", "lineTotal": "£314.60", "listPrice": "£18.50", "why": "Brand discount −15%", "taxNote": "ex VAT" } ``` Prova: "Quanto paga OAK01 per 20 di HX-8510, e perché?" ## list_customers Clienti commerciali con codici account, email di contatto, stato attivo e sconto account. **Chi:** solo personale. **Input:** `workspace`. ```json [ { "accountCode": "OAK01", "name": "Oakfield Joinery", "email": "accounts@oakfieldjoinery.co.uk", "active": true, "discount": "5%" } ] ``` Prova: "Quali clienti non hanno uno sconto impostato?" ## list_orders Ordini recenti, dal più recente al più vecchio, fino a **50**. **Chi:** il personale può vedere gli ordini di ogni cliente; i compratori possono vedere solo quelli del loro account. | Input | Tipo | Obbligatorio | Descrizione | | ----------- | ------ | ------------ | --------------------------------------------------------------------------------------- | | `workspace` | string | sì | Indirizzo del workspace. | | `status` | string | no | `new`, `pending`, `acknowledged`, `processed`, `dispatched`, `completed` o `cancelled`. | ```json [ { "reference": "SO-000142", "customer": "Oakfield Joinery", "status": "new", "total": "£314.60", "poNumber": "PO-88231", "placed": "2026-09-27T07:48:12.000Z" } ] ``` Prova: "C'è qualche ordine nuovo da ieri? Totale per cliente." ## recent_activity Il registro delle attività delle modifiche ai clienti, agli sconti e ai prezzi, dal più recente al più vecchio, fino a **50** voci. Opzionalmente, la storia di un solo cliente. **Chi:** solo personale. I proprietari e gli amministratori vedono l'intero registro; altri dipendenti vedono solo le modifiche relative ai clienti che possono vedere. | Input | Tipo | Obbligatorio | Descrizione | | ----------- | ------ | ------------ | --------------------------- | | `workspace` | string | sì | Indirizzo del workspace. | | `customer` | string | no | Codice o nome dell'account. | ```json [ { "when": "2026-09-26T14:21:03.000Z", "who": "Jo Hartley", "customer": "Oakfield Joinery", "what": "Set Northgate brand discount to 15% (was 12.5%)" } ] ``` Prova: "Chi ha modificato i prezzi di Oakfield questo mese?" ## Note - I nomi dei clienti e i codici di account vengono abbinati senza tenere conto del caso. Un codice di account esatto è più sicuro. - `list_workspaces` restituisce i valori dell'acquirente `accountId`. Fornisci quello intenzionato a `search_products` e a ogni azione dell'acquirente. Non indovinare mai tra gli account. - Esegui ricerche di prodotti nella pagina con `offset` e il `nextOffset` restituito. Usa `list_buyer_orders` per un account acquirente selezionato esplicitamente. ## Modifiche e conferme Le modifiche al carrello dell'acquirente, le notifiche di aggiornamento e la creazione di bozze di prezzi non pubblicati vengono eseguite immediatamente quando autorizzate. Altri scritture restituiscono `awaiting_confirmation`, un `actionId` e un `reviewUrl`. I client ChatGPT e compatibili visualizzano una scheda con il workspace esatto e la modifica proposta: scegliere **Conferma** o **Annulla** senza uscire dalla conversazione. I client senza schede utilizzano il link di revisione autenticato. Le revisioni scadono dopo 15 minuti e vengono eseguite al massimo una volta. Disconnettere l'app o rimuovere l'accesso necessario al workspace invalida le revisioni in sospeso. I carrelli degli ordini modificati e le anteprime dei cambiamenti dei prezzi richiedono una nuova revisione. Utilizzare `get_action_status` per leggere l'esito; una richiesta in sospeso non è un'azione completata. Il helper `decide_action` è disponibile solo per l'interfaccia utente della carta. La sua capacità di conferma a breve termine è nascosta dall'output del modello e vincolata alla persona che effettua la richiesta, alla connessione OAuth e alla proposta. Un messaggio del modello o un ID di azione non possono approvare un cambiamento. Le stesse verifiche per ruolo, snapshot, scadenza e utilizzo singolo si applicano sia alle approvazioni della carta che a quelle del browser. Ogni azione dell'acquirente richiede il tuo esatto `accountId`. Per `send_order`, copia il carrello `fingerprint` in `expectedBasket`, insieme a `expectedTotal`. I prezzi, le quantità e l'account vengono verificati nuovamente prima dell'invio. Utilizza gli strumenti di passaggio separati per il lavoro che termina nell'app con accesso effettuato: gli amministratori utilizzano `open_api_key_settings`, `download_workspace_export` e `open_logo_settings`; il personale utilizza `open_import_page`, `open_product_image_upload` e `open_product_file_manager`. I due passaggi del prodotto richiedono un `productId` verificato dal locatario. I collegamenti dei file da `get_product` e `get_buyer_product` richiedono il tuo browser con accesso effettuato; restituire un collegamento non indica che il documento è stato letto o che un caricamento, rimozione, esportazione o creazione di credenziali è stato completato. L'amministrazione della piattaforma non viene mai delegata tramite OAuth. ## Liste clienti approvate Il personale utilizza `get_customer` per leggere l'ambito del catalogo del cliente e i prodotti approvati. `set_catalogue_scope` passa tra `all` e `approved`. `approve_products` aggiunge prodotti espliciti o una categoria; `unapprove_product` rimuove un prodotto. Queste modifiche richiedono la revisione del cliente esatto, della lista corrente e dei prodotti interessati. La membership alla categoria viene verificata nuovamente al momento della conferma. I compratori rimangono limitati al loro account selezionato e ai prodotti visibili a quell'account. ## Strumenti per fornitori e acquirenti `create_workspace` è disponibile anche quando `list_workspaces` è vuoto. Crea un workspace per fornitori Free e una membership di proprietario solo dopo la conferma. La connessione `/mcp/account` opzionale offre anche `open_billing`: i proprietari possono aprire la fatturazione abbonamento sicura e confermare il pagamento in Stripe, quindi verificare `get_settings` per lo stato risultante. I collegamenti di fatturazione non completano i pagamenti. La connessione standard `/mcp` utilizzata dal plugin ChatGPT non espone `open_billing`. Consulta [registrazione e fatturazione](/docs/mcp#sign-up-and-pay-with-an-agent). MCP 3.0.0 espone ogni operazione chiamabile da modello in anticipo con il proprio nome, descrizione, schema di input e annotazioni. Gli strumenti `bulk_products` e `open_workspace_action` precedenti vengono sostituiti dalle operazioni individuali riportate di seguito; aggiorna le definizioni degli strumenti del tuo client dopo l'aggiornamento. La risposta MCP `tools/list` è lo schema di input autoritativo. I seguenti strumenti completano gli strumenti di ricerca sopra indicati: | Strumento | Scopo | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `open_api_key_settings` | Solo proprietario: restituisce la pagina delle impostazioni API con accesso autenticato per la creazione delle credenziali. Aprire il collegamento non crea una chiave. Non chiedere mai agli utenti di incollare segreti in chat. | | `download_workspace_export` | Solo proprietario: restituisce il collegamento per l'esportazione completa del workspace autenticato. L'utente deve aprire il collegamento per scaricarlo; questo strumento non legge o trasferisce l'esportazione. | | `open_logo_settings` | Solo per il proprietario: restituisce la pagina delle impostazioni del marchio autenticato per caricare il logo del fornitore. L'apertura del collegamento non carica né modifica il logo. | | `open_import_page` | Personale: restituisce la pagina di importazione file autenticata. L'utente carica e verifica il file in TradeCatalog; aprire il collegamento non importa nulla. | | `open_product_image_upload` | Personale: restituisce l'editor autenticato per un prodotto esistente per caricare un'immagine. Aprire il collegamento non carica o modifica un'immagine. | | `open_product_file_manager` | Personale: restituisce l'editor autenticato per un prodotto esistente per caricare o rimuovere i file del prodotto. Aprire il collegamento non legge, carica o rimuove i file. | | `delete_workspace` | Solo proprietario: cancella definitivamente questo workspace, il suo catalogo, l'accesso dei clienti e le immagini, e annulla la sottoscrizione. Richiede la revisione autenticata e la digitazione del nome del workspace. Non può essere annullato nell'app. | | `get_workspace` | Personale: ruolo attuale, totali del catalogo e degli ordini. Le somme sono unità di valuta minore intere; le percentuali sono punti base (100 = 1%). | | `get_catalogue_options` | Personale: elenca gli ID delle categorie e delle marche per modifiche al catalogo e agli sconti. | | `get_product` | Personale: campi prodotto, prezzo listino corrente, visibilità, restrizioni clienti, immagini e file allegati (fogli tecnici). | | `save_product` | Crea o modifica un prodotto. Leggi prima il prodotto corrente e preserva i campi che l'utente non ha chiesto di modificare. listPrice è in unità minori; le modifiche ai prezzi esistenti utilizzano il flusso di modifica prezzo dell'app. Richiede revisione. | | `set_product_image` | Scegli la foto principale, o cancellala. Cancellare rimuove quella foto dalla galleria e la successiva diventa la foto principale. Richiede revisione. | | `create_category` | Crea una categoria con nome, opzionalmente sotto una categoria padre. Richiede approvazione. | | `update_category` | Rinomina o sposta una categoria. I suoi prodotti rimangono in essa. Richiede revisione. | | `delete_category` | Rimuovi una categoria e le sue regole di sconto per categoria. I prodotti e le sottocategorie si spostano di un livello. Richiede revisione. | | `hide_products` | Personale: nascondere gli ID dei prodotti espliciti agli acquirenti senza eliminarli. Richiede una revisione. | | `show_products` | Personale: rendere attivi gli ID prodotto espliciti. Restrizioni del catalogo clienti sono ancora applicabili. Richiede revisione. | | `move_products` | Personale: sposta gli ID prodotti espliciti in una categoria, o passa null per rimuovere la loro categoria. Richiede revisione. | | `delete_products` | Personale: eliminare definitivamente gli ID dei prodotti espliciti, inclusi i loro prezzi, immagini e linee del carrello. Gli ordini storici mantengono le loro copie. Richiede una revisione. | | `clear_catalogue` | Solo proprietario: rimuovere permanentemente ogni prodotto, prezzo e foto. Richiede la revisione con accesso effettuato e la digitazione della frase di cancellazione corrente. | | `get_customer` | Personale: termini del cliente, lista dei prezzi, ambito del catalogo, prodotti approvati, regole di sconto, prezzi concordati, acquirenti e inviti in sospeso. `priceLists` sono le liste che puoi assegnare con `update_customer`. Assegnare una lista dei prezzi diversa non Standard richiede Pro. | | `create_customer` | Crea un account commerciale. La sua email di contatto può accedere come quell'account, quindi conferma l'indirizzo. Richiede revisione. | | `update_customer` | Modifica i dettagli del cliente, codice account (`accountCode`; unico per fornitore ignorando le maiuscole, ometti per mantenerlo), email di accesso del contatto, email aggiuntive per gli aggiornamenti (`notifyEmails`), stato attivo, percentuale dell'intera lista (`discountBp`, 0 a 10.000) e la sua `adjustment` (`discount` o `markup`; ometti per mantenerla), ordinamento (`follow`, `prices_only` o `can_order`) e `priceListId` (null è Standard). Basis points: 100 = 1%. Leggi get_customer prima. Richiede revisione. Assegnare una lista dei prezzi diversa non Standard richiede Pro. | | `save_discount_rule` | Imposta una percentuale di categoria, marca o prodotto per il cliente, in basis points (0 a 10.000). `adjustment` è `discount` o `markup`; omettilo per uno sconto. La regola più specifica vince e nulla si accumula. Cambia i prezzi immediatamente. Richiede revisione. Richiede Pro. | | `remove_discount_rule` | Rimuovi la regola di sconto del cliente selezionata. I prezzi potrebbero aumentare immediatamente. Richiede revisione. | | `set_fixed_price` | Imposta un prezzo specifico per il cliente in unità di valuta minori intere. `note` è un commento opzionale; `noteVisible` lo mostra a quel cliente. `internalNote` rimane solo per il personale. Richiede revisione. Richiede Pro. | | `end_fixed_price` | Termina un prezzo fisso per il cliente ora in modo che vengano applicate le regole di sconto normali. Richiede una revisione. | | `list_staff` | Personale: elencare il team del workspace e le inviti in sospeso. | | `invite_staff` | Solo il proprietario: invia un'email con un invito per concedere accesso al personale o al proprietario. Richiede la revisione del destinatario e del ruolo. | | `invite_buyer` | Personale: invia un invito a un account cliente specifico. Richiede la revisione del destinatario e dell'account. | | `remove_buyer` | Rimuovi una membership dall'account cliente specificato. Richiede revisione. | | `preview_product_import` | Anteprima delle righe analizzate senza importarle. Non riparare in modo silenzioso i prezzi incerti della fonte. | | `import_products` | Importa al massimo 100 righe analizzate. listPrice va alla priceList (ometti per Standard); listPrices nomina altre liste. Ogni lista cambia si unisce a un bozza. Richiede revisione. Le URL delle immagini possono essere recuperate. | | `import_customers` | Importa al massimo 100 clienti. La priceList opzionale nomina la loro lista; l'aggiustamento è sconto o markup. Un nome di lista sconosciuto è un errore. Richiede revisione. | | `preview_agreed_prices` | Anteprima fino a 2.000 prezzi concordati (codice account, SKU, prezzo in unità minori intere e un commento opzionale) senza salvare. Solo Pro. I conti e i SKU sconosciuti vengono segnalati e saltati. Quando un account e un SKU sono ripetuti, l'ultima riga viene utilizzata. | | `import_agreed_prices` | Salva fino a 2.000 prezzi concordati per account e SKU esistenti. Solo Pro. Ogni prezzo è versionato da ora, in lotti di 100. Le righe sconosciute vengono saltate. Richiede revisione. | | `list_import_layouts` | Elenco delle mappature delle colonne salvate di questo fornitore. | | `save_import_layout` | Salva una mappatura delle colonne riutilizzabile per questo fornitore. Richiede revisione. | | `list_price_changes` | Elenco bozze e modifiche ai prezzi programmate o pubblicate. | | `draft_price_change` | Crea una bozza di modifica percentuale per una lista dei prezzi (`priceListId`; ometti per Standard). Un batch non mescola mai liste. Basis points firmati: 600 = +6%, da −90% a +100%. Non pubblica o invia email ai clienti. Richiede Pro. | | `preview_price_change` | Leggi l'impatto, gli avvisi, i prezzi fissi e gli scontri di pianificazione prima di pubblicare. | | `publish_price_change` | Pubblica ora o a un timestamp ISO, opzionalmente inviando email ai clienti (alla pubblicazione o a un `notifyAt` pianificato) e modificando i prezzi concordati. Richiede la revisione della preview corrente; le preview modificate invalidano l'approvazione. Pro è richiesto, tranne per gli import di prezzi Standard immediati senza email o modifiche ai prezzi concordati. | | `cancel_price_change` | Annulla una modifica dei prezzi pianificata. I clienti potrebbero ricevere un'email di cancellazione. Richiede revisione. | | `discard_price_draft` | Cancellare definitivamente una modifica dei prezzi non pubblicata. Richiede revisione. | | `get_staff_order` | Personale: righe ordine, cliente, note e cronologia dello stato. | | `set_order_status` | Accetta, elabora, completa o annulla un ordine utilizzando le transizioni consentite dall'app. Potrebbe inviare un'email al compratore. Richiede revisione. | | `get_settings` | Leggi le impostazioni del fornitore e lo stato della sottoscrizione; non vengono restituite credenziali di pagamento. | | `save_settings` | Solo proprietario: modifica i dettagli aziendali, destinatari degli ordini, valuta, elenco della directory, preferenze di ricerca se i clienti vedono il prezzo standard accanto al loro (`showStandardPrice`; `false` mostra solo il loro prezzo), come i prodotti vengono ordinati per i clienti (`productOrder`: `name`, `sku`, `category` o `custom`; `category` segue l’ordine della pagina Categorie, dalla A alla Z in ogni categoria, con i prodotti senza categoria per ultimi), quali colonne del catalogo vedono e in che ordine (`catalogueColumns`), l'intestazione per ogni nota del trattato commerciale del prodotto (`dealLabel`), se il login del cliente marchiato nasconde il collegamento per il login del personale (`hidePortalStaffLink`; proprietario o admin, predefinito false), se le sottotitoli e i collegamenti per le istruzioni del personale sono nascosti (`hideStaffGuides`; solo proprietario o admin, predefinito false), se la pagina di accesso si apre sul nome utente e sulla password (`loginUsernameFirst`; solo proprietario o amministratore, false per impostazione predefinita per mantenere prima l’e-mail), e quali parti del listino prezzi PDF marchiato stampare (`pdfShowLogo`, `pdfShowDate`, `pdfShowSupplierName`, `pdfShowCustomerName`, `pdfShowPageNumbers`; ogni true per default, false nasconde quella parte). Leggi prima le impostazioni correnti. Richiede revisione. | | `list_api_keys` | Solo proprietario: elenco delle etichette e degli ambiti delle chiavi. Non restituisce mai segreti. | | `revoke_api_key` | Solo proprietario: disconnetti immediatamente un'integrazione API. Richiede revisione. | | `list_news` | Personale: elenco di annunici, inclusi quelli scaduti. | | `post_news` | Pubblica un annuncio agli acquirenti, ora o da `startsLocal` (orario del fornitore). L'opzione `endsOn` nasconde l'annuncio a `YYYY-MM-DDTHH:mm` nel fuso orario del fornitore, o alla fine di un `YYYY-MM-DD`. emailCustomers invia anche gli abbonati quando inizia. Richiede la revisione del messaggio esatto e dell'audience. | | `remove_news` | Rimuovi un annuncio pubblicato. Gli email inviate non possono essere richiamate. Richiede revisione. | | `list_support_tickets` | Solo proprietario e admin: elenco dei ticket di supporto di questo workspace. | | `get_support_ticket` | Solo proprietario e admin: leggi i messaggi su un ticket appartenente a questo workspace. | | `open_support_ticket` | Solo proprietario e admin: invia una richiesta di supporto a Happy Webs. Richiede la revisione del messaggio esatto. | | `reply_to_support` | Solo proprietario e admin: invia una risposta a una conversazione di supporto esistente. Richiede revisione. | | `get_buyer_product` | Leggi un prodotto visibile con prezzi e file allegati (fogli di specifiche) per l'account selezionato esplicitamente. | | `get_basket` | Leggi le quantità e i prezzi correnti per il tuo account cliente selezionato esplicitamente. | | `set_basket_quantity` | Imposta una quantità assoluta (0 rimuove la riga). Modifica solo il tuo carrello; non invia un ordine. | | `send_order` | Invia il carrello dell'account selezionato al fornitore, con copia dell'email del compratore. Richiede la revisione autenticata dei prodotti esatti, quantità, prezzi, PO e note. Se il carrello cambia, richiedi una nuova revisione. Copia expectedBasket da get_basket.fingerprint. | | `list_buyer_orders` | Leggi gli ordini per l'account cliente selezionato. | | `get_buyer_order` | Leggi le linee e la cronologia dello stato per un ordine appartenente all'account selezionato. | | `reorder` | Aggiungi prodotti disponibili da un ordine precedente al tuo carrello ai prezzi correnti. Non invia un ordine. Richiede revisione. | | `get_buyer_updates` | Leggi le notizie correnti, le tue modifiche dei prezzi e gli aggiornamenti non letti per l'account cliente selezionato. | | `mark_updates_read` | Contrassegna gli aggiornamenti attualmente disponibili per l'account selezionato come letti. | | `get_action_status` | Leggi il risultato di una recensione richiesta da questa connessione. | L'ingresso degli ordini del personale utilizza `preview_customer_order` poi revisionato `create_customer_order` con prezzi esatti e un UUID di ripetizione. Il processo utilizza `set_order_status` con `note` pubblici, `internalNote`/`correctionReason` privati e `expectedRevision`. `set_order_delivery` revisionati registra un metodo di consegna visibile al cliente e corriere opzionale, riferimento e collegamento HTTPS. Questi strumenti seguono le autorizzazioni e lo scope del cliente attuali. Vedi [Ordini](/docs/api/orders) per i campi e il comportamento.