Come abilitare le connessioni API in Woocommerce / PrestaShop/ Shopify / Magento 1 / bindCommerce

Woocommerce

Accedendo al menù di amministrazione di Wordpress selezionamo la voce Woocommerce → Impostazioni → Avanzate e successivamente la voce API REST nel sottomenù



Selezioniamo il pulsante Aggiungi Chiave
Inseriamo i dati richiesti e procediamo con la generazione delle chiavi
Ottenute le chiavi procediamo nell'inserimento dei dati in SystemCloud come evidenziato nel passo successivo.

PrestaShop

Accedendo al menù di amministrazione di PrestaShop nella sezione Configura selezionamo la voce Parametri Avanzati → Webservice



Selezioniamo il pulsante Aggiungi una nuova chiave di servizio che si trova in alto a destra
Procediamo con la generazione della chiave attraverso il tasto "Crea" e all'attribuzione dei permessi alle funzioni necessarie all'integrazione con SystemCloud.it:

• addresses
• carriers
• contacts
• coutries
• currencies
• customers
• order_carriers
• order_details
• order_histories
• order_payments
• order_states
• orders
• products
• states
• taxes

Ottenute le chiave procediamo nell'inserimento dei dati in SystemCloud come evidenziato nel passo successivo.

Shopify

Per permettere l'interazione con SystemCloud attravero le API di Shopify è necessario abilitare lo sviluppo di App private dal pannello di controllo di shopify:

• dal pannello di controllo passa ad App
• gestisci app private
• clicca su abilita App private
• leggi e controlla i termini, quindi clicca su Abilita lo sviluppo di app private.

Dopo aver abilitato lo sviluppo di app private, puoi generare nuove credenziali per un'app privata.

• Dal tuo pannello di controllo Shopify, passa ad App
• Clicca su Gestisci app private.
• Clicca su Crea app privata.
• Nella sezione Dettagli app, inserisci un nome per la tua app privata e un indirizzo email di contatto(Es. SystemCloud - info@systemcloud.it)
• Nella sezione API pannello di controllo, seleziona le aree del tuo negozio a cui vuoi che l'app abbia accesso(Ordini, anagrafiche clienti, prodotti, collezioni).
• Quando hai finito, clicca Salva.

Per maggiori informazioni è possibile fare riferimento alla documentazione ufficiale:
https://help.shopify.com/it/manual/apps/app-types/custom-apps#enable-custom-app-development

Magento 1

Contattare il supporto a info@systemcloud.it per ottenere info sull'integrazione...

bindCommerce

Contattare il supporto a info@systemcloud.it per ottenere info sull'integrazione...

Come configurare la connessione al tuo E-commerce

Dopo aver attivato la funzione di scambio dati all'interno dell'e-commerce, possiamo configurare i parametri di connessione in SystemCloud.it accedendo al menù Impostazioni



Cliccando sull'icona E-Commerce si accede alla schermata di configurazione:

• "Nome E-commerce:" → nome interno assegnato alla piattaforma di vendita(utile quando nel sistema sono cofigurate più piattaforme tramite il modulo multi E-commerce).
• "Tipo E-commerce:" → selezionare la piattaforma tecnologica utilizzata dal vostro ecommerce.
• "Url completo del sito E-Commerce:" → indirizzo web completo del vostro ecommerce (es. https://www.shop.miodominio.it/)
• "API Key:" → api key generata nell' ecommerce per l'accesso di SystemCloud
• "API Secret:" → api secret generata nell'ecommerce per l'accesso di SystemCloud (non necessaria per bindCommerce)
• "Access Token:" → token generata nell' ecommerce (solo per Magento)
• "Token Secret:" → token secret generata nell'ecommerce (solo per Magento)
• "Data ordine SystemCloud:"
• Data odierna → l'ordine SystemCloud verrà acquisito con la data in cui avviene effettauta l'importazione ordini
• Data ordine ecommerce → l'ordine SystemCloud verrà acquisito con lo stessa data dell'ordine ecommerce abbinato
• "Verifica coerenza data:" → se impostato a SI e Data ordine SystemCloud ha valore "Data ordine ecommerce" viene verificato che le date acquisite abbiano querenza temporale con il numero ordine
• "Sezionale numero ordine:" → sezionale da cui prelevare la numerazione degli ordini, in caso di più ecommerce impostati è possibile attribuire numerazioni seprate
• "Acquisisci ordini in stato:" → selezionare lo stato degli ordini da acquisitre in SystemCloud.it
• "Plugin per gestione partita iva cliente:" → dato che woocommerce non gestisce in modo nativo il campo partita iva o codice fiscale sui cliente ed indispensabile per la gestione in SystemCloud specificare quali tra i plugin disponibili avete configurato in woocommerce per la gestione di queste informazioni
• "Opzioni anagrafica cliente su ordine:" → questa opzione consente di:
  • importa anagrafica da ecommerce → abbinare l'anagrafica presente nell'ordine con l'anagrafica SystemCloud attraverso il campo partita iva o codice fiscale, se l'anagrafica non è presente in SystemCloud viene inserita automaticamente. Se l'anagrafica cliente nell'ordine non ha valorizzato almeno uno dei campi partita iva o codice fiscale l'ordine non viene importato
  • importa anagrafica da ecommerce se errore usa default come in campo Cliente → questa opzione abbina l'anagrafica con le logiche definite nell'opzione precedente, in caso il cliente presente nell'ordine non abbia partita iva o codice fiscale non viene generato un errore e l'ordine viene acquisito con l'anagrafica inserita nel campo cliente.
  • Utilizza anagrafica fissa per tutti gli ordini indicata nel campo Cleinte → questa opzione aquisisce ogni ordine presente nell'ecommerce abbinando l'anagrafica presente nel campo cliente ed ignorando l'anagrafica presente nell'ordine ecommerce.
• "Cliente:" → valore opzionale utilizzato per swpecificare l'anagrafica di Default eventualmente necessaria dalla valorizzazione del campo "Opzioni anagrafica cliente su ordine:"
• "Pagamento per vendite online:" → tipo pagamento abbinato all'ordine, In Shopify è possibile creare un link con i pagamenti SystemCloud per abbinare lo stesso gateway presente sull'ecommerce
• "Tipo acquisizione per nuovo clienti:" → tipo di acquisizione in caso di inserimento di una nuova anagrafica abbinata all'ordine

N.B.
Per confermare la configurazione impostata è necessario eseguire un test di lettura di un ordine presente sul vostro e-commerce, inserire nel campo id ordine e-commerce l'identificativo di un ordine qualsiasi presente sull'ecommerce e cliccare su Visualizza ordine.

• Shopify: l'id ordine è visualizzabile aprendo l'ordine su shopify e leggendo il numero finale contenuto nell'url

Prima di eseguire il test con l'ordine di prova verifcare che gli SKU prensenti nell'ordine siano correttamente abbinati agli articoli e che il cliente sia già inserito in SystemCloud con la mail utilizzata nell'ordine ecommerce.

Se la lettura dei dati avviene correttamente viene visualizzata l'anteprima dell'ordine, altrimente vengono mostrati gli errori riscontrati
Per confermare la configurazione è necessario che la lettura dell'ordine avvenga senza errori.

Come abbinare gli articoli

L'acquisizione degli ordini prevede che ogni articolo in vedita sull'ecommerce abbia una esatta corrispondenza con un articolo presente in SystemCloud.it da cui, nella fase di importazione vengono prelevate le informazioni relative all'aliquota iva da applicare ed altre proprietà.
L'abbinamento tra l'articolo e-commerce ed il suo omonimo in SystemCloud è formalizzato dal codice SKU che deve assumere lo stesso valore in entrambi i programmi.
Vediamo come impostare il codice SKU in Woocommerce, dal menù princilapale selezioniamo Prodotti:
Sull'articolo desiderato selezionare Modifica e nella sezione inventario valorizzare il campo SKU o COD con il codice desiderato:


A questo punto dobbiamo abbinare l'articolo con il suo riferimento in SystemCloud.it valorizzando il campo SKU con il codice appena inserito, dal menù principale selzioniamo Magazzino → Articoli e tramite il menù azioni selezioaniamo il modifica l'articolo desiderato:

Selezionando in alto a destra la voce Dettaglio articolo/Listini accediamo alla schermata dove valorizzare il campo SKU(e-commerce):

Come importare nuovi ordini

Dal menù principale selezionare Vendite → Ordini di vendita



Selezionaimo il pulsante Azioni per acquisire dal nostro e-commerce gli ordini nello stato selezionato nella configurazione del modulo.

Gli ordini acquisiti sono in stato Da approvare (E-comm)
Possiamo selezionare in modifica l'ordine per controllarne il contenuto, come ad esmpio l'indirizzo di fatturazione, le righe e l'indirizzo di spedizione.

Come avere la giacenza prodotti sincronizzata sull'ecomemrce

Con SystemCloud è possibile che il tuo ecommerce abbia in tempo reale lo stock disponibile a magazzino ed inoltre abbia anche le quantità di prodotto in ordine o in arrivo dalla produzione in modo da fornire delle tempistiche precise di evasione al cliente finale.
Per ottenere ciò è sufficiente abilitare il modulo API di SystemCloud ed integrare nel tuo ecommerce la chiamata api /products/stockbysku.
Per maggiori dettagli puoi consultare la guida di riferimento delle API SystemCloud a questo link:
https://www.systemcloud.it/doc/doc-API-software-terzi.html