Knowledge Base

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:

  1. Aceder a: System | Configuration | Services e Magento Core API;
  2. Colocar yes em WS-I Compliance;
  3. Aceda: System | Web Services | SOAP/XML-RPC – Roles;
  4. Clicar em Add New Role;
  5. Em Role Info insira o nome do perfil que deseja e em Role Resources, colocar All em Resource Access;
  6. Depois de gravar o perfil aceder a:System | Web Services | SOAP/XML-RPC – Users e Add New User;
  7. 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;
  8. 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: Pendentes – Para encomendas efetuadas mas não pagas; Pagas – Encomendas processadas e pagas; Pagas e enviadas – Para encomendas que se encontram pagas e que já foram enviadas.
Estado a faturar	É possível indicar em que estado se devem encontrar as encomendas para que possam ser processadas em faturas: Encomendas pagas – Processadas e pagas; Encomendas pagas e enviadas – Processadas, pagas e enviadas.
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: Atualizar dados de cliente existente; Criar novo cliente sem NIF.
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	Não sincronizar; Criar apenas; Criar e atualizar – Pode optar por enviar as famílias e subfamílias para a loja online, caso sejam enviadas pode atualizá-las quando forem modificadas no WISEDAT. 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: Código; Tipo artigo: Simples; Virtual; Configurável. Descrição; Descrição breve; Descrição comercial; Estado (Ativo/Inativo); Imagens; Preço unitário (sem imposto) (PVP1, por omissão – Pode ser parametrizado); Preços por quantidade vendida; Peso bruto; Taxa e Tipo de taxa: Isenta; Normal; Intermédia; Reduzida; Não dedutível. 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: Descrição (campo Name no Magento); Descrição Comercial (campo Description no Magento); Descrição Breve (campo ShortDescription no Magento); Serviço/Mercadoria (Virtual/Não virtual); Taxa e Tipo de Taxa IVA; Peso Bruto (campo Weight no Magento); Código de barras (campo Barcode no Magento); Preços por quantidade; (Tier Prices) Preço unitário 1 (campo Price no 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.