Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi n11 con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
API di integrazione venditori di n11 (Turchia): prodotti con task di creazione, modifica, prezzo e giacenza e i loro esiti, albero delle categorie e attributi, ordini come pacchi di spedizione con approvazione, suddivisione, ritiro e link alla fattura, richieste di reso e domande dei clienti. Eliminare prodotti e rifiutare resi sono disattivati all'installazione.
Prova a chiedere
Prompt di esempio per n11
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.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → n11, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
n11
API di integrazione venditori di n11 (Turchia): prodotti con task di creazione, modifica, prezzo e giacenza e i loro esiti, albero delle categorie e attributi, ordini come pacchi di spedizione con approvazione, suddivisione, ritiro e link alla fattura, richieste di reso e domande dei clienti. Eliminare prodotti e rifiutare resi sono disattivati all'installazione.
Setup
La configurazione richiede circa 5 minuti. Ti serve un account venditore n11.
- Accedi al pannello venditori di n11 (so.n11.com) e apri Hesabım > API Hesapları (account > account API). Crea un account API se non c'è.
- Copia l'API anahtarı (chiave) in
N11_APP_KEYe l'API şifresi (secret) inN11_APP_SECRET. - Installa il connettore ed esegui
n11_list_products: elenca i tuoi prodotti e conferma la coppia.
Quale API: l'API di integrazione venditori di n11 su https://api.n11.com (documentazione su developer.n11.com). Prodotti, prezzi e giacenze, categorie e ordini usano gli attuali servizi REST di n11, che vogliono chiave e secret negli header appkey e appsecret. Resi, domande dei clienti e link alla fattura esistono solo sui servizi SOAP di n11; lì il connettore inserisce chiave e secret nella richiesta per te. Dal 15 agosto 2025 anche i servizi delle categorie richiedono la chiave.
Cosa legge: i tuoi prodotti con id prodotto n11, stock code, titolo, categoria, product main id (gruppo), stato, stato di vendita, prezzi, giacenza, aliquota IVA e di commissione, attributi e immagini, filtrati per stock code, codice gruppo, stato di vendita o di approvazione, marca o categoria (productStatus InApproval significa che n11 aspetta un'azione da te, CatalogRejected arriva con rejectInfo); l'intero albero delle categorie e gli attributi di una categoria foglia con i valori ammessi; gli esiti dei task sui prodotti; gli ordini come pacchi di spedizione con numero d'ordine, stato, acquirente, indirizzo di fatturazione e di spedizione, corriere e tracking, data di spedizione concordata e righe (orderLineId, prodotto, stock code, quantità, prezzo, sconti, sellerInvoiceAmount, commissione); le richieste di reso con motivo, numero d'ordine, prodotto, quantità, prezzi, acquirente e tracking del corriere, e i motivi che puoi indicare per rinviare o rifiutare; le domande dei clienti con acquirente, prodotto, date di domanda e risposta.
Ogni scrittura sui prodotti è un task: n11_create_products, n11_update_products (lo stato Suspended toglie un prodotto dalla vendita), n11_update_price_and_stock e n11_delete_products accettano fino a 1.000 stock code per chiamata e rispondono con un id di task e lo stato IN_QUEUE (o REJECT con i motivi). L'AI chiama poi n11_get_task_details finché lo stato è PROCESSED e legge per ogni stock code status (SUCCESS o FAIL) e reasons. Un 200 sulla scrittura significa solo che il task è in coda. Per creare prodotti l'AI prende una categoria foglia (subCategories null) e invia ogni attributo obbligatorio: valueId quando isCustomValue è false, altrimenti customValue; lo stesso productMainId raggruppa le varianti.
Ordini: i nuovi pacchi hanno stato Created. n11_approve_order_lines porta le righe a Picking; spedisci con il codice campagna cargo di n11 in cargoTrackingNumber, poi il pacco passa a Shipped e Delivered. Un pacco in Picking si può suddividere per riga (n11_split_package) o per quantità (n11_split_package_by_quantity), eventualmente annullando quantità con motivo 61 esaurito, 62 difettoso, 63 prezzo errato, 64 forza maggiore, 65 altro. La merce voluminosa ottiene un ritiro con n11_create_collection_request, le righe di gioielleria il costo di manodopera con n11_send_labor_costs, e n11_send_invoice_link salva il link alla fattura (con numero e data della fattura per gli ordini e-export, dove micro è true).
Resi e domande: n11_list_claim_returns mostra di default i resi REQUESTED (ALL per tutti gli stati; ricerca per numero d'ordine con searchInfoType ORDERID); n11_approve_claim_return rimborsa l'acquirente, n11_postpone_claim_return rinvia la decisione con un motivo. n11_answer_product_question risponde a una domanda una sola volta; la risposta diventa pubblica.
Scritture: prima conferma. Prezzi, giacenze, stato dei prodotti, approvazione degli ordini, suddivisioni e annullamenti, resi e risposte agiscono sul negozio live. Prima di ogni chiamata l'AI ti mostra cosa cambia (stock code con prezzo o giacenza vecchi e nuovi, righe, il testo della risposta) e aspetta il tuo sì.
Disattivati all'installazione: n11_delete_products e n11_deny_claim_return. Un amministratore li attiva quando il team ne ha bisogno.
Formati dei dati: le date degli ordini (startDate, endDate, lastModifiedDate, invoiceDateTime) sono millisecondi epoch in ora turca (UTC+3), ad es. 1793318400000; i servizi SOAP usano dd/mm/yyyy. Senza date l'elenco dei pacchi mostra gli ultimi 15 giorni, e le finestre più lunghe vengono ridotte a 15 giorni. I prezzi sono in TL salvo che currencyType indichi USD o EUR; si inviano con il punto e due decimali, e salePrice non può superare listPrice. Id come orderNumber e n11ProductId possono allungarsi nel tempo, quindi trattali come stringhe. I dati degli ordini precedenti a novembre 2024 non sono disponibili.
Paginazione: gli elenchi REST partono da pagina 0 e restituiscono totalPages; l'AI si ferma quando content è vuoto. I prodotti arrivano al massimo 250 per pagina, i pacchi 100, i resi 20.
Limiti: l'elenco ordini consente 1.000 richieste al minuto, le scritture sui prodotti 1.000 stock code per chiamata e l'elenco delle domande una chiamata al minuto.
Errori comuni: 401 (SellerApiUserUnauthorizedException) significa che n11 ha rifiutato chiave e secret: ricopiali entrambi da Hesabım > API Hesapları. 403 Authentication failed significa che chiave e secret non vanno insieme o che l'account API è inattivo. Una risposta SOAP con stato failure riporta l'errorMessage di n11. Un task con REJECT o uno stock code con FAIL elenca i motivi, ad esempio un attributo obbligatorio mancante.
Il connettore non crea etichette di spedizione e non legge i tuoi pagamenti e regolamenti n11: non ci sono strumenti per farlo.
Prerequisiti: N11_APP_KEY, N11_APP_SECRET
Installazione locale del connettore
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 n11 e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
n11_list_products | List your n11 products: n11 product id, stock code, title, category, product main id (group), status, sale status, prices, stock, VAT and… |
n11_list_categories | Get the whole n11 category tree in one call (id, parentId, name, subCategories) |
n11_get_category_attributes | Get the attributes of a leaf category with their allowed values: attributeId, name, isMandatory, isVariant (same productMainId groups… |
n11_get_task_details | Read the result of a product task (create, update, price and stock, delete): task status PROCESSED, IN_QUEUE or REJECT and per stock code… |
n11_list_shipment_packages | List orders as shipment packages: order number, package id, status, buyer, billing and shipping address, cargo company and tracking, agreed… |
n11_list_claim_returns | List return requests (claims) with id, status, reason, order number, product, quantity, prices, buyer and cargo tracking; 20 per page… |
n11_list_return_deny_reasons | List the reasons (id and text) you may give when refusing a return with n11_deny_claim_return |
n11_list_return_pending_reasons | List the reasons (id and text) you may give when postponing the decision on a return with n11_postpone_claim_return |
n11_list_product_questions | List customer questions about your products (id, product, subject, question, answer). startDate, endDate, currentPage and pageSize are… |
n11_get_product_question | Get one customer question with buyer name and email, product, question and answer dates, visibility and status |
n11_update_price_and_stock | Update price and/or stock of products by stock code (up to 1,000 per call). listPrice and salePrice go together, with a dot and two… |
n11_create_products | Create products (up to 1,000 per call) in leaf categories with title, description, categoryId, productMainId, stockCode, barcode, images… |
n11_update_products | Update product data by stock code (up to 1,000 per call): status (Active or Suspended to take it off sale), preparingDay, shipmentTemplate… |
n11_delete_products | Delete products by stock code (up to 1,000 per call) |
n11_approve_order_lines | Approve (accept) new order lines: moves Created lines to Picking |
n11_split_package | Split a Picking package into several packages by order line (each group becomes its own package with its own tracking code; lines not… |
n11_split_package_by_quantity | Split a Picking package by quantity, optionally cancelling part of a line (cancelReasonId 61 out of stock, 62 defective, 63 wrong price, 64… |
n11_create_collection_request | Create a collection (pickup) request with a logistics company for Picking packages of bulky goods: every line of the package with box… |
n11_send_labor_costs | Send the labour cost (excluding VAT, with its VAT rate 0, 1, 10 or 20, default 20) of order lines, for gold, jewellery and similar… |
n11_send_invoice_link | Save the invoice link (https, pdf, png or jpeg) of an order; a new link replaces the previous one |
n11_approve_claim_return | Approve a return request: the buyer gets the refund |
n11_postpone_claim_return | Postpone the decision on a return request by some days, with a reason from n11_list_return_pending_reasons and a note |
n11_deny_claim_return | Refuse a return request with a reason from n11_list_return_deny_reasons and a note; for most reasons say how the product goes back… |
n11_answer_product_question | Answer a customer question (1 to 2,048 characters) |
Esempi di prompt
- "Quali dei nostri prodotti n11 sono in InApproval o CatalogRejected, e perché?"
- "Imposta la giacenza dello stock code ABC-1 a 40 e il prezzo di vendita a 199,90 TL. Mostrami prima i valori vecchi e nuovi, poi controlla l'esito del task."
- "Elenca i nuovi pacchi n11 (Created) degli ultimi tre giorni con le loro righe."
- "Mostrami le richieste di reso aperte su n11 e i motivi indicati dagli acquirenti."
- "Prepara le risposte alle domande dei clienti aperte di questa settimana e fammi approvare ognuna prima di inviarla."
Prossimi passi
Questa guida ti è stata utile?