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 Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Siigo con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 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 + Microsoft Copilot
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 Microsoft Copilot
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.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Siigo. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
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.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?