Integração ERP com Spiritshop
Integração desenvolvida pela Spiritshop, através da nossa API de integração.
Recursos disponíveis
| Receber pedidos Solução desenvolvida pela Spiritshop | ✔ |
| Receber produtos Solução desenvolvida pela Spiritshop | ✔ |
| Enviar produtos | ✔ |
| Enviar estoque | ✔ |
| Enviar preços | ✔ |
| Sincronizar situação | ✔ |
| Receber clientes | X |
Configuração no ERP
Configurar integração com a Spiritshop
Inicie a configuração, acessando menu → início → integrações.
Observações:
Caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma:
- Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
- Inativa: Indica a inatividade desta loja no ERP, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
- Não conectada: Indica que a configuração ainda não foi realizada.
Somente as integrações Ativas serão exibidas para uso nas sincronizações, importações e demais ações no ERP.
Clique em adicionar Integração, busque por Spiritshop e clique em instalar.
Na aba Conexão, campo nome informe o nome da integração no ERP.
Defina os seguintes campos:
Produtos > Fluxo de Produtos
| Enviar imagens dos produtos ao sincronizar | Selecione umas das opções disponíveis para que as imagens do produto, no ERP, sejam enviadas para o e-commerce. |
|---|---|
| Enviar dias para preparação ao sincronizar | Habilite a opção para enviar a informação do campo Dias para preparação no envio de produtos para Americanas Marketplace. Para preencher este campo, acesse o Cadastro do seu produto , clique em Editar e na aba Dados gerais , na seção Estoque preencha o campo Dias para preparação. Lembramos que esse campo pode ser alimentado por planilha e será inserido também nas APIs de cálculos dos fretes (Carrefour, por exemplo). |
Pedidos > Fluxo de Pedidos
| Enviar rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos. |
|---|
Notificações por e-mail
| Enviar e-mail de rastreamento ao alterar a situação no ERP para enviado | Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no ERP, o código de rastreio será enviado de forma automática via e-mail conforme layout estabelecido nas configurações da expedição. |
|---|---|
| Enviar e-mail de entrega ao alterar a situação no ERP para entregue | Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no ERP, será enviado de forma automática um e-mail conforme layout estabelecido nas configurações da expedição. |
- Na aba Produtos > Regras de estoque, defina as regras de estoque da integração:
| Atualizar estoque na loja virtual a partir do ERP | Selecione umas opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque). |
|---|---|
| Depósito a ser considerado na integração |
Escolha qual será o depósito padrão para: importar pedido, importar produtos e enviar estoque. * O campo depósito a ser considerado na integração será exibido nas contas que possuem a extensão depósitos de estoque instalada |
| Lançamento de estoque para saídas |
Defina quando o estoque dos pedidos será lançado: ao selecionar a opção Manual , o usuário deverá através do menu de contexto localizado ao lado de cada pedido ou nota fiscal selecionar a opção Lançar estoque. Se escolhida uma das opções de Automático , o sistema fará o lançamento no momento determinado: Ao autorizar a NFe , Ao salvar NFe , Ao salvar o pedido ou Ao marcar pedido como enviado. Se selecionar Ao marcar pedido como enviado e o pedido tiver uma nota fiscal vinculada, o lançamento de estoque ocorrerá pela nota fiscal. * O lançamento do estoque pode ser parametrizado de acordo com as configurações das naturezas de operação. Ao lançar estoque manual para uma natureza configurada para não permitir lançamento de estoque, será exibido um aviso não permitindo lançar estoque. A configuração da natureza de operação deverá ser verificada. |
Na aba Pedidos > Preços , defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce.
- Preço fixo : conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
- Conforme regras de preço : trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais;
- Conforme lista de preços : para uso de listas de preços dos produtos, específicas para o e-commerce ou marketplace.
Na aba Notificações preencha os campos URL do notificações de estoque, URL para envio de produtos, URL para envio do rastreio, URL para envio da nota fiscal, URL para envio dos preços e URL para envio de alteração na situação de pedidos com as URLs utilizadas para webhook de sua loja virtual.
Observação:
Estes links devem ser solicitados ao suporte da Spiritshop.
Ao final, não esqueça de Salvar as configurações.
Adicionar extensão token api
Inicie adicionando a extensão Token API em sua conta. Para isso acesse Menu → Início → Extensões do ERP.
Na seção Vendas , adicione a extensão Token API.
Agora, clique em Instalar e Confirme a instalação da extensão.
Gerar token api
Acesse as configurações de e-commerce do ERP em Menu → Configurações → Aba E-commerce → Token API.
No campo Token , encontra-se o Token identificador da sua conta.
- Esse Token deve ser adicionado no momento que integrar o ERP na Spiritshop
Como enviar produtos do ERP para a Spiritshop
Enviar apenas um produto
Para enviar apenas um produto para a Spiritshop, acesse em Menu → Cadastros → Produtos.
Agora, acesse o Menu de contexto do produto e clique em Enviar para o e-commerce.
A seguir, no campo Plataforma selecione sua loja Spiritshop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição
- Preço
- Peso bruto
- NCM
- Origem
- Estoque
- Estoque mínimo
- Dimensões
- Variações
- Anexos
Enviar produtos selecionados
Para enviar o cadastro de produtos do ERP para a Spiritshop, acesse em Menu → Cadastros → Produtos → Selecione os produtos que deseja enviar → Enviar para e-commerce.
A seguir, no campo Plataforma selecione sua loja Spiritshop e marque a opção Atualizar estoque no e-commerce. Após isso, clique em Avançar.
Valide se o produto esta com as informações corretas para envio clique em Enviar.
Campos enviados:
- Descrição
- Preço
- Peso bruto
- NCM
- Origem
- Estoque
- Estoque mínimo
- Dimensões
- Variações
- Anexos
Como mapear o cadastro dos produtos para integração do estoque
Para que o mapeamento dos itens entre o ERP e a Spiritshop ocorra, é necessário sincronizar o produto desejado a partir do Tiny.
Como visualizar os pedidos do e-commerce no ERP
A importação dos pedidos é realizada de forma automática. Para visualizar os pedidos, acesse sua conta no ERP em Menu → Vendas → Pedidos de venda.
Configuração na Spiritshop
Como integrar o ERP com a plataforma Spiritshop
Para ativar e configurar a integração da loja com o sistema ERP, entre em contato com o suporte da Spiritshop e encaminhe o Token gerado anteriormente no ERP.
Informações relacionadas
Cadastrando os produtos no ERP
Quando você opta por integrar o ERP à Spiritshop, alguns dados são sincronizados entre as duas plataformas, evitando que você precise fazer o cadastro de produtos duas vezes.
É importante que você entenda quais campos serão sincronizados. Segue abaixo a lista com a especificação de cada campo:
| Descrição | O campo descrição no ERP equivale ao campo Título no painel de controle da Spiritshop. |
|---|---|
| NCM | O NCM do produto no ERP será sincronizado com o NCM do item na Spiritshop. |
| Origem | A origem do produto no ERP será sincronizada com a origem do item na Spiritshop. |
| Preço | O campo preço de venda no ERP equivale ao campo preço no painel de controle da Spiritshop. |
| Peso bruto | O peso bruto equivale ao campo peso bruto no painel de controle da Spiritshop. |
| Largura | Preencha o campo largura no ERP com a largura exata do produto. Este campo será vinculado ao campo largura no painel Spiritshop. |
| Altura | O campo altura no ERP equivale ao campo altura no painel de controle da Spiritshop. |
| Comprimento | O campo comprimento no ERP equivale ao campo comprimento no painel de controle da Spiritshop. |
| Estoque | O campo estoque no ERP corresponde ao estoque no painel de controle da Spiritshop. |
| Estoque Mínimo | O campo estoque mínimo no ERP corresponde ao estoque no painel de controle da Spiritshop. |
| Variações | As variações dos produtos no ERP serão sincronizadas com as variações do item na Spiritshop. |
| Anexos | As imagens dos produtos no ERP serão sincronizadas com as imagens dos itens na plataforma. |
Saiba como cadastrar no ERP produtos Simples e com Variações.
Enviar estoque dos produtos no ERP ao e-commerce
Enviar quantidade em estoque em lote
Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos. Na lista que será exibida, selecione as integrações que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar quantidade em estoque de forma individual
Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.
No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto. Na lista que será exibida, selecione aquelas que deseja enviar a quantidade em estoque.
Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.
Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.
Para concluir o processo de envio, clique em Enviar.
Enviar preço dos produtos no ERP ao e-commerce
Enviar preços em lote
Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Enviar preço de forma individual
Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.
Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.
Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.
Para concluir o processo de envio, clique em Enviar.
Reajustar preço dos produtos no ERP e atualizar na Spiritshop
Para realizar os ajustes nos preços dos produtos cadastrados no ERP e após atualizar na loja virtual, acesse em Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.
Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.
Após isso, será exibido a lista dos produtos, clique em Informar reajuste.
Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços, por reajuste de Percentual , ou adicione o novo preço em cada produto na coluna Novo preço , marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.
Enviar código de rastreio para Spiritshop
Atenção!
Para enviar o código de rastreamento para Spiritshop, é preciso informar no pedido ou nota fiscal o transportador, sendo ele Correios ou Transportadora. O campo será preenchido no Pedido de Venda ou na Nota Fiscal e por fim, gerar o agrupamento (PLP ou Coleta) no módulo de Expedição. Veja como gerar a Expedição.
Acesse o módulo de Expedição, Selecione a forma de envio → Aba Concluídas → Clique no menu de contexto ao lado da expedição gerada → Enviar código de rastreio para o e-commerce.
Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado a Spiritshop.
Enviar dados da chave de acesso ao e-commerce
Ao utilizar a integração com a Spiritshop, assim que as notas forem emitidas através das vendas importadas de sua plataforma, os dados das notas fiscais serão enviados de forma automática.
Dicas e informações adicionais
- Os campos sincronizados devem ser corrigidos/modificados apenas no ERP. Caso você corrija/modifique alguma destas informações no painel de controle da Spiritshop, estas informações serão sobrescritas pelos dados cadastrados no ERP assim que rodar a próxima rotina de sincronização.
- Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.
