In breve
API Siigo per Siigo Nube, il software colombiano di contabilità e fatturazione elettronica: clienti e fornitori, prodotti, fatture di vendita con il loro stato DIAN, preventivi, note di credito, ricevute di cassa e di pagamento, voucher contabili, cataloghi (tipi di documento, tasse, metodi di pagamento, centri di costo, utenti, magazzini), bilancio di verifica e conti da pagare. Nome utente e chiave di accesso.
Configurazione guidata
Collega Siigo a ChatGPT in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Siigo con la configurazione guidata e aggiungi il tuo URL MCP a ChatGPT. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Il plugin AnythingMCP nella directory di ChatGPT risponde, su AnythingMCP Cloud, a domande sui database aziendali (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, in sola lettura): apri la scheda (si apre in una nuova scheda) e clicca Install plugin. Tutti gli altri connettori si aggiungono a ChatGPT come server MCP personalizzato con l'URL MCP del tuo AnythingMCP.
Prova a chiedere
Prompt di esempio per Siigo
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 Connectors → Siigo, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Siigo + ChatGPT
API Siigo per Siigo Nube, il software colombiano di contabilità e fatturazione elettronica: clienti e fornitori, prodotti, fatture di vendita con il loro stato DIAN, preventivi, note di credito, ricevute di cassa e di pagamento, voucher contabili, cataloghi (tipi di documento, tasse, metodi di pagamento, centri di costo, utenti, magazzini), bilancio di verifica e conti da pagare. Nome utente e chiave di accesso.
Requisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
SIIGO_USERNAME, SIIGO_ACCESS_KEY
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- Accedi a Siigo Nube come amministratore e apri Alianzas nel menu a sinistra, poi Mi Credencial API.
- Genera la credenziale e copia il nome utente in
SIIGO_USERNAMEe la chiave di accesso inSIIGO_ACCESS_KEY.
Il connettore accede a POST /auth con entrambi i valori, riceve un token che dura 24 ore e lo rinnova autonomamente. Ogni chiamata porta l'intestazione Partner-Id: AnythingMCP, che Siigo richiede per identificare l'applicazione integrata.
Dove iniziare: siigo_list_document_types (i tipi di fattura dell'azienda), siigo_list_users (venditori), siigo_list_payment_types e siigo_list_taxes: i loro id sono necessari per creare documenti. siigo_list_invoices con un cliente o un intervallo di date risponde alla maggior parte delle domande di vendita.
Cataloghi: siigo_list_document_types, siigo_list_taxes, siigo_list_payment_types, siigo_list_cost_centers, siigo_list_users, siigo_list_warehouses, siigo_list_account_groups. Cambiano raramente: leggili una volta per conversazione.
Terze parti e prodotti: siigo_list_customers (filtra per identification), siigo_get_customer, siigo_create_customer; siigo_list_products (filtra per code), siigo_get_product, siigo_create_product.
Fatture di vendita: siigo_list_invoices, siigo_get_invoice, siigo_create_invoice, siigo_get_invoice_stamp_errors, siigo_send_invoice_email. siigo_create_invoice salva la fattura senza inviarla al DIAN a meno che send_to_dian non sia true; una fattura accettata dal DIAN ha un cufe e non può più essere annullata o eliminata, solo corretta con una nota di credito. siigo_annul_invoice e siigo_delete_invoice sono installati disattivati. L'public_url di una fattura è la vista stampabile da condividere; il connettore non restituisce file PDF.
Altri documenti (solo lettura): siigo_list_quotations, siigo_get_quotation, siigo_list_credit_notes, siigo_get_credit_note, siigo_list_vouchers e siigo_get_voucher (ricevute di cassa: denaro ricevuto), siigo_list_payment_receipts (denaro pagato ai fornitori), siigo_list_journals. Il connettore non crea ricevute, note di credito o voucher contabili e non muove denaro.
Report: siigo_generate_trial_balance e siigo_generate_trial_balance_by_third_party restituiscono un link a un file Excel, non cifre. siigo_list_accounts_payable restituisce i debiti aperti dei fornitori in formato JSON.
Paging: le liste restituiscono results, pagination (page, page_size, total_results) e _links. Richiedi la page successiva finché ci sono righe; page_size arriva fino a 100.
Formati: le date sono yyyy-MM-dd; i filtri creati e aggiornati accettano anche date-ora UTC. Gli id dei documenti sono GUID, gli id dei cataloghi sono numeri. Un cliente è identificato nei documenti da identification e branch_office, un prodotto da code. Gli importi sono numeri nella valuta locale (COP) a meno che il documento non abbia una currency.
Errori sono Status e Errors con Code, Message e Params: parameter_required e invalid_reference indicano il campo o l'id che non esiste, invalid_total_payments significa che i pagamenti non sommano al totale, already_exists un codice o un'identificazione duplicati, unauthorized una credenziale errata o bloccata.
Limiti: 100 chiamate al minuto per azienda (requests_limit). Siigo blocca un utente API le cui chiamate sono state più del 80 % errori per 7 giorni, quindi non indovinare id o codici: leggili prima dai cataloghi.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in ChatGPT
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
ChatGPT aggiunge i server MCP come plugin dalla pagina Plugins, sul web e nei piani a pagamento. La modalità sviluppatore non serve più. In un workspace Business possono farlo solo admin e owner; in Enterprise ed Edu un amministratore può concedere il permesso Create plugins with MCPs.
- Vai su chatgpt.com/plugins, clicca Add e poi Add custom MCP server.
- Inserisci un nome, ad esempio Name:
Siigo. - In Connection inserisci come Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDe lascia Authentication su OAuth. - Seleziona I understand and want to continue, poi Create as a plugin. Quando ChatGPT lo chiede, accedi ad AnythingMCP e consenti l'accesso.
- Installa il nuovo plugin dai tuoi plugin personali, poi digita @ in una chat e selezionalo.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
siigo_list_document_types | Elenca i tipi di documento (comprobantes) configurati in Siigo per un tipo di documento: id, codice, nome, descrizione, se è elettronico… |
siigo_list_taxes | Elenca le tasse configurate in Siigo: id, nome, tipo (IVA, Retefuente, ReteIVA, ReteICA, Impoconsumo, AdValorem, Autorretencion), percentuale… |
siigo_list_payment_types | Elenca i metodi di pagamento (formas de pago) utilizzabili su un tipo di documento: id, nome, tipo (Cartera, Proveedor, CarteraProveedor), attivo e… |
siigo_list_cost_centers | Elenca i centri di costo (centros de costo): id, codice, nome e attivo. Alcuni tipi di documento richiedono uno su ogni fattura. Solo lettura |
siigo_list_users | Elenca gli utenti Siigo dell'azienda: id, nome utente, nome, cognome, email, identificazione e attivo. L'id di un utente è il… |
siigo_list_warehouses | Elenca i magazzini (bodegas) utilizzati per l'inventario: id, nome, attivo e has_movements. Solo lettura |
siigo_list_account_groups | Elenca le classificazioni di inventario (grupos de inventario): id, nome e attivo. Un nuovo prodotto ha bisogno dell'id di uno come account_group.… |
siigo_list_customers | Elenca clienti e altre terze parti (clientes, proveedores, terceros): id, tipo, person_type, id_type, identificazione, check_digit… |
siigo_get_customer | Leggi una terza parte in modo completo: identificazione e tipo, nomi, responsabilità IVA e responsabilità fiscali, indirizzo con paese, stato… |
siigo_create_customer | Crea una terza parte (cliente, fornitore o altro) in Siigo e restituiscila con il suo id. Cercala prima con siigo_list_customers per… |
siigo_list_products | Elenca prodotti e servizi, i più recenti per primi: id, codice, nome, account_group, tipo (Prodotto, Servizio, Bene di Consumo), controllo_stock, attivo… |
siigo_get_product | Leggi un prodotto o servizio in modo completo: codice, nome, classificazione, tipo, tasse, prezzi, unità, descrizione, campi aggiuntivi (codice a barre, marca… |
siigo_create_product | Crea un prodotto o servizio in Siigo e restituiscilo con il suo id. Il codice deve essere unico; account_group è l'id di un inventario… |
siigo_list_invoices | Elenca fatture di vendita (facturas de venta): id, tipo di documento, numero, nome (ad esempio FV-2-22), data, cliente, centro di costo, totale, saldo… |
siigo_get_invoice | Leggi una fattura di vendita in modo completo: numero e nome, data, cliente, venditore, centro di costo, valuta, ogni articolo con quantità, prezzo, sconto… |
siigo_create_invoice | Crea una fattura di vendita in Siigo per un cliente esistente e restituiscila con il suo id, numero, totale e public_url. Per impostazione predefinita, la fattura è… |
siigo_get_invoice_stamp_errors | Leggi perché il DIAN ha rifiutato una fattura elettronica: errors con il messaggio di ciascun rifiuto. Usalo quando lo stato del timbro di una fattura… |
siigo_send_invoice_email | Invia una fattura di vendita esistente a un massimo di 5 indirizzi. Restituisce status inviato quando Siigo ha accettato la richiesta. Conferma i destinatari con il… |
siigo_annul_invoice | Annulla (anular) una fattura di vendita. Siigo rifiuta fatture già inviate o accettate dal DIAN (con un CUFE) e fatture con documenti correlati… |
siigo_delete_invoice | Elimina permanentemente una fattura di vendita. Siigo rifiuta fatture inviate o accettate dal DIAN e fatture con documenti correlati. Questo non può… |
siigo_list_quotations | Elenca preventivi (cotizaciones): id, numero, nome (ad esempio C-1-22), data, cliente, totale, venditore, articoli e public_url. Filtra per nome… |
siigo_get_quotation | Leggi un preventivo in modo completo: numero, nome, data, cliente, venditore, articoli con quantità, prezzi e tasse, totale e public_url. Solo lettura |
siigo_list_credit_notes | Elenca note di credito (notas credito): id, tipo di documento, numero, nome, data, la fattura che ciascuna corregge, cliente, totale, timbro DIAN, articoli… |
siigo_get_credit_note | Leggi una nota di credito in modo completo: numero, data, la fattura che corregge, cliente, motivo, articoli, pagamenti, totale e il timbro DIAN. Solo lettura |
siigo_list_vouchers | Elenca ricevute di cassa (recibos de caja), il registro di denaro ricevuto dai clienti: id, tipo di documento, numero, nome, data, tipo, cliente… |
siigo_get_voucher | Leggi una ricevuta di cassa (recibo de caja) in modo completo: numero, data, cliente, le fatture dovute che paga con i loro valori, metodo di pagamento, costo… |
siigo_list_payment_receipts | Elenca ricevute di pagamento (recibos de pago o egreso), il registro di denaro pagato ai fornitori: id, tipo di documento, numero, nome, data, fornitore… |
siigo_list_journals | Elenca voucher contabili (comprobantes contabili): id, tipo di documento, numero, nome, data e gli articoli di debito e credito con conto, terzo… |
siigo_generate_trial_balance | Genera il bilancio di verifica generale (balance de prueba) di un anno per un intervallo di mesi e conti. Siigo crea un file Excel e restituisce… |
siigo_generate_trial_balance_by_third_party | Genera il bilancio di verifica per terza parte (balance de prueba por tercero) per un intervallo di mesi e conti, per tutte le terze parti o una.… |
siigo_list_accounts_payable | Elenca conti da pagare (cuentas por pagar): una riga per ogni importo dovuto aperto con due (prefisso, consecutivo, preventivo, data, saldo in locale… |
Esempi di prompt
- "Elenca le fatture di vendita al cliente NIT 900123456 di ottobre con il loro stato DIAN."
- "Perché la fattura FV-1-2045 è stata rifiutata dal DIAN?"
- "Crea una bozza di fattura per Comercial Andina: 3 unità del prodotto CAF-500 al prezzo di listino."
- "Quali debiti dei fornitori sono aperti in questo momento?"
- "Genera il bilancio di verifica per settembre."
FAQ
Da dove provengono le credenziali? Accedi a Siigo Nube come amministratore, apri Alianzas nel menu a sinistra, poi Mi Credencial API, e genera la credenziale: il nome utente va in SIIGO_USERNAME, la chiave di accesso in SIIGO_ACCESS_KEY. Il connettore accede con entrambi e rinnova il suo token di 24 ore autonomamente.
Cosa copre? Clienti e fornitori, prodotti, fatture di vendita con il loro stato DIAN e errori di timbro, invio di fatture via e-mail, preventivi, note di credito, ricevute di cassa e di pagamento, voucher contabili, i cataloghi di cui ha bisogno un documento, il bilancio di verifica (come link a un file Excel) e conti da pagare. Le note di credito, le ricevute e i voucher contabili sono solo in lettura, e nessuno strumento muove denaro.
Quali strumenti sono installati disattivati? siigo_annul_invoice e siigo_delete_invoice. Attivali nella pagina del connettore solo se l'AI deve usarli. Una fattura viene inviata al DIAN solo quando send_to_dian è true; una volta accettata può essere corretta solo con una nota di credito.
Il piano free di ChatGPT funziona con i server MCP personalizzati? OpenAI documenta i server MCP personalizzati solo per i piani a pagamento; il piano Free non è nell'elenco.
Prossimi passi
Questa guida ti è stata utile?