Il canale Manual/API

Quando usare un canale Manual/API

Un canale Manual/API non è collegato a nessun negozio. Non viene caricato nulla su un sito e nessun ordine arriva da solo. Usalo quando:

• Vendi sul tuo sito, su un marketplace a cui non ci colleghiamo, sui social o per telefono, e vuoi inviarci ogni ordine tu stesso.
• Hai un tuo sistema o sviluppatore e vuoi inviarci ordini tramite la nostra API.

Se il tuo negozio è su una piattaforma mostrata nella pagina Add Sales Channel, come Shopify, WooCommerce, eBay o TikTok Shop, collega invece quella piattaforma. Così i prodotti vengono caricati per te e gli ordini arrivano da soli.

Puoi avere più di un canale Manual/API, per esempio uno per ogni sito.

Creare il canale

1. Apri Channels nel menu. Vedi l'elenco dei tuoi Sales Channels.
2. Premi Add Sales Channel. La pagina mostra Select channel you want to create.
3. Sulla card Manual/API premi Create.
4. Si apre una finestra Create platform manual. Digita un nome per il canale, per esempio il nome del tuo sito. Il nome può avere fino a 28 caratteri.
5. Premi Create.

Vedi il messaggio Your Manual store has been created. e si apre la pagina del canale.

Ogni tuo canale ha bisogno del proprio nome. Se il nome è già usato da un altro dei tuoi canali, la finestra mostra un errore. Scegli un nome diverso.

La pagina del tuo canale

La pagina del canale ha il nome del tuo canale come titolo e l'intestazione Manual/API order management. Mostra tre riquadri, ciascuno con un link View all:

• Orders: gli ordini che hai inserito in questo canale.
• Clients: le persone a cui invii ordini.
• Products: i prodotti nel tuo elenco My Products.

Nel menu, sotto il nome del canale, trovi:

• Baskets: ordini che hai iniziato e non hai ancora pagato.
• My Products: i prodotti che vendi in questo canale. Vedi Gestire i prodotti sul canale Manual/API.
• Clients: i tuoi acquirenti. Vedi Gestire i clienti.
• Orders: i tuoi ordini inseriti. Vedi Inserire ordini manualmente.
• API: token e documentazione per collegare il tuo sistema.

Il modo abituale di lavorare è:

1. Aggiungi i prodotti che vendi a My Products con Add products. Serve per l'API. Per gli ordini che digiti tu stesso è facoltativo: il carrello ti permette di scegliere qualsiasi prodotto che vendiamo.
2. Quando ricevi un ordine, apri Clients, trova il tuo acquirente o aggiungilo.
3. Sulla pagina del cliente premi Create Order, aggiungi prodotti e quantità e paga.

Cambiare il nome o chiudere il canale

Per rinominare il canale, premi Edit sulla pagina del canale e cambia Store name.

Per chiudere un canale, vai su Channels e premi il pulsante di chiusura nella colonna Action (tooltip Close channel). La finestra chiede Are you sure you want to close this channel? e avverte This operation is irreversible. Un canale chiuso esce dal menu. I tuoi ordini e fatture passati vengono conservati.

Collegare il tuo sistema con l'API

L'API permette al tuo sito o alla tua app di fare da sola quello che fai nelle pagine del canale: leggere il nostro catalogo prodotti con prezzi in tempo reale, aggiungere prodotti a My Products, creare e cambiare clienti, creare ordini, aggiungervi prodotti, inviarli e seguirli. Puoi anche scaricare il tuo elenco My Products come feed CSV o JSON per caricare i prodotti nel tuo sito.

Apri API sotto il tuo canale. La pagina ha queste schede:

• Overview: come collegarsi, l'indirizzo base dell'API e il pulsante API documentation. La documentazione elenca ogni endpoint con esempi.
• API tokens: i token di questo canale.
• API calls: le richieste fatte dal tuo sistema.
• History: le modifiche fatte sul tuo account.

Ottenere un token

1. Premi Generate API token.
2. Se il token serve solo per leggere i dati, spunta Read only (cannot create, change or submit orders).
3. Premi Click to Generate.
4. Copia il token con l'icona di copia e conservalo al sicuro. La finestra dice Put this token in a safe place, you won't be able to see it again. La breve etichetta nell'elenco token è solo un nome, non il token.

Invia il token con ogni richiesta nell'header Authorization: Bearer seguito dal tuo token. Ogni token appartiene a un canale: prodotti, clienti e ordini che il tuo sistema crea vanno a quel canale. Per far smettere di funzionare un token, eliminalo nella scheda API tokens.

Prova prima su staging

La scheda Overview ha anche Open staging mirror. Staging è una copia separata del sito dove puoi fare test senza ordini o pagamenti reali. Accedi con la stessa email e password. Staging viene reimpostato regolarmente con una copia nuova, il che cancella ciò che hai creato lì. I token del sito reale non funzionano su staging: genera un token separato su staging, e uno nuovo dopo ogni reset. L'indirizzo base di staging è mostrato nella scheda Overview.

Come vengono pagati gli ordini dall'API

Quando il tuo sistema invia un ordine, lo paghiamo prima dal saldo del tuo account, poi dalle tue carte salvate. Aggiungi una carta prima di iniziare. Una volta che hai un token, il menu mostra Saved Cards. Finché non è salvata nessuna carta, la pagina API mostra You have no cards saved yet. con un pulsante Add card.

Se né il tuo saldo né le tue carte coprono l'ordine, l'ordine viene segnato Unpaid e non passa al magazzino. Ricarica il tuo saldo con Top Up, apri l'ordine e premi Pay … with balance. Il pulsante compare quando il tuo saldo copre l'importo dovuto.

Quando qualcosa non funziona

• Il nome è già usato quando creo il canale. Un altro dei tuoi canali aperti ha quel nome. Digita un nome diverso. Il nome di un canale chiuso può essere riusato.
• I miei ordini non arrivano da soli. Un canale Manual/API non raccoglie mai ordini da un sito. Creali nella pagina del cliente, oppure inviali dal tuo sistema tramite l'API. Se vendi su una piattaforma mostrata nella pagina Add Sales Channel, collega quella piattaforma come canale a sé.
• I miei prodotti non sono sul mio sito. Non carichiamo nulla da un canale Manual/API. Caricali tu stesso nel tuo sito, con lo scarico CSV in My Products o tramite l'API.
• Ho perso il mio token API. Non può essere mostrato di nuovo. Genera un nuovo token, mettilo nel tuo sistema ed elimina quello vecchio.
• L'API risponde che non posso creare o cambiare ordini. Il token è di sola lettura. Genera un token senza Read only spuntato.
• L'API rifiuta le mie richieste per un po'. Ogni token può fare fino a 120 richieste al minuto. Rallenta il tuo sistema e riprova dopo un minuto.
• L'API dice "This order has no products yet". Aggiungi almeno un prodotto all'ordine prima di inviarlo.
• L'API dice "Unable to find related portfolio item". Tramite l'API aggiungi un prodotto a un ordine tramite il suo elemento My Products, non tramite il prodotto stesso. Aggiungi prima il prodotto a My Products e usa l'id di quell'elemento.
• L'API dice che esiste già un'altra transazione con lo stesso prodotto. Il prodotto è già nell'ordine. Cambia la quantità di quella riga invece di aggiungerlo di nuovo.
• L'API dice che l'ordine "is already in the 'submitted' state and cannot be updated". Gli ordini inviati non possono essere cambiati o eliminati tramite l'API. Chiedici nella chat del nostro sito se l'ordine deve cambiare.
• Il mio ordine API mostra Unpaid. Il tuo saldo e le tue carte salvate non lo coprivano. Ricarica il tuo saldo, apri l'ordine e premi Pay … with balance, e controlla che la tua carta salvata sia ancora valida.