For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to page URLs.
Pular para o conteúdo

Importar catálogo e clientes do ERP

Importar produtos e clientes do ERP para a Uplaces de uma vez: escolha o que trazer, quantos itens e acompanhe o relatório. Bling, Tiny e Omie.

O botão Importar do ERP copia para a Uplaces o que já está cadastrado no seu ERP: produtos, preços, estoque, clientes e outros cadastros. Você escolhe o que trazer e quantos itens, e acompanha o resultado na própria tela. A importação só lê o ERP; nada é enviado a ele. O nome do botão leva o do seu ERP: Importar do Bling, Importar do Tiny v3, Importar do Tiny ou Importar do Omie.

Antes de começar

  • A integração com o ERP conectada: Bling, Tiny ou Omie. O botão só aparece depois da conexão.

  • Usuário administrador da loja.

  • Produtos ativos no ERP, com código (SKU). Cliente com CPF ou CNPJ.

  • Em conta de teste, a importação tem um limite de produtos. Para ver a loja com os seus dados, comece com poucos.

1

Abrir a janela de importação

  1. No menu, abra Integração ERP › Nativa e, no card do seu ERP, clique em Gerenciar.

  2. No alto da tela, clique em Importar do seguido do nome do seu ERP.

  3. A janela abre com as opções do seu ERP. Em conta de teste, ela já abre em Começar com seus dados.

2

Escolher o que trazer

As opções mudam conforme o ERP:

Opção
O que traz
Bling
Tiny v3
Tiny v2
Omie

Começar com seus dados (recomendado)

tudo o que a loja precisa para nascer, nessa ordem, num clique. Botão Trazer meus dados

sim

sim

não

não

Catálogo inteiro

produtos, variações, preços, fotos e estoque. Botão Importar catálogo

sim

sim

não

não

Produtos por código

só os produtos da lista. Botão Importar produtos

sim

sim

sim

sim

Clientes

todos os clientes, ou só a lista que você colar

sim

sim

Clientes da lista

Clientes da lista

Categorias

a árvore de categorias da vitrine

sim

não

não

não

Formas de pagamento

para o pedido chegar ao ERP com a forma que ele conhece

sim

não

não

não

Listas de preços

as listas do ERP viram tabelas de preço

não

sim

não

não

Vendedores

Vincular vendedores: liga cada vendedor do ERP ao usuário da Uplaces com o mesmo nome

sim

sim

não

não

O que o "Começar com seus dados" traz: no Bling, formas de pagamento, produtos (com as categorias) e clientes. No Tiny v3, listas de preço, produtos e clientes. A ordem existe para cada passo aproveitar o anterior: a categoria e a lista de preço já existem quando o produto chega.

3

Informar a lista, quando a opção pede

Nas opções Produtos por código e Clientes, aparece uma caixa de texto:

  • Produtos: um código por linha, ou separados por vírgula. No Bling, o código pode ser o ID do produto ou o SKU. No Tiny e na Omie, é o código do produto.

  • Clientes: CPF/CNPJ ou o ID do cliente no ERP, um por linha.

  • O contador mostra quantos itens você colou. No Bling e no Tiny v3 não há limite de itens na lista. Nos demais, a janela avisa o máximo por vez; para trazer mais, repita a importação com a lista seguinte.

  • Em Clientes (Bling e Tiny v3), a caixa é opcional: vazia, traz todos os clientes e o botão passa a ser Importar todos os clientes.

4

Escolher quantos trazer

Em Quantos trazer, preencha Produtos: até e Clientes: até. O campo vazio significa todos. Em conta de teste, o campo de produtos já vem preenchido com o limite do teste.

Comece com poucos itens, confira a loja e importe o restante depois, pelo mesmo botão. O botão da janela passa a dizer a quantidade, por exemplo Importar até 20 produtos. A importação para de ler o ERP quando chega ao número escolhido, então pedir 20 não espera o ERP listar o catálogo todo.

5

Importar e acompanhar

  1. Clique no botão da opção (Trazer meus dados, Importar catálogo, Importar produtos, Importar clientes).

  2. A janela fecha e a importação roda em segundo plano. Você pode continuar usando o admin.

  3. Na mesma tela, a seção Atividades sendo processadas em background mostra as colunas Atualização, Atividade, Descrição e Processado em. O botão de atualizar recarrega a lista, e o da lixeira limpa a lista.

Resultado

No Bling, a Descrição da atividade traz o relatório por item: quantos entraram e, para cada item que ficou de fora, o motivo. Exemplo de resumo: 45 de 50 produto(s) importado(s): 40 criado(s), 5 atualizado(s), 5 não encontrado(s) no ERP. Os desfechos possíveis são criado(s), atualizado(s), ignorado(s), não encontrado(s) no ERP, com erro e fora do limite do teste. A lista mostra os primeiros itens com problema, e o resto entra só na contagem.

Nos outros ERPs, a atividade mostra o fim da tarefa. Confira o resultado em Produtos e Clientes, no menu da Uplaces.

Depois de importar:

  • Produto sem preço em nenhuma tabela de preço fica invisível para o cliente logado. Confira o cadastro de produtos e as tabelas de preços.

  • Associe tabela de preço, condição comercial e vendedor aos clientes importados, conforme as políticas comerciais.

  • Importar de novo atualiza os itens que já existem, respeitando os Critérios para atualização de PRODUTOS e de CLIENTES da integração (por exemplo, Não atualizar nome).

Problemas comuns

O botão Importar não aparece

A integração ainda não está conectada, ou o seu usuário não é administrador. Veja a página do seu ERP: Bling, Tiny ou Omie.

Vieram menos itens do que eu esperava

Confira o campo Quantos trazer e, no Bling, o relatório em Atividades: cada item que ficou de fora vem com o motivo. Produto inativo no ERP não entra no Tiny v3.

Alguns clientes não entraram

No Bling, entram os cadastrados como cliente (ou sem tipo); fornecedor e funcionário ficam de fora. Se Com e-mail válido estiver marcado em Critérios para atualização de CLIENTES, quem não tem e-mail também fica de fora.

A importação não termina

O ERP limita as chamadas por minuto, conforme o plano. A importação continua em segundo plano; acompanhe em Atividades. Na Omie, uma sequência de erros bloqueia a conexão por um tempo: veja a página da Omie.

O produto chegou sem estoque

Confira o depósito configurado: Estoque de produtos (depósito) no Bling, Id do deposito no Tiny v3. Depois rode a importação de novo.

Perguntas frequentes

A importação altera alguma coisa no meu ERP?

Não. Ela só lê o ERP e grava na Uplaces.

Posso importar de novo?

Sim, quantas vezes precisar. O que já existe é atualizado, e o que é novo é criado.

Quanto tempo leva?

Depende da quantidade de itens e do limite de chamadas do ERP. Comece com poucos para ver o resultado em minutos.

Veja também