Integrando a Tiny ERP na Oruc

 

Configuração

voltar ↑

Acesse: Integrações > ERP’s > Tiny ERP > Configuração

Atenção: É necessário que você possua o plano “Evoluir” ou superior na Tiny para realizar a integração. Planos antecedentes do “Evoluir”, não possuem um recurso fundamental para se manter o sincronismo de Preço, Status e Estoque de seus produtos junto à plataforma.

Configuração Conta

voltar ↑

  • Para fazer a integração, é necessário pegar o Identificador do Integrador da nossa plataforma e o Token da API no seu painel da Tiny. Para isso, siga os passos abaixo:
    • 1° Passo – Passe o cursor do mouse sobre o ícone do seu usuário no canto inferior esquerdo

    • 2° Passo – Clique em Integrações

    • 3° Passo – Na tela de Integrações, clique no botão adicionar integração

    • 4° Passo – Na barra de pesquisa de integrações, busque por Oruc e em seguida, clique em instalar

  • Preencha as pré-configurações de acordo com o desejado e clique em salvar e avançar

 Observação: As pré-configurações entre Plataforma e Tiny são realizadas dentro da própria Oruc. Mais abaixo temos o passo a passo para que você possa configurar.

    • 5º Passo – Ao chegar na aba de Notificações, informe a URL que aparecerá em seu painel Oruc  (https://www.seudominio.com.br/tiny.php) em todos os campos de URL e depois clique em salvar e avançar.

    • 6º Passo – Feito isso, clique no botão finalizar instalação e em seguida concluir
    • 7º Passo – Será exibido suas Credenciais de acesso, copie seu Identificador do integrador e o Token, em seguida, retorne para tela de configuração da Tiny na Oruc, cole os dados nos campos correspondentes e clique em Instalar

Pré-configurações

voltar ↑

Para usar as pré-configurações, é necessário habilitar uma extensão dentro do seu painel da Tiny, para fazer isso, siga os passos abaixo:

  • 1° Passo – Acesse Menu > Início (1) > Loja de extensões (2).

  • 2° Passo – Pesquise no campo de busca “API para estoque em tempo real” (3) e clique na opção que vai aparecer (4)

  • 3. Clique em Instalar extensão.

  • Após fazer o procedimento acima, sua loja estará apta a usar as pré-configurações abaixo

  • As pré-configurações servem para auxiliar na hora de fazer a integração dos seus produtos, lembrando que na etapa de integração é possível mudar essas configurações individualmente conforme a necessidade
  • As pré-configurações disponíveis são:
    • Sincronizar Estoque: Selecione se deseja que tenha sincronização de Estoque do produto. (Sem Sincronismo – Cada ambiente terá o seu Estoque individual; Com Sincronismo – A Tiny quem controlará o Estoque)
    • Sincronizar Preço: Selecione se deseja que tenha sincronização de Preço do produto. (Sem Sincronismo – Cada ambiente terá o seu Preço individual; Com Sincronismo – A Tiny quem controlará o Preço)
    • Sincronizar Status: Selecione ao lado se deseja que tenha sincronização de Status do produto. (Sem Sincronismo – Cada ambiente terá o seu Status individual; Com Sincronismo – A Tiny quem controlará o Status)
    • Variação de Produto: Ao exportar um produto da Plataforma para a Tiny ou importar um produto da Tiny para a Plataforma, será considerada a configuração selecionada nessa opção para a padronização de variações de produtos. Obs: Na Plataforma o padrão é Modelo = Cor e Opção = Tamanho.
    • Origem de Produtos: Ao exportar um produto da Plataforma para a Tiny, exportar a origem com a opção selecionada nesta configuração.
    • Venda de Medicamentos: Caso seja marcado, será apresentado um campo obrigatório na página de integrar produtos para ser informado o registro ANVISA do produto.

Obs: Para integrar medicamentos, é necessário que o produto contenha o atributo “NCM” criado. A Tiny aceita apenas medicamentos com NCM iniciado por 3001, 3002, 3003, 3004, 3005 e 3006.

    • Estoque do Produto: Selecione qual campo de estoque será considerado
      • Estoque Físico: Saldo em estoque físico.
      • Estoque Disponível: Saldo em estqoue físico menos as reservas de estoque.

Obs: É necessário configurar o tipo de estoque também na Tiny, para isso, vá no Menu da Tiny > Início > Integrações > Produtos > Regras de Estoque

    • Regra de Preço: Um campo para a inserção de preço ou porcentagem irá surgir quando selecionado método de implementação da regra de preço
    • Aumentar Preço em %: Após salvar as pré-configurações, ficará preenchido com valor de acréscimo ou desconto escolhido

Configuração de Pedido

voltar ↑

Após ter inserido a URL da sua loja em seu painel da Tiny, a Plataforma irá receber os retornos de atualizações e manter o sincronizado os dados de produtos e pedidos. Sem a devida configuração, o sincronismo dos dados será comprometido.

 

  • Com sua conta já configurada, você terá acesso na plataforma, das configurações de pedidos para Tiny, clique onde está marcado para ter acesso:

  • As configurações de pedido disponíveis são:
    • Gerar NF-e automaticamente: Gerar NF-e automaticamente na Tiny, quando o status do pedido for Pagamento Aprovado. OBS: Com essa opção marcada, após a NFe ser gerada, a Tiny não permite mais editar informações do pedido.
    • Frete por Conta: Selecione qual será a opção enviada para a Tiny referente ao Frete.
    • Incluir valor do frete na NF-e: Incluir valor do frete no valor total da NF-e.
    • Envio de Pedidos: Selecione em qual status o seu pedido será enviado para Tiny. (Aguardando Pagamento ou Pagamento Confirmado)
    • Alteração das Fases do Pedido: Permitir que a Tiny altere a fase do pedido na plataforma e inclua o código de rastreio, se tiver. A configuração do envio da NF em arquivo para o cliente é realizado no Tiny. Obs: As fases de pedidos de MarketPlaces devem ser alteradas manualmente na plataforma.
    • Pedidos de MarketPlaces: Caso essa opção esteja marcada, os pedidos oriundos dos Marketplaces que estão integrados com a loja também serão enviados para a Tiny.

Integração e Gestão de Produto

voltar ↑

Acesse: Integrações > ERP’s > Tiny ERP > Integração e Gestão de Produtos

  • Nessa tela é possível filtrar os produtos que estão na plataforma
  • É possível alterar os dados dos produtos e integrar eles com a Tiny
  • É possível fazer em massa. As atualizações em massa disponíveis são:
    • Integrar Produtos: Envia para a Tiny os produtos selecionados com as configurações escolhidas (Máximo de 20 produtos por vez)
    • Alterar Dados Abaixo: Ao alterar os dados de um produto na listagem e marcar ele, use essa opção para que essas informações sejam atualizadas na Tiny
    • Remover Integração de Produtos: Remove a integração do produto com a Tiny, dessa forma cada produto fica independente em cada ambiente (É possível aplicar para todos os produtos cadastrados na plataforma, inclusive os não selecionados na tela)
    • Atualizar Sincronismo Status de Produto: Selecione os produto que deseja desativar o ativar o sincronismo de Status para atualizar em massa (É possível aplicar para todos os produtos cadastrados na plataforma, inclusive os não selecionados na tela)
    • Atualizar Sincronismo Preço de Produto: Selecione os produto que deseja desativar o ativar o sincronismo de Preçopara atualizar em massa (É possível aplicar para todos os produtos cadastrados na plataforma, inclusive os não selecionados na tela)
    • Atualizar Sincronismo Estoque de Produto: Selecione os produto que deseja desativar o ativar o sincronismo de Estoque para atualizar em massa (É possível aplicar para todos os produtos cadastrados na plataforma, inclusive os não selecionados na tela)
    • Revisão de Estoque: Selecione os produtos e use essa opção, caso os estoques estejam diferentes entre as plataformas será feito a correção para ficar igual
    • Atualizar Regra de Preço: Selecione uma nova regra de preço (diferença de valor entre as plataformas) para os produtos (É possível aplicar para todos os produtos cadastrados na plataforma, inclusive os não selecionados na tela)
    • Atualizar Todos os Dados do Produto: Esta ação ignora qualquer alteração feita nesta tela (sincronizações, preços, regra de preço…). Ela serve apenas para enviar todos os dados destes produtos selecionados novamente para a Tiny, como Título, Descrição, Fotos, Preço, Estoque, Status e todas as demais informações que possuir.

Relacionamento de Produtos

voltar ↑

Acesse: Integrações > ERP’s > Tiny ERP > Relacionamento de Produtos

  • Nessa tela é possível filtrar os produtos que estão na plataforma, caso possua os mesmos SKUs na Tiny, ela trará o produto ao lado pronto para relacionar
  • Caso não possua o mesmo SKU, é possível buscar o produto manualmente
  • As opções de Relacionar os produtos são:
    • Com Pré-configurações de Sincronização e Regra de Preço: Relaciona os produtos usando as pré-configurações escolhidas pelo usuário
    • Sem Sincronização: Relaciona os produtos e deixa as sincronizações desativadas (é possível ativar depois)
    • Relacionar todos os produtos com SKU iguais da Tiny: Todos os produtos da plataforma que tiverem o mesmo SKU na Tiny serão relacionados.

Importação de Produtos

voltar ↑

Acesse: Integrações > ERP’s > Tiny ERP > Importação de Produtos

  • Nessa tela é possível filtrar os produtos que estão na Tiny, para que possa ser trazidos para a plataforma
  • As opções de Importação são:
    • Importar Selecionados (Pré-Configuração): Traz os produtos selecionados na tela usando as pré-configurações escolhidas pelo usuário
    • Importar Selecionados (Sem Sincronismo): Traz os produtos selecionados na tela com as sincronizações desativadas (é possível ativar depois)
    • Importar Todos da Tiny (Pré-Configuração): Traz todos os produtos que estão na Tiny usando as pré-configurações escolhidas pelo usuário
    • Importar Todos da Tiny (Sem Sincronismo): Traz todos os produtos que estão na Tiny com as sincronizações desativadas (é possível ativar depois)

Log de Ações Tiny

voltar ↑

Acesse: Integrações > ERP’s > Tiny ERP > Log de Ações Tiny

  • Nessa tela é possível verificar todas as ações que foram feitas no sistema em relação a Tiny
  • Dessa forma é possível ter um maior controle de integração e importação de produtos, pedidos e busca de dados como, conexões que foram consultados, alterados, etc…

 

Orientações Gerais

voltar ↑

MEU PEDIDO NÃO ESTÁ SENDO ENVIADO PARA TINY, QUAL MOTIVO?

Para os pedidos irem para a Tiny, existem algumas restrições e obrigações de dados para funcionar. Veja abaixo como seu pedido deve estar para entrar nas regras da Tiny:

1) Se for um pedido de Marketplace, a opção de enviar pedido Marketplace precisa estar ativada em “Integrações > ERP’s > Tiny ERP > Configuração” e selecionar quais os Marketplaces ativos que serão enviados para a Tiny.

2) Se for um pedido de Marketplace, o produto precisa estar integrado obrigatoriamente entre “Marketplace x Plaforforma” e “Plataforma x Tiny”, mas se o pedido for direto da loja, ele precisa estar integrado entre “Plataforma x Tiny”. Se não houver integração entre os sistemas, o pedido não é enviado, pois não criamos produto na Tiny via pedido.

3) O pedido precisa obrigatoriamente possuir nome e documento do cliente. Se o Marketplace não forneceu ou disponibilizou esses dados, esse pedido não conseguirá ser enviado para o Tiny, pois eles obrigam essas informações no envio do pedido para lá. Neste caso você terá que editar o cadastro deste cliente no painel da sua loja em “Catálogo > Clientes > Gestão de Clientes”. O endereço é opcional, mas caso deseja enviar essa informação para a Tiny e se o pedido estiver sem, você também terá que editar o endereço do cliente nesta mesma tela.

4) Para saber por qual motivo o pedido não foi enviado, basta acessar a tela de “Integrações > ERP’s > Tiny ERP > Log de Ações Tiny” e visualizar na coluna “Mensagem de Retorno” qual foi o motivo do erro.

 

ATINGI O LIMITE DE REQUISIÇÕES DA TINY, O QUE FAZER?

Dependendo do seu plano na Tiny, é possível que você atinja o limite de requisições da API. Nesse caso, será necessário aguardar até que a fila seja processada para poder realizar novas ações que envolvam alterações relacionadas aos produtos na plataforma para Tiny.

Imagem exibida quando é atingido o limite de requisições