In breve
Amazon Vendor Central attraverso l'API Selling Partner: ordini di acquisto al dettaglio, conferme, conferme di spedizione, fatture, ordini di Adempimento Diretto con etichette, documenti di imballaggio e inventario, stato delle transazioni e report vendor. Accedi con il token di aggiornamento Amazon di un'app vendor privata.
Configurazione guidata
Collega Amazon Vendor Central a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Amazon Vendor Central 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 Amazon Vendor Central (SP-API)
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 → Amazon Vendor Central, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Amazon Vendor Central
Amazon Vendor Central attraverso l'API Selling Partner: ordini di acquisto al dettaglio, conferme, conferme di spedizione, fatture, ordini di Adempimento Diretto con etichette, documenti di imballaggio e inventario, stato delle transazioni e report vendor. Accedi con il token di aggiornamento Amazon di un'app vendor privata.
Configurazione
La configurazione richiede circa 20 minuti. Hai bisogno dell'approvazione di Amazon del profilo sviluppatore.
- In Vendor Central apri Integrazione, poi Integrazione API, e completa il Profilo Sviluppatore. Sotto Accesso ai Dati scegli Sviluppatore Privato: Creo applicazione(i) che integrano la mia azienda con le API dei servizi Amazon, seleziona i ruoli di cui hai bisogno e scegli Registrati. Amazon esamina il profilo e apre un caso con i prossimi passi.
- Nella stessa pagina scegli Aggiungi nuovo client app, completa il modulo, seleziona Vendor dove Amazon offre la scelta, e seleziona i ruoli. Poi scegli Visualizza sotto credenziali LWA e copia l'identificatore client in
SPAPI_CLIENT_IDe il segreto client inSPAPI_CLIENT_SECRET. - Scegli Autorizza app per il tuo account vendor. Amazon mostra un token di aggiornamento (inizia con
Atzr|): incollalo inSPAPI_REFRESH_TOKEN. - Scegli la tua regione in
SPAPI_ENDPOINT(Nord America, Europa o Far East) e inserisci l'id del marketplace del tuo negozio Amazon inSPAPI_MARKETPLACE_ID, ad esempioATVPDKIKX0DER(US),A1PA6795UKMFR9(Germania),A1F83G8C2ARO7P(UK),APJ6JRA9NG5V4(Italia),A13V1IB3VIYZZH(Francia),A1RKKUPIHCS9HS(Spagna),A1VC38T7YXB528(Giappone).
Ruoli: gli strumenti al dettaglio necessitano del ruolo Amazon Fulfillment. Gli strumenti di Adempimento Diretto necessitano di Spedizione Diretta al Consumatore (Riservato), un ruolo riservato perché gli ordini contengono indirizzi dei clienti; Amazon richiede ulteriori informazioni sulla protezione dei dati prima di concederlo. I report vendor necessitano di Brand Analytics. Una chiamata senza il suo ruolo restituisce 403.
Da dove iniziare: amazon_vendor_list_purchase_orders con purchase_order_state New mostra cosa ha ordinato Amazon; amazon_vendor_get_purchase_order fornisce un ordine completo.
Acquisti al dettaglio: amazon_vendor_list_purchase_orders, amazon_vendor_get_purchase_order, amazon_vendor_list_purchase_order_statuses (quantità accettate e ricevute). Rispondi a un ordine con amazon_vendor_submit_acknowledgements, annuncia la spedizione con amazon_vendor_submit_shipment_confirmations, e segui con amazon_vendor_list_shipments e amazon_vendor_list_transport_labels. Le conferme e le conferme di spedizione sono risposte vincolanti per Amazon, quindi amazon_vendor_submit_acknowledgements e amazon_vendor_submit_shipment_confirmations sono installati disattivati, così come amazon_vendor_submit_invoices: attivali nella pagina del connettore quando l'AI dovrebbe inviarli; ti chiederà di confermare ognuno.
Adempimento Diretto (spedisci al cliente di Amazon): amazon_vendor_list_df_orders, amazon_vendor_get_df_order, amazon_vendor_acknowledge_df_orders, amazon_vendor_list_df_packing_slips, amazon_vendor_get_df_packing_slip, amazon_vendor_list_df_customer_invoices, amazon_vendor_list_df_shipping_labels, amazon_vendor_get_df_shipping_label, amazon_vendor_submit_df_shipment_confirmations e amazon_vendor_update_df_inventory. Creare etichette prenota il trasporto: amazon_vendor_request_df_shipping_labels e amazon_vendor_create_df_shipping_labels sono installati disattivati, così come amazon_vendor_acknowledge_df_orders, amazon_vendor_submit_df_shipment_confirmations e amazon_vendor_submit_df_invoices.
Le sottomissioni sono asincrone: ogni strumento di invio risponde con un transactionId e nient'altro. Leggi il risultato con amazon_vendor_get_transaction_status (al dettaglio) o amazon_vendor_get_df_transaction_status (Adempimento Diretto): Elaborazione, Successo o Fallimento con gli errori. Non segnalare una sottomissione come completata prima che dica Successo.
Report (3 passi): amazon_vendor_create_report, poi amazon_vendor_get_report fino a DONE, poi amazon_vendor_download_report_document.
Note sui campi: le chiamate di elenco coprono al massimo 7 giorni per chiamata; gli elenchi di Adempimento Diretto necessitano sia di created_after che di created_before. I tempi sono in formato ISO 8601. Le quantità vengono fornite con un'unità (Casse o Pezzi per il dettaglio, Pezzo per l'Adempimento Diretto); il denaro è una stringa decimale con un codice valuta. partyId è il tuo codice vendor per la parte venditrice e un codice magazzino per le parti di spedizione e ricezione. Pagina degli elenchi con pagination.nextToken.
Limiti di chiamata: 10 chiamate al secondo per operazione con un picco di 10 (stato della transazione: picco 20). In caso di 429 aspetta un momento e chiama di nuovo.
Prerequisiti: SPAPI_CLIENT_ID, SPAPI_CLIENT_SECRET, SPAPI_REFRESH_TOKEN, SPAPI_ENDPOINT, SPAPI_MARKETPLACE_ID
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 Amazon Vendor Central e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
amazon_vendor_list_purchase_orders | Elenca gli ordini di acquisto al dettaglio che Amazon ha effettuato con te, creati o modificati in un intervallo di tempo di al massimo 7 giorni: purchaseOrderNumber… |
amazon_vendor_get_purchase_order | Leggi un ordine di acquisto al dettaglio: stato, data dell'ordine, tipo di ordine di acquisto, finestra di consegna, metodo di pagamento, acquisto, vendita, indirizzo di spedizione e… |
amazon_vendor_list_purchase_order_statuses | Elenca lo stato di adempimento degli ordini di acquisto al dettaglio in un intervallo di tempo di al massimo 7 giorni: purchaseOrderStatus (APERTO, CHIUSO) e per articolo il… |
amazon_vendor_submit_acknowledgements | Riconosci gli ordini di acquisto al dettaglio: accetta, metti in attesa o rifiuta ciascun articolo con la quantità e le date a cui ti impegni. Un riconoscimento… |
amazon_vendor_submit_shipment_confirmations | Invia conferme di spedizione (avvisi di spedizione anticipata) per ordini di acquisto al dettaglio: cosa è stato spedito, da dove, con quale corriere e in… |
amazon_vendor_list_shipments | Elenca le spedizioni al dettaglio di cui Amazon è a conoscenza, con dettagli sul corriere, stato attuale, contenitori e gli ordini di acquisto in essi. Filtra per il tuo… |
amazon_vendor_list_transport_labels | Elenca le etichette di trasporto per pacchi piccoli che Amazon ha già creato per le spedizioni al dettaglio: dati dell'etichetta per pacchetto con numero di tracciamento, più il… |
amazon_vendor_submit_invoices | Invia fatture o note di credito per ordini di acquisto al dettaglio ad Amazon. Una fattura è un documento legale e finanziario: Amazon paga in base ad essa e un… |
amazon_vendor_get_transaction_status | Leggi il risultato di una sottomissione al dettaglio (riconoscimento, conferma di spedizione o fattura) tramite il suo transactionId: stato Elaborazione, Successo… |
amazon_vendor_list_df_orders | Elenca gli ordini di acquisto per Adempimento Diretto (ordini che spedisci direttamente ai clienti di Amazon) creati in un intervallo di tempo di al massimo 7 giorni… |
amazon_vendor_get_df_order | Leggi un ordine di acquisto per Adempimento Diretto: stato, data dell'ordine, indirizzo di spedizione del cliente, dettagli della spedizione (metodo di spedizione, priorità, promesso… |
amazon_vendor_acknowledge_df_orders | Riconosci gli ordini di acquisto per Adempimento Diretto: conferma o rifiuta con la quantità per articolo. Rifiutare annulla l'ordine del cliente su… |
amazon_vendor_list_df_shipping_labels | Elenca le etichette di spedizione che già esistono per ordini di Adempimento Diretto creati in un intervallo di tempo di al massimo 7 giorni: purchaseOrderNumber, etichetta… |
amazon_vendor_get_df_shipping_label | Leggi l'etichetta di spedizione che esiste per un ordine di Adempimento Diretto: formato dell'etichetta e numero di tracciamento per pacchetto, corriere, metodo di spedizione… |
amazon_vendor_request_df_shipping_labels | Chiedi ad Amazon di creare etichette di spedizione per ordini di Adempimento Diretto con corrieri pagati da Amazon. Questo prenota il trasporto per i pacchi. Amazon… |
amazon_vendor_create_df_shipping_labels | Crea le etichette di spedizione per un ordine di Adempimento Diretto e ricevile immediatamente (contenuto dell'etichetta come Base64 con numeri di tracciamento). Questo… |
amazon_vendor_submit_df_shipment_confirmations | Conferma che gli ordini di Adempimento Diretto siano stati spediti (o non potessero essere: FLOOR_DENIAL), con la quantità spedita per articolo e i pacchetti.… |
amazon_vendor_list_df_packing_slips | Elenca i documenti di imballaggio che Amazon ha preparato per ordini di Adempimento Diretto creati in un intervallo di tempo di al massimo 7 giorni: purchaseOrderNumber, contenuto… |
amazon_vendor_get_df_packing_slip | Leggi il documento di imballaggio di un ordine di Adempimento Diretto: tipo di contenuto e contenuto del documento (Base64 di un PDF) da inserire nel pacco. Limite: 10… |
amazon_vendor_list_df_customer_invoices | Elenca le fatture dei clienti che Amazon ha preparato per ordini di Adempimento Diretto creati in un intervallo di tempo di al massimo 7 giorni (negozi dove la fattura… |
amazon_vendor_update_df_inventory | Invia lo stock disponibile per Adempimento Diretto in uno dei tuoi magazzini. Con is_full_update false solo gli articoli elencati cambiano… |
amazon_vendor_submit_df_invoices | Invia fatture per ordini di Adempimento Diretto ad Amazon. Una fattura è un documento legale e finanziario: Amazon paga in base ad essa. Amazon elabora… |
amazon_vendor_get_df_transaction_status | Leggi il risultato di una sottomissione per Adempimento Diretto (riconoscimento, conferma di spedizione, aggiornamento inventario, richiesta di etichetta o fattura) tramite… |
amazon_vendor_create_report | Richiedi un report vendor tramite l'API Reports (passo 1 di 3), per il marketplace di questo connettore. Tipi di report vendor… |
amazon_vendor_get_report | Controlla un report (passo 2 di 3): processingStatus è IN_QUEUE, IN_PROGRESS, DONE, CANCELLED o FATAL. Poll fino a DONE, poi passa… |
amazon_vendor_download_report_document | Leggi il contenuto di un report completato (passo 3 di 3). Il server recupera il file, lo decomprime e lo restituisce: report di analisi vendor… |
Esempi di richieste
- "Quali nuovi ordini di acquisto Amazon sono arrivati questa settimana e quali quantità richiedono?"
- "Mostra l'ordine di acquisto 2JK3S9VC con i suoi articoli e la finestra di spedizione."
- "Quali ordini di Adempimento Diretto necessitano ancora di un'etichetta di spedizione?"
- "Controlla la transazione 12345-abcde: Amazon ha accettato la fattura che ho inviato?"
- "Richiedi un report di vendita vendor per la scorsa settimana e dimmi quando è pronto."
Prossimi passi
Questa guida ti è stata utile?