In breve
Siigo API 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 pagamento, giustificativi 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 Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Siigo 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 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 Connettori → Siigo, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Siigo
Siigo API 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 pagamento, giustificativi 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
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 automaticamente. 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.
Terzi 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 sia vero; 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 giustificativi contabili e non movimenta 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 verso i fornitori in formato JSON.
Paging: le liste restituiscono results, pagination (page, page_size, total_results) e _links. Richiedi la page successiva mentre rimangono 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 hanno superato l'80 % di errori in 7 giorni, quindi non indovinare id o codici: leggili prima dai cataloghi.
Prerequisiti: SIIGO_USERNAME, SIIGO_ACCESS_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 Siigo e incolla le variabili d'ambiente elencate sotto Prerequisiti.
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 altri terzi (clientes, proveedores, terceros): id, tipo, person_type, id_type, identificazione, check_digit… |
siigo_get_customer | Leggi un terzo in dettaglio: identificazione e tipo, nomi, responsabilità IVA e responsabilità fiscali, indirizzo con paese, stato… |
siigo_create_customer | Crea un terzo (cliente, fornitore o altro) in Siigo e restituiscilo con il suo id. Cercalo prima con siigo_list_customers per… |
siigo_list_products | Elenca prodotti e servizi, i più recenti per primi: id, codice, nome, account_group, tipo (Product, Service, ConsumerGood), stock_control, attivo… |
siigo_get_product | Leggi un prodotto o servizio in dettaglio: codice, nome, classificazione, tipo, tasse, prezzi, unità, descrizione, campi aggiuntivi (barcode, 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 (come FV-2-22), data, cliente, cost_center, totale, saldo… |
siigo_get_invoice | Leggi una fattura di vendita in dettaglio: 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 (come C-1-22), data, cliente, totale, venditore, articoli e public_url. Filtra per nome… |
siigo_get_quotation | Leggi un preventivo in dettaglio: 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 dettaglio: 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 dettaglio: numero, data, cliente, le fatture scadute 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 giustificativi contabili (comprobantes contabili): id, tipo di documento, numero, nome, data e gli elementi 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 terzo (balance de prueba por tercero) per un intervallo di mesi e conti, per tutti i terzi o uno.… |
siigo_list_accounts_payable | Elenca conti da pagare (cuentas por pagar): una riga per ogni importo scaduto con due (prefisso, consecutivo, preventivo, data, saldo in locale… |
Esempi di richieste
- "Elenca le fatture di vendita per il 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 verso i fornitori sono aperti in questo momento?"
- "Genera il bilancio di verifica per settembre."
Prossimi passi
Questa guida ti è stata utile?