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.
Sincronizador WISEDAT for E-Commerce
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 for 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 for Magento
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 Magento 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 Magento 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;