Abaixo você encontra as informações necessárias para instalação do novo módulo de integração entre a plataforma Magento e a SkyHub desenvolvido pela SkyHub.
Solicite a instalação ao seu desenvolvedor responsável pelo Magento.
Atenção! - É muito importante que você mantenha o módulo atualizado. Se já possui a instalação, verifique qual é a versão e se necessário solicite a atualização para seu desenvolvedor Magento.
Versão atual:
- Versão: 1.6.2
Última atualização: 07/12/2021
Download: https://drive.google.com/file/d/1kVbN_rW0IgCBhBTlu8Q3kibX3STFv0JQ/view?usp=sharing
Github: https://github.com/bittools/skyhub-magento1
Se ainda não realizou a instalação do módulo, siga o passo a passo abaixo:
Pré requisitos:
- Magento: Compatível com as versões 1.8.x e 1.9.x
- Caso queira integrar o módulo Magento 2.x com a SkyHub, por gentileza acesse o artigo a seguir: >> Instalação do Módulo de Integração SkyHub para Magento 2
- PHP: Compatível com a versão 5.4 ou superior.
- Banco de dados MySQL: Compatível com a versão 5.6.
- Cadastro no Marketplace B2W ou permissão da equipe comercial para outros marketplaces;
- Solicitar para a SkyHub suas credenciais (Token e Usuário) de acesso para integração:
- Para integrar com marketplace B2W: solicite sua chave no seguinte formulário - em Categoria selecione: "Integração" -> "Solicitar token de acesso da API SkyHub" - clique aqui
- Para integrar com os demais marketplaces: entre em contato com o nosso time comercial - clique aqui
*Veja no final desse artigo as últimas correções, documentação completa para o desenvolvedor e o que a instalação do módulo altera no ambiente do seller.
Instalação do módulo no Magento:
Solicite ao seu desenvolvedor responsável pelo Magento a instalação do módulo:
- Passo 1- Download do módulo Magento disponível no link abaixo:
Versão: 1.6.2
Última atualização: 24/08/2021
Download: https://drive.google.com/file/d/1kVbN_rW0IgCBhBTlu8Q3kibX3STFv0JQ/view?usp=sharing
Github: https://github.com/bittools/skyhub-magento1 - Passo 2- Descompactar os arquivos .zip
- Passo 3- Copiar os arquivos do módulo na pasta raiz do Magento.
-
Passo 4- Instalação do monitor de CRON's (CRON Scheduler) - Importante:
A CRON do servidor executa as rotinas do módulo Magento, portanto se a CRON estiver sendo executada corretamente, todos os produtos catalogo e busca serão automaticamente enviados para a SkyHub.
Para monitoria das CRONs é importante que seja instalado o CRON Scheduler, disponibilizado pelo link abaixo:
https://github.com/AOEpeople/Aoe_Scheduler - Passo 5- No ambiente Magento, limpe o cache do sistema pelo caminho: Sistema > Gerenciar Cache > Liberar as três opções conforme abaixo, fazer logoff e logar novamente:
Configurações necessárias para ativação do módulo:
Mapeamento de atributos obrigatórios:
Atributos do Produto - (Magento > SkyHub)
É necessário indicar para o módulo de integração BSeller/SkyHub quais são os atributos obrigatórios correspondentes no Magento, esse mapeamento será utilizado para o envio do Magento para a SkyHub.
- Seguindo o menu BSeller > Integração SkyHub > Atributos do Produtos > Mapeamento de Atributos
- Informar o código do atributo Magento relacionado ao código SkyHub, basta clicar no atributo que ainda não foi mapeado.
- E selecionar o atributo relacionado seguido de "salvar".
Os atributos de produto são relacionados ao envio de atributos do Magento para a SkyHub, já os atributos de cliente (lojista) é o inverso, corresponde ao mapeamento dos campos das informações que vão da SkyHub para o Magento.
Obs: Esse mapeamento faz, por exemplo, com que o lojista receba a informação Inscrição Estadual, necessária para faturamento de cliente PJ.
- Seguindo o menu BSeller > Integração SkyHub > Atributos do Cliente > Mapeamento de Atributos
- Indique para o módulo BSeller/SkyHub quais os atributos de cliente correspondente no Magento aos atributos dos pedidos vindos da B2W > SkyHub, basta clicar no atributo...
Seleção do Escopo Multi Loja:
Na versão 1.3.3 em diante, o módulo está preparado para integração multi loja. Nesse caso, se o cliente possuir 3 lojas no mesmo Magento, por exemplo, pode integrar em 3 contas SkyHub diferentes, por isso é necessário selecionar qual loja está sendo configurada, selecionando o escopo no canto superior esquerdo das configurações do módulo conforme abaixo:
Importante: É necessário selecionar o escopo mesmo que o Magento possua somente uma loja criada, caso contrário alguns campos das configurações do módulo não são habilitados.
No exemplo abaixo, foi selecionada a loja Varejo, que é a principal do cliente em questão.
O último passo que ativa o módulo é o cadastro das credenciais SkyHub.
- Acesse o menu BSeller > Integraçao SkyHub > Configuração
- Certifique-se que a opção habilitado está marcada como 'Sim' e insira o email e chave API informada pelo time de Setup, seguido de 'Salvar'.
Documentação completa do módulo:
Documentação da versão 1.4.2:
Atualizado em:
https://drive.google.com/file/
O que o módulo altera no ambiente do cliente:
Alterações do módulo na plataforma Magento:
- Em questão de código, o módulo não altera, sobrescreve ou conflita com absolutamente nenhum arquivo do Magento e/ou outros módulos de integração.
Alterações do módulo no banco de dados:
-
Em questão de banco de dados, o módulo cria as seguintes tabelas:
bseller_skyhub_entity_id
Tabela responsável por guardar todas as entidades que já foram integradas entre a sua loja Magento e sua conta SkyHub.
bseller_skyhub_product_attributes_mapping
Esta tabela é responsável por armazenar todos os atributos de produto necessários para a integração de produtos na SkyHub e que devem ser mapeados com os atributos na sua loja
Magento nos setup inicial do módulo.
bseller_skyhub_queue
Esta tabela é responsável por armazenar todas as entidades que deve ser enfileiradas para a integração com a SkyHub. Basicamente todas as filas de entidades (atributo de produto, produto,
categoria, status de pedidos, etc) são criadas nesta tabela. - O módulo também cria alguns campos em algumas tabelas:
sales_flat_quote
Campos:
bseller_skyhub_interest: taxa do pedido cobrado pelo MarketPlace
sales_flat_order
bseller_skyhub: Identifica se o pedido foi importado da SkyHub;
bseller_skyhub_code: Código do pedido na SkyHub;
bseller_skyhub_channel: Canal de venda (MarketPlace);
bseller_skyhub_invoice_key: Chave da nota fiscal após o faturamento do pedido;
bseller_skyhub_interest: taxa do pedido cobrado pelo MarketPlace.
Correções e Melhorias Realizadas (Change Log):
Conforme histórico abaixo, desde a primeira versão do módulo foram realizadas dezenas de correções e melhorias, portanto, é muito importante que você mantenha o módulo atualizado. Se já possui a instalação, verifique qual é a versão e se necessário solicite a atualização para seu desenvolvedor Magento.
HISTÓRICO DE ALTERAÇÕES:
Versão 1.6.2 (07/12/2021)
- Adicionar produto na fila pela listagem de produtos e executar a fila manualmente via admin.
|
Para adicionar os produtos na fila, basta selecionar eles conforme abaixo:
|
Versão 1.6.1 (21/11/2021)
- - Send in invoice to skyhub the volume_qty.
- You need to active the config in Invoice Key Configuration -> Send Volume Qty to SkyHub. Exemplo: volume_qty: 2
|
Para ativar o envio de volume_qty para a SkyHub, basta ir em: System -> Configuration -> BSeller -> SkyHub Integration. Selecione o Website desejado, pois a configuração não funciona Global, no setor de Invoice, basta colocar Yes em Send Volume Qty to SkyHub, conforma a Imagem:
Nos Comentários do pedido, basta colocar o seguinte para o módulo enviar junto com o número de Invoice, a quantidade de volume:
chave de acesso: 322111175865300001665500100019
|
- Correção de salvar complemento para channel Carrefour nos endereços.
Versão 1.6.0 (24/08/2021)
- Adicionado envio de Nfe em xml para a nova api da skyhub.
|
Somente envia pedido se o pedido for do tipo b2wentregadirect e o pedido for aprovado(APPROVED).
 |
Versão 1.5.9 (12/08/2021)
- Correção de envio de pedidos a skyhub, mesmo sendo feito pelo magento.
Versão 1.5.8 (01/02/2020)
- Remoção dos e-mails nos arquivos dos módulos.
Versão 1.5.7 (27/09/2020)
- Fix bug in canceled order.
Versão 1.5.4 (27/04/2020)
- Send url carrier, configured in SkyHub Integrations.
- Fix bug in simulateStore.
- Create customer when order is amazon.
- Fix bug when product is delete.
Versão 1.5.3 (13/09/2019)
- Fix bug on order queue. Previous this version, api settings is removed from some requests.
- Send order requests without status field.
- Save "Não informado" in "Complement" and "Neighborhood" field when is empty.
Versão 1.5.2 (04/09/2019)
- Envio do preço no campo Preço Promocional quando a variação não possui Preço Promocional;
- Adicionadas novas configurações que permitem o lojista configurar/enviar status customizados na atualização de pedidos, para as requisições de: cancelamento, entrega, envio/tracking e exceção de entrega;
- Envio de Data de Entrega quando o pedido for completado (definido como Entregue ao Cliente);
Versão 1.5.1 (09/07/2019)
- Ajustes na remoção de status duplicados na fila de integração;
- Envio de preço quando campo preço promocional estiver vazio.
Versão 1.5.0 (05/07/2019)
- Integração de produto inativo;
- Ajustes na integração de pedidos Magazine Luiza;
- Ajustes relacionados a códigos de rastreamento;
- Ajustes na integração de produtos após cancelamento de pedido.
Versão 1.4.9 (05/07/2019)
- Ajustes das novas políticas de preço original e preço promocional (desconto);
- Correções na obtenção do store_id;
Versão 1.4.8 (17/06/2019)
- Ajustes para obtenção do código do pedido no agrupamento das PLPs;
- Ajustes quando store_id é igual a zero;
- Correção no GET de produtos;
- Inclusão do atributo category_ids na blacklist para que não haja conflito na integração;
- Inclusão de verificação quando um atributo estático é enviado vazio;
- Atualização do instalador para liberação da próxima versão.
- Ajustes para criação de pedidos quando não informado o region_code;
- Ajustes para continuidade da execução da fila caso ocorra erros na requisição durante o processo de atualização de status de pedidos;
- Ajustes para envio de nota fiscal quando pedido tiver status entregue e não tiver nota fiscal;
- Outros ajustes e correções para melhoria de desempenho.
Versão 1.4.7 (26/03/2019)
- Exibição de informações de entrega estimadas no pedido no painel de administração;
- Adicionada lista personalizada de atributos do produto integrados a Skyhub;
- Exibição da data de entrega estimada no pedido de exibição do administrador quando houver;
- Adicionada possibilidade de remoção de itens da fila de integração de produtos;
- Correção do erro na atualização de status do pedido quando ele é entregue;
- Adicionada sinalização nos produtos para permitir que ele seja ou não integrado no marketplace.
Versão 1.4.6 (28/01/2019)
- Habilitamos o botão para redefinir histórico de integração do produto somente na página de fila do produto;
- Corrigimos o erro com pedidos criados com valor de interesse;
- Mostrando o valor do desconto na página de pedidos.
Versão 1.4.5 (11/01/2019)
- Correção de erro na cotação quando o primeiro pedido ou a fila gera uma exceção e os próximos pedidos estão sendo criados sem moeda;
- Corrigimos a integração de produtos. Agora, o módulo possui um filtro para permitir que a integração funcione apenas com produtos capturados com sites de integração habilitados;
- Agora será mostrado vários métodos de pagamento na página de pedidos;
- Remoção de informações duplicadas de faturamento de pedidos / endereços de remessa (complemento e referência);
- Corrigimos o BUG quando o "modo de conformidade" é ativado;
- Corrigimos o BUG na atualização do status do pedido quando o pedido é "mantido" no magento;
- Escrevemos os primeiros testes funcionais.
Versão 1.4.4 (22/11/2018)
- Ajuste em regra de carrinho configurada na loja do cliente.
Versão 1.4.3 (25/10/2018)
- Ajuste na listagem das PLPs no Magento.
- Ajuste na integração de produtos configuráveis.
- Implementação da função de exportação CSV/XLS dos erros de importação de pedidos.
Versão 1.4.2 (24/10/2018)
- Permissão de cancelamento de pedidos após faturamento.
- Ajuste na integração dos atributos de produtos com variações.
- Implementação de consulta da PLP via API do Magento.
Versão 1.4.1 (03/09/2018)
- Ajuste na fila de status de pedido
- Ajuste no status de pedido consumido
- Ajuste no envio de atributos no valor 0
Versão 1.4.0 (21/08/2018)
- Ajuste nas permissões de integração
- Ajuste de integração de produtos
- Implementação de integração de produtos atualizados por alteração de atributos de forma massiva
- Implementação de PLP
Versão: 1.3.6 (20/07/2018)
- Ajuste no retorno do método (PHP) para integração de estoque
Versão 1.3.5 (13/07/2018)
- Ajuste na integração de estoque
Versão 1.3.3 (26/06/2018)
- Implementação do detalhe de pagamento do pedido
- Implementação da funcionalidade de limpeza de atributos e categorias de produtos já integrados (para casos de reintegração)
- Ajuste na criação de pedidos via painel administrativo do Magento
- Ajuste na integração de categorias de produtos
- Ajuste na integração de produtos (preço promocional)
Versão 1.3.2 (11/06/2018)
- Ajuste na seleção de produtos a serem atualizados
- Ajuste na criação de pedidos (dados da SkyHub)
- Ajuste na integração de produtos com variação (estoque dos itens filhos)
- Ajuste na integração de status de pedido
Versão 1.3.1 (25/05/2018)
- Ajuste na criação de pedidos (melhorias no consumo da fila da SkyHub e dados default de cliente)
- Ajuste na integração de produtos (itens com variação)
Versão 1.3.0 (18/05/2018)
- Implementação de mapeamento de atributos de clientes
- Implementação da funcionalidade multi loja
- JSON de pedido recebido da SkyHub no detalhe do pedido
Versão 1.2.6 (18/05/2018)
- Ajuste na integração de produtos (em caso de exclusão no Magento e reintegração aṕos pedidos realizados)
- Ajuste na integração de pedidos (tratamento para itens sem e-mail de cliente)
Versão 1.2.5 (27/04/2018)
- Ajustes e melhorias na integração de pedidos
- Implementação de mapeamento de atributos de clientes
- Implementação de escolha de tipo de order Id a ser incorporado ao Magento
- Melhorias para o upgrade de módulos
Versão 1.2.4 (20/04/2018)
- Ajustes e melhorias na integração de produtos
Versão 1.2.3 (10/04/2018)
- Melhorias na utilização de tabelas flat do Magento (ISKY-86)
Versão 1.2.2 (06/04/2018)
- Ajuste de integração de endereços
Versão 1.2.1 (05/04/2018)
- Ajuste da forma de pagamento
Versão 1.2.0 (29/03/2018)
- Ajuste da mensagem de configuração do atributo weight
- Melhorias na integração de pedidos
- Implementação de Limpeza de integração de produtos
Versão 1.1.0 (27/03/2018)
- Implementação de filtros por visibilidade de produtos
- Implementação de opção de integração imediata na atualização de preço/estoque
- Melhorias na fila de integração de produtos e pedidos
Comentários 16
Olá Bom Dia!
Gostaria de saber sobre a previsão para o Magento 2 pois minha plataforma é Magento 2
Oi Gabriel, tudo bem?
Para solicitar a integração com o Magento 2, por gentileza abrir um chamado na Central de Ajuda, clicando no botão Fale com a SkyHub assim o time responsável lhe mostrará quais os próximos passos.
Não se esqueça de informar os dados abaixo: 😉
- Nome da Loja:
- CNPJ da Loja na B2W:
- Email de cadastro:
- ERP/Plataforma s ser integrada:
Aguardamos o seu contato.
Grande abraço, e boas vendas!
A versão atual do módulo apresenta erro ao acessar os pedidos pela plataforma, pois está sendo salvo na tabela sales_flat_order.increment_id os seguintes valores,
, causando erro na consulta do pedido, 
como podemos resolver ?
Olá Lucas, bom dia.
Como vai?
Por se tratar de uma situação específica na qual precisaremos realizar uma análise mais detalhada, não conseguiremos te orientar aqui na Comunidade.
Neste caso, abrimos o ticket do link abaixo para que o time do Suporte SkyHub troque informações com você sem expor publicamente dados sensíveis de sua loja.
https://skyhub.zendesk.com/agent/tickets/150056
Peço que aguarde o retorno.
Grande abraço e boas vendas!
Boa tarde!
Fiz a integração do Magento X Skyhub, porém estou conseguindo mandar meus produtos para a skyhub.
O Modúlo que foi instalado no Magento foi o Bseller.
Fico no aguardo.
Olá, tudo bem?
Conseguiu colocar as credenciais da Skyhub na Bseller?
Apresentou algum erro no momento do envio de produtos para a Skyhub?
Confirme esses processos para podermos lhe ajudar da melhor forma possível.
Abraços.
Boa tarde Lucas,
Tentei achar um passo-a-passo para enviar os produtos da Magento pra Skyhub mas acabei não encontrando.
As credencias que você diz, seria essa:
Se for, eu coloquei na plataforma da Magento, salvei, porém não aconteceu.
Não sei se estou fazendo algo de errado.
Att,
Eduardo Trindade.
Olá, tudo bem?
Sim, são estas as credenciais. Token e Usuário.
Poderia tentar este processo, caso não consiga, vou abrir um chamado com a equipe especializada nesta questão.
Envio de Produtos do Magento para a SkyHub
Espero poder ter ajudado novamente.
Abraços.
Eu tentei também este processo e nada...
É este processo seria do módulo Bizcommerce né? e o que foi instalado no meu Magento foi o Bseller, mas caso funcione apenas com esse Bizcommerce, eu posso solicitar a instalação dele.
att,
Eduardo Trindade.
Oi Eduardo, tudo bem com você ?
A sincronização de produtos do Magento com a SkyHub ocorre de forma automática conforme os produtos são cadastrados através das filas de execução.
Neste caso, oriento que verifique com o seu desenvolvedor se as CRONs do Magento estão sendo executadas corretamente e se o módulo Magento está configurado conforme as instruções do tutorial abaixo.
Instalação do Módulo para Integração entre Magento 1.x e SkyHub
Peço que verifique também, se ao utilizar a função Integrate With SkyHub, o produto é sincronizado com a SkyHub, conforme exemplo abaixo:
Permaneço à disposição.
Tenha um bom dia. :)
Bom dia Mayara
Esse seu print do Magento, está instalado qual módulo?
O módulo que o pessoal da Magento instalou na loja foi o Bseller, disseram que o Bizcommerce não encontraram onde baixar.
Já segui o passo a passo desse módulo e não está dando certo...
att,
Eduardo Trindade.
Olá, tudo bem?
Esta imagem é do magento 1
Qual o modulo e versão do magento que você está utilizando?
Aguardamos.
O módulo que está ativo é o Bseller e a versão do Magento é 1.9.4
Oi, tudo bem?
Por se tratar de uma situação específica, abrimos um chamado para o suporte especializado nesta questão. (https://skyhub.zendesk.com/agent/tickets/211682).
Em breve um dos nossos especialistas entrará em contato contigo por e-mail.
Qualquer dúvida, estamos à disposição!
Abraço :)
Olá ...
Instalei o modulo e verifiquei que existe um bug na área de configuração do módulo.
na classe
linha 21 e 24
esta dessa forma
Noque me retorna um erro 500 ...
Sugiro a seguinte correção
Se conseguirem corrigir isso para eu manter sempre o modulo atualizado agradeço ...
Att
Oi Fabielly, tudo bem com você ?
Essas informações foram repassadas para o time responsável.
Agradecemos a sua contribuição.
Tenha uma ótima tarde e uma ótima semana. :)
Por favor, entre para comentar.