In breve
API Seller Center di ABOUT YOU per partner di marketplace: ordini, spedizioni con tracciamento, fatture e documenti di imballaggio, prodotti con stato di approvazione, magazzino, prezzi, categorie e attributi, marchi e report. Chiave API.
Configurazione guidata
Collega ABOUT YOU a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega ABOUT YOU 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 ABOUT YOU
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 → ABOUT YOU, incolla le tue credenziali, genera una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
ABOUT YOU
API Seller Center di ABOUT YOU per partner di marketplace: ordini, spedizioni con tracciamento, fatture e documenti di imballaggio, prodotti con stato di approvazione, magazzino, prezzi, categorie e attributi, marchi e report. Chiave API.
Configurazione
La configurazione richiede circa 2 minuti.
- Accedi al Seller Center di ABOUT YOU come utente Admin. Gli utenti membri non possono creare chiavi API.
- Apri Impostazioni, poi Chiavi API, e clicca su + Aggiungi.
- Inserisci un'etichetta, opzionalmente una data di scadenza, e clicca su Aggiungi Chiave.
- Copia subito la chiave in
ABOUT_YOU_API_KEY: il Seller Center la mostra solo questa volta.
La chiave viene inviata nell'intestazione X-API-Key. Per i dati di test, crea un sandbox sotto Impostazioni, Sandbox, Crea Sandbox: ha la sua chiave API sullo stesso indirizzo, i prodotti vengono pubblicati lì senza approvazione, e gli ordini di test provengono dal pulsante Ricevi Ordini nella pagina Ordini.
Da dove iniziare: about_you_list_orders con order_status aperto mostra cosa è in attesa di essere spedito. about_you_list_products mostra il tuo catalogo con magazzino e prezzi. about_you_list_countries è la chiamata economica che dimostra che la chiave funziona.
Ordini e spedizioni: about_you_list_orders restituisce gli articoli di ogni ordine con il loro id; gli strumenti di spedizione, cancellazione e restituzione prendono questi id degli articoli, mai gli SKU. Spedisci con about_you_ship_order_items (chiave del corriere da about_you_list_carriers, chiave di tracciamento della spedizione e chiave di tracciamento della restituzione sono tutte richieste). about_you_get_delivery_document restituisce il documento di imballaggio di un ordine dropshipping e about_you_get_order_invoices le fatture dei clienti, entrambi come file. about_you_cancel_order_items e about_you_return_order_items sono installati disattivati: un articolo cancellato non può essere spedito in seguito, e contrassegnare un articolo come restituito fa sì che ABOUT YOU rimborsi automaticamente il cliente. Controlla una restituzione entro 24 ore dal ricevimento; non registrare una restituzione che rifiuti.
Scritture asincrone: ogni scrittura risponde immediatamente con un batchRequestId ed è elaborata in background. Leggi il risultato con about_you_get_batch_result (scegli il result_type corrispondente) fino a quando lo stato è completato o fallito; ogni articolo riporta successi ed errori. I risultati vengono mantenuti per 7 giorni. Lo stesso payload inviato due volte in un breve periodo restituisce lo stesso id batch e non viene elaborato nuovamente.
Prodotti: una riga è un SKU (una taglia di un colore di uno stile). Crea o modifica utilizzando about_you_upsert_products usando gli id da about_you_list_categories, about_you_list_category_attribute_groups e about_you_list_brands, poi invia lo stile per approvazione con about_you_publish_product. Stati: bozza, in attesa di approvazione (bloccato mentre ABOUT YOU esamina), rifiutato (motivi in about_you_list_rejected_products), in attesa attivo, attivo, inattivo e problema (un prodotto attivo che è diventato non valido; torna attivo una volta risolto). about_you_update_product_status (anche bozza e inattivo) e about_you_delete_product sono installati disattivati.
Magazzino e prezzi: about_you_update_stock e about_you_update_prices accettano fino a 1000 righe per chiamata e vengono sempre applicati, a differenza di magazzino o prezzi inviati tramite l'upsert dei prodotti. I prezzi dei prodotti sono numeri decimali nella valuta del paese (49,99), mentre gli importi degli ordini sono interi nella più piccola unità (4999 = 49,99 EUR). Invia currency con ogni prezzo.
Report e webhook: about_you_list_reports e about_you_download_report (report di magazzino e movimenti per beni nei magazzini di ABOUT YOU, DAC7), about_you_list_webhooks (solo lettura).
Paging: le liste restituiscono items e pagination. Gli ordini e i prodotti dovrebbero essere paginati con cursor = pagination.next_cursor; il parametro page funziona ancora lì ma è deprecato. Liste più piccole usano page e per_page (max 100).
Tipi di evasione: dropshipping significa che tu spedisci; fulfillment_by_marketplace significa che ABOUT YOU spedisce dal proprio magazzino (FbAY), quindi non c'è nulla da spedire e nessun documento di consegna per quegli ordini.
Limiti di frequenza (per endpoint e per chiave): ordini 100 al minuto, spedizione 200, cancellazione e restituzione 50, magazzino 1000, prezzi 200, lista prodotti 1000, upsert prodotto e stato 100, risultati batch 200, fatture e report 10. Le intestazioni X-RateLimit-Limit e X-RateLimit-Remaining mostrano il budget; un 429 significa aspettare il minuto successivo.
Errori: 400 e 401 rispondono con un JSON message. Un 404 su un documento significa che l'ordine non ha tale file. Questa API non ha chiamate di pagamento o di rimborso; l'unica azione che porta a un rimborso è registrare una restituzione, che è disattivata.
Requisiti: ABOUT_YOU_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 ABOUT YOU e incolla le variabili d'ambiente elencate sotto Requisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
about_you_list_orders | Elenca gli ordini: per ordine order_number, stato (aperto, spedito, cancellato, restituito, misto), fulfillment_type, carrier_key, cost_with_tax e… |
about_you_list_carriers | Elenca i corrieri con cui puoi spedire: chiave (es. DHL_STD_NATIONAL, il valore per carrier_key quando spedisci), carrier_name, display_label e… |
about_you_ship_order_items | Contrassegna gli articoli dell'ordine aperto come spediti, un'entrata per pacco: gli id degli articoli dell'ordine in esso, la chiave del corriere, la chiave di tracciamento della spedizione e la restituzione… |
about_you_cancel_order_items | Annulla gli articoli dell'ordine aperto che non puoi consegnare (ad esempio, esauriti). Gli articoli cancellati non possono essere spediti in seguito, il magazzino non viene aggiunto… |
about_you_return_order_items | Registra gli articoli dell'ordine spediti come restituiti a te, con la chiave di tracciamento della restituzione. Una volta che un articolo è contrassegnato come restituito, ABOUT YOU rimborsa il… |
about_you_get_order_invoices | Scarica le fatture dei clienti di un ordine. La risposta è un file allegato al risultato: un PDF, o un ZIP quando l'ordine ha più… |
about_you_get_delivery_document | Scarica il documento di consegna (documento di imballaggio) di un ordine dropshipping come PDF allegato al risultato. Gli ordini spediti da ABOUT YOU… |
about_you_list_products | Elenca le varianti dei tuoi prodotti (una riga per SKU): sku, style_key, colorway_key, ean, nome, stato (bozza, in attesa di approvazione, rifiutato… |
about_you_list_rejected_products | Elenca i prodotti rifiutati da ABOUT YOU nell'approvazione: style_key, rejection_message, rejection_reasons[] (chiave, tipo Requisiti Immagine o… |
about_you_upsert_products | Crea o aggiorna fino a 100 varianti di prodotto (un'entrata per SKU). I nuovi prodotti iniziano come bozza; pubblicali con about_you_publish_product.… |
about_you_publish_product | Pubblica un prodotto (tutte le varianti di una chiave di stile). Una bozza va in approvazione da ABOUT YOU (in attesa di approvazione, poi in attesa attivo, poi… |
about_you_update_product_status | Imposta lo stato di uno o più prodotti per chiave di stile: published (invia per approvazione o torna online), draft (ritira dall'approvazione; solo… |
about_you_update_stock | Imposta la quantità di magazzino di fino a 1000 SKU (il tuo magazzino; una quantità di 0 rende la taglia non disponibile). Un aggiornamento con un… |
about_you_update_prices | Imposta il prezzo di fino a 1000 coppie SKU e paese: prezzo al dettaglio e prezzo di vendita opzionale, come numeri decimali nella valuta del paese.… |
about_you_delete_product | Elimina una variante per SKU. Quando era l'ultima taglia di un colore, anche il colore viene eliminato, e con l'ultimo colore l'intero prodotto.… |
about_you_list_categories | Cerca l'albero delle categorie di ABOUT YOU: id (il valore della categoria per i prodotti), nome, percorso (per visualizzazione), parent_id, material_composition_type… |
about_you_list_category_attribute_groups | Elenca i gruppi di attributi richiesti da una categoria (colore, taglia, gruppi di materiale e altri attributi): per gruppo id, nome, frontend_name… |
about_you_list_brands | Elenca i marchi che il tuo account può vendere: id (il valore del marchio per i prodotti) e nome. Solo lettura, una chiamata restituisce tutto, 50 chiamate al minuto |
about_you_list_countries | Elenca i paesi in cui il tuo account vende (codice, nome), le localizzazioni per le descrizioni dei prodotti e la valuta di ciascun paese (country_code… |
about_you_get_batch_result | Leggi il risultato di una scrittura asincrona: stato (in attesa, in elaborazione, completato, riprova, fallito) e items[] con l'elemento della richiesta… |
about_you_list_reports | Elenca i file di report generati da ABOUT YOU per il tuo account: id, tipo (SELLABLE_STOCK, WAREHOUSE_MOVEMENTS, DAC7), file_name, data… |
about_you_download_report | Scarica un file di report per id. Un file di testo (CSV) torna come testo, qualsiasi altro formato come file allegato al risultato. Solo lettura, 10… |
about_you_list_webhooks | Elenca gli abbonamenti webhook dell'account: id, url, eventi (order.created, order.shipped, stock.updated e altri), abilitato… |
Esempi di richieste
- "Quali ordini ABOUT YOU sono aperti e in attesa di essere spediti?"
- "Quali dei miei prodotti sono stati rifiutati da ABOUT YOU, e perché?"
- "Imposta il magazzino dello SKU AY-TSHIRT-WHT-M a 50."
- "Spedisci gli articoli dell'ordine 123456789 con DHL, tracciamento 003404341612345678 e tracciamento restituzione 003404341698765432."
- "Scarica il report delle vendite del mese scorso."
Prossimi passi
Questa guida ti è stata utile?