Como integrar o ERP com a Yampi

 O que é

A Yampi é uma plataforma de e-commerce que está disponível para integração com o ERP da Olist. Através da integração você consegue obter melhor controle de estoque, automatizar a emissão de notas fiscais e gerenciar seus pedidos de vendas.

 Pré-requisitos:

A integração da Yamp está disponível para todos os planos do ERP.

Recursos disponíveis

• Receber pedidos
• Receber produtos
• Enviar produtos
• Enviar estoque
• Enviar preços
• Sincronizar situação
• OMS

Configuração da integração com a Yampi

Para iniciar a configuração e conexão do e-commerce ao ERP, é necessário seguir o passo a passo do artigo Como configurar uma integração para instalá-la ao ERP.

Especificidades da integração

Após realizar a conexão da integração ao sistema, siga o passo a passo da configuração para finalizar a integração.

Sincronização de produtos

• Enviar imagens dos produtos ao sincronizar: Selecione uma das opções para que as imagens do produto no ERP sejam enviadas para o e-commerce.
• Ao importar produtos: Selecione uma das opções para que o ERP receba as imagens dos produtos importados do e-commerce no cadastro do produto.
• Enviar dias para preparação ao sincronizar: Habilite esta opção para enviar a informação sobre a quantidade de dias necessários para o envio dos produtos para a Yampi.

Observação: para preencher este campo, acesse menu > cadastro > Produto > Editar > aba dados gerais > seção Estoque > Dias para preparação. O campo pode ser preenchido por planilha e será incluído nas APIs de cálculo de frete.

• Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): Habilite este campo para atualizar o Código (SKU) sempre que os produtos forem importados do e-commerce.

Sincronização de pedidos

• Importar valor do frete nos pedidos: Habilite esta opção para importar o valor do frete junto com os pedidos.
• Sincronização automática dos pedidos: Habilite esta opção para usar o recurso de OMS na integração com seu e-commerce. Para saber mais sobre o recurso, acesse OMS.
• Enviar rastreamento ao alterar a situação no ERP para enviado: Habilite este parâmetro para que o código de rastreamento seja enviado automaticamente para a plataforma sempre que a situação do pedido for alterada para Enviado. Saiba mais sobre esta rotina na Central de Ajuda Atualizar situação de envio dos pedidos.
• Marcar pedido como entregue ao alterar a situação no ERP: Habilite este parâmetro para que, sempre que a situação do pedido for alterada para Entregue no ERP, ela também seja alterada no seu e-commerce.
• Formatar nome dos contatos no recebimento dos pedidos: Habilite esta opção para que o nome do cliente seja formatado com as iniciais maiúsculas no nome e sobrenome ao importar os pedidos.
• Enviar e-mail, através da plataforma, ao alterar a situação do pedido no ERP: Habilite este parâmetro para que a plataforma envie um e-mail para o cliente quando a situação do pedido for alterada para Enviado ou Entregue.

2. Na aba Estoque, defina as regras de estoque para a integração: 

3. Na aba Dados Fiscais, selecione a forma de envio dos dados da Nota Fiscal Eletrônica (NF-e) para o e-commerce: Automático ao autorizar nota fiscal ou Manual.

No campo Natureza de operação para venda, selecione a natureza de venda padrão para esta integração. A natureza selecionada será atribuída aos pedidos importados no ERP e usada ao gerar a Nota Fiscal a partir do pedido.

Observações:

• Você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Ao habilitar, você poderá selecionar uma natureza de operação específica. Ela será usada quando o ERP identificar que o pedido de venda é de um cliente contribuinte.

 Lembre de consultar as informações das naturezas de operações diretamente com o seu contador.

4. Na aba Gestão de preços, defina a regra de preços para a integração, tanto para importação quanto para envio de produtos para o e-commerce.

• Preço fixo: O preço de venda do anúncio é um valor fixo, que leva em conta os acréscimos e descontos aplicados individualmente.
• Conforme regras de preço: Considera todas as regras de precificação do marketplace, como percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado, e a fórmula de cálculo para aplicar os valores adicionais. Se você escolher esta opção, siga a configuração de Precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
• Conforme lista de preços: Usa listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir esta regra, no campo Lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos. Para saber como configurar, acesse o artigo sobre Listas de preços.

5. Na aba Categorias, vincule as categorias de produtos do ERP com as categorias do e-commerce. Assim, os produtos serão enviados para as categorias já mapeadas.

As categorias já cadastradas são exibidas em Categoria no ERP. Adicione o Código da categoria no e-commerce clicando em Configurar categoria no e-commerce.

Observações:

• Se você ainda não tem categorias cadastradas na sua conta no ERP, veja as instruções em Como cadastrar categorias de produtos.
• As instruções para vincular categorias no cadastro de produtos estão disponíveis em Como cadastrar um produto simples.

6. Na aba Situações, você pode relacionar as situações dos pedidos no e-commerce com as do ERP, além de definir o fluxo da sequência de situações no ERP.

• Adicione as situações padrão do e-commerce clicando em Adicionar situações padrão.
• Para adicionar novas situações, clique em Adicionar mapeamento de situação.

Para alterar a situação de um pedido para uma anterior, habilite a opção Permite retroceder situação dos pedidos na sincronização de situações. Por exemplo, um pedido com a situação Enviado poderá voltar para Preparando Envio.

Observação: Ao importar um pedido de venda do e-commerce para o ERP, ele assume a situação configurada. Se a situação não estiver configurada, o pedido importado terá a situação em aberto atribuída.

7. Na aba Formas de recebimento, você pode vincular as formas de recebimento dos pedidos da sua loja virtual com as formas de recebimento do ERP. Assim, suas contas a receber serão geradas no ERP com as mesmas informações da plataforma.

Para fazer isso, primeiro habilite o parâmetro Importar forma de recebimento nos pedidos. Depois, clique em Adicionar forma de recebimento.

Em seguida:

1. No campo Forma de recebimento, selecione a forma de recebimento do ERP que você quer vincular à da integração.
2. No campo Código na integração, clique no botão Relacionar forma de recebimento e selecione a forma de recebimento da sua plataforma.
3. Se você souber o código da integração, pode clicar em Informar código manualmente e digitá-lo.

Observação: ao adicionar as formas de recebimento, o ERP busca as que já estão configuradas na sua conta. Para saber como cadastrá-las, acesse Formas de Recebimento.

Para confirmar o relacionamento, clique em Relacionar.

No campo Forma de recebimento padrão, defina a forma de recebimento que será usada sempre que o pedido importado não tiver uma forma relacionada.

8. Na aba Formas de frete, você pode mapear as formas de frete do e-commerce com as formas de envio cadastradas no seu ERP.

Para mapear as formas de frete, siga os passos abaixo:

1. Nos campos Forma de envio e Forma de frete, selecione as formas que você quer mapear.
2. Em Código na integração, clique em Relacionar forma de frete.
3. Na lista, selecione a forma de envio correspondente na sua plataforma.
4. Se a forma de frete não for exibida, você pode obtê-la a partir de um pedido que já tenha a mesma forma de frete para fazer a relação. Caso você saiba o código da integração, clique em Informar código manualmente e digite o código.
5. Clique em Relacionar para confirmar o vínculo.
6. Para adicionar mais formas de frete, clique em Adicionar.

Observações: ao adicionar as formas de frete, o ERP busca as formas de envio já configuradas na sua conta. Para cadastrar novas formas de envio, acesse Formas de Envio.

• Para mapear as formas de frete da Frenet, acesse a ajuda Mapear formas de frete Frenet.

9. Na aba Custos, você define os custos de comissão cobrados pelos pedidos do marketplace. Escolha se a base de cálculo da comissão vai considerar o valor total da venda ou o total da venda sem o frete.

Observação: a aba custos só será exibida se a extensão custos do e-commerce estiver instalada.

10. Clique em salvar para finalizar as configurações.

Utilizando a integração

Após concluir as configurações da sua integração no ERP, acesse o artigo Como usar uma integração no dia a dia para entender como trabalhar com a integração dentro da sua operação.