Tutorial de Configuração do Integrador do E-commerce do FutebolShop Especificações de funcionamento: O integrador desenvolvido para com o objetivo de manter sincronizado o estoque da loja virtual FutebolShop(desenvolvido pela Tray) com o SISMoura e viceversa. Para realizar essa sincronia o integrador gera um arquivo diário (configurado no integrador) com o seguinte formato DD-MM-YYYY.txt Este arquivo será salvo em um diretório pré-configurado no integrador. Este arquivo é enviado automaticamente para o FTP da loja virtual da FutebolShop onde o sistema da Tray se encarregara de ler esse arquivo e atualizar o estoque da loja virtual. Caso o arquivo foi enviado com sucesso para o FTP da loja virtual do FutebolShop, o integrador irá renomear o arquivo para o seguinte formato: Processado_DD-MM-YYYY.txt Caso ocorrer algum erro ao gerar o arquivo, o integrador irá renomear o arquivo para o formato: Erro_DD-MM-YYYY.txt O layout do arquivo do estoque (passado pela própria Tray) é definido abaixo: Produto:<codigo_tray> <nome_produto_tray> <estoque> Variação:<codigo_tray> <codigo_variacao_tray> <nome_variacao_tray> <estoque> Linha Produto: <codigo_tray> : Código do produto na loja virtual da FutebolShop. O SISMoura não envia nenhum cadastro de produto para a loja virtual do FutebolShop. <nome_produto_tray>: Nome do produto cadastrado dentro da loja virtual do FutebolShop esse nome deverá ser exatamente o nome do produto cadastrado dentro do ambiente da loja virtual. <estoque>: Quantidade em estoque do produto a ser enviada para ser atualizada na loja virtual. A quantidade deverá ser um número INTEIRO (podendo ser negativo). Linha Variação: A variação é correspondente ao cadastro de produto por referência do SISMoura ou seja, como o FutebolShop vende artigos esportivos, existe para um mesmo produto numerações e cores diferentes a loja virtual da Tray, entende-se como variação cada mudança no produto principal, ou seja, caso exista, por exemplo, o produto tênis e este possua 8 numerações, no cadastro de produto da Tray existirá o produto principal(denominado produto mãe) com 8 variações. Cada variação possui um código de identificação único gerado pela loja do FutebolShop. 1
<código_tray>: Código do produto mãe na loja virtual do FutebolShop. O SISMoura não envia nenhum cadastro de produto para a loja virtual do FutebolShop. <codigo_variacao_tray>: Código da variação do produto mãe cadastrado na loja virtual do FutebolShop. <nome_variacao_tray>: Nome da variação do produto mãe cadastrado dentro da loja virtual do FutebolShop esse nome deverá ser exatamente o nome da variação informada no momento do cadastro da mesma dentro do ambiente da loja virtual. <estoque>: Quantidade em estoque da variação do produto mãe a ser enviada para ser atualizada na loja virtual. A quantidade deverá ser um número INTEIRO (podendo ser negativo). Configuração do SISMoura para o Integrador: Para configurar o integrador corretamente é necessário realizar algumas configurações dentro dos módulos: Retaguarda e Compras. Configurações do módulo RETAGUARDA: No módulo Retaguarda, vá no menu Administração -> Configurações -> Configurações do Sistema. Localize a configuração E-COMMERCE e marque-a com SIM. Salve. 2
Configurações do módulo COMPRAS: No módulo Compras será necessário atribuir a cada referência e produto-mãe o código criado na loja virtual. Para isso acesse o menu: Estoque -> Produto -> Cadastro de Produto por Referência No campo Referência informe a referência do produto ou pressione F2 para pesquisar a pelo nome do produto. Clique no botão Alterar. Na grade logo abaixo da tela o sistema listará todas as referências para este produto. Para informar o código da loja virtual para cada referência de um duplo clique sobre a referência desejada. O sistema irá preencher os campos acima vá até o campo Cód.Internet e informe o código da variação da loja virtual. Faça isso para todas as variações! Após clique em Gravar. Atenção: O integrador só conseguirá enviar o estoque das referências (variações) dos produtos que estiverem com o campo Cód.Internet informado na tela Cadastro de Produto por Referência. 3
Configurações do Integrador: Primeiro passo a ser feito ao abrir o programa Integrador será realizar as configurações iniciais. Para isso acesse o menu: Sistema -> Configurações da Integração. Preencha os campos conforme a descrição abaixo: Host: endereço do servidor FTP onde esta armazenado a loja virtual do FutebolShop(obter esta informação com o Juliano da FutebolShop). Usuário: usuário de acesso ao FTP da loja virtual do FutebolShop(obter esta informação com o Juliano da FutebolShop). Senha: senha de acessso ao FTP da loja virtual do FutebolShop(obter esta informação com o Juliano da FutebolShop). Diretórios virtuais (informe os diretórios dentro do FTP da loja virtual do FutebolShop para salvar os arquivos da integração) Informe somente o campo Pasta para Importação do Estoque (obter esta informação com o Juliano da FutebolShop). 4
Diretório temporário local: Informe um diretório a ser salvo os arquivos diários para a exportação do arquivo de estoque. As demais configurações não serão necessárias a pedido do próprio Ademir. Clique em Menu para salvar as configurações! Próximo passo será cadastrar os nomes de TODOS os produtos-mãe da loja virtual bem como TODOS os nomes das variações. Para isso acesse o menu: Sistema -> Cadastro de Nomes dos Produtos do E- commerce. Informe o campo Produto o código do produto da loja virtual ou pressione F2 para consultar pelo nome do produto/variação. No campo Nome informe o nome do produto/variação exatamente da mesma forma que foi cadastrado na loja virtual. Selecione o Tipo de produto se é um produto-mãe ou uma variação. Após clique em Gravar. Próximo passo será definir quais serão as variações para cada produto-mãe. 5
Para isso acesse o menu: Sistema -> Cadastro de Variações dos Produtos. Existem três formas de informar as variações: Produto-mãe e variações: O sistema irá amarrar cada variação informada ao seu produto-mãe correspondente. Variação sem produto-mãe: O sistema irá permitir informar uma variação e não tornará obrigatório informar o produto-mãe. Sendo assim ao gravar essa variação a coluna Produto da grade ficará como 0 produto indefinido. Produto-mãe sem variação: O sistema irá somente adicionar o produto-mãe e irá dizer para o arquivo de estoque que esse produto é um produto único que não há variações correspondentes. Para cadastrar: Marque a forma de cadastro : Variação sem produto-mãe, Produto-mãe sem variação ou não marque nenhuma opção para cadastro do tipo Produto-mãe e variações. No campo Produto, informe o código do produto-mãe da loja virtual ou pressione F2 para consultar pelo nome do produto-mãe. (Caso o tipo de cadastro estiver marcado Variação sem produto-mãe o sistema irá bloquear este campo) No campo Variação informe o código da variação da loja virtual. 6
(Caso o tipo de cadastro estiver marcado Produto-mãe sem Variação o sistema irá bloquear este campo) Após clique no botão Adicionar para gravar. Atenção: Somente será exportado para o arquivo de estoque os produtos e variações definidas nesta tela. Gerar e enviar arquivo de exportação do Estoque: Para gerar e enviar o arquivo do estoque do SISMoura para a loja virtual do FutebolShop, acesse o menu: Exportação -> Gerar Arquivo de Exportação do Estoque. Para exportar selecione o tipo de arquivo a ser gerado as opções são: Produto e variações e Somente Produtos. Para gerar e exportar para o FTP da loja virtual do FutebolShop clique no botão Gerar Arquivo. O sistema irá exibir na grade todo o progresso da criação e exportação do estoque, exibindo produto a produto e mostrando OK caso exportado para o arquivo com sucesso ou [X] e grifando a linha em vermelho para erros do produto/variação, indicando que este produto/variação não foi exportado para o arquivo. 7