# REF AliExpress L'affiliazione diretta AliExpress è fornita tramite l'integrazione con le API ufficiali, alle quali ogni utente deve richiedere l'accesso direttamente ad AliExpress per poi configurarle sul BOT.\ Queste API vengono anche utilizzate per fornire un miglior ottenimento delle info dei prodotti (prezzi, info di spedizione, ecc..)
### Richiesta di accesso alle API e ottenimento della configurazione Si presuppone che siate già registrati all'affiliazione AliExpress, in caso negativo è possibile effettuare la richiesta di registrazione [cliccando qui](https://portals.aliexpress.com/affiportals/web/home.htm) (*la richiesta viene solitamente approvata nel giro di un paio di giorni*). Una volta registrati come affiliati lo step successivo è quello di registrarsi al portale "*Open Platform*" e di richiedere l'accesso alle API. {% hint style="info" %} Qualora si verificassero delle difficoltà in fase di registrazione al portale "Open Platform" si invita a contattare direttamente il vostro *Affiliate Manager* AliExpress. {% endhint %} {% hint style="info" %} Il portale "Open Platform" è diverso dal portale di affiliazione. Per questo motivo è necessaria una registrazione anche se siete già registrati al portale affiliati. {% endhint %} 1. Registrarsi sul portale Open Platform: 2. Potrebbe venir richiesta la tipologia di sviluppatore, selezionare "*Dropshipping / Affiliates Developer*" (l'ultima voce a destra):
4. Una volta effettuato il login troverete il vostro indirizzo mail in alto a destra: selezionate l'opzione "*Profile*"\ ![](/files/nf9EkpCfw1EZyNqvaM9Y)
5. Selezionate la voce "Affiliate" (Individual per privati, Corporation se siete un'azienda) e compilate le voci richieste:
6. Anche in questo caso sarà richiesto un paio di giorni prima che la richiesta venga approvata (*si riceverà una e-mail con l'esito*).\ Tornare quindi sul portale Open Platform ed effettuare il login:
7. In alto sarà presente il menu "*App Console -> App Console*", selezionarlo
8. Selezionare il pulsante blu "*Create*"
9. Selezionare il pulsante "*Create App*" a fianco di "*Affiliate*":
10. Compilare i campi esattamente come riportato di seguito: * **App Name:** "DealsBOT App" * **Callback URL:** "" * **App Description:** "DealsBOT API Integration for Affiliates" * **App Logo:** caricare il file del logo [scaricabile qui](https://dealsbot.io/assets/dealsbot-square-logo.png)
11. Confermare l'invio con il pulsante "*Submit*"
12. Tornando poi sul menu "*App Console*" troveremo l'App appena creata. Selezionare quindi il pulsante "*Manage*" a destra.
13. Si aprirà quindi la sezione "*App Overview*", scorriamo verso il basso nella sezione "API Permission Group":
14. Tra le opzioni nella tabella sarà presente "**Advanced API**", clicchiamo il pulsante "Apply" sulla riga e nel campo "Reason" scriviamo: `Need to obtain shipping informations for products`
15. Selezioniamo il pulsante OK per inviare la richiesta di approvazione, che verrà approvata nel giro di qualche giorno. Questa servirà al BOT per l'ottenimento delle informazioni relative alla spedizione del prodotto (magazzino, tempistiche di spedizione, costo, ecc...). Per maggiori informazioni vedere la [sezione dedicata](#ottenimento-informazioni-sulla-spedizione-di-un-prodotto).
16. Procediamo ora con l'ottenimento della configurazione necessaria per collegare le API al BOT. Nella stessa pagina troveremo poco al di sopra la sezione "**Advanced Informations**".\ \ All'interno saranno presenti le seguenti voci: * **App Key:** chiave API (*numerica*) che andrà inserita sul BOT * **App Secret:** chiave Segreta (*alfanumerica*) che andrà inserita sul BOT (visibile pemendo il pulsante "View")
17. L'App è ora correttamente configurata ed è possibile procedere alla configurazione sul BOT. ### Configurazione delle API sul BOT Le impostazioni relative alle API AliExpress sul BOT si trovano nella sezione:\ \ \&#xNAN;*Impostazioni -> REF -> REF AliExpress* Una volta raggiunta la sezione selezionare il pulsante Configura API e seguire le istruzioni riportate inserendo, in ordine: * L'App Key (*Chiave API*) ottenuta precedentemente * L'App Secret (*Chiave Segreta*) ottenuta precedentemente * Il Tracking ID da utilizzare: i Tracking ID possono essere configurati attraverso l'account affiliazione di AliExpress ([qui](https://portals.aliexpress.com/affiportals/web/tracking_id.htm)).\ Nell'esempio sotto i tracking ID inseribili sul BOT sono "default" oppure "Example-Id": attenzione a **mantenere esattamente** le stesse maiuscole / minuscole quando si riporta il Tracking ID sul BOT!
### Ottenimento informazioni sulla Spedizione di un prodotto Per visualizzare le informazioni relative alla spedizione di un prodotto (magazzino, tempistiche di spedizione, costo...) è necessaria della configurazione aggiuntiva. Prima di tutto va richiesto l'accesso alle "**Advanced API**" per la propria App creata sul portale AliExpress Open Platform (seguire la [guida precedente](#richiesta-di-accesso-alle-api-e-ottenimento-della-configurazione) dal **Punto 12** al **Punto 15** se non è già stato fatto). Una volta ottenuto l'accesso (l'approvazione richiederà qualche giorno e si riceverà la conferma via e-mail), il BOT sarà in grado di ottenere dati relativamente alla spedizione di un prodotto, in particolare: * **Magazzino di spedizione** (TAG `{house}` nei formati testuali):\ il tag `{house}` viene sostituito con nome e bandiera del magazzino, ad esempio "Italia :flag\_it:", "Spagna :flag\_es:" ecc...\ Se per qualche ragione il valore non fosse disponibile, l'intera riga viene rimossa (*non devono essere presenti altri TAG sulla stessa riga*). \ Dunque è possibile creare una riga simile a questa nei formati testuali:\ `Spedito dal magazzino in {house}`\ \ \
* **Tempistiche di spedizione** (TAG `{delivery}` nei formati testuali):\ il tag `{delivery}` viene sostituito con la stima delle tempistiche in giorni di spedizione del prodotto, ad esempio: "4-8", "3", ecc...\ Se per qualche ragione il valore non fosse disponibile, l'intera riga viene rimossa (*non devono essere presenti altri TAG sulla stessa riga*). \ Dunque è possibile creare una riga simile a questa nei formati testuali:\ `Consegna stimata in: {delivery} giorni`
* Costi di spedizione (TAG `{shippingcost}` nei formati testuali):\ il tag `{shippingcost}` viene sostituito con il prezzo di spedizione del prodotto, ad esempio: "0,00", "1,99", ecc...\ Se per qualche ragione il valore non fosse disponibile, l'intera riga viene rimossa (*non devono essere presenti altri TAG sulla stessa riga*). \ Dunque è possibile creare una riga simile a questa nei formati testuali:\ `Consegna a: {shippingcost}€`\
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.dealsbot.io/configurazione-base/configurazione-dei-ref/ref-aliexpress.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.