275 lines
11 KiB
Text
275 lines
11 KiB
Text
<!DOCTYPE html>
|
|
<html lang="it">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
<title>Manuale Configurazione API Amazon Seller Central</title>
|
|
<style>
|
|
body {
|
|
font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
|
|
line-height: 1.6;
|
|
color: #333;
|
|
max-width: 900px;
|
|
margin: 0 auto;
|
|
padding: 20px;
|
|
background-color: #f9f9f9;
|
|
}
|
|
h1 {
|
|
color: #232f3e; /* Amazon Dark Blue */
|
|
border-bottom: 3px solid #ff9900; /* Amazon Orange */
|
|
padding-bottom: 10px;
|
|
}
|
|
h2 {
|
|
color: #232f3e;
|
|
margin-top: 40px;
|
|
border-left: 5px solid #ff9900;
|
|
padding-left: 10px;
|
|
}
|
|
h3 {
|
|
color: #444;
|
|
margin-top: 25px;
|
|
}
|
|
.step {
|
|
background: #fff;
|
|
padding: 20px;
|
|
margin-bottom: 20px;
|
|
border-radius: 8px;
|
|
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
|
|
}
|
|
.step-number {
|
|
display: inline-block;
|
|
background: #232f3e;
|
|
color: #fff;
|
|
width: 30px;
|
|
height: 30px;
|
|
text-align: center;
|
|
line-height: 30px;
|
|
border-radius: 50%;
|
|
margin-right: 10px;
|
|
font-weight: bold;
|
|
}
|
|
code {
|
|
background-color: #eee;
|
|
padding: 2px 5px;
|
|
border-radius: 3px;
|
|
font-family: 'Courier New', Courier, monospace;
|
|
color: #d63031;
|
|
}
|
|
.note {
|
|
background-color: #fff3cd;
|
|
border: 1px solid #ffeeba;
|
|
color: #856404;
|
|
padding: 15px;
|
|
border-radius: 5px;
|
|
margin-top: 10px;
|
|
}
|
|
.important {
|
|
font-weight: bold;
|
|
color: #c0392b;
|
|
}
|
|
.image-placeholder {
|
|
background-color: #e0e0e0;
|
|
border: 2px dashed #aaa;
|
|
color: #555;
|
|
padding: 20px;
|
|
text-align: center;
|
|
margin: 15px 0;
|
|
border-radius: 5px;
|
|
}
|
|
table {
|
|
width: 100%;
|
|
border-collapse: collapse;
|
|
margin-top: 20px;
|
|
}
|
|
th, td {
|
|
border: 1px solid #ddd;
|
|
padding: 12px;
|
|
text-align: left;
|
|
}
|
|
th {
|
|
background-color: #232f3e;
|
|
color: white;
|
|
}
|
|
tr:nth-child(even) {
|
|
background-color: #f2f2f2;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<h1>Manuale Configurazione API Amazon (SP-API)</h1>
|
|
<p>Guida completa per attivare le nuove credenziali SP-API per software gestionali privati. Aggiornato al 2025.</p>
|
|
|
|
<div class="step">
|
|
<h2>Prerequisiti</h2>
|
|
<p>Prima di iniziare, assicurati di avere accesso a:</p>
|
|
<ul>
|
|
<li>Amazon Seller Central (Account Amministratore)</li>
|
|
<li>Amazon Web Services (AWS) Console</li>
|
|
<li>Il tuo software gestionale aperto sulla schermata dei parametri</li>
|
|
</ul>
|
|
</div>
|
|
|
|
<!-- SEZIONE 1: AWS -->
|
|
<div class="step">
|
|
<h2>Fase 1: Configurazione AWS (Creazione Utente e Ruolo)</h2>
|
|
|
|
<h3>1. Creare l'Utente IAM (Per le Chiavi di Accesso)</h3>
|
|
<ol>
|
|
<li>Accedi alla console AWS > Cerca <strong>IAM</strong>.</li>
|
|
<li>Vai su <strong>Utenti</strong> > <strong>Crea utente</strong> (es. nome: <code>GestionaleUser</code>).</li>
|
|
<li>Una volta creato, clicca sul nome dell'utente > Tab <strong>Credenziali di sicurezza</strong>.</li>
|
|
<li>Scorri a "Chiavi di accesso" > <strong>Crea chiave di accesso</strong>.</li>
|
|
<li>Seleziona "Applicazione al di fuori di AWS".</li>
|
|
<li><span class="important">Copia subito i dati!</span> Non verranno più mostrati.</li>
|
|
</ol>
|
|
<div class="note">
|
|
<strong>Dati da salvare:</strong><br>
|
|
- <strong>IAM Access Key:</strong> (Inizia con AKIA...)<br>
|
|
- <strong>IAM Secret Key:</strong> (Stringa lunga segreta)
|
|
</div>
|
|
<p>Torna in alto nella pagina dell'utente e copia l'<strong>ARN Utente</strong> (es. <code>arn:aws:iam::123456789:user/GestionaleUser</code>). Ti servirà tra poco.</p>
|
|
|
|
<h3>2. Creare il Ruolo IAM (Per l'autorizzazione)</h3>
|
|
<ol>
|
|
<li>Sempre in IAM > Vai su <strong>Ruoli</strong> > <strong>Crea ruolo</strong>.</li>
|
|
<li>Seleziona <strong>Account AWS</strong>.</li>
|
|
<li>Dai un nome al ruolo (es. <code>SellingPartnerRole</code>) e crea.</li>
|
|
<li>Clicca sul ruolo appena creato.</li>
|
|
<li>Vai su <strong>Relazioni di attendibilità</strong> (Trust Relationships) > <strong>Modifica</strong>.</li>
|
|
<li>Incolla questo JSON modificando l'ARN con quello del tuo Utente (copiato al punto precedente):</li>
|
|
</ol>
|
|
<pre><code>{
|
|
"Version": "2012-10-17",
|
|
"Statement": [
|
|
{
|
|
"Effect": "Allow",
|
|
"Principal": {
|
|
"AWS": "arn:aws:iam::TUO_ID_ACCOUNT:user/NOME_TUO_UTENTE"
|
|
},
|
|
"Action": "sts:AssumeRole"
|
|
}
|
|
]
|
|
}</code></pre>
|
|
<div class="note">
|
|
<strong>Dato da salvare:</strong><br>
|
|
- <strong>IAM Role ARN:</strong> (Inizia con <code>arn:aws:iam::...:role/SellingPartnerRole</code>)
|
|
</div>
|
|
</div>
|
|
|
|
<!-- SEZIONE 2: SELLER CENTRAL -->
|
|
<div class="step">
|
|
<h2>Fase 2: Registrazione App su Seller Central</h2>
|
|
|
|
<h3>1. Attivare il Profilo Sviluppatore</h3>
|
|
<p>Vai su <strong>Partner Network</strong> > <strong>Sviluppa app</strong> > Clicca su "Profilo Sviluppatore".</p>
|
|
<ul>
|
|
<li>Seleziona: <strong>Sviluppatore Privato</strong> (La mia organizzazione crea app solo per la mia azienda).</li>
|
|
<li>Non richiedere accesso a dati PII (Dati personali) se non strettamente necessario per evitare lunghe revisioni.</li>
|
|
<li>Attendi l'approvazione (da 24h a 5 giorni).</li>
|
|
</ul>
|
|
|
|
<h3>2. Creare l'App</h3>
|
|
<ol>
|
|
<li>Una volta approvato, torna su <strong>Sviluppa app</strong> > <strong>Aggiungi nuovo client app</strong>.</li>
|
|
<li>Configurazione:
|
|
<ul>
|
|
<li><strong>Tipo API:</strong> SP-API</li>
|
|
<li><strong>Tipo app:</strong> Produzione</li>
|
|
<li><strong>Entità economiche:</strong> Seleziona SOLO <strong>"Venditori"</strong>.</li>
|
|
</ul>
|
|
</li>
|
|
<li><strong>Ruoli:</strong> Seleziona "Assegnazione Prezzo", "Offerte prodotti", "Gestione Ordini".</li>
|
|
<li>Salva. L'app rimarrà in stato <strong>Bozza</strong> (Draft). È normale e funziona ugualmente per uso privato.</li>
|
|
</ol>
|
|
|
|
<div class="image-placeholder">
|
|
<img src="awsAppRuoli.png" width="756" height="862" alt=""/></div>
|
|
|
|
<h3>3. Recuperare le Credenziali LWA</h3>
|
|
<p>Nella schermata dell'app:</p>
|
|
<ol>
|
|
<li>Clicca su <strong>Visualizza</strong> sotto "Credenziali LWA".
|
|
<br>-> Copia <strong>Client ID</strong> e <strong>Client Secret</strong>.
|
|
</li>
|
|
<li>Clicca sulla freccia accanto a "Modifica App" > Seleziona <strong>Autorizza</strong>.
|
|
<br>-> Questo genererà il <strong>Refresh Token</strong> (Gettone di aggiornamento). Copialo subito!
|
|
</li>
|
|
</ol>
|
|
</div>
|
|
|
|
<!-- SEZIONE 3: MODELLO SPEDIZIONE -->
|
|
<div class="step">
|
|
<h2>Fase 3: Modello di Spedizione (Merchant Shipping Group)</h2>
|
|
<p>Per configurare la spedizione gratuita e ottenere l'ID.</p>
|
|
<ol>
|
|
<li>Vai su Seller Central > Impostazioni > <strong>Impostazioni di spedizione</strong>.</li>
|
|
<li>Crea o Modifica un modello.</li>
|
|
<li>Imposta tariffa: <strong>Per Articolo/Peso</strong>.</li>
|
|
<li>Imposta i costi a <strong>0.00</strong> sia per ordine che per kg.</li>
|
|
<li>Salva.</li>
|
|
<li>Guarda l'URL nel browser (es. <code>.../templateId=e5efe0c6-7346...</code>).</li>
|
|
<li>Copia la stringa alfanumerica dopo l'uguale. Quello è il tuo ID.</li>
|
|
</ol>
|
|
</div>
|
|
|
|
<!-- TABELLA RIASSUNTIVA -->
|
|
<div class="step">
|
|
<h2>Riepilogo Dati per il Software</h2>
|
|
<p>Inserisci questi dati nel tuo gestionale esattamente in questi campi:</p>
|
|
|
|
<table>
|
|
<thead>
|
|
<tr>
|
|
<th>Campo Software</th>
|
|
<th>Descrizione / Dove trovarlo</th>
|
|
<th>Esempio / Formato</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><strong>Seller ID</strong></td>
|
|
<td>Seller Central > Info Account > Gettone Venditore</td>
|
|
<td>Inizia con <code>A...</code> (es. A1BC23DE...)</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Client ID</strong></td>
|
|
<td>Seller Central > App > Credenziali LWA</td>
|
|
<td><code>amzn1.application-oa2...</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Client Secret</strong></td>
|
|
<td>Seller Central > App > Credenziali LWA</td>
|
|
<td><code>amzn1.oa2-cs...</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Refresh Token</strong></td>
|
|
<td>Seller Central > App > Tasto "Autorizza"</td>
|
|
<td>Stringa molto lunga, inizia con <code>Atzr|...</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>IAM Role ARN</strong></td>
|
|
<td>Console AWS > IAM > Ruoli</td>
|
|
<td><code>arn:aws:iam::123...:role/NomeRuolo</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>IAM Access Key</strong></td>
|
|
<td>Console AWS > IAM > Utenti > Crea Chiavi</td>
|
|
<td><code>AKIA...</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>IAM Secret Key</strong></td>
|
|
<td>Console AWS > IAM > Utenti > Crea Chiavi</td>
|
|
<td>Stringa segreta (visibile solo alla creazione)</td>
|
|
</tr>
|
|
<tr>
|
|
<td><strong>Amz Merchant Ship. Gr. Free</strong></td>
|
|
<td>URL del modello di spedizione</td>
|
|
<td><code>xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx</code></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|