Cin7 Core MCP: magazzino, vendite e acquisti

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → Cin7 Core, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Cin7 Core

Cin7 Core (precedentemente DEAR Inventory) tramite External API v2: prodotti e disponibilità di magazzino per posizione, vendite con ordini, evasioni, fatture e pagamenti (solo lettura), acquisti, clienti, fornitori, aggiustamenti di magazzino e trasferimenti. Crea vendite, acquisti, clienti, fornitori e trasferimenti. ID account e chiave dell'applicazione.

Configurazione

La configurazione richiede circa 2 minuti. Hai bisogno di un account Cin7 Core (precedentemente DEAR Inventory; accedi su inventory.dearsystems.com) con accesso a Integrazioni → API. Il connettore ha bisogno dell'ID account e di una chiave dell'applicazione.

Core o Omni? Cin7 vende due prodotti diversi. Cin7 Core (questo connettore, precedentemente DEAR Systems) utilizza un ID account e una chiave dell'applicazione. Cin7 Omni (il Cin7 originale, go.cin7.com) ha una API v1 separata con un nome utente e una chiave API: usa il connettore Cin7 Omni per questo. Le credenziali di uno non funzionano sull'altro.

1. In Cin7 Core apri la pagina di configurazione API, Integrazioni → API (inventory.dearsystems.com/ExternalAPI).
2. Clicca su + per aggiungere un'applicazione API e dai un nome.
3. Copia l'ID account (un GUID) in CIN7_CORE_ACCOUNT_ID e la chiave dell'applicazione in CIN7_CORE_APPLICATION_KEY.
4. Installa il connettore. Esegui cin7_core_get_me per controllare la connessione: restituisce il nome dell'azienda, la valuta di base e il fuso orario dell'account.

Cloud e self-hosted funzionano allo stesso modo: le credenziali sono le stesse e non c'è un URL di reindirizzamento da impostare. Il connettore le invia negli header api-auth-accountid e api-auth-applicationkey. Eliminare l'applicazione API in Cin7 Core revoca la chiave.

Da dove iniziare: cin7_core_get_me per la valuta di base, cin7_core_list_locations per i nomi delle posizioni, poi cin7_core_list_sales e cin7_core_get_product_availability, che rispondono alla maggior parte delle domande.

Cosa legge: prodotti con livelli di prezzo, disponibilità di magazzino per prodotto e posizione (disponibile, allocato, disponibile, in ordine); vendite con il loro preventivo, ordine, evasioni (prelievo, imballaggio e spedizione, con corriere e tracciamento), fatture e pagamenti; acquisti con il loro ordine; clienti, fornitori, regole fiscali e termini di pagamento; aggiustamenti di magazzino e trasferimenti di magazzino.

Creare una vendita richiede due chiamate: cin7_core_create_sale crea l'intestazione (cliente, posizione) e restituisce il suo ID, poi cin7_core_create_sale_order aggiunge le righe. Le righe necessitano di Nome, Quantità, Prezzo, Tassa e RegolaTassa più SKU o ProductID. L'AI mantiene l'ordine in BOZZA a meno che tu non voglia che sia autorizzato: AUTORIZZATO allocca il magazzino, riordina una carenza senza preavviso e blocca l'ordine contro ulteriori modifiche API. Gli acquisti funzionano allo stesso modo, con cin7_core_create_purchase e cin7_core_create_purchase_order.

Altri scritti: cin7_core_create_customer, cin7_core_update_customer e cin7_core_create_supplier (hanno bisogno di nomi di termini di pagamento e regole fiscali e codici conto, che cin7_core_list_payment_terms e cin7_core_list_tax_rules elencano), e cin7_core_create_stock_transfer (BOZZA per impostazione predefinita). Tutti questi sono attivati.

Disattivato all'installazione: cin7_core_create_stock_adjustment (crea un aggiustamento di magazzino). Un aggiustamento COMPLETATO registra i movimenti di magazzino e le voci contabili in una sola volta, e le sue quantità sono i nuovi valori disponibili, non le differenze. Attivalo nella pagina del connettore se l'AI deve usarlo; l'AI ti chiede di confermare ogni modifica.

Niente soldi e niente cancellazioni: il connettore non registra, modifica o cancella mai pagamenti, fatture o note di credito, e non ha strumenti di cancellazione o annullamento.

Identificatori: i record utilizzano GUID (ID, SaleID, TaskID). Le posizioni, le regole fiscali, i termini di pagamento e i livelli di prezzo sono referenziati per nome.

Paging: le liste prendono page (da 1) e limit (predefinito 100, al massimo 1.000); la risposta riporta Total. updated_since o modified_since restituiscono solo ciò che è cambiato. Le date sono in UTC, yyyy-MM-ddTHH:mm:ss.

Limite di chiamate: 60 chiamate al minuto per applicazione API; oltre a questo, Cin7 Core risponde 429 (account più vecchi 503). Pagine e filtri grandi utilizzano meglio il budget rispetto a molte piccole chiamate.

Errori comuni: una chiamata rifiutata risponde 400 con [{"ErrorCode": 400, "Exception": "..."}] che nomina il problema, come un cliente, una posizione o una regola fiscale sconosciuti, o un documento già autorizzato. 403 significa un ID account o una chiave dell'applicazione errati.

Prerequisiti: CIN7_CORE_ACCOUNT_ID, CIN7_CORE_APPLICATION_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 Cin7 Core e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

Esempi di richieste

• "Quante unità di SKU MUG-WHT-350 sono disponibili in ciascuna posizione?"
• "Elenca le vendite di questo mese che sono autorizzate ma non completamente evase."
• "Mostra l'evasione dell'ordine SO-1042 con il suo corriere e numero di tracciamento."
• "Quali acquisti stanno ancora aspettando di ricevere merce?"
• "Crea una vendita in bozza per il cliente Coffee Corner presso il Magazzino Principale con 24 unità di MUG-WHT-350 a 6.50."

Prossimi passi

• Collegati a Claude
• Collegati a ChatGPT