In breve
API del marketplace Target Plus per venditori invitati nel marketplace statunitense di Target: catalogo prodotti e famiglie di variazione, prezzi, stock per centro di distribuzione, ordini con conferma e adempimenti, resi e controversie, report e tassonomia degli articoli Target. Chiave API, ID venditore e token venditore.
Configurazione guidata
Collega Target Plus a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Target Plus con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. 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 Target Plus
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 → Target Plus, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Target Plus + Microsoft Copilot
API del marketplace Target Plus per venditori invitati nel marketplace statunitense di Target: catalogo prodotti e famiglie di variazione, prezzi, stock per centro di distribuzione, ordini con conferma e adempimenti, resi e controversie, report e tassonomia degli articoli Target. Chiave API, ID venditore e token venditore.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili d'ambiente richieste per questo connettore sono:
TARGET_PLUS_API_KEY, TARGET_PLUS_SELLER_ID, TARGET_PLUS_SELLER_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti. Hai bisogno dell'amministratore dell'account del Partner Portal.
- ID venditore: nel Partner Portal di Target Plus (https://plus.target.com) apri Informazioni aziendali, Informazioni di base e copia l'ID SMS in
TARGET_PLUS_SELLER_ID. - Token venditore: apri Impostazioni partner, Token API e crea un token. Solo gli amministratori possono farlo, e il token viene mostrato una sola volta: copialo direttamente in
TARGET_PLUS_SELLER_TOKEN. - Chiave API: la
x-api-keyviene fornita con il tuo accesso API di Target Plus, dal portale sviluppatori di Target dove è registrata l'app partner (cerca Gestione API o App e Chiavi). Copiala inTARGET_PLUS_API_KEY. I nomi degli schermi esatti possono variare per account; se non riesci a trovare la chiave, chiedi al tuo contatto partner di Target Plus di abilitare l'accesso API.
Ogni chiamata invia le tre intestazioni x-api-key, x-seller-id e x-seller-token; l'ID venditore va anche in ciascun percorso venditore. Le chiamate alla tassonomia necessitano solo della chiave API.
Dove iniziare: target_plus_list_distribution_centers (verifica anche le credenziali), poi target_plus_list_orders con order_status ["RELEASED_FOR_SHIPMENT", "ACKNOWLEDGED_BY_SELLER"] per ordini ancora da spedire, e target_plus_list_products per il catalogo.
Ordini: target_plus_list_orders, target_plus_get_order, target_plus_get_order_address, target_plus_list_order_addresses. L'ID ordine è il numero dell'ordine e il numero di avviso di spedizione uniti da un trattino (1028521085032-1635740801). Stati: PENDING, RELEASED_FOR_SHIPMENT, ACKNOWLEDGED_BY_SELLER, PARTIALLY_SHIPPED, SHIPPED, CANCELED, REFUNDED. Conferma un ordine con target_plus_update_order_status (ACKNOWLEDGED_BY_SELLER), poi riporta ogni pacco spedito con target_plus_create_order_fulfillments (order_line_number, quantity, shipped_date, tracking_number e il nome del metodo di spedizione da target_plus_list_shipping_methods). target_plus_list_order_fulfillments mostra cosa è registrato e target_plus_update_order_fulfillments lo corregge tramite l'ID di adempimento. target_plus_update_order_line (annulla unità con un motivo) è installato disattivato: un'annullamento non può essere annullato e conta contro il venditore. I venditori non possono impostare REFUNDED; i rimborsi passano attraverso il team operativo di Target Plus. Gli indirizzi sono dati personali dell'acquirente: usali solo per la spedizione.
Prodotti: target_plus_list_products, target_plus_get_product, target_plus_create_product, target_plus_update_product, target_plus_upsert_variation_family, target_plus_list_product_catalog_errors, target_plus_unlist_product (disattivato). Un prodotto ha un ID Target Plus, il tuo SKU (external_id), un TCIN una volta che Target ne assegna uno, e campi come coppie nome/valore. Ogni creazione o aggiornamento aggiunge una nuova versione del prodotto (product_status con latest=true) che Target convalida (validation_status INITIATED, VALIDATED, ERROR, REVIEW, BLOCKED) e lista (listing_status PENDING, APPROVED, REJECTED); la versione con current=true è quella in vendita. I prodotti figli (VC) esistono solo all'interno di una famiglia di variazione con un genitore (VAP). Dopo una sottomissione, leggi target_plus_list_product_catalog_errors per field_name, reason e partner_action.
Quali campi necessita un prodotto: trova il tipo di articolo con target_plus_list_taxonomies (type ITEM_TYPE, name), elenca i suoi attributi con target_plus_list_attribute_assignments (taxonomy_id; required=true contrassegna quelli obbligatori), cerca attributi con target_plus_list_attributes e valori consentiti con target_plus_list_attribute_values. target_plus_get_catalog_item legge un articolo Target tramite TCIN. Prima di elencare un nuovo tipo di articolo o marchio, controlla target_plus_list_legalizations (cosa sei approvato a vendere) e target_plus_list_protected_legalizations (cosa nessun partner può vendere).
Prezzo, stock e logistica (nessuna nuova versione del prodotto): target_plus_get_product_price e target_plus_update_product_price (list_price richiesto, offer_price al massimo list_price, map_price; USD). Lo stock è mantenuto per centro di distribuzione: target_plus_get_product_quantities, target_plus_get_product_quantity, target_plus_update_product_quantity (numero assoluto, 0 consentito) e target_plus_bulk_update_product_quantities (diversi centri per un prodotto, ciascuno almeno 1; restituisce 207 con uno stato per voce). target_plus_get_product_logistics e target_plus_update_product_logistics gestiscono fulfillment.is_add_on, fulfillment.two_day_shipping_eligible, shipping_exclusion e seller_return_policy (un ID della politica di reso da target_plus_list_return_policies); l'aggiornamento viene elaborato in modo asincrono, quindi leggilo di nuovo per lo stato PROCESSED e feedback.
Resi e controversie (solo lettura): target_plus_list_product_returns, target_plus_get_product_return, target_plus_search_product_returns (per numero di ordine di reso, numero di tracciamento, targa, data), target_plus_list_return_disputes, target_plus_get_return_dispute, target_plus_list_return_policies. Le controversie vengono presentate nel Partner Portal; gli importi di chargeback e rimborso sono mostrati solo per informazione.
Report: target_plus_create_report_request (type, format, start_date, end_date) costruisce un file in modo asincrono; interroga target_plus_get_report_request fino a quando lo stato è COMPLETE e fornisci all'utente il suo download_url. target_plus_list_report_requests li elenca; le richieste vengono mantenute per 5 giorni. target_plus_terminate_report_request è disattivato. Un report PAYOUT_RECONCILIATION legge solo i dati di pagamento.
Dati di configurazione: target_plus_list_distribution_centers (ids per gli strumenti di stock, con nodi di spedizione), target_plus_list_ship_nodes (corrieri, livelli di servizio, orari di cut-off).
Paging: la maggior parte delle liste richiede page (da 1) e per_page; il default di Target è 10 e il paging profondo si ferma a 10.000 risultati, quindi restringi per data per avere di più. Le loro intestazioni X-Total-Count e Link tornano in _headers, e _pagination nomina la pagina successiva fino all'ultima. target_plus_list_products, target_plus_list_product_catalog_errors e target_plus_search_product_returns paginano con after_id: passa l'ID dell'ultima riga.
Formati e insidie: le date sono ISO 8601 in UTC; i filtri di intervallo (order_date, last_modified, return_date) richiedono un intervallo start/end, ad esempio 2026-11-01T00:00:00Z/2026-11-14T23:59:59Z. I prezzi sono in USD. Gli errori tornano come {"message": ..., "errors": [...]}. Target non pubblica limiti di velocità nelle specifiche; in caso di 429 attendi prima di riprovare. Il connettore non gestisce mai denaro: non può rimborsare, pagare o acquistare etichette.
Passo 2 — Installa l'adattatore
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
Passo 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
Target Plus. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
target_plus_list_products | Elenca il tuo catalogo prodotti Target Plus: per ID prodotto, external_id (il tuo SKU), tcin, relationship_type (SA stand-alone, VAP parent, VC… |
target_plus_get_product | Leggi un prodotto tramite il suo ID prodotto Target Plus: external_id, tcin, relationship_type, parent_id, fields, price, quantities e… |
target_plus_create_product | Crea un prodotto stand-alone (relationship_type SA) o un genitore (VAP) dal tuo SKU e dalle sue proprietà. La nuova versione inizia come PENDING… |
target_plus_update_product | Invia una nuova versione di un prodotto esistente: invia external_id, relationship_type e l'intero set di campi. Target aggiunge una nuova… |
target_plus_upsert_variation_family | Crea o aggiorna una famiglia di variazione in una sola chiamata: esattamente un genitore (VAP) e i suoi figli (VC). I prodotti esistenti ottengono una nuova versione.… |
target_plus_unlist_product | Rimuovi un prodotto dall'elenco: la sua versione attuale diventa UNLISTED e l'articolo smette di essere vendibile su target.com fino a quando non viene inviata una nuova versione e… |
target_plus_list_product_catalog_errors | Elenca i prodotti con errori sui loro ultimi stati di prodotto: id, external_id, tcin, parent_id e per stato listing_status… |
target_plus_get_product_price | Leggi il prezzo di un prodotto: list_price, offer_price e map_price (prezzo minimo pubblicizzato) in USD, e last_updated. Solo lettura |
target_plus_update_product_price | Imposta il prezzo di un prodotto in USD: list_price è richiesto; offer_price (il prezzo di vendita, al massimo list_price) e map_price sono opzionali.… |
target_plus_get_product_quantities | Leggi la quantità disponibile di un prodotto in ogni centro di distribuzione: per voce distribution_center_id, quantity, last_modified e… |
target_plus_get_product_quantity | Leggi la quantità disponibile di un prodotto in un centro di distribuzione: quantity, last_modified e last_modified_by. Solo lettura |
target_plus_update_product_quantity | Imposta la quantità disponibile di un prodotto in un centro di distribuzione (un numero assoluto, 0 per fermare la vendita da lì). Restituisce il… |
target_plus_bulk_update_product_quantities | Imposta la quantità di un prodotto in diversi centri di distribuzione contemporaneamente. Ogni quantità deve essere almeno 1 (usa… |
target_plus_get_product_logistics | Leggi le proprietà logistiche di un prodotto (fulfillment.is_add_on, fulfillment.two_day_shipping_eligible, shipping_exclusion… |
target_plus_update_product_logistics | Aggiorna le proprietà logistiche di un prodotto senza creare una nuova versione del prodotto. Invia campi come coppie nome/valore con i nomi… |
target_plus_list_orders | Elenca i tuoi ordini Target Plus, filtrati per stato, numero, TCIN, nodo di spedizione o data: per ID ordine (numero ordine-numero avviso di spedizione)… |
target_plus_get_order | Leggi un ordine: stato, date (ordine, spedizione richiesta e consegna), level_of_service, scac, nodo di spedizione, centro di distribuzione e ciascuno… |
target_plus_get_order_address | Leggi l'indirizzo di spedizione di un ordine: first_name, last_name, address1, address2, city, state, postal_code, country_code e… |
target_plus_list_order_addresses | Elenca gli indirizzi di spedizione dei tuoi ordini, una voce per ID ordine con shipping_address (name, street, city, state, postal_code, country_code… |
target_plus_update_order_status | Riconosci un ordine: imposta il suo stato su ACKNOWLEDGED_BY_SELLER per confermare che lo spedirai. La spedizione viene riportata con… |
target_plus_update_order_line | Aggiorna una riga d'ordine, principalmente per annullare unità: imposta order_line_status (quantità per stato, ad esempio 1 CANCELED e 2 SHIPPED) e un… |
target_plus_list_order_fulfillments | Elenca gli adempimenti (spedizioni) registrati per un ordine: per ID adempimento, order_line_number, quantity, shipped_date, shipping_method… |
target_plus_create_order_fulfillments | Riporta unità spedite di un ordine con tracciamento: un elemento per riga d'ordine e pacco con order_line_number, quantity, shipped_date… |
target_plus_update_order_fulfillments | Correggi gli adempimenti già riportati per un ordine (numero di tracciamento errato, metodo, data o quantità). Ogni elemento ripete il… |
target_plus_list_shipping_methods | Elenca i metodi di spedizione che Target Plus accetta per gli adempimenti: per metodo shipping_method (il nome da inviare, ad esempio USPSPriorityMail)… |
target_plus_list_product_returns | Elenca i resi dei tuoi prodotti: per ID reso, order_id, order_number, tcin, external_id, quantity, return_date, return_reason, is_online… |
target_plus_get_product_return | Leggi un reso di prodotto: ordine, tcin, SKU, quantità, return_date, return_reason, disposition, inbound tracking e tracking_data (tracciamento… |
target_plus_search_product_returns | Cerca resi per numero di ordine di reso, numero di tracciamento, targa, bolla di carico, posizione o data di reso, ad esempio per abbinare un… |
target_plus_list_return_disputes | Elenca le tue controversie sui resi: per ID controversia, case_number, order_id, return_order_number, product_return_id, dispute_reason, quantity… |
target_plus_get_return_dispute | Leggi una controversia di reso: motivo, descrizione, quantità, giudizio, risposta finale, risposte, chargeback_amount e seller_refund_amount in… |
target_plus_list_return_policies | Elenca le tue politiche di reso: per ID politica, stato (ACTIVE, INACTIVE), return_address, ID di disposizione fisica e finanziaria… |
target_plus_create_report_request | Richiedi un report, ad esempio ORDERS, INVENTORY, ITEM_ERRORS, BULK_PRODUCT_DATA, RETURN_ORDERS_EXTERNAL, PAYOUT_RECONCILIATION o SALES_METRICS… |
target_plus_list_report_requests | Elenca le tue richieste di report degli ultimi 5 giorni: per ID richiesta, tipo, formato, stato (PENDING, PROCESSING, COMPLETE, CANCELED), start_date… |
target_plus_get_report_request | Leggi una richiesta di report: stato (PENDING, PROCESSING, COMPLETE, CANCELED), download_url una volta COMPLETE, feedback con eventuali errori, tipo… |
target_plus_terminate_report_request | Termina una richiesta di report: una richiesta che non è ancora COMPLETE diventa CANCELED. Risponde 204 senza corpo. Installato disattivato |
target_plus_list_distribution_centers | Elenca i tuoi centri di distribuzione: per ID centro, nome, indirizzo, fuso orario, giorni di operazione (orari di lavoro, giorni chiusi), two_day_state_codes… |
target_plus_list_ship_nodes | Elenca i nodi di spedizione di un centro di distribuzione: per ID nodo, nome, corrieri (id, shipping_account), livelli di servizio (id, cut_off_time… |
target_plus_list_legalizations | Elenca le tue legalizzazioni: i tipi di articolo e i marchi che Target ha approvato per la vendita (primary_attribute, paired_attributes). Controlla qui… |
target_plus_list_protected_legalizations | Elenca le legalizzazioni protette: marchi e tipi di articolo che i partner esterni non possono vendere su Target Plus. Paginato. Solo lettura |
target_plus_list_taxonomies | Cerca la tassonomia dei prodotti Target: per ID nodo, nome, tipo (ITEM_TYPE, PRODUCT_TYPE, PRODUCT_SUBTYPE, MERCHANDISE_TYPE), parent_id… |
target_plus_list_attribute_assignments | Elenca gli attributi assegnati a un nodo di tassonomia (ad esempio un tipo di articolo): per assegnazione attribute_id, attribute, required… |
target_plus_list_attributes | Cerca attributi di prodotto: per ID attributo, nome, etichetta, descrizione, tipo, attribute_group, valore minimo e massimo, tag (variazione… |
target_plus_list_attribute_values | Cerca i valori consentiti di un attributo (ad esempio i colori o i materiali accettati da Target): per ID valore, nome, descrizione e… |
target_plus_get_catalog_item | Leggi un articolo del catalogo Target tramite TCIN: product_title, brand, item_type e item_type_name, product type e subtype, merch type, department… |
Esempi di prompt
- "Quali ordini Target Plus sono stati rilasciati per la spedizione e non sono ancora stati riconosciuti?"
- "Mostrami lo stock del prodotto 1234567 in ciascun centro di distribuzione."
- "Quali prodotti hanno errori di catalogo e cosa dice Target che non va?"
- "Imposta il prezzo del prodotto 1234567 a 39,99 USD."
- "Richiedi un report di vendita per il mese scorso e dimmi quando è pronto."
FAQ
Chiunque può usarlo? Target Plus è solo su invito. Hai bisogno di un account partner Target Plus approvato con accesso API; il connettore utilizza quindi la tua chiave API, ID venditore e token venditore.
Da dove proviene l'ID venditore? È l'ID SMS nel Partner Portal di Target Plus sotto Informazioni aziendali, Informazioni di base. Il token API viene creato sotto Impostazioni partner, Token API, da un amministratore, e mostrato solo una volta.
Può annullare ordini o rimuovere prodotti dall'elenco? target_plus_update_order_line (utilizzato per le cancellazioni) e target_plus_unlist_product sono installati disattivati. Attivali nella pagina del connettore solo se l'AI deve usarli.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?