Yep: o que é, quais os pré-requisitos e como instalar

O que é e quais são os pré-requisitos

A integração entre o ERP e o Yep importa automaticamente os pedidos para sua conta, agilizando a emissão de notas fiscais e o controle de estoque.

Recursos disponíveis

Como configurar a integração

Confira nesta seção: 

• 1. Configurando a Yep
• 2. Configurando no ERP

1. Configurando a Yep

Crie um Papel (Role) para acesso ao WebServices. 

1. Acesse o Painel de Administração da sua loja Yep.
2. No menu System, selecione a opção WebServices e depois SOAP/XML-RPC - Roles (ou apenas Roles).
3. Na tela seguinte, clique em Add New Role.
4. No campo Role Name, insira uma descrição para o papel (por exemplo, "ERP").
5. No campo Current Admin Password, digite a senha do administrador da Yep.
6. Clique em Save Role.
7. Agora, clique em Role Resources.
8. No campo Resource Access, atribua All (Todas) as funções.
9. Clique em Save Role novamente.

Crie um Usuário para acesso ao WebServices

1. Ainda no Painel de Administração da sua loja Yep.
2. No menu System, selecione a opção WebServices e depois SOAP/XML-RPC - Users (ou apenas Users).
3. Clique no botão Add New User.
4. Preencha os seguintes dados do usuário:
5. Current Admin Password: Informe a senha do administrador do seu painel Yep.
6. API Key: Informe a senha de acesso para este novo usuário.
7. API Key Confirmation: Repita a senha informada no campo "API Key".
8. Clique em Save User.
9. Após salvar o usuário, você precisa vinculá-lo ao papel que criou anteriormente. Acesse a aba User Role.
10. Marque a opção Admin.
11. Clique em Save User.

2. Configurando no ERP

1. Para iniciar a configuração no ERP, siga os passos abaixo:
2. Acesse o menu → Início → Integrações.
3. Clique em Adicionar Integração.
4. Busque por "Yep" e clique em Instalar.

Aba Integração

1. No campo Nome, informe um nome para a integração no ERP (ex: "Minha Loja Yep").
2. Na seção Autenticação, preencha os campos com as credenciais do usuário que você criou na Yep.
3. Clique em Testar Configurações para validar as credenciais de login.

Aba Configurações

Nesta aba, você definirá diversas opções de sincronização:

1. Sincronização de Produtos

• Enviar imagens dos produtos ao sincronizar: Escolha como as imagens dos produtos no ERP serão enviadas para a Yep.
• Enviar imagens do produto pai nas variações: Ative para que as imagens do produto pai sejam enviadas para as variações sem imagem própria.
• Ao importar produtos: Escolha como o ERP receberá as imagens dos produtos importados da Yep.
• Enviar categoria na atualização do produto: Ative para que a categoria do produto seja enviada ao atualizar produtos existentes na Yep.
• Na importação de produtos, ao atualizar um produto, atualizar o código (SKU): Ative para que o código SKU seja atualizado no ERP ao importar produtos.
• Envio e importação de produtos com variações (beta): Ative para enviar e importar produtos com variações. (Configuração válida apenas para Yep 2.3)
• Atualizar o produto em todos os escopos: Ative para atualizar os produtos em todos os store modes. (Configuração válida apenas para Yep 2.3)

2. Sincronização de Pedidos

• Sincronização automática de pedidos: Ative para usar o recurso de OMS na integração. (Saiba mais sobre OMS na Central de Ajuda do ERP).
• Importar valor do frete nos pedidos: Ative para importar o valor do frete nos pedidos.
• Importar forma de recebimento nos pedidos: Ative para receber a forma de recebimento. As configurações devem ser feitas na aba Formas de Recebimento.
• Importar campo "shipping_description" como: Escolha entre "Transportadora" ou "Transportadora + Prazo de Entrega".
• Importar transportadora ou forma de frete: Ative para importar a forma de frete da transportadora.
• Shipping Carrier para envio de código de rastreio: Preencha este campo com o Shipping Carrier da Yep para que o código de rastreio do ERP seja enviado.
• Enviar rastreamento ao alterar a situação no ERP para Enviado: Ative para enviar o código de rastreio automaticamente quando o pedido for alterado para "Enviado" no ERP.
• Formatar nome dos contatos no recebimento dos pedidos: Ative para formatar o nome e sobrenome do cliente com iniciais maiúsculas ao importar pedidos.
• Importar campo COMPANY quando cliente for pessoa jurídica: Ative para importar o campo "company" para o ERP quando o cliente for pessoa jurídica. Se desabilitado, serão importados "firstname" e "lastname".
• Completar endereço do cliente a partir do CEP na importação de pedidos: Ative para que o endereço seja preenchido no ERP a partir do CEP. Se escolher Sempre, o CEP será validado nos Correios.
• Adicionar o endereço do cliente nas observações da venda: Ative para incluir o endereço do cliente nas observações da venda ao importar o pedido.
• Inclui observação no pedido da Yep com o número da nota fiscal ou venda: Ative para incluir os números da nota fiscal ou venda nas observações do pedido da Yep.
• Enviar e-mail, através da plataforma, ao enviar rastreamento para a Yep: Ative para que um e-mail seja enviado ao enviar o rastreamento para a plataforma.

Notificações por E-mail

• Enviar e-mail de entrega ao alterar a situação no ERP para Entregue: Ative para que um e-mail seja enviado automaticamente quando o pedido for alterado para "Entregue" no ERP.

Configurações Adicionais

• Envio de dados da NFe: Selecione para enviar os dados da NFe para a Yep.
• Layout da mensagem do envio de dados da NFe: Preencha o texto para configurar a mensagem de envio dos dados da NFe.

Aba Estoque

Defina as regras de estoque para a integração:

• Atualizar estoque na loja virtual a partir do ERP: Escolha "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: Selecione o depósito padrão para importação de pedidos, produtos e envio de estoque. (Este campo só aparece se você tiver a extensão de depósitos de estoque instalada).
• Estoque mínimo: Escolha como enviar a informação de estoque mínimo: "enviar para quantidade mínima para exibir produto como disponível (min_qty)", "enviar para quantidade mínima para notificar estoque baixo (notify_stock_qty)" ou "não enviar".
• Produto sempre em estoque na Yep: Ative para que os produtos sempre mantenham estoque na plataforma.

Aba Dados Fiscais

• Selecione a Natureza de Operação para Venda nesta integração. Esta natureza será atribuída por padrão na importação de pedidos no ERP e na geração da nota fiscal.
• Você pode habilitar ou desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Se habilitado, poderá selecionar uma natureza de operação específica para clientes contribuintes.

Aba Campos Personalizados

Preencha os campos personalizados que serão importados com os pedidos ou produtos, conforme as descrições da Yep.

Atenção: preencha estes campos somente se sua loja Yep foi alterada para incluir essas informações. Caso contrário, deixe-os em branco.

Aba Gestão de Preços

Defina a regra de preços para a integração:

• Preço Fixo: O anúncio recebe um valor fixo de preço de venda, considerando acréscimos e descontos individuais.
• Conforme Regras de Preço: Considera as regras do marketplace (percentual de comissão, adicional de frete, fórmula de cálculo de valores adicionais).
• Conforme Lista de Preços: Usa listas de preços específicas para o e-commerce ou marketplace. Se escolher esta opção, selecione a lista de preços a ser considerada na importação de pedidos.

Aba Categorias

Relacione as categorias de produtos do ERP com as categorias da Yep:

1. As categorias já cadastradas no ERP serão exibidas.
2. Clique no botão Configurar Categoria no E-commerce e adicione o código da categoria correspondente na Yep.

Aba Situações

Relacione as situações dos pedidos na Yep com as situações no ERP e defina o fluxo de situações:

1. Clique em Adicionar Situações Padrão para adicionar as situações presentes na Yep.
2. Para adicionar novas situações, clique em Adicionar Mapeamento de Situação.
3. Para permitir que um pedido retorne a uma situação anterior, habilite o campo Permite Retroceder Situação dos Pedidos na Sincronização de Situações.
4. Em Situações Personalizadas, adicione filtros personalizados para a listagem de pedidos. Preencha os campos Código da Situação e Descrição da Situação.

Aba Formas de Recebimento

Relacione as formas de recebimento da Yep com as formas de recebimento no ERP:

1. Habilite o parâmetro Importar Forma de Recebimento nos Pedidos.
2. Clique em Adicionar Forma de Recebimento.
3. No campo Forma de Recebimento, selecione a forma do ERP.
4. No campo Código na Integração, clique em Relacionar Forma de Recebimento e selecione a forma de recebimento correspondente na Yep.
5. Se a forma não for exibida, você pode buscar por um pedido que a possua ou clicar em Informar Código Manualmente e digitar o código.
6. Clique em Relacionar para confirmar.
7. No campo Forma de Recebimento Padrão, defina uma forma de recebimento que será usada se o pedido importado não tiver uma forma relacionada.

Aba Formas de Frete

Mapeie as formas de frete da Yep com as formas de envio cadastradas no ERP:

1. Nos campos Forma de Envio e Forma de Frete, selecione as formas que deseja mapear.
2. Em Código na Integração, clique no botão Relacionar Forma de Frete.
3. Na listagem, selecione a forma de envio correspondente na plataforma.
4. Se a forma não for exibida, você pode buscar por um pedido que a possua ou clicar em Informar Código Manualmente e digitar o código.
5. Clique em Relacionar para confirmar.
6. Para adicionar novas formas de frete, clique em Adicionar.

Aba Custos

• Defina os custos de comissão cobrados pelos pedidos do marketplace:
  • Escolha se a base de cálculo da comissão considerará o Valor Total da Venda ou o Total da Venda sem o Frete.

Não se esqueça de Salvar todas as configurações ao finalizar.

Após finalizar a instalação e configuração, confira como usar a integração sua conta do ERP.