Il manuale OnLine di Bman

Connettore WooCommerce (wordpress)

Prima di impostare il connettore specifico per WooCommerce è necessario creare una API REST specifica per Bman nel tuo sito WooCommerce. Per farlo accedi come amministratore sul sito ed dal menu WooCommerce è necessario entrare in “impostazioni – avanzate – API REST” e creare una nuova chiave:

Impostazioni Api Rest WooCommrce

Crea un nuova chiave e assegnale il permesso di lettura/scrittura

Creare nuova chiave API

Una volta generata la chiave, otterremo la key (o “chiave utente” se utilizzate WooCommerce in italiano) ed il secret (o “utente nascosto” se utilizzate WooCommerce in italiano) da inserire su Bman, non chiudete questa scheda fino a quando non avete impostato key e secret su Bman altrimenti sareste costretti a generare una nuova chiave.

Recupera Key e Secret

Adesso è necessario creare un connettore Bman, entrando in “Utilità – impostazioni ” nella sezione E-commerce cliccare su “E-commerce sterni”

Connettore WordPress Bman

Url – Impostare la url del vostro sito seguita /wp-json/wc/v3/
quindi se per esempio il vostro shop si trova alla url https://www.mioshop.it
nel campo url dovrete inserire https://www.mioshop.it/wp-json/wc/v3/

Key – Impostare la key generata automaticamente nelle api di
woocommerce

Secret – Impostare il secret generato automaticamente nelle api di WooCommerce

Torniamo su woocommerce, possiamo chiudere le impostazioni della nostra api rest e dedicarci alle impostazioni dell’ecommerce.

Per poter far funzionare correttamente Bman è necessario “settare” alcune impostazioni del sito come di seguito:

  • Impostazioni – generali – abilitare l’opzione
    “Abilita le aliquote e i calcoli delle imposte”
  • Impostazioni – generali – valuta – Euro
  • Impostazioni – prodotti – unità di peso / unità
    di misura – impostare identico a quello che avete impostato su Bman in utilità
    – impostazioni – opzioni articolo – Suffisso unità di misura
  • Impostazioni – imposta – Prezzi imposte Incluse
    – selezionare l’opzione “si, voglio inserire i prezzi comprensivi di imposte”

Una volta terminata questa prima configurazione, sarà possibile procedere con la configurazione degli altri parametri vedi Impostazioni ecommerce esterni

Risoluzione dei problemi

Se una sicronizzazione non va a buon fine, è possibile ispezionare il motivo di tale fallimento cliccando sul pulsante LOG a fianco dell’operazione in questione.

Ispezionando il LOG è possibile che si verifichi un errore come il seguente:

!!! ERRORE !!! sincronizzazione non riuscita {"code":"woocommerce_rest_cannot_view","message":"Non puoi creare una lista delle risorse.","data":{"status":401}}  

Questo vuol dire che il sistema non riesce ad accedere correttamente alle API di WooCommerce.

Per prima cosa occorre verificare la correttezza di entrambi i valori di KEY e SECRET inseriti nelle impostazioni del connettore di Bman. 

Se i valori sono correttamente inseriti, il modo più semplice per correggere questo errore (soprattutto se l’unico accesso a disposizione sull’hosting è attraverso il protocollo FTP) è quello di modificare il file .htaccess presente nella root del sito web nel seguente modo:

# BEGIN WordPress

 <IfModule mod_rewrite.c>
 RewriteEngine On
 RewriteBase /
 RewriteRule ^index\.php$ - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization},L]
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteCond %{REQUEST_FILENAME} !-d
 RewriteRule . /index.php [L]
 </IfModule>

 # END WordPress

Con molta probabilità basterà solo aggiungere o modificare la riga evidenziata in neretto aggiungendo E=HTTP_AUTHORIZATION:%{HTTP:Authorization}, alla prima L.

Una volta salvato il file, riprovare con una nuova sincronizzazione e tutto dovrebbe funzionare correttamente.

Attenzione agli aggiornamenti: è probabile che aggiornando il plugin WooCoomerce questa modifica dovrà essere ripetuta.