> 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/tiny/configuracao-da-integracao.md).

# 🔧 Configuração da Integração

#### 🔧 Passo a Passo de Configuração

Você confere a seguir todas as etapas necessárias para realizar a integração de forma autônoma:

{% embed url="<https://tiny.com.br/ajuda/integracao-uplaces>" %}

### 1 - Cadastre um usuário de integração

Acesse a aba **Usuários** dentro da Uplaces e clique em **Incluir** para cadastrar um novo usuário exclusivo para a integração com o Tiny.

<figure><img src="/files/7HD8bDnzqCpLlgXFMhLV" alt=""><figcaption></figcaption></figure>

Esse usuário deve ter o perfil **Integração**, como mostrado abaixo:

{% hint style="warning" %}
Isso garante que o sistema consiga se comunicar de forma segura com o Tiny
{% endhint %}

<figure><img src="/files/wiAWZvYhbQ3PcxPI9RcE" alt=""><figcaption><p>Preencha os campos obrigatórios e selecione o perfil <strong>Integração</strong> na criação do usuário.</p></figcaption></figure>

### 2 - Credenciais de Acesso no Tiny

Acesse sua conta no Tiny e vá até a opção de integrações. Em seguida, adicione a integração com a Uplaces e clique em "**Gerenciar**".

{% hint style="success" %}
Para obter mais informações, consulte a documentação oficial do Tiny para integrações:\
<https://suporte.olist.com/kb/articles/erp/integracoes/outras-integracoes-via-api/integracao-tiny-com-a-uplaces>
{% endhint %}

<figure><img src="/files/gMiEpRNuqsVRKp94kdoA" alt=""><figcaption></figcaption></figure>

🔐 Essas credenciais serão necessárias para autenticar a comunicação entre os sistemas.

<figure><img src="/files/SIiF8TSLD6inIUnureBW" alt=""><figcaption></figcaption></figure>

### 3 - Acesse o módulo de integrações

Acesse **Integrações ERP > Nativos** e selecione Tiny\
![](/files/2MpkvTfTVYqR5tc3ev6r)

No painel lateral selecione a opção **Tiny ERP**.

![](/files/Wc360uZJY4ztZ3tUC2wF)

#### Informe os seguintes dados:

* Nome da integração: ex ***Integração Tiny ERP***
* Usuário da integração criado no passo anterior:

<figure><img src="/files/pruc8Y2UmYmSvBV1rF2D" alt=""><figcaption></figcaption></figure>

* Nesta seção, é determinado em que status na Uplaces os pedidos devem ser encaminhados para o Tiny:

![](/files/5U1CAfZAyT4xHieDiDSE)&#x20;

* Informe as credenciais de acesso (**Identificador do integrador e Token**) obtidas no Tiny no passo anterior.

<figure><img src="/files/HU1dAAj2tDrFY1V94BNd" alt=""><figcaption></figcaption></figure>

* Salve e clique em **Testar**!

<figure><img src="/files/5fD3au0YSENKKctkubP3" alt=""><figcaption></figcaption></figure>

### 4 - Configurar Webhooks para atualização de Estoque e Preços

Para manter os dados de estoque e preços atualizados na Uplaces, o Tiny envia uma URL para notificar a plataforma sobre as atualizações em tempo real dos dados dos produtos.

{% hint style="warning" %}
**Atenção**: Certifique-se de ter copiado e colado no Tiny a URL com os caminhos corretos para evitar problemas na integração.
{% endhint %}

#### Copiar URL das configurações da Uplaces

<figure><img src="/files/rBQpW83Iz3IDoMuQwnAC" alt=""><figcaption></figcaption></figure>

#### Colar nas Notificações por integração no Tiny ERP

<figure><img src="/files/SDh3DBCXYt504z4fwZMi" alt=""><figcaption></figcaption></figure>

### 5 - ✅ Integração concluída!

Com esses passos, o sistema da **Uplaces estará integrado com o Tiny ERP** e será possível **receber produtos automaticamente** e **enviar pedidos diretamente** para o Tiny. A integração estará ativa e funcional.

#### 🔧 Próximos passos – configurações adicionais da integração

Após a ativação, é possível **personalizar o comportamento da integração** conforme a realidade do seu negócio. Abaixo, listamos as principais opções disponíveis para ajuste:

**📌 Critérios de atualização de clientes**

<figure><img src="/files/KqBN0RU1fsK8R4oMPGUV" alt=""><figcaption></figcaption></figure>

Você pode definir quais tipos de clientes devem ser sincronizados com o Tiny:

* **Pessoa Jurídica**
* **Pessoa Física**
* **Com e-mail válido**
* **Apenas atualizar (não insere novos clientes)**

Essas opções ajudam a manter a base de clientes no ERP organizada e alinhada com a operação da Uplaces.

**📦 Critérios de atualização de produtos**

<figure><img src="/files/BCfQ88FDrCIIQ2S8WNHS" alt=""><figcaption></figcaption></figure>

Permite definir quais dados dos produtos serão atualizados na integração. Algumas opções disponíveis:

* Ignorar categorias
* Não atualizar nome ou descrição
* Não atualizar status (Ativo/Inativo)
* Ignorar fabricante ou marca
* Entre outras regras específicas

Essas regras evitam sobreposição indesejada de informações no Tiny, caso ele já esteja sendo usado como base principal de cadastro.

**🚚 Mapeamento de status de pedidos**

<figure><img src="/files/0ufsxypAp4ljd65yrHNs" alt=""><figcaption></figcaption></figure>

Você pode configurar o **mapeamento de status dos pedidos** para garantir que cada etapa da operação na Uplaces seja refletida corretamente no Tiny.\
Exemplo:

* Enviado pelo comprador → *Em aberto*
* Em transporte → *Enviado*
* Entregue → *Entregue*
* Nota Fiscal emitida → *Faturado*
* Cancelado → *Cancelado*

Também é possível habilitar a opção para **incluir o vendedor no envio do pedido**, facilitando o controle da equipe comercial.

***

Caso tenha dúvidas ou precise de ajuda com alguma configuração específica, entre em contato com o time de suporte da Uplaces. Estamos prontos para te ajudar a aproveitar ao máximo sua integração com o Tiny ERP!