Guida al connettore13 minuti di lettura38 tool MCP7 lingue

Åhléns MCP Server: ordini, offerte e spedizioni

Gestisci il tuo negozio sul marketplace di Åhléns da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e magazzino, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

HCA cura del team HelpCodeAggiornato 13 min di lettura Open source su GitHub

Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile

Åhléns Marketplace

Åhléns Marketplace

Run your shop on the Åhléns marketplace from an AI agent: orders, acceptance, tracking and shipping, incidents, offers with prices and stock, imports, messages, returns, invoices and transactions. The marketplace sells in Sweden; sign in with the shop API key from your Åhléns seller back office.

tool

38

Regione

SE

Categoria

E-commerce

Autenticazione

API Key

Env vars richieste

AHLENS_API_KEY
Installa con un clic su Cloud

7 giorni di prova gratuita · Nessuna carta di credito

  • Prova gratuita di 7 giorni
    Nessuna carta di credito
  • GDPR & SOC 2 ready
    Dati in UE, log di audit
  • Open source su GitHub
    Open source · AGPL-3.0
  • Funziona con ChatGPT, Claude, Gemini
    Qualsiasi client compatibile MCP

In breve

Gestisci il tuo negozio sul marketplace di Åhléns da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e magazzino, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Configurazione guidata

Collega Åhléns Marketplace a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Åhléns Marketplace 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 Åhléns Marketplace

Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.

Åhléns Marketplace · live via MCP
Condividi
Opus 4.7

Claude è un'AI e può sbagliare. Verifica sempre le risposte.

💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → Åhléns Marketplace, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente git clone, niente server locale.

Åhléns Marketplace

Gestisci il tuo negozio sul marketplace di Åhléns da un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e magazzino, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Configurazione

Paesi: Svezia.

Chi può vendere: Åhléns seleziona i suoi venditori: scrivi al suo team marketplace con una breve descrizione del tuo marchio e un link al tuo sito web. Gli ordini devono essere spediti entro sei giorni, le immagini dei prodotti devono essere quadrate e le descrizioni devono essere in svedese. Åhléns addebita una quota mensile e una commissione per ogni vendita. Il connettore necessita di un account venditore che Åhléns ha già aperto.

L'indirizzo venditore di questo connettore è quello che la piattaforma assegna a questo rivenditore; nessuna guida venditore lo nomina ancora. Se il tuo back office venditore si apre a un indirizzo diverso, faccelo sapere in chat così possiamo correggerlo.

La configurazione richiede circa 5 minuti.

  1. Accedi al back office venditore di Åhléns: https://ahlens-prod.mirakl.net/login.
  2. Nel back office apri il tuo nome utente (in alto a destra) > Le mie impostazioni utente > Chiave API e clicca su Genera una nuova chiave (o copia la chiave esistente). Incollala in AHLENS_API_KEY. La chiave viene inviata così com'è nell'intestazione Authorization, senza Bearer. Generare una nuova chiave invalida quella precedente, quindi qualsiasi altro strumento che la utilizza smette di funzionare.
  3. Lascia AHLENS_SHOP_ID vuoto. Solo se il tuo utente gestisce più negozi su Åhléns, imposta AHLENS_SHOP_ID all'id numerico del negozio su cui questo connettore dovrebbe funzionare (mostrato sulla dashboard del back office accanto a Identifier o Shop ID, e restituito come shop_id da ahlens_get_account). Senza di esso, viene utilizzato il tuo negozio predefinito.
  4. Installa ed esegui ahlens_get_account: restituisce il negozio a cui appartiene la chiave.

Da dove iniziare: ahlens_get_account mostra il negozio dietro la chiave (id, nome, stato, valuta e canali). Per il lavoro quotidiano utilizza ahlens_list_orders con order_state_codes=WAITING_ACCEPTANCE, ahlens_list_offers per prezzi e magazzino e ahlens_list_threads per messaggi che aspettano una risposta.

Prodotti e offerte concorrenti: ahlens_get_products cerca i prodotti nel catalogo di Åhléns tramite EAN o un altro riferimento e restituisce lo SKU del prodotto marketplace; ahlens_list_product_offers elenca le offerte di ogni negozio per i prodotti dati, il miglior prezzo per primo, con circa 5 chiamate al minuto.

Flusso di lavoro degli ordini: un nuovo ordine attende in WAITING_ACCEPTANCE. ahlens_accept_order accetta (o rifiuta) ogni riga; dopo che il cliente è stato addebitato, l'ordine passa a SHIPPING. Poi ahlens_update_tracking memorizza il corriere e il numero di tracciamento (i codici dei corrieri provengono da ahlens_list_carriers) e ahlens_ship_order conferma la spedizione (SHIPPED). Gli stati successivi sono TO_COLLECT, RECEIVED, CLOSED, REFUSED e CANCELED. Usa ahlens_list_orders con order_state_codes=WAITING_ACCEPTANCE per la lista delle cose da fare quotidiane e has_incident=true per incidenti aperti; ahlens_resolve_incident chiude un incidente su una riga d'ordine una volta risolto. I documenti allegati agli ordini (note di consegna, etichette, fatture clienti) sono elencati da ahlens_list_order_documents.

Scritture: conferma prima. ahlens_accept_order, ahlens_update_tracking, ahlens_ship_order, ahlens_resolve_incident, ahlens_accept_return, ahlens_receive_return, ahlens_update_offers, ahlens_reply_thread, ahlens_create_order_thread e ahlens_import_products agiscono sul marketplace live. Prima di ogni chiamata, mostra all'utente cosa cambierà (id e righe dell'ordine, numero di tracciamento, SKU dell'offerta con il vecchio e il nuovo prezzo o magazzino, il testo del messaggio e i destinatari) e aspetta un sì. Rifiutare una riga d'ordine la annulla definitivamente. Nessuno strumento qui rimborsa, annulla ordini o sposta denaro; fallo nel back office. ahlens_import_offers può eliminare offerte (la modalità REPLACE elimina ogni offerta mancante dal file), quindi è installato spento.

Aggiornamento delle offerte (prezzi e magazzino): ahlens_update_offers (OF24) sostituisce l'intera offerta. Ogni campo che lasci fuori viene ripristinato: una quantity mancante diventa 0, uno sconto o una descrizione mancanti vengono eliminati. Leggi sempre prima l'offerta (ahlens_get_offer o ahlens_list_offers con sku) e rimandala completa con solo la modifica prevista: shop_sku, product_id e product_id_type (da product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (il suo codice), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leggi come available_start_date / available_end_date) e qualsiasi offer_additional_fields. Lascia update_delete vuoto o update. La chiamata restituisce un import_id; la modifica viene applicata in modo asincrono, quindi controllala con ahlens_get_offer_import prima di leggere di nuovo l'offerta. I codici di condizione per state_code provengono da ahlens_list_offer_conditions, i codici della classe logistica da ahlens_list_logistic_classes.

Importazioni di file: ahlens_import_products (P41) e ahlens_import_offers (OF01) prendono l'URL di un file CSV, XLSX o XML nel formato di file richiesto da Åhléns; il connettore lo scarica e lo carica su Åhléns. Tracciali con ahlens_list_product_imports / ahlens_get_product_import e ahlens_list_offer_imports / ahlens_get_offer_import.

Resi: ahlens_list_returns (RT11) elenca le richieste di reso. Dove Åhléns lascia decidere al negozio, ahlens_accept_return accetta o rifiuta una in WAITING_ACCEPTANCE e ahlens_receive_return conferma che la merce è arrivata. I rimborsi rimangono nel back office.

Messaggi: ahlens_list_threads elenca le conversazioni (filtra con entity_type=MMP_ORDER e entity_id=<order id> per un ordine; entity_id senza entity_type viene rifiutato), ahlens_get_thread legge una con i suoi messaggi, ahlens_reply_thread risponde (destinatario CUSTOMER o OPERATOR, che è Åhléns) e ahlens_create_order_thread apre una nuova conversazione su un ordine. I codici di motivo per gli argomenti provengono da ahlens_list_reasons; lascia il suo locale vuoto a meno che tu non sappia che il marketplace ha quella lingua (un locale inattivo risponde 400).

Denaro: ahlens_list_invoices (IV01) elenca i documenti contabili che Åhléns emette al negozio e ahlens_list_transactions (TL02) le righe delle transazioni (vendite, commissioni, rimborsi, pagamenti). Se Åhléns utilizza la Fatturazione Venditore Avanzata, IV01 non restituisce nuovi documenti; usa ahlens_list_document_requests (DR11) e le transazioni poi.

Intero catalogo: per leggere ogni offerta (un controllo di magazzino o prezzo attraverso il catalogo, contando le offerte), avvia un'esportazione con ahlens_export_offers, interroga ahlens_get_offer_export_status circa una volta al minuto fino a quando non è COMPLETED, e leggi i file uno per uno con ahlens_get_offer_export_file; include_fields mantiene solo le colonne di cui hai bisogno. Un'esportazione completa è consentita una volta al giorno; per ciò che è cambiato da allora, passa last_request_date (un'esportazione differenziale, al massimo una volta al minuto). Non sfogliare ogni offerta con ahlens_list_offers: è destinato a poche offerte alla volta e risponde 429 quando viene sfogliato un grande catalogo.

Più negozi: ogni strumento prende un shop_id opzionale. Un utente che gestisce più negozi su questo marketplace (un'agenzia, o un negozio per paese) può lavorare su tutti con una sola installazione: passa l'id del negozio in ogni chiamata e controlla quale negozio è con ahlens_get_account e lo stesso shop_id. Senza shop_id, una chiamata utilizza AHLENS_SHOP_ID, o il negozio predefinito dell'utente quando questo è vuoto. Chiedi all'utente gli id dei loro negozi; il back office li mostra.

Liste di riferimento: ahlens_list_channels (siti nazionali), ahlens_list_carriers, ahlens_list_shipping_zones, ahlens_list_shipping_methods e ahlens_list_logistic_classes cambiano raramente; leggili una volta per conversazione.

Paginazione: ordini, offerte, fatture e importazioni di prodotti paginano con max (al massimo 100) e offset. Thread, resi, transazioni, richieste di documenti e importazioni di offerte restituiscono un next_page_token; passalo come page_token per ottenere la pagina successiva (tutti gli altri filtri vengono quindi ignorati) fino a quando non è mancante.

Date sono ISO 8601, ad esempio 2026-10-01T00:00:00Z; le risposte sono in UTC.

Limiti di frequenza: Ogni API ha il proprio limite e Åhléns può inasprirli. L'elenco di offerte e ordini è destinato a un uso interattivo, importazioni di prodotti e offerte al massimo ogni 15 minuti, ahlens_get_account e le liste di riferimento circa una volta al giorno. Un 429 porta un'intestazione Retry-After con i secondi da attendere; non riprovare in un ciclo.

Errori: 401 significa che la chiave è errata o è stata sostituita da una più recente, 403 che il tuo utente non ha il diritto per questa azione, 404 che l'ordine, l'offerta o il thread non esistono per questo negozio o che il marketplace non utilizza quella funzione, come i resi, 400 un parametro errato o un ordine nello stato sbagliato (il messaggio lo nomina, ad esempio ORDER_INVALID_STATE).

Prerequisiti: AHLENS_API_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 Åhléns Marketplace e incolla le variabili d'ambiente elencate sotto Prerequisiti.

Strumenti disponibili

StrumentoCosa fa
ahlens_get_accountLeggi il negozio dietro la chiave API su questo marketplace (A01): id e nome del negozio, stato, canali, valuta, grado e tasso di approvazione, contatto…
ahlens_list_ordersElenca gli ordini (OR11) con le loro righe, cliente, indirizzo di spedizione, prezzi, stato e incidenti. Filtra per stato (ad esempio WAITING_ACCEPTANCE per…
ahlens_list_offersElenca le offerte del negozio (OF21): SKU, prodotto, prezzo e sconto, tutti i prezzi dei canali, quantità in magazzino, condizione, tempo di consegna e se…
ahlens_get_offerLeggi un'offerta intera tramite il suo id offerta (OF22): ogni campo di prezzo, sconto, quantità, condizione, classe logistica, tempo di consegna e personal…
ahlens_list_offer_conditionsElenca le condizioni delle offerte (OF61) che il marketplace accetta, ad esempio nuovo o usato, con il codice da inserire in state_code quando si aggiornano le offerte
ahlens_list_offer_importsElenca le importazioni e aggiornamenti delle offerte (OF04), da file e da ahlens_update_offers: stato (WAITING, RUNNING, COMPLETE, FAILED), righe lette…
ahlens_get_offer_importLeggi lo stato di un'importazione di offerta o aggiornamento offerta (OF02) tramite il suo import_id, come restituito da ahlens_update_offers o ahlens_import_offers…
ahlens_export_offersAvvia un'esportazione di tutte le offerte del negozio come file (OF52), il modo per leggere l'intero catalogo (ogni SKU con prezzo e magazzino) invece di…
ahlens_get_offer_export_statusStato di un'esportazione di offerta avviata con ahlens_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code e error.detail), e…
ahlens_get_offer_export_fileLeggi un file di un'esportazione di offerta completata (OF54): le offerte con il loro SKU, prodotto, quantità, prezzi e gli altri campi esportati, come…
ahlens_list_product_importsElenca le importazioni di prodotti (P51) con il loro stato (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), i conteggi delle trasformazioni e il…
ahlens_get_product_importLeggi lo stato di un'importazione di prodotto (P42) tramite il suo import_id: stato di importazione, motivo, conteggi delle trasformazioni e i dettagli di integrazione…
ahlens_get_productsCerca prodotti nel catalogo del marketplace tramite i loro identificatori (P31), ad esempio EAN, e ottieni lo SKU del prodotto marketplace, titolo e categoria.…
ahlens_list_product_offersElenca le offerte di ogni negozio per prodotti dati (P11), ordinati per miglior prezzo, per confrontare il tuo prezzo con la concorrenza. Fornisci product_ids…
ahlens_list_threadsElenca i thread di messaggi (M11) con clienti e Åhléns: argomento, ordine o offerta collegata, partecipanti, data dell'ultimo messaggio e da quando un negozio…
ahlens_get_threadLeggi un thread di messaggi (M10) con tutti i suoi messaggi, mittenti, destinatari, allegati e l'ordine o offerta collegata
ahlens_list_returnsElenca le richieste di reso (RT11) con il loro stato, righe di reso, motivo, RMA, tracciamento e l'ordine collegato. Filtra per stato, ordine o data.…
ahlens_list_reasonsElenca i codici di motivo del marketplace (RE01): incidente, cancellazione, rimborso e motivi di messaggio, con le loro etichette e se il negozio può…
ahlens_list_carriersElenca i corrieri che il marketplace conosce (SH21) con il loro codice, etichetta e URL di tracciamento. Usa il codice come carrier_code in…
ahlens_list_invoicesElenca i documenti contabili che Åhléns emette al negozio (IV01): fatture e note di credito con periodo, totali con e senza tasse…
ahlens_list_transactionsElenca le righe delle transazioni del negozio (TL02): importi degli ordini, spedizione, commissioni, rimborsi, crediti manuali e pagamenti, con importo, tipo…
ahlens_list_document_requestsElenca le richieste di documenti contabili (DR11), utilizzate quando Åhléns esegue la Fatturazione Venditore Avanzata: fatture e note di credito che Åhléns o il…
ahlens_list_order_documentsElenca i documenti allegati a uno o più ordini (OR72): note di consegna, etichette di spedizione, fatture clienti e altri file, con id, file…
ahlens_list_channelsElenca i canali di vendita del marketplace (CH11), di solito uno per sito nazionale, con codice ed etichetta. Usa i codici come channel_codes in…
ahlens_list_shipping_zonesElenca le zone di spedizione attive del marketplace (SH11) con codice ed etichetta, ad esempio Francia continentale o Corsica. Cambiano raramente: chiamalo…
ahlens_list_shipping_methodsElenca i metodi di spedizione attivi del marketplace (SH12), ad esempio standard, espresso o ritiro, con codice, etichetta, se un numero di tracciamento…
ahlens_list_logistic_classesElenca le classi logistiche del marketplace (SH31), le fasce di dimensione o peso che decidono i prezzi di spedizione, con codice ed etichetta. Usa il codice come…
ahlens_accept_orderAccetta o rifiuta le righe di un ordine in attesa di accettazione (OR21). Ogni riga dell'ordine deve essere elencata. Rifiutare una riga la annulla…
ahlens_update_trackingImposta il corriere e il numero di tracciamento di un ordine (OR23). Fornisci carrier_code da ahlens_list_carriers, o carrier_name con carrier_url per un…
ahlens_ship_orderConferma che un ordine in SPEDIZIONE è stato spedito (OR24); passa a SPEDITO e il cliente viene avvisato. Imposta prima il tracciamento con…
ahlens_update_offersCrea o aggiorna offerte, inclusi prezzo e magazzino (OF24). Sostituisce ogni offerta completamente: ogni campo lasciato fuori viene ripristinato (una mancante…
ahlens_reply_threadRispondi in un thread di messaggi (M12) al cliente o a Åhléns. Il messaggio viene consegnato immediatamente e non può essere ritirato: mostra all'utente il…
ahlens_create_order_threadAvvia un nuovo thread di messaggi su un ordine (OR43) con il cliente, Åhléns o entrambi. Il messaggio viene consegnato immediatamente: mostra all'utente il testo…
ahlens_resolve_incidentSegna l'incidente aperto su una riga d'ordine come risolto (OR64), una volta che il problema del cliente è risolto. reason_code deve essere un INCIDENT_CLOSE…
ahlens_accept_returnAccetta o rifiuta una richiesta di reso in WAITING_ACCEPTANCE (RT21). Solo quando Åhléns gestisce i resi nel back office venditore e lascia il…
ahlens_receive_returnConferma che la merce di un reso accettato è arrivata nel tuo magazzino (RT25). Il reso passa a RICEVUTO. Agisce sul marketplace live…
ahlens_import_productsInvia un file di prodotto al marketplace (P41) per creare o arricchire prodotti nel suo catalogo. file_url è l'indirizzo di un CSV, XLSX o XML…
ahlens_import_offersImporta un file di offerta (OF01) per creare, aggiornare o eliminare offerte in blocco. La modalità REPLACE elimina ogni offerta che non è nel file, e…

Esempi di richieste

  • "Quali ordini di Åhléns sono in attesa della mia accettazione?"
  • "Quali ordini accettati cinque giorni fa non sono ancora stati spediti? Åhléns si aspetta la spedizione entro sei giorni."
  • "Imposta il magazzino del mio SKU di candela profumata AH-CND-200 a 35 e mantieni il prezzo."
  • "Aggiungi il tracciamento PostNord 00370712345678901235 all'ordine 2201234-A e conferma la spedizione."
  • "Quali messaggi dei clienti devono ancora ricevere una risposta?"

Prossimi passi

Questa guida ti è stata utile?

Collega Åhléns Marketplace a Claude, ChatGPT o Copilot in 2 minuti

Avvia la prova gratuita su AnythingMCP Cloud, collega Åhléns Marketplace con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. Senza codice e senza server da gestire.

Guide correlate

Connettori

Collegare Åhléns MCP a ChatGPT

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Connettori

Collegare Åhléns MCP a Claude

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Connettori

Collegare Åhléns MCP a Microsoft Copilot

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Connettori

Collegare Åhléns MCP a Cursor

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Connettori

Collegare Åhléns MCP a Gemini CLI

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.

Connettori

Collegare Åhléns MCP a Meta Muse

Gestisci il tuo negozio su Åhléns marketplace tramite un agente AI: ordini, accettazione, tracciamento e spedizione, incidenti, offerte con prezzi e stock, importazioni, messaggi, resi, fatture e transazioni. Il marketplace vende in Svezia; accedi con la chiave API del negozio dal tuo back office venditore Åhléns.