# 🔧 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!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajuda.uplaces.com.br/integracoes/tiny/configuracao-da-integracao.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.