> 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.md).

# Integração com o Tiny ERP

Integração Tiny ERP com a Uplaces: conecte por OAuth na API v3, importe produtos e clientes e envie os pedidos da loja B2B ao Tiny. Veja também a v2.

A integração com o Tiny liga a sua loja B2B da Uplaces ao Tiny ERP. Os produtos, as listas de preço e os clientes vêm do Tiny para a loja, e cada pedido feito pelo cliente ou pelo vendedor segue para o Tiny sem redigitação. A Uplaces trabalha com o Tiny de duas formas: na API v3, você conecta com o botão **Conectar com o Tiny**; na API v2, que as integrações existentes continuam usando, a conexão é por **Id integrador** e **Chave**.

## Para que serve

* Catálogo no Tiny, venda na Uplaces: os produtos ativos, com variações, fotos, preços das listas e estoque, chegam à loja sem cadastro duplo.
* Pedido direto no Tiny: o pedido da loja vira pedido de venda no Tiny, com cliente, itens, preços, forma de pagamento e vendedor.
* Carteira de clientes pronta: os clientes do Tiny entram na Uplaces com os critérios que você definir (pessoa jurídica, pessoa física, só com e-mail válido).
* Faturamento no lugar de sempre: o pedido aparece no Tiny para você faturar como já faz, e a situação dele acompanha o status da Uplaces.

## Qual versão usar

|                                     | Tiny v3                         | Tiny v2                          |
| ----------------------------------- | ------------------------------- | -------------------------------- |
| Card em **Integração ERP › Nativa** | **Tiny v3**                     | **Tiny**                         |
| Conexão                             | **Conectar com o Tiny** (OAuth) | **Id integrador** e **Chave**    |
| Quem conecta                        | contas novas, sem Tiny em uso   | integrações que já existem       |
| Importar dados                      | botão **Importar do Tiny v3**   | **Importar do Tiny** (por lista) |

Se a sua loja já usa a v2 e funciona, o card **Tiny v3** aparece como **Em homologação**, com o botão **Em breve**. Fale com o suporte da Uplaces antes de trocar de versão.

## Como funciona

1. [Conecte o Tiny](https://ajuda.uplaces.com.br/integracoes/tiny/configuracao-da-integracao.md): na v3, crie um aplicativo no Tiny e autorize; na v2, informe o **Id integrador** e a **Chave**.
2. [Traga os produtos](https://ajuda.uplaces.com.br/integracoes/tiny/envio-de-produtos-para-a-uplaces.md) para a loja.
3. [Traga os clientes](https://ajuda.uplaces.com.br/integracoes/tiny/importacao-de-clientes-do-tiny.md) do Tiny.
4. Em **Enviar para integração quando o status for**, escolha o momento em que o [pedido segue para o Tiny](https://ajuda.uplaces.com.br/integracoes/tiny/sincronizacao-de-pedidos-com-o-tiny.md).
5. Acompanhe o que foi enviado e a resposta do Tiny no [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md).

## O que você precisa

* Conta no Tiny com a API liberada. O Tiny define quais planos incluem esse recurso; veja a documentação do Tiny para esta integração: [Integração Tiny com a Uplaces](https://suporte.olist.com/kb/articles/erp/integracoes/outras-integracoes-via-api/integracao-tiny-com-a-uplaces).
* Usuário administrador na Uplaces. Para a v2, também um usuário com perfil **Integração**.

## O que sincroniza

| Dado                 | Tiny v3                                                         | Tiny v2                                                                               |
| -------------------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Produtos e variações | Tiny para Uplaces, ao importar                                  | Tiny para Uplaces, por **Enviar para o E-commerce** no Tiny, por webhook ou por lista |
| Preços               | listas de preço do Tiny viram tabelas de preço, ao importar     | webhook de preços                                                                     |
| Estoque              | ao importar                                                     | webhook de estoque                                                                    |
| Clientes             | Tiny para Uplaces, ao importar. Para o Tiny, junto com o pedido | Tiny para Uplaces, por lista de CPF/CNPJ. Para o Tiny, junto com o pedido             |
| Pedido               | Uplaces para Tiny, no status escolhido                          | Uplaces para Tiny, no status escolhido                                                |
| Situação do pedido   | Uplaces para Tiny                                               | Uplaces para Tiny e, por webhook, Tiny para Uplaces                                   |

Cotações não seguem para o Tiny.

## O que (não) faz

* A importação só lê o Tiny: nada é enviado de volta a ele por ela.
* Na v3, estoque e preço são atualizados quando você importa de novo; o aviso em tempo real (webhook) é da v2.
* Produto sem preço em nenhuma tabela de preço fica invisível para o cliente logado.

## Páginas desta seção

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Conectar o Tiny ERP</strong></td><td>v3 com um botão, v2 com Id integrador e Chave</td><td><a href="https://ajuda.uplaces.com.br/integracoes/tiny/configuracao-da-integracao.md">Conectar o Tiny ERP</a></td></tr><tr><td><strong>Importar produtos</strong></td><td>catálogo, variações, listas de preço e estoque</td><td><a href="https://ajuda.uplaces.com.br/integracoes/tiny/envio-de-produtos-para-a-uplaces.md">Importar produtos do Tiny</a></td></tr><tr><td><strong>Importar clientes</strong></td><td>a carteira, com os critérios que você definir</td><td><a href="https://ajuda.uplaces.com.br/integracoes/tiny/importacao-de-clientes-do-tiny.md">Importar clientes do Tiny</a></td></tr><tr><td><strong>Pedidos no Tiny</strong></td><td>quando o pedido sai e o mapeamento dos status</td><td><a href="https://ajuda.uplaces.com.br/integracoes/tiny/sincronizacao-de-pedidos-com-o-tiny.md">Pedidos da Uplaces no Tiny</a></td></tr></tbody></table>

## Problemas comuns

<details>

<summary>O card Tiny v3 mostra Em breve</summary>

A sua loja usa a v2. Continue na v2 ou fale com o suporte.

</details>

<details>

<summary>O Tiny recusa o pedido</summary>

Na v3, preencha **Id do vendedor** e **Id do deposito** (veja a [configuração](https://ajuda.uplaces.com.br/integracoes/tiny/configuracao-da-integracao.md)).

</details>

<details>

<summary>A API do Tiny devolve erro de limite</summary>

O limite de chamadas depende do plano do Tiny. Aguarde um minuto e tente de novo.

</details>

## Perguntas frequentes

<details>

<summary>A Uplaces integra com a API v3 do Tiny?</summary>

Sim. Contas novas, sem Tiny em uso, conectam pela API v3 com o botão **Conectar com o Tiny**. Lojas que já usam a v2 continuam nela.

</details>

<details>

<summary>Preciso gerar chave de API no Tiny?</summary>

Na v2, sim: você informa o **Id integrador** e a **Chave** do Tiny. Na v3, não há chave: você cria um aplicativo no Tiny e autoriza a conexão.

</details>

<details>

<summary>Em que momento o pedido vai para o Tiny?</summary>

Quando chega ao status escolhido em **Enviar para integração quando o status for**. Veja [como os pedidos são enviados](https://ajuda.uplaces.com.br/integracoes/tiny/sincronizacao-de-pedidos-com-o-tiny.md).

</details>

<details>

<summary>Os clientes do Tiny entram todos na Uplaces?</summary>

Entram os que passam pelos **Critérios para atualização de CLIENTES**. Veja a [importação de clientes](https://ajuda.uplaces.com.br/integracoes/tiny/importacao-de-clientes-do-tiny.md).

</details>

## Veja também

* [Integração com ERP](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md)
* [Integração com o Bling](https://ajuda.uplaces.com.br/integracoes/bling.md)
* [Integração com a Omie](https://ajuda.uplaces.com.br/integracoes/omie.md)
* [Políticas comerciais](https://ajuda.uplaces.com.br/ecommerce-b2b/politicas-comerciais.md)
* No site: [integração com o Tiny](https://uplaces.com.br/integracao-tiny/)

{% hint style="success" %}
**Ainda não usa a Uplaces?** Teste grátis por 10 dias, sem cartão de crédito: crie a conta e configure a integração com o Tiny com os seus produtos. [Começar o teste grátis](https://b2b.admin.uplaces.com.br/login?cadastro\&utm_source=ajuda\&utm_medium=cta\&utm_campaign=central-de-ajuda)
{% endhint %}
