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
- Richieda i ruoli nel suo profilo sviluppatore e 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) - In Entità commerciali supportate, selezioni i quattro partner:
- Trasporto
- Venditori
- Spedizione
- Fornitori
- In Ruoli, selezioni ogni ruolo elencato:
- Trasporto e Spedizione: Logistica Amazon
- Venditori e Fornitori: Finanze e contabilità, Monitoraggio di inventario e ordini, Gestito da Amazon
- Alla domanda sul token di dati riservati (RDT), scelga Sì, delegherò l'accesso ai PII all'applicazione di un altro sviluppatore, poi selezioni:
- Servizi professionali
- Assistenza ai partner di vendita
- Spedizione diretta ai clienti
- Versamento delle imposte
- Fatturazione delle imposte
- Lasci vuoti URI di accesso OAuth e URI di reindirizzamento OAuth. Il pulsante Authorize non usa questi indirizzi.
- 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.
Senza Spedizione diretta ai clienti e Fatturazione delle imposte, Amazon non condivide nome, indirizzo e partita IVA dell'acquirente: le fatture escono senza. Se modifica queste caselle in seguito, faccia di nuovo clic su Authorize e incolli il nuovo refresh token.
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.
Versamenti
I versamenti Amazon vengono sincronizzati ogni giorno dai Suoi report di liquidazione. Li trova nel menu Versamenti del Suo connettore Amazon, con gli ordini, i rimborsi e le commissioni di ogni versamento.
Marketplace
Un account venditore Amazon vende su più marketplace (Amazon.fr, Amazon.de…). Ogni ordine, rimborso e versamento indica il marketplace da cui proviene.
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 i ruoli dell'applicazione, in particolare Monitoraggio di inventario e ordini, Finanze e contabilità e, nella sezione RDT, Spedizione diretta ai clienti e Fatturazione delle imposte
- Se ha modificato i ruoli, faccia di nuovo clic su Authorize e incolli il 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