> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/importar-do-erp.md).

# 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](https://ajuda.uplaces.com.br/integracoes/bling.md), [Tiny](https://ajuda.uplaces.com.br/integracoes/tiny.md) ou [Omie](https://ajuda.uplaces.com.br/integracoes/omie.md). 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.

{% stepper %}
{% step %}

## 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**.
   {% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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**.
  {% endstep %}

{% step %}

## 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.
{% endstep %}

{% step %}

## 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.
   {% endstep %}
   {% endstepper %}

## 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](https://ajuda.uplaces.com.br/ecommerce-b2b/produtos/cadastro.md) e as [tabelas de preços](https://ajuda.uplaces.com.br/ecommerce-b2b/produtos/tabelas-de-precos.md).
* Associe tabela de preço, condição comercial e vendedor aos clientes importados, conforme as [políticas comerciais](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais.md).
* 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

<details>

<summary>O botão Importar não aparece</summary>

A integração ainda não está conectada, ou o seu usuário não é administrador. Veja a página do seu ERP: [Bling](https://ajuda.uplaces.com.br/integracoes/bling.md), [Tiny](https://ajuda.uplaces.com.br/integracoes/tiny.md) ou [Omie](https://ajuda.uplaces.com.br/integracoes/omie.md).

</details>

<details>

<summary>Vieram menos itens do que eu esperava</summary>

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.

</details>

<details>

<summary>Alguns clientes não entraram</summary>

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.

</details>

<details>

<summary>A importação não termina</summary>

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](https://ajuda.uplaces.com.br/integracoes/omie.md).

</details>

<details>

<summary>O produto chegou sem estoque</summary>

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.

</details>

## Perguntas frequentes

<details>

<summary>A importação altera alguma coisa no meu ERP?</summary>

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

</details>

<details>

<summary>Posso importar de novo?</summary>

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

</details>

<details>

<summary>Quanto tempo leva?</summary>

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

</details>

## Veja também

* [Integrações](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md)
* [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md)
* [Importar dados de clientes](https://ajuda.uplaces.com.br/ecommerce-b2b/clientes/importar-dados-de-clientes.md)
