WISEDAT for Magento
Conetor WISEDAT for Magento
O conetor WISEDAT for Magento consiste num sistema automático de sincronização de informação entre a loja online e o software WISEDAT, permite a troca regular de informação entre o software Wisedat e uma loja online Magento.
Permite que a gestão da loja online seja praticamente efetuada no lado do WISEDAT, poupando largas de horas no processamento de encomendas, no controlo de stocks, na criação de artigos (simples e compostos), categorias, imagens, atualização de preços, envio da fatura PDF para a área de cliente, etc.
Instalação WISEDAT for Magento
A instalação do WISEDAT for Magento deve ser feita através do instalador WISEDAT, selecionando o módulo adicional WISEDAT for Magento.
Download Manual e Extensão Wisedat for Magento- Configuração - Magento versão 1
Na versão 1 do Magento são utilizados os serviços SOAP, que necessitam de alguma configuração prévia. Certifique-se que a extensão php_soap se encontra ativa no ficheiro de inicialização do servidor PHP.
Na área de administração da loja:
- Aceder a: System | Configuration | Services e Magento Core API;
- Colocar yes em WS-I Compliance;
- Aceda: System | Web Services | SOAP/XML-RPC – Roles;
- Clicar em Add New Role;
- Em Role Info insira o nome do perfil que deseja e em Role Resources, colocar All em Resource Access;
- Depois de gravar o perfil aceder a:System | Web Services | SOAP/XML-RPC – Users e Add New User;
- Em User Info insira os dados da sua conta de administrador e uma API Key que irá necessitar para a configuração de acesso no WISEDAT Comercial;
- No User Role seleccione o perfil que criou anteriormente.
Ao receber uma encomenda, o Wisedat para Magento adiciona a esta a taxa de IVA aos portes, se o país for igual ao da licença
Para os totais do documento estarem certos na loja Magento com o WISEDAT, necessita de aplicar as taxas na loja. Para criar taxas para o país em questão:
Sales | Tax | Manage Tax Zones e Rates.
E uma regra para aplicar a taxa à classe dos portes:
Shipping | Sales | Tax | Manage Tax Rules.
Nesta versão do Magento, como não é feita a gestão automática das taxas de IVA dos artigos, este controlo tem de ser feito desta mesma maneira, criando também uma classe de artigos relativa a cada tipo de taxa:
Sales | Tax | Product Tax Classes.
- Configuração - Magento versão 2
Nesta versão apenas tem de aplicar a taxa de IVA relativa aos portes. Depois de fazer a primeira sincronização e se tiver um artigo que aplique a mesma taxa que os portes, já terá uma classe relativa a esta taxa (eg. VAT-Normal-23). Terá somente de a aplicar aos portes, para isso aceda a:
Stores | Configuration | Sales | Tax e em Tax Class for Shipping selecionar a classe devida.
- Instalação da extensão Wisedat
Para além de instalar o módulo através do instalador Wisedat, deverá instalar um módulo de extensão para o Magento.
Nota: Existe um para a versão 1 e outro para a versão 2 do Magento.
É necessário ativar uma extensão Wisedat na sua loja online, que está disponível para download no Portal WISEDAT.
Deve copiar o conteúdo da pasta do módulo extensão, na raiz do projeto da loja online, no servidor Web.
Ativar extensão na loja Magento – Versão 1
Para ativar a extensão na área de administração da loja Magento aceda a:
System | Configuration | Advanced e ative a extensão WISEDAT.
Ativar extensão na Loja Magento – Versão 2
Para ativar a extensão na área de administração da loja Magento aceda a:
System | Tools | Web Setup Wizard e Module Manager e ative a extensão WISEDAT.
Se a extensão não aparecer, poderá a partir da linha de comandos, na raiz do projeto da loja Magento executar os seguintes comandos:
php bin\magento module:enable Wisedat_PDFInvoiceFile
php bin\magento setup:upgrade
Loja Magento
Insira o endereço URL da loja e indique a versão do Magento. Se esta for a versão 1, o utilizador é o que criou na configuração da loja e a palavra-passe é a API Key (da loja Magento). Caso seja a versão 2, insira o nome de utilizador e palavra-passe com os quais acede à área de administração da loja.
Configuração no WISEDAT Comercial
Para ativar o WISEDAT for Magento, aceda ao WISEDAT Comercial e em Sistema | Preferências | Loja online (E-commerce) selecione a opção Ativar integração.
Configuração de parâmetros
Também pode configurar os seguintes parâmetros:
Parâmetros do sincronizador |
|
Intervalo sincronização | Intervalo de tempo entre cada sincronização (5 segundos por omissão). |
Duração Log | 30 dias (por omissão). |
Timeout pedidos | 30 segundos (por omissão). |
Reiniciar sincronização | Clique no botão para reiniciar a sincronização. |
Parâmetros da integração das encomendas |
|
Importar encomendas | Caso pretenda importar encomendas geradas na loja online, para o Wisedat. |
Tipo de documento encomenda | Por omissão está definido a Encomenda de Cliente – ECL. |
Taxa de IVA por omissão | Selecionar a taxa de imposto a ser utilizada, caso não esteja definida numa transação. |
Armazém | Selecionar o armazém de onde pretende efetuar a gestão dos stocks da loja. Caso não esteja identificado é usado o stock global do artigo. |
Integrar encomendas | Pode selecionar um dos seguintes estados das encomendas na loja:
|
Estado a faturar | É possível indicar em que estado se devem encontrar as encomendas para que possam ser processadas em faturas:
|
Atualizar o estado completo da Encomenda | Considerar a encomenda como finalizada na loja online associando também a data de envio da encomenda à data da fatura. |
Atualizar crédito da encomenda (Credit Memo) | Caso exista uma nota de crédito sobre a fatura da encomenda, criá-la também na loja online. |
Importar o NIF de clientes (da loja online) | Ao selecionar a opção , pode escolher uma das seguintes alternativas, em caso de NIF repetido:
|
Outros parâmetros da sincronização |
|
Sincronizar todos os clientes da loja online | Clientes gerados a partir da loja online são sincronizados com o Wisedat. |
Atualizar stocks da loja online | Quando seleciona esta opção, o stock dos artigos da loja online são sincronizados. |
Atualizar taxa do IVA dos artigos na loja online | Atualiza o IVA dos artigos |
Categoria de artigos |
Sincronizar apenas categorias associadas aos artigos a disponibilizar na loja. |
Tabela PVP (Artigos) | Tabela de preços (PVP1 a PVP5) definida no artigo para sincronizar.
Em cenário de alteração de PV1 para PVP3 por exemplo, é questionado se deseja marcar todos os artigos para sincronizar novamente. NOTA: Os preços sincronizados não têm imposto incluído. Caso o preço escolhido não esteja definido será enviado o PVP1. |
Outros parâmetros |
|
Ativar a sincronização dos novos artigos | Quando seleciona esta opção, os novos artigos criados no WISEDAT, serão inseridos automaticamente na loja online.
Para poder enviar artigos para a loja online, basta selecioná-los na lista de artigos e realizar a operação em lote loja online ou na ficha do artigo, na aba loja online, onde poderá também adicionar uma descrição breve a apresentar na loja. |
Permitir a anulação de encomendas sincronizadas | Permite anular uma encomenda já sincronizada e não faturada, independentemente do estado em que esta se encontra na loja online. A anulação da encomenda é IRREVERSÍVEL!
NOTA: A encomenda da loja online NÃO é sincronizada novamente. |
Operações
Sincronizar um artigo com a loja online
Para que o artigo seja sincronizado coma loja online deve aceder à ficha do Artigo, no separador Loja Online e selecione a opção Sincronizar na Loja online.
O campo da Descrição Breve surge por omissão, no entanto pode ser alterada, esta descrição é a que surge associada ao artigo na Loja online.
Nota:
– Ao descontinuar um artigo no Wisedat é enviada a informação à loja que o artigo se encontra descontinuado.
– No separador Logística poderá indicar o: Comprimento (cm); Largura (cm); Altura (cm).
Operações em lote
Através da listagem dos artigos, pode selecionar um ou mais artigos, clicando no botão direito do rato, selecione as opções:
Operações em lote | Loja Online | Sim, para enviar os artigos para a loja online.
Sincronizador Wisedat for Magento
O sincronizador WISEDAT for Magento permite a troca regular de informação entre o software WISEDAT e uma Loja Online.
Para sincronizar manualmente a Loja Online com o software WISEDAT, execute o sincronizador Wisedat for Magento (ícone vermelho) e clique no botão sincronizar:
Quando clica em Log tem acesso a uma lista com os detalhes das sincronizações, podendo filtrar por data/sessão:
Dados trocados entre o WISEDAT e loja Magento
Os dados trocados regularmente entre o WISEDAT e a loja online são os seguintes:
Clientes | Importação de clientes da loja online para o Wisedat. |
Artigos | Os artigos sinalizados no Wisedat para sincronizar na loja online serão enviados para a loja online. Artigos que sejam criados na loja online e não existam no Wisedat serão criados desse lado, se estiverem incluídos numa encomenda.
São sincronizados os campos:
Em ambas as versões do Magento, relativamente aos artigos são também enviadas as imagens e os preços por quantidade vendida. Atualizados na loja Magento:
|
Dimensões e medidas | Envio de dimensões e respetivas medidas para a loja Magento. |
Taxas de IVA | Se um artigo que for enviado tiver associado uma taxa de IVA que não se encontra na loja online, esta é criada e aplicada aos artigos para o país da licença (disponível apenas para a versão 2). |
Famílias e subfamílias | Envio de famílias (ou categorias) e respetivas subfamílias para a loja online. Os artigos são associados à subfamília a que pertencem. |
Stocks | O stock dos artigos, total ou num determinado armazém, pode ser enviado para a loja online de modo a ter controlo exato da quantidade disponível de cada artigo. Ao stock é descontado as reservas efetuadas a partir das encomendas. |
Encomendas | As encomendas geradas na loja online podem ser enviadas para o Wisedat. |
Faturas | Uma encomenda processada em fatura no WISEDAT gera um PDF que é enviado para a loja Magento e pode ser consultado na área de cliente (disponível para a versão 2 do Magento).
Saiba mais em Converter documentos. Também podem ser atualizados os estados das encomendas no Magento, como tendo sido processada ou em caso de desistência e/ou falta de stock atualizar o estado de creditada. |
-
- A versão do Magento 2 suportada pelo conetor: 2.4.X;
- A instalação e manutenção da loja online são da responsabilidade do cliente;
- A WISEDAT aconselha a que se realizem todos os testes e verificações necessárias em base de dados de testes antes de entrar em produção;
- Os códigos e as descrições dos artigos devem ser únicas, pois o WooCommerce não aceita descrições (ou nomes dos artigos) iguais;
- Os códigos e as descrições das categorias (famílias/subfamílias) devem ser únicas, pois o WooCommerce não aceita descrições (ou nomes de categorias) iguais;
- Ao criar um novo artigo no Wisedat, caso já exista esse código previamente na loja online, o Wisedat passa a atualizar esse artigo com as informações introduzidas no Wisedat;
- É necessário aplicar a taxa de IVA relativa aos portes. A forma mais simples é, depois de fazer a primeira sincronização e se tiver um artigo que aplique a mesma taxa que os portes, já terá uma classe relativa a esta taxa (ex. PT-VAT-Normal-23). Terá somente de aceder a Stores > Configuration > Sales > Tax e em Tax Class for Shipping selecionar a classe devida.
- Todas as alterações efetuadas nos registos (artigos, categorias, etc.) diretamente na loja online podem ser perdidas assim que forem atualizados os respetivos registos provenientes do Wisedat.
- Licenciamento e suporte:
- O conector WISEDAT for Magento encontra-se disponível nas edições Professional e Advanced e em modalidade de subscrição anual, associado à data do BASIC Plan ou validade da licença (licenças anuais), isto é, a renovação do conetor implica também a renovação do plano de manutenção ou licença;
- Não está incluído no BASIC Plan o apoio, consultoria, configuração ou instalação da loja online;