Antes de começar:
A partir de Janeiro de 2024, a Shopify passou a adotar uma nova regra para o envio de dados fiscais via API.
Agora, apenas lojas que utilizam o plano Shopify ou superior terão os dados fiscais incluídos nas transações. Para contas no plano Basic criadas antes de Janeiro de 2024, nada muda: os dados fiscais continuam sendo retornados normalmente pela API.
No entanto, contas criadas a partir de Janeiro de 2024 no plano Basic não terão mais esses dados disponíveis via API. Caso seja necessário acessar essas informações, será preciso fazer o upgrade para o plano Shopify ou superior.
Recomendamos verificar o plano atual da sua conta para garantir que você está recebendo todos os dados necessários.
Em caso de dúvidas, consulte a documentação atualizada ou entre em contato com o suporte.
Informações importantes antes de integrar sua Shopify:
Para garantir o bom funcionamento da plataforma, atente-se a estes pontos fundamentais:
-
Comissões: A Shopify cobra uma taxa por transação que varia entre 0,5% e 2%, dependendo do plano contratado.
-
Emissão de Etiquetas: A Shopify não emite etiquetas nativamente. No momento, essa funcionalidade está disponível apenas para clientes que utilizam as integrações com os Correios, Intelipost ou Mandaê
Gerando o token na Shopify
Acesse a plataforma da Shopify utilizando seu e-mail e senha. Em seguida, vá até a opção “Configurações” no menu.
No painel administrativo, acesse a seção “Domínios”. Em seguida, localize e copie o domínio que termina com myshopify.com. Guarde essa informação para uso posterior na integração no Magis5 HUB.
💡 Dica:
Abra um bloco de notas no seu computador e organize previamente todos os dados necessários para a integração. Isso facilitará o processo e ajudará você a se orientar melhor durante as etapas.
Em seguida, na mesma tela, localize a opção “Apps” e clique nela. Dentro da tela de aplicativos, selecione a opção “Desenvolver apps no Dev Dashboard”.
Você será redirecionado para tela "dev dashboard" da Shopify clique em "Create app"
Clique em “Create app”. Em seguida, dentro de “Start from Dev Dashboard”, informe o “App name” e finalize clicando em “Create”.
Dentro da seção “Versions”, localize a opção “Access” e clique em “Select scopes”.
Ao acessar a opção de seleção de scopes, altere para Admin API e marque todas as opções disponíveis dentro dessa categoria.
Após marcar todas as opções disponíveis, clique em “Done” para salvar as alterações. Em seguida, role até o final da página e clique em “Release” para concluir a operação.
O nome da versão (Version Name) é opcional e pode ser deixado em branco. Em seguida, clique novamente em “Release”.
Após processar, a versão do Magis será criada e você poderá confirmar que está ativa.
Para visualizar o token, acesse “Settings”. Na seção “Credenciais”, serão exibidos o “Client ID” e o “Secret”. Copie essas informações e guarde-as da mesma forma que fez com o "Domínio" no passo anterior.
Após a criação do app, será necessário instalá-lo. Volte para “Home”, ainda dentro da página do Dev Dashboard, e no canto direito da tela clique em “Install app”.
Você será redirecionado para selecionar sua loja na Shopify. Clique na opção correspondente à loja que está sendo integrada.
Em seguida, clique em “Install” para concluir a instalação do app
Após a instalação, o Magis5 HUB ficará disponível na seção Apps.
⚠️ IMPORTANTE:
Com as informações do "Dominio", “Client ID” e o “Secret”, será necessário abrir um atendimento com o suporte para que seja gerado o Token final, permitindo a integração da Shopify com o Magis.
Integrando a Shopify no Magis5 HUB
Feito o login no Magis5, vá para "Configurações", depois até "Integrações" e por último clique em "Lojas Virtuais ".
Na página de integrações, clique em "Adicionar nova integração".
Como fazer o preenchimento da aba "Integração"
Selecione a opção Shopify no campo marketplace
- Nome da sua loja: você deverá colocar um nome que identifique sua loja no painel do Magis5.
- Código da sua loja no ERP: esse campo é alimentado com o código que identificará os pedidos dentro do seu ERP.
Segue a orientação de como prosseguir de acordo com cada sistema:
- Bling: dentro da sua conta responsável pelo controle de estoque no Magis5, você deve efetuar o passo a passo indicado no tutorial: Como preencher o campo "Código da sua loja no ERP" utilizando o Bling!
- Faturador Magis5: não há necessidade de preencher o campo caso utilize o faturador Magis5 como controlador de estoque.
- ERP Magis5: você deverá informar o código do empreendimento responsável pelo faturamento dos pedidos dessa loja.
- Integração via API: você deverá solicitar ao desenvolvedor ou suporte do seu ERP para que ele gere o código interno que identifica os pedidos dessa loja quando criados no ERP.
- Omie: você deverá efetuar o cadastro de um vendedor dentro da sua conta Omie. Esse vendedor deverá ter o mesmo nome da sua loja que será integrada, exemplo: Nome da Loja - Shopify
Após isso, é necessário solicitar ao suporte do Omie, o ID desse vendedor na API. O suporte irá lhe informar um código, ao qual deve ser incluso no campo "Código da sua loja no ERP" dentro do Magis5.
- Sankhya: você deverá efetuar o cadastro de um vendedor dentro da sua conta Sankhya. Esse vendedor deverá ter o mesmo nome da sua loja que será integrada, exemplo: Nome da Loja - Shopify
Após isso, é necessário solicitar ao suporte do Sankhya, o ID desse vendedor na API. O suporte irá lhe informar um código, ao qual deve ser incluso no campo "Código da sua loja no ERP" dentro do Magis5.
- Código do vendedor: Caso utilize o Magis ERP como principal, você deverá cadastrar um novo usuário no empreendimento informado no campo Codigo ERP. Para isso basta seguir o passo a passo indicado no tutorial: [Magis ERP] Como preencher o campo "Código do vendedor" utilizando o Magis ERP
Caso utilize outro ERP principal, esse campo é alimentado somente na condição que a loja que esta sendo integrada é do tipo oficial do Mercado Livre.
- Token de acesso: Token gerado pelo suporte com as informçãoes adquiridas na Shopify (Domínio, Client ID e Secret).
- Url da loja: Insira o domínio da sua loja na Shopify (terminado com myshopify.com).
Como fazer o preenchimento da aba "Empresas"
As informações cadastradas nessa aba vão alimentar os dados referente ao remetente na declaração de conteúdo.
Nome - deverá ser informado a Razão Social do CNPJ vinculado ao marketplace que será integrado.
CNPJ - deverá ser informado o CNPJ cadastrado na conta do marketplace que será integrado.
Inscrição Estadual - deverá ser informado a IE cadastrado na conta do marketplace que será integrado.
Estado - deverá ser selecionado o Estado a que pertence o cadastro do CNPJ vinculado a conta do marketplace que será integrado.
Como fazer o preenchimento da aba "Notas fiscais"
ERP emissão nota fiscal - você deverá selecionar o ERP cadastrado no Magis5 que será responsável para emissão da nota fiscal.
Caso sua loja não faça a emissão de nota fiscal, é necessário selecionar o ERP destinado ao controle de estoque.
- Habilitando a emissão automática de notas fiscais
Para ativar a emissão automática as seguintes opções deverão ser ativas:
1º - Gerar nota fiscal de forma automática
2º - Emitir nota fiscal de forma automática
3º - Gerar/Emitir nota fiscal automaticamente quando o pedido for para o status de Ag. Separação
5º - Aguardar etiqueta no marketplace para imprimir a declaração de conteúdo/nota fiscal
7º - Mostrar itens dos pedidos na declaração de conteúdo/Nota Fiscal
8º - Mostrar itens dos pedidos na declaração de conteúdo/Nota Fiscal
9º - Imprimir nota fiscal
Observação: as opções desmarcadas na imagem possuem detalhes importantes que são explicados a seguir. Leia atentamente o próximo tópico e, em caso de dúvidas, entre em contato com o suporte da Magis5.
Observações sobre as flags:
Flag nº 3 - Gerar/Emitir nota fiscal automaticamente quando o pedido for para o status de Ag. Separação
- se necessitar que a emissão das notas fiscais ocorra somente quando realizar a expedição dos pedidos, ela deverá ficar DESMARCADA.
Flag nº 4 - Emitir nota fiscal de forma automática para pedidos flex
- deverá ser MARCADA caso você precise emitir notas fiscais para os pedidos na modalidade de envio FLEX.
Flag nº 6 - Adicionar o valor do frete automaticamente na nota fiscal
- deverá ser MARCADA caso você tenha obrigatoriedade fiscal de destacar o valor do frete na nota fiscal (consulte sua contabilidade).
- se decidir trabalhar SEM o destaque do frete, é necessário verificar com o marketplace se eles aceitam a nota fiscal sem esse valor destacado.
Flag nº 7 - Mostrar itens dos pedidos na declaração de conteúdo/Nota Fiscal
- deverá ser DESMARCADA caso não queira visualizar a informação dos itens vendidos na etiqueta de nota fiscal.
Flag nº 8 - Imprimir nota fiscal
- deverá ser DESMARCADA caso não deseje realizar a impressão da etiqueta de nota fiscal.
2. Desativando a emissão automática de notas fiscais
Para interromper a emissão automática de notas fiscais, somente as opções citadas devem se manter ativas:
5º - Aguardar etiqueta no marketplace para imprimir a declaração de conteúdo/nota fiscal
7º - Mostrar itens dos pedidos na declaração de conteúdo/Nota Fiscal
8º - Imprimir nota fiscal
Observação sobre as flags:
Flag nº 5 - Aguardar etiqueta no marketplace para imprimir a declaração de conteúdo/nota fiscal
- deverá ser DESMARCADA caso você NAO utilize integração logística (Correios, Intelipost ou Mandaê) conectada a Magis5 para emitir etiqueta de envio para os pedidos ou caso o marketplace não forneça via API a etiqueta de envio para o Magis5.
Flag nº 7 - Mostrar itens dos pedidos na declaração de conteúdo/Nota Fiscal
- deverá ser DESMARCADA caso não queira visualizar a informação dos itens vendidos na etiqueta de declaração de conteúdo.
Flag nº 8 - Imprimir nota fiscal
- deverá sempre permanecer marcada mesmo que não vá emitir nota fiscal.
Atenção: caso deseje trabalhar com a emissão automática de notas fiscais desativada, o processo para efetuar o faturamento dos pedidos deverá ser de forma manual, indo até a tela de: Expedição>Picking>Bloco de Separação, selecionando os pedidos e clicando na opção "Gerar/Emitir notas fiscais".
Como fazer o preenchimento da aba "Margens e custos"
Esta seção aplica-se exclusivamente a usuários que utilizam a ferramenta de precificação automática do Magis5.
Para entender como funciona a precificação automática basta clicar no link a seguir: Como utilizar a precificação automática do Magis5?
Caso não utilize nossa ferramenta de precificação, os campos disponíveis nessa aba deverão ficar vazios.
Como fazer o preenchimento da aba "Depósitos"
Observação: se para o marketplace que esta integrando você deseja efetuar a configuração de baixa de estoque dos pedidos fulfillment dentro do ERP, é necessário acionar o time de Suporte da Magis5 para efetuar a configuração.
Caso NÃO tenha necessidade, os campos "Código do depósito fulfillment", "Código da sua loja ERP no fulfillment" e "Código do vendedor no fulfillment" devem ficar vazios.
Para otimizar o controle do seu estoque, o sistema oferece duas opções de baixa de estoque automática quando um pedido é recebido do marketplace;
- Baixa em um Único Depósito: Selecione um depósito específico para que a baixa de estoque ocorra sempre a partir dele, independentemente da disponibilidade em outros locais.
- Priorização de Depósitos: Defina uma ordem de prioridade entre seus depósitos. O sistema buscará o item no primeiro depósito da lista. Caso não haja estoque suficiente, prosseguirá para o próximo depósito na ordem definida, e assim por diante.
Opção 1 - Como configurar a baixa de estoque em um único depósito
Deverá selecionar nesta tela o depósito que os pedidos de venda deverão descontar estoque, o preenchimento deve ser feito da seguinte forma:
- seleciono o depósito
- no campo prioridade incluo o valor "1"
Opção 2 - Como configurar a priorização de depósitos para baixa de estoque
Como funciona?
- Tentativa de baixa no depósito prioritário: O sistema verificará se há estoque disponível no depósito designado como prioritário (o que está alimentado o campo prioridade com o valor 1).
- Verificação de estoque insuficiente: Caso o depósito prioritário não possua estoque suficiente para atender ao pedido, o sistema avançará para o próximo depósito na lista de prioridades.
- Tentativa de baixa no depósito secundário (e subsequentes): O sistema tentará baixar o estoque do próximo depósito na ordem de prioridade (o que está alimentado o campo prioridade com o valor 2).
Com isso, basta selecionar os depósito e indicar a ordem de baixa de acordo com a imagem a seguir:
Como fazer o preenchimento da aba "Comissão"
O Magis5 define comissões padrão para cada marketplace integrado. No entanto, caso você trabalhe com uma taxa de comissão distinta daquela predefinida pelo sistema, é obrigatório informar o valor correto nesta aba.
Para conferir as comissões padrões utilizadas basta clicar no link:
Comissões Padrão para precificação automática
Caso não utilize nossa ferramenta de precificação, os campos disponíveis nessa aba deverão ficar vazios.
Como fazer o preenchimento da aba "Impressoras"
Os campos disponíveis nessa aba devem ficar vazios.
Como fazer o preenchimento da aba "Logística"
Se for utilizar alguma integração logística como: Correios, Intelipost ou Mandaê para a emissão de etiquetas de envio da loja que esta integrando, em primeiro momento deve deixar os campos "Integração Logística Correios" e "Dados da Transportadora" definidos como "Selecione" e após concluir a integração do marketplace, acione nosso time de suporte para lhe apoiar na configuração dessa aba.
Como fazer o preenchimento da aba "Envio"
Essa aba somente é preenchida quando possui a integração logística Intelipost conectada ao Magis5. Caso você não utilize essa integração logística, os campos apresentados nessa aba devem ficar vazios.
Como fazer o preenchimento da aba "Etiqueta"
Nessa aba é possível selecionar quais dados você deseja que apareçam disponíveis na etiqueta de nota fiscal ou de declaração de conteúdo. As opções podem ser marcadas de forma distinta.
Após ter finalizado o preenchimento das abas necessárias, para concluir o processo de integração basta estar clicando na opção "Realizar Integração".
Observação: a loja que acabou de integrar será exibida no painel principal do Magis5 somente após a importação do primeiro pedido de venda.
