Configurare Amazon
Ottieni le tue credenziali Amazon SP-API per collegare Order Invoicer
Prerequisiti
Prima di iniziare, assicurati che:
- Disponga di un account Amazon Seller Central attivo
- Sia iscritto al programma Amazon Selling Partner API (SP-API)
- Abbia creato (o abbia accesso a) un'applicazione per sviluppatori SP-API
La Selling Partner API è riservata ai venditori professionali. Se è un venditore privato, dovrà innanzitutto passare a un account professionale per utilizzare l'integrazione.
Ottenere le credenziali SP-API
Order Invoicer necessita di tre informazioni per collegarsi ad Amazon:
- Un refresh token
- Un Client ID (ID dell'applicazione LWA)
- Un Client Secret (segreto dell'applicazione LWA)
Registrarsi come sviluppatore Amazon
Se non l'ha ancora fatto:
- Acceda a Seller Central
- Vada su Apps & Services > Develop Apps
- Segua la procedura di registrazione al programma per sviluppatori SP-API
- Attenda l'approvazione di Amazon (può richiedere diversi giorni)
Creare un'applicazione LWA (Login with Amazon)
- Nella console per sviluppatori Amazon, faccia clic su Add new app client
- Assegni un nome alla sua applicazione (ad es.
Order Invoicer) - Selezioni i ruoli necessari:
- ✅ Product Listing
- ✅ Pricing
- ✅ Inventory and Order Management
- Salvi l'applicazione
- Prenda nota del Client ID (LWA Client ID) e del Client Secret (LWA Client Secret) visualizzati
Il Client Secret è un dato sensibile. Non lo condivida e non lo pubblichi su piattaforme pubbliche.
Autorizzare l'applicazione e generare un refresh token
- Dalla sua console per sviluppatori, faccia clic su Authorize accanto alla sua applicazione
- Acceda con l'account Seller Central che desidera collegare
- Accetti le autorizzazioni richieste
- Amazon restituisce un refresh token (una stringa che inizia con
Atzr|...) - Copi immediatamente questo refresh token
Il refresh token viene visualizzato una sola volta. Se lo perde, dovrà ripetere la procedura di autorizzazione.
Il refresh token è valido a lungo termine. Order Invoicer lo utilizza per ottenere automaticamente nuovi access token quando necessario.
Inserire le credenziali in Order Invoicer
Dal modulo di connessione Amazon in Order Invoicer, inserisca:
- Refresh Token: il token ottenuto nel passaggio precedente
- Client ID: il Client ID LWA della sua applicazione
- Client Secret: il Client Secret LWA della sua applicazione
Il connettore convaliderà automaticamente le sue credenziali interrogando la SP-API.
Risoluzione dei problemi
Errore "Invalid credentials"
- Verifichi che il refresh token sia stato copiato per intero (di solito è molto lungo)
- Verifichi che il Client ID e il Client Secret appartengano alla stessa applicazione
- Si assicuri che non vi siano spazi all'inizio o alla fine delle stringhe
Errore "Access denied" o "Missing permissions"
- Verifichi che la sua applicazione disponga dei ruoli necessari (in particolare la gestione degli ordini)
- Se ha modificato i ruoli, dovrà ripetere l'autorizzazione per generare un nuovo refresh token
Errore "Token expired"
- I refresh token possono essere revocati da Seller Central; verifichi che siano ancora attivi
- Se sono stati revocati, ripeta la procedura di autorizzazione per ottenere un nuovo refresh token
Riferimento API
Per maggiori dettagli sull'Amazon SP-API, consulti:
Assistenza
Se incontra difficoltà:
- Consulti la sezione sulla risoluzione dei problemi qui sopra
- Faccia riferimento alla documentazione ufficiale di Amazon SP-API
- Contatti la nostra assistenza:
contact@orderinvoicer.com