In breve
Sage Business Cloud Accounting, edizione sudafricana (l'ex Sage One): aziende, clienti, fornitori, articoli, fatture fiscali, preventivi, fatture fornitori, piano dei conti, transazioni bancarie, ricevute clienti, scadenze, conto economico e stato patrimoniale. Accedi con il tuo login Sage e una chiave API di Sage.
Configurazione guidata
Collega Sage Accounting a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Sage Accounting con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per Sage Accounting (South Africa)
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Sage Accounting (Sudafrica), incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Sage Accounting (Sudafrica)
Sage Business Cloud Accounting, edizione sudafricana (l'ex Sage One): aziende, clienti, fornitori, articoli, fatture fiscali, preventivi, fatture fornitori, piano dei conti, transazioni bancarie, ricevute clienti, scadenze, conto economico e stato patrimoniale. Accedi con il tuo login Sage e una chiave API di Sage.
Configurazione
La configurazione richiede fino a 2 giorni lavorativi.
- Richiedi una chiave API su https://accounting.sageone.co.za/marketing/developerprogram.aspx (Richiedi la tua chiave API). Sage emette una chiave per applicazione; appare come
39478ac6-ac2a-44d8-a31c-7e7e14af4de3. Incollala inSAGE_ZA_API_KEY. - Scegli il sito su cui accedi in
SAGE_ZA_API_HOST: accounting.sageone.co.za per la maggior parte degli account, o resellers.accounting.sageone.co.za quando quella è la tua pagina di accesso. - Inserisci l'indirizzo e-mail e la password di un utente Sage Accounting in
SAGE_ZA_USERNAMEeSAGE_ZA_PASSWORD. L'API utilizza l'autenticazione HTTP Basic con lo stesso accesso dell'applicazione web, quindi si consiglia un utente dedicato con solo l'accesso necessario per l'assistente. Un utente invitato accede solo alle funzioni consentite dal proprio ruolo (altre chiamate restituiscono 405). - Facoltativo: inserisci l'ID dell'azienda in cui lavora l'assistente in
SAGE_ZA_COMPANY_ID. Trovalo consage_accounting_za_list_companies. Senza di esso, passacompany_idin ogni chiamata.
Da dove iniziare: sage_accounting_za_list_companies mostra le aziende del login e il loro ID. Ogni altro strumento funziona all'interno di un'azienda (company_id, o il predefinito del connettore).
Clienti, fornitori, articoli: sage_accounting_za_list_customers, sage_accounting_za_get_customer, sage_accounting_za_list_suppliers, sage_accounting_za_get_supplier, sage_accounting_za_list_items, sage_accounting_za_get_item. Crea o modifica con sage_accounting_za_save_customer, sage_accounting_za_save_supplier e sage_accounting_za_save_item.
Documenti di vendita e acquisto: sage_accounting_za_list_tax_invoices e sage_accounting_za_get_tax_invoice (fatture di vendita), sage_accounting_za_list_quotes e sage_accounting_za_get_quote, sage_accounting_za_list_supplier_invoices e sage_accounting_za_get_supplier_invoice. Gli strumenti di elenco restituiscono solo intestazioni a meno che include_detail non sia vero. Scrivi un preventivo con sage_accounting_za_save_quote e una fattura con sage_accounting_za_save_tax_invoice; visualizza prima i totali con sage_accounting_za_calculate_quote o sage_accounting_za_calculate_tax_invoice. Una riga indica un articolo (LineType 0) o un conto del libro mastro (LineType 1) in SelectionId, con Quantità, un prezzo unitario e un TaxTypeId. Se un documento salvato restituisce totali zero, passa le righe esattamente come il tool di calcolo le ha restituite.
Libro mastro e banking: sage_accounting_za_list_accounts, sage_accounting_za_list_account_categories e sage_accounting_za_list_tax_types descrivono il piano dei conti; sage_accounting_za_save_account aggiunge o modifica un conto. sage_accounting_za_list_bank_accounts, sage_accounting_za_list_bank_transactions e sage_accounting_za_list_customer_receipts sono in sola lettura: questo connettore non registra ricevute o pagamenti e non sposta mai denaro.
Report: sage_accounting_za_get_customer_ageing e sage_accounting_za_get_supplier_ageing (chi deve cosa, per età), sage_accounting_za_list_outstanding_customer_documents, sage_accounting_za_get_profit_and_loss, sage_accounting_za_get_balance_sheet e sage_accounting_za_get_account_balances (movimento per conto, come un bilancio di verifica). Queste sono chiamate POST che leggono solo.
Salvataggio: un Salva senza id crea un record; con id sostituisce quel record. Sage memorizza il record così come viene inviato, quindi un campo lasciato fuori da un aggiornamento può essere ripristinato: leggi prima il record e passa ciò che deve rimanere in extra_fields. I nuovi record sono attivi a meno che active non sia falso. Niente viene eliminato da questo connettore.
Filtraggio e paginazione: gli strumenti di elenco accettano un sottoinsieme di OData. filter e orderby funzionano solo su numeri, booleani e date, mai su testo (cerca nomi leggendo l'elenco). Le date letterali sono scritte DateTime'2026-01-31'; se Sage rifiuta quella forma, prova la data quotata da sola. Ogni elenco è limitato a 100 righe: la risposta è avvolta come TotalResults, ReturnedResults e Results; aumenta skip di 100 fino a ottenere righe TotalResults.
Limiti: 100 richieste al minuto per azienda e 5.000 al giorno per utente. Superare il limite di un minuto blocca l'indirizzo IP per un'ora (HTTP 429), quindi mantieniti su circa una chiamata al secondo e non riprovare in un ciclo. 20 accessi non riusciti in un'ora bloccano l'utente per 24 ore: dopo un 401, fermati e fai controllare le credenziali.
Campi e formati: Gli ID sono interi. Le date sono YYYY-MM-DD. Gli importi sono decimali nella valuta dell'azienda a meno che un cliente o fornitore non abbia la propria valuta (vedi Customer_CurrencyId e il tasso di cambio sul documento). Esclusivo è l'importo prima delle tasse, Tax l'IVA e Totale l'importo comprensivo di tasse. Errori: 400 porta i messaggi di validazione, 402 significa che l'abbonamento Sage è scaduto, 404 che il record non è in questa azienda, 409 che un record è in uso.
Prerequisiti: SAGE_ZA_API_HOST, SAGE_ZA_USERNAME, SAGE_ZA_PASSWORD, SAGE_ZA_API_KEY
Installa il connettore localmente
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Apri http://localhost:3000/connectors/store, scegli Sage Accounting (Sudafrica) e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
sage_accounting_za_list_companies | Elenca le aziende che questo accesso Sage può aprire: ID, Nome, SimboloValuta, NumeroFiscale, NomeRegistrato, PaeseId, Attivo, ÈProprietario… |
sage_accounting_za_list_customers | Elenca i clienti: ID, Nome, Categoria, NomeContatto, Email, Telefono, Mobile, RiferimentoFiscale, Saldo, LimiteCredito, indirizzo postale e di consegna… |
sage_accounting_za_get_customer | Leggi un cliente con ogni campo: nome, categoria, contatto, riferimento fiscale, saldo, limite di credito, indirizzi, tipo di tassa predefinito, listino prezzi… |
sage_accounting_za_list_suppliers | Elenca i fornitori: ID, Nome, Categoria, NomeContatto, Email, Telefono, RiferimentoFiscale, Saldo, LimiteCredito, righe indirizzo, Attivo e Modificato.… |
sage_accounting_za_get_supplier | Leggi un fornitore con ogni campo: nome, categoria, dettagli di contatto, riferimento fiscale, saldo, indirizzi, tipo di tassa predefinito, valuta e scadenza… |
sage_accounting_za_list_items | Elenca gli articoli (prodotti e servizi): ID, Codice, Descrizione, Categoria, PrezzoEsclusivo, PrezzoInclusivo, UltimoCosto, Unità, Fisico (articolo di magazzino… |
sage_accounting_za_get_item | Leggi un articolo con ogni campo: codice, descrizione, categoria, prezzi di vendita, ultimo costo, unità, tipi di tassa, gruppi di reporting e definiti dall'utente… |
sage_accounting_za_list_tax_invoices | Elenca le fatture fiscali (fatture di vendita): ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale… |
sage_accounting_za_get_tax_invoice | Leggi una fattura fiscale con le sue righe: numero documento, date, cliente, indirizzi, sconto, Esclusivo, Tassa, Totale, ImportoDovuto e per riga… |
sage_accounting_za_list_quotes | Elenca i preventivi: ID, NumeroDocumento, Data, DataScadenza, CustomerId, NomeCliente, Riferimento, Esclusivo, Tassa, Totale e Stato. Solo lettura, 100… |
sage_accounting_za_get_quote | Leggi un preventivo con le sue righe: numero documento, data, data di scadenza, cliente, sconto, totali, stato e per riga l'articolo o conto… |
sage_accounting_za_list_supplier_invoices | Elenca le fatture fornitori (fatture di acquisto): ID, NumeroDocumento, Data, DataScadenza, SupplierId, NomeFornitore, Riferimento, Esclusivo, Tassa, Totale… |
sage_accounting_za_get_supplier_invoice | Leggi una fattura fornitore con le sue righe: numero documento, date, fornitore, riferimento, Esclusivo, Tassa, Totale, ImportoDovuto e per riga il… |
sage_accounting_za_list_accounts | Elenca i conti del libro mastro (piano dei conti senza conti di sistema): ID, Nome, Descrizione, Categoria (ID e Descrizione), Saldo… |
sage_accounting_za_list_account_categories | Elenca le categorie di conto (Vendite, Costo delle Vendite, Spese, Attività Correnti e così via): ID, Descrizione e Ordine. L'ID è la categoria… |
sage_accounting_za_list_tax_types | Elenca i tipi di tassa (IVA) dell'azienda: ID, Nome, Percentuale, ÈPredefinito e Attivo. L'ID è il TaxTypeId delle righe del documento, articoli e… |
sage_accounting_za_list_bank_accounts | Elenca i conti bancari e delle carte di credito: ID, Nome, NomeBanca, NumeroConto, NumeroFiliale, Categoria, Saldo, Predefinito, CurrencyId… |
sage_accounting_za_list_bank_transactions | Elenca le transazioni bancarie del libro cassa: ID, BankAccountId, Data, Tipo, Beneficiario, Descrizione, Riferimento, NumeroDocumento, Esclusivo, Tassa… |
sage_accounting_za_list_customer_receipts | Elenca le ricevute clienti (pagamenti ricevuti): ID, CustomerId, Data, NumeroDocumento, Riferimento, Descrizione, Totale, Sconto… |
sage_accounting_za_get_customer_ageing | Scadenza clienti (debitori) in dettaglio: per cliente i documenti in sospeso con data, numero documento, riferimento e l'importo in ciascuno… |
sage_accounting_za_get_supplier_ageing | Scadenza fornitori (creditori) in dettaglio: per fornitore i documenti in sospeso con data, numero documento, riferimento e l'importo in ciascuno… |
sage_accounting_za_list_outstanding_customer_documents | Elenca i documenti non pagati di un cliente (fatture fiscali, e con include_paid_invoices anche quelle pagate): tipo documento, numero, data… |
sage_accounting_za_get_profit_and_loss | Conto economico (income statement) per un intervallo di date: un albero di livelli di reporting (Vendite, Costo delle Vendite, Utile Lordo, Spese, Utile Netto)… |
sage_accounting_za_get_balance_sheet | Stato patrimoniale alla data: un albero di livelli di reporting (attività, passività, patrimonio netto) con Descrizione, NumeroConto, Categoria, Figli… |
sage_accounting_za_get_account_balances | Movimento per conto del libro mastro su un intervallo di date, come un bilancio di verifica: ID conto, Descrizione, CategoriaId, DescrizioneCategoria, Dare… |
sage_accounting_za_save_customer | Crea un cliente, o aggiorna uno quando viene fornito l'id. Restituisce il cliente salvato con il suo ID. Un Salva sostituisce l'intero record: per un aggiornamento… |
sage_accounting_za_save_supplier | Crea un fornitore, o aggiorna uno quando viene fornito l'id. Restituisce il fornitore salvato con il suo ID. Un Salva sostituisce l'intero record: per un aggiornamento… |
sage_accounting_za_save_item | Crea un articolo (prodotto o servizio), o aggiorna uno quando viene fornito l'id. Restituisce l'articolo salvato con il suo ID. Un Salva sostituisce l'intero record… |
sage_accounting_za_save_account | Crea un conto del libro mastro, o aggiorna uno quando viene fornito l'id. Restituisce il conto salvato con il suo ID. La categoria decide dove il conto… |
sage_accounting_za_calculate_quote | Calcola i totali di un preventivo senza salvarlo: restituisce il documento con Esclusivo, Tassa, Totale e Sconto per riga e per l'intero… |
sage_accounting_za_save_quote | Crea un preventivo per un cliente, o aggiorna uno quando viene fornito l'id. Restituisce il preventivo salvato con il suo ID, NumeroDocumento e totali. Controlla il… |
sage_accounting_za_calculate_tax_invoice | Calcola i totali di una fattura fiscale senza salvarla: restituisce il documento con Esclusivo, Tassa, Totale e Sconto per riga e per il… |
sage_accounting_za_save_tax_invoice | Crea una fattura fiscale (fattura di vendita) per un cliente, o aggiorna una quando viene fornito l'id. Restituisce la fattura salvata con il suo ID, NumeroDocumento… |
Esempi di richieste
- "Quali clienti ci devono soldi da più di 60 giorni?"
- "Mostra il conto economico per l'ultimo trimestre finanziario."
- "Anteprima di una fattura fiscale per Acme Trading: 10 ore di consulenza a R950, poi salvala."
- "Elenca le fatture fornitore di ottobre che sono ancora in sospeso."
- "Quali sono i saldi dei nostri conti bancari e le ultime transazioni?"
Prossimi passi
Questa guida ti è stata utile?