OBJETIVO
Inserir e atualizar anúncios dos produtos e sincronizar os pedidos de venda originados nos marketplaces.
UTILIZAÇÃO
1. Parametrização
Acesse o módulo Vendas (Figura 1) e localize o menu Marketplace:
Figura 1 - Menu do Marketplace
1.1 Parâmetros do Marketplace
Acesse o menu "Markeplace > Parâmetros" da Figura 1 acima.
Na aba Geral, o campo URL (Figura 2) deve conter o caminho do Serviço Web da integração.
Dados da URL
localhost: deve ser substituído pelo IP configurado pelo administrador de rede.
8080: deve ser substituído pela porta configurada pelo administrador de rede.
empresa: deve ser substituída pelo nome de acesso da empresa, configurado pelo administrador de rede.
Figura 2 - Parâmetros do Marketplace
Dados do Token
As informações de token de acesso (Figura 3) serão geradas no momento da ativação da loja (filial) na plataforma de integração com os marketplaces.
Figura 3 - Informações do Token de Acesso
Dados Faturamento
Nesta aba (Figura 4) são cadastrados os parâmetros para a inclusão dos pedidos de venda.
- Operação: criar uma nova operação específica, que terá parâmetros diferentes dos utilizados na operação realizada fora dos marketplaces. No cadastro da operação, quadro "Operações no Faturamento", o campo "Indicador de Presença Padrão" deve estar configurado com a opção "2 - OPERAÇÃO NÃO PRESENCIAL (PELA INTERNET)", para que não seja necessário informar manualmente em cada pedido de vendas. O mesmo ocorre para o campo "Indicador de Intermediador Padrão", utilizando a opção "1 - OPERAÇÃO EM SITE OU PLATAFORMA DE TERCEIROS (INTERMEDIADORES/MARKETPLACE). O campo "Intermediador da Transação Padrão" não precisa ser preenchido, pois será identificado pelo pedido de vendas recebido do marketplace.
- Classif. Consumidor: cadastrado em "Faturamento > Parâmetros do Faturamento > Cadastro Simplificado de Consumidor". É necessário preencher a parametrização fiscal para que o pedido seja calculado corretamente. Esta informação será gravada no cadastro do cliente do pedido.
Figura 4 - Dados Faturamento
1.2 Intermediador da Operação - Marketplace
Acesse "Companhias & Pessoas", abra o cadastro do intermediador, neste caso um dos marketplaces.
Na aba Geral (Figura 5) marque a opção "Nosso Intermediador = SIM". Em seguida, clique no botão "Dados de Intermediador".
Figura 5 - Dados de Intermediador
1.2.1 Dados de Intermediador
É necessário cadastrar as informações do intermediador (Figura 6) para cada uma das filiais.
Geral
- ID no Intermediador: necessário para emissão da NFe.
- Gera Lançamento Financeiro: lançamento automático de contas a receber para o intermediador com os dados do faturamento da venda, visto que o cliente já efetuou o pagamento ao marketplace.
Figura 6 - Dados de Intermediador
1.2.2 Marketplace (Figura 7)
- Marketplace: selecionar a opção entre as disponíveis.
- Seller ID: chave fornecida pelo marketplace (utilizada apenas pelo Mercado Livre).
Figura 7 - Dados de Intermediador - Marketplace
1.2.3 Formas de Pagamento (Intermediador x Forma de Pagamento) - "DE-PARA" (Figura 8)
- Descrição Forma Pagto: texto recebido no pedido do marketplace (exemplo: se informado %CREDITO%, qualquer texto contendo a palavra crédito será identificada com a forma de pagamento relacionada.
- Forma de Pagamento: conforme o cadastro "Formas de Pagamento/Recebimento", sendo necessário cadastrar uma forma de pagamento para cada filial.
Importante: se o "DE-PARA" não estiver preenchido, o usuário precisará preencher manualmente nas duplicatas dos pedidos.
Figura 8 - Dados de Intermediador - Intermediador x Forma de Pagamento
2. Cadastros
2.1 Produtos
Os produtos da integração via marketplaces devem estar com os campos obrigatórios (Figura 9) devidamente configurados: Categoria; Marca, Largura, Altura, Comprimento e Peso Líquido (necessários para cálculo de frete); e Classe Origem.
Importante: produtos sem a categoria definida não ficam disponíveis para inclusão nos anúncios.
Figura 9 - Dados para o Marketaplace no Produto
2.2 Anúncios
Pode ser cadastrado um anúncio (Figura 10) com vários produtos e vários marketplaces.
Dados Gerais
- Nome/Título: é utilizado em destaque no canal de vendas (marketplace)
- Referência: código para o anúncio
- Filial: filial da tabela de preço
- Almoxarifado: necessário criar almoxarifados específicos para a venda via marketplaces, e um almoxarifado para cada anúncio, pois a gestão do estoque disponível será feita pela integração das plataformas dos marketplaces. Um mesmo anúncio/almoxarifado pode ser compartilhado entre vários marketplaces.
Figura 10 - Dados Gerais do Anúncio
Marketplaces do Anúncio
É possível configurar uma tabela de preço (Figura 11) para cada marketplace.
Figura 11 - Dados do Marketplace no Anúncio
Produtos do Anúncio
Nesta janela (Figura 12) é possível ativar e desativar um marketplace e/ou produtos específicos dos anúncios. A efetivação das alterações ocorrerá após o processo de agendamento e sincronização com sucesso.
- Saldo Disponível: exibe o saldo atual no estoque toda vez que carrega a janela (diferente do saldo que está no marketplace, pois a gestão do saldo é feita por lá, conforme as vendas que estão ocorrendo até a integração dos pedidos no ERP Ti9)
- Ativo: desmarcar irá inativar o anúncio nos marketplaces
- Satus Sincronização: é necessário agendar a sincronização para que as alterações no ERP sejam sincronizadas (atualizadas) nos marketplaces
- Data Hora Sincronização: referente a última sincronização
- Status Processo: resultado da última sincronização
- NOME_Markeplace: é necessário marcar/desmarcar as colunas com o nome dos marketplaces nos produtos para definir em quais markeplaces o produto será criado/atualizado, clicando depois no botão "Agendar"
- Preço NOME_Markeplace: preço do anúncio no markeplace
Importante: é necessário clicar em "Salvar" após concluir as alterações.
Figura 12 - Produtos do Anúncio
3. Processo
3.1 Anúncios (Produtos)
Após realizar o agendamento das alterações dos produtos, é necessário executar a sincronização conforme as alterações efetuadas (Figura 13):
- Tudo: todas as informações dos anúncios (utilize esta opção também quando estiver desativando um produto).
- Descrições: apenas as descrições dos produtos.
- Preços: apenas os preços dos produtos.
- Estoque: quantidade disponível alterada.
Figura 13 - Sincronizar Anúncios
Status do Processo
É possível consultar o status do processo da sincronização no cadastro de Produtos do Anúncio (Figura 14), coluna "Status Processo".
Figura 14 - Status do Processo
Log de Sincronização de Anúncios
Caso ocorra erro de integração, o conteúdo da coluna Mensagem (Figura 15) pode ser copiado para localizar a causa do erro. Corrigido o cadastro, a alteração do produto pode ser agendada e sincronizada novamente.
Figura 15 - Log Integração Anúncios
3.2 Pedidos
Nesta etapa é demonstrado o processo de visualização e integração dos pedidos dos marketplaces com o ERP Ti9. Os pedidos listados na versão Web da consulta (Figura 16) estão pendentes de integração. A integração dos pedidos pode ser executada automaticamente em um intervalo de tempo definido com o administrador da infraestrutura de TI da empresa.
Figura 16 - Lista de Pedidos - Web
Clique no link do número do pedido para visualizar os detalhes. (Figura 17)
Figura 17 - Detalhes do Pedido - Web
Para executar a integração manualmente, clique no botão "Pedidos > Sincronizar" (Figura 18) da janela de "Anúncios" do ERP.
Figura 18 - Sincronizar Pedidos
Após a sincronização, é possível clicar na opção "Consulta LOG > Pedidos" da mesma janela para verificar o resultado (Figura 19) da integração.
O administrador da infraestrutura de TI da sua empresa pode configurar uma rotina automática que, a cada intervalo de tempo específico, consulte os pedidos com falha na integração e envie esta lista a alguns e-mails específicos.
Figura 19 - Log Integração Pedidos
Também pode-se confirmar as informações da integração na consulta Web (Figuras 20 e 21) dos pedidos no marketplace.
Figura 20 - Pedido Web Integrado
Figura 21 - Pedido Web Integrado - Cód. do Pedido no ERP
Ao consultar pedido no ERP, as informações do pedido no marketplace também podem ser acessadas pelo botão "Info Marketplace" (Figuras 22 e 23).
Figura 22 - Pedido Integrado no ERP
Figura 23 - Pedido ERP - Informações Marketplace
Se o "DE-PARA" mencionado no item 1.2.3 (acima) estiver configurado corretamente, a forma de pagamento será preenchida nos dados financeiros do pedido (Figuras 24 e 25). Caso contrário, será necessário preenchê-los manualmente.
Figura 24 - Pedido ERP - Financeiro
Figura 25 - Pedido ERP - Detalhes da Duplicata
4. Sincronização automática
Para realizar a sincronização das informaçõs abaixo, é necessário entrar em contato com a equipe de infraestrutura para realizarem o agendamento das tarefas (no Scheduler)
Importante:
- É necessário definir de quanto em quanto tempo cada um dos serviços deve ser executado.
- O token tem validade de 24h, desta maneira é necessário que o refresh seja executado 2 vezes ao dia.
4.1 Sincronização dos Pedidos
Onde:
- EMPRESA = nome de acesso da empresa, configurado pelo administrador de rede
- FILIAL = código da filial no Ti9
4.2 Refresh Token
Serviço/URL:
http://localhost:8080/ti9-crm-api/integra/tenant/EMPRESA/33e5dea3d6218afc76ddf77b3cc72058/api/mktplace/sandbox/token/refresh
Onde:
- EMPRESA = nome de acesso da empresa, configurado pelo administrador de rede
Labels