> 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

Aprenda como ativar a integração entre a Uplaces e o Tiny ERP, incluindo a geração da chave de API, criação do usuário e aplicação das credenciais.

#### 🔧 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FaJROc2s5jVKT3LyI6th8%2Fimage.png?alt=media&amp;token=b4463e3f-0fe7-4ea7-a54f-cf1f8907dd9a" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FQYUv8VK1bmCZ5qgqiZ1p%2Fimage.png?alt=media&amp;token=6e8d6c70-f0d4-45bc-bb3a-2c79ab7e0a28" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2Fj6lcpOEsI13Z96dfGkZ8%2Fimage.png?alt=media&amp;token=435feefc-bcb1-4913-a5ef-00c7194234e6" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FxXtCcWY0ADM1CSnOEMEv%2Fimage.png?alt=media&amp;token=7d9e24b2-d70c-455f-b928-9e1e93877092" alt=""><figcaption></figcaption></figure>

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

Acesse **Integrações ERP > Nativos** e selecione Tiny\
![](https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FAUAeWvavJM77N1xmX18A%2Fimage.png?alt=media\&token=937bea45-edee-45fa-8b41-68636b470439)

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

![](https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2F7sJkD7noeZ1QNwIEII9w%2Fimage.png?alt=media\&token=2acf0c85-d343-451f-9f59-a44a9b2bd59e)

#### 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FUkp4XNCp4FYLO2Tgb40p%2Fimage.png?alt=media&amp;token=40495bf5-8337-4b63-84a3-b922bf24aa29" alt=""><figcaption></figcaption></figure>

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

![](https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FyExMZQIsPSkCnWxsuaPu%2Fimage.png?alt=media\&token=3b0c8145-3619-457f-8e8a-79043aa8f2e5)&#x20;

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

<figure><img src="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2Fte2JCZvuR08VYvDluQ3a%2Fimage.png?alt=media&amp;token=5a2f3f09-e68f-4237-8b91-b29f66d882fe" alt=""><figcaption></figcaption></figure>

* Salve e clique em **Testar**!

<figure><img src="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FkN1samA506vfvoiJpGZk%2Fimage.png?alt=media&amp;token=0766b5f3-1fa4-48cb-b5cf-7b601baa3576" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FhOFThVGxjVUsYrdkqvN7%2Fimage.png?alt=media&amp;token=ccc37d84-6de0-4bda-99c5-1042999c61ff" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FSQoLiR4FtHLo2uAGll8F%2Fimage.png?alt=media&amp;token=5c48d6bb-2e23-4dfe-b2d4-2f60c88fb08b" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2F6mgNIDSv1eoYuDX1m2Ty%2Fimage.png?alt=media&amp;token=c5868503-7f08-460c-8adf-db3eaa9a62fa" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FxLGIXQO7zFG5zYmBC4Q9%2Fimage.png?alt=media&amp;token=ba017cc6-5986-4ab3-bba1-99bd7770c7ab" 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="https://128756250-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LOKoNubndKZitzqvBNV%2Fuploads%2FgC3WUyAEW65RRIjmlm0G%2Fimage.png?alt=media&amp;token=44265622-0787-48f9-804e-b1559ea9caff" 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!