Manual Integração Woocommerce
Conteúdo
Nota utilização ... 3
Configuração inicial ... 3
Sincronização de imagens ... 5
Selecção de Imagens ... 5
Integração de encomendas ... 5
Exportação de produto ... 6
Stock loja online... 6
Impostos ... 7
FAQ´s ... 8
Nota utilização
Neste manual, encontrará todos os passos para a sua configuração, tal como uma explicação do seu funcionamento. Com a atualização do WordPress 5.6, surgiu uma forma muito mais fácil de criar uma autenticação de utilizador para utilizar em aplicações.
Configuração inicial
Deverá selecionar primeiro o WooCommerce como o seu sistema de loja online, nas configurações gerais. Na Gestão Comercial, Diversos -> Gerais. No XD POS, Definições -> Configurações Gerais.
1- Depois de selecionada a opção, reinicie a aplicação.
2- Após voltar a iniciar sessão, poderá reparar que na Gestão Comercial, já lhe aparecerá no tabulador “Plugins”, a opção “WooCoomerce”. No caso do XD POS, poderá aceder a esta mesma configuração, através da função (de botão) ONLINE_SHOP.
3- Dentro dessa janela, deverá preencher as configurações globais. Estes dados são bastante intuitivos, por isso não elaboraremos muito sobre eles.
4- De seguida, preencha as configurações específicas do WooCommerce. Em detalhe, elas são as seguintes:
- Endereço da loja:
Sub-domínio do seu site, ou seja, na loja https://lojaonline.xd.pt, introduziria “lojaonline.xd.pt”
nesse campo.
- Protocolo:
https ou http
- Consumer key e consumer secret:
Pode obter estes dados facilmente entrando na sua loja online e seguindo os seguintes passos:
Configurações -> API REST -> Adicionar chave
Poderá gravar o formulário só com esses dados e as preferências como mostra a imagem. Habilitar a sincronização de imagens é mais complexo e será elaborado mais abaixo.
Infelizmente, a API oficial do WooCommerce não possibilita o envio das imagens de produtos para o servidor. Por isso, será necessário que crie também uma chave para a API do WordPress, de um utilizador administrador.
Com a versão 5.6 este processo tornou-se muito mais fácil.
Basta ir no WordPress a Utilizadores -> Selecionar utilizador administrador -> Crie uma senha de aplicação, com um nome a seu gosto (XD Wordpress?)
Depois, na configuração do XD, introduza o nome de utilizador desse utilizador e a senha sendo a combinação de números que lhe foi mostrada após a criação da senha de aplicação.
Selecção de Imagens
As imagens que serão enviadas pelo sincronizador, são as que estão presentes no arquivo digital, com a hashtag “woocommerce” (sem aspas).
As imagens do arquivo digital só estão acessíveis pela Gestão Comercial ou pelo Backoffice. Se tem a necessidade de carregamento de imagens, será imperativo que use um deles.
Alternativamente, poderá usar apenas a imagem principal do produto, marcando essa opção nas configurações.
Integração de encomendas
Na mesma janela de configuração referida anteriormente, tem a possibilidade de integrar as encomendas feitas na loja online, na Gestão Comercial ou no XD.
Basta selecionar a data das encomendas a integrar, e para aquelas que ainda não foram carregadas para o software, ser-lhes-à criado um documento.
Não se esqueça que a referência dos produtos deverá estar presente tanto na loja, como no software. Se fizer o envio dos produtos pela aplicação XD (ou seja, não os criar manualmente na loja), isto é feito automaticamente, pelo que não deverá ter problemas a carregar as encomendas.
Exportação de produto
Para que produto seja enviado para a loja online, basta marcar a sua visibilidade na loja online como positiva.
Posteriormente, ao exportar os produto para a loja, ele e a sua família serão enviados, e se existir, nenhuma alteração ser-lhe-á feita (a não ser que tenha habilitado a atualização de preço, em que nesse caso, o preço será alterado).
Stock loja online
Se os artigos sincronizados tiverem habilitada a gestão de stocks, no processo de sincronização será enviado o número de unidades que tem em stock. No caso de utilizar esta opção e utilizar produtos com atributos (ou cores e tamanhos), recomendamos-lhe que habilite a opção
“Sincronizar cada atributo individualmente”, pois caso contrário a gestão de stock não será bem feita.
Pode escolher que seja o preço sem impostos, a ser enviado para a loja. Para tal, utilize esta opção:
Em relação à taxa aplicada ao produto, no caso de ter produtos com diferentes taxas de IVA… é imperativo que a taxa no XD e no WooCommerce tenham exatamente o mesmo nome. Exemplo (padrão):
FAQ´s
A aplicação regista o erro retornava “401 - Sorry, you cannot view this resource”, como devo proceder?
Durante os nossos testes, reparamos que em alguns servidores, o WooCommerce em vez de responder “Ok” à autenticação com consumer key e consumer secret, retornava “401 - Sorry, you cannot view this resource” (pode ver o erro retornado no errorlog.txt da aplicação).
Se este for o seu caso, recomendamos que introduza as seguintes 7 linhas no início do seu htaccess (antes do #BEGIN WORDPRESS):
#XD - Fix error 401
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
</IfModule>
#END XD
Fonte:
https://wordpress.org/support/topic/woocommerce-rest-api-error-401/
