In breve
Negozi SHOPLINE (myshopline.com) tramite l'API REST Admin: ordini, evasioni e tracciamento, transazioni e rimborsi, prodotti e varianti, clienti, località e livelli di inventario. Token di accesso per app private.
Configurazione guidata
Collega SHOPLINE a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega SHOPLINE 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 SHOPLINE
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 → SHOPLINE, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
SHOPLINE
Negozi SHOPLINE (myshopline.com) tramite l'API REST Admin: ordini, evasioni e tracciamento, transazioni e rimborsi, prodotti e varianti, clienti, località e livelli di inventario. Token di accesso per app private.
Configurazione
La configurazione richiede circa 5 minuti.
- Accedi all'Admin di SHOPLINE su
https://admin.myshopline.come apri App, poi Sviluppa App (in alto a destra), e crea un'app privata. - Assegna le autorizzazioni necessarie agli strumenti:
read_orders,write_orders,read_products,write_products,read_customers,read_inventory,write_inventory,read_location,read_assigned_fulfillment_ordersewrite_assigned_fulfillment_orders(le autorizzazioni di sola lettura sono sufficienti per gli strumenti di lettura). - Apri il certificato API dell'app e copia il token di accesso in
SHOPLINE_ACCESS_TOKEN. Un token per app private è valido per 3 anni e può essere aggiornato lì; eliminare l'app lo revoca. - Inserisci il nome del negozio, la prima parte di
<handle>.myshopline.com, inSHOPLINE_HANDLE.
Da dove iniziare: shopline_list_orders con status qualsiasi (e fulfillment_status quando cerchi ordini spediti), poi shopline_list_order_fulfillments. Per i prodotti shopline_list_products, shopline_get_product e shopline_list_product_variants.
Ordini: shopline_list_orders, shopline_count_orders, shopline_update_order (tag, contatto, note, indirizzo di spedizione), shopline_list_order_transactions, shopline_list_order_refunds. L'id è l'id dell'ordine; name è il numero dell'ordine che il cliente vede (1001 e oltre, con un prefisso opzionale). Cancellare e rimborsare non sono inclusi, perché restituiscono denaro.
Spedizione: shopline_create_fulfillment spedisce un ordine con un numero di tracciamento, shopline_list_order_fulfillments elenca le spedizioni, shopline_update_fulfillment_tracking sostituisce l'elenco di tracciamento di una spedizione (invia tutte le voci, il resto viene cancellato).
Prodotti: shopline_list_products, shopline_get_product, shopline_count_products, shopline_update_product (lo stato attivo pubblica, la bozza nasconde), shopline_list_product_variants, shopline_update_variant (prezzo, prezzo di confronto, SKU, codice a barre). I tag vengono inseriti come elenco e tornano come stringa separata da virgole. I prodotti hanno fino a cinque opzioni per variante.
Clienti: shopline_list_customers, shopline_get_customer, shopline_search_customers, shopline_list_customer_orders.
Stock: ogni variante ha un inventory_item_id. shopline_list_locations, shopline_get_inventory_items, shopline_get_inventory_levels, poi shopline_set_inventory (assoluto) o shopline_adjust_inventory (delta).
Paging: le liste utilizzano un cursore. Quando c'è un'altra pagina, la risposta contiene _pagination.nextUrl; passa il suo valore page_info con lo stesso limite. _pagination è assente nell'ultima pagina.
Ids e formati: gli id sono stringhe di cifre lunghe (26 cifre): passali sempre come testo. I tempi sono in ISO 8601; i prezzi sono stringhe decimali nella valuta del negozio.
Limite di richiesta: 4 richieste al secondo per app e negozio, con picchi fino a 40 in coda; oltre a questo SHOPLINE risponde con 429 Troppe richieste. Le risposte sono limitate a 8 MB, quindi utilizza fields e limiti più piccoli per negozi grandi.
Prerequisiti: SHOPLINE_HANDLE, SHOPLINE_ACCESS_TOKEN
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 SHOPLINE e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
shopline_list_orders | Elenca gli ordini: id, nome (numero dell'ordine come 1001), order_at, financial_status, fulfillment_status, status, currency, current_total_price… |
shopline_count_orders | Conta gli ordini che corrispondono ai filtri (status, pagamento, spedizione, date): risponde con il conteggio. Solo lettura |
shopline_update_order | Modifica i tag di un ordine, l'email o il telefono dell'acquirente, le note del commerciante (note_attributes) o l'indirizzo di spedizione. Solo i campi forniti vengono inviati; tag… |
shopline_list_order_fulfillments | Elenca le evasioni (spedizioni) di un ordine: id, status, tracking_company, tracking_number, tracking_url, line_items e created_at |
shopline_create_fulfillment | Spedisci un ordine (tutto o solo gli articoli specificati) con un numero di tracciamento e un corriere. notify_customer invia l'email di spedizione. Risponde… |
shopline_update_fulfillment_tracking | Sostituisci le informazioni di tracciamento di un'evasione. L'elenco sostituisce ciò che è memorizzato: le voci di tracciamento escluse vengono rimosse |
shopline_list_order_transactions | Elenca le transazioni di pagamento di un ordine: id, tipo (vendita, rimborso e così via), status, importo, valuta, gateway e processed_at. Solo lettura |
shopline_list_order_refunds | Elenca i rimborsi di un ordine: id, created_at, note, refund_line_items e transazioni con importi. Solo lettura |
shopline_list_products | Elenca i prodotti: id, titolo, handle, status (attivo, bozza, archiviato), fornitore, tag, product_category, created_at, updated_at, opzioni e… |
shopline_get_product | Leggi un prodotto: titolo, body_html, status, fornitore, tag, handle, opzioni, immagini, media e varianti con prezzo, sku, codice a barre, peso… |
shopline_count_products | Conta i prodotti che corrispondono ai filtri (status, collezione, date): risponde con il conteggio. Solo lettura |
shopline_update_product | Modifica un prodotto: titolo, sottotitolo, descrizione (body_html), status (attivo pubblica, bozza nasconde, archiviato archivia), fornitore, tag… |
shopline_list_product_variants | Elenca le varianti di un prodotto: id, sku, codice a barre, prezzo, compare_at_price, option1 a option5, peso, inventory_quantity, inventory_policy… |
shopline_update_variant | Modifica una variante: prezzo e compare_at_price (stringhe decimali nella valuta del negozio), sku, codice a barre, peso con weight_unit… |
shopline_list_customers | Elenca i clienti: id, email, telefono, nome, cognome, stato, tag, orders_count, total_spent, accepts_marketing, indirizzi e… |
shopline_get_customer | Leggi un cliente: email, telefono, nomi, stato, tag, note, orders_count, total_spent, consenso al marketing e indirizzi |
shopline_search_customers | Cerca clienti per nome, email, telefono o testo dell'indirizzo (query_param), o per criteri esatti come tag o orders_count (query). Stessa… |
shopline_list_customer_orders | Elenca gli ordini di un cliente, con gli stessi campi d'ordine di shopline_list_orders. Fino a 100 per pagina |
shopline_list_locations | Elenca le località di inventario (magazzini e negozi): id, nome, indirizzo, attivo e se è la località predefinita |
shopline_get_inventory_items | Leggi gli articoli di inventario (uno per variante): id, sku, tracciato, costo e paese di origine. L'inventory_item_id è su ogni variante |
shopline_get_inventory_levels | Leggi lo stock disponibile per articolo di inventario e località: inventory_item_id, location_id, disponibile e updated_at |
shopline_set_inventory | Imposta lo stock disponibile di un articolo di inventario in una località a un numero assoluto (sostituisce la quantità attuale) |
shopline_adjust_inventory | Modifica lo stock disponibile di un articolo di inventario in una località di un delta: positivo aggiunge, negativo rimuove |
Esempi di richieste
- "Quanti ordini SHOPLINE sono arrivati questa settimana e quanti sono non evasi?"
- "Aggiungi il tracciamento DHL 1234567890 all'evasione dell'ordine #1052."
- "Quali varianti hanno meno di 5 unità nella nostra località principale?"
- "Mostra tutti gli ordini del cliente Anna Berg."
- "Quali ordini sono stati rimborsati il mese scorso e per quanto?"
Prossimi passi
Questa guida ti è stata utile?