Como integrar Tiny Erp com WooCommerce

Integração desenvolvida pela equipe Tiny, onde os pedidos e produtos do Woocommerce (plataforma de código aberto criada com WordPress) podem ser importados em sua conta no Tiny. Compatível com versões do WooCommerce 2.2+

Recursos disponíveis
- Receber pedidos
- Receber produtos
- Enviar produtos
- Enviar estoque
- Enviar preços
- Sincronizar situação
- OMS

Passo a passo

Configurar integração com o WooCommerce

1. Acesse as configurações de e-commerce do Tiny em Menu → Configurações → Aba E-commerce → Integrações.

2. Agora, clique no botão Incluir integração para adicionar as configurações de integração.

Caso já possua integrações configuradas em sua conta, as mesmas serão exibidas e indicadas com suas respectivas situações.

Cada situação indica:

• Ativa: Representa que a configuração da integração foi realizada com sucesso e a mesma encontra-se pronta para uso.
• Inativa: Indica a inatividade desta loja no Tiny, a mesma não será utilizada ou mostrada para sincronização de pedidos, produtos e demais ações pertinentes.
• Não configurada: Esta situação indica que a configuração ainda não foi realizada.
• Não instalada: Representa que ainda não houve a comunicação com o e-commerce para ativar a integração.

Observação: Somente as integrações com a situação Ativa serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.

3. Na aba Integração, selecione WooCommerce no campo Integração. Abaixo, no campo Nome informe o nome da sua loja.

Na seção Autenticação, preencha os campos abaixo:

- URL da loja: Neste campo, informe a URL da sua loja virtual.
- Consumer Key e Consumer secret: Ambos os campos precisam ser verificados com o responsável da loja virtual.
- Versão do WooCommerce: Sendo que, o envio de produtos do Tiny para o WooCommerce encontra-se disponível somente para versão 3.0+

Atenção!
Após preencher os campos, verifique se os dados informados estão corretos, em Testar configurações.

4. Em Configurações, defina os seguintes campos abaixo:

Regras de estoque

Atualizar estoque na loja virtual a partir do Tiny: Selecione a opção Enviar saldo físico sempre que houver alguma movimentação de estoque de um produto no Tiny, o saldo em estoque desse produto será automaticamente atualizado na loja virtual.
Depósito a ser considerado na integração: Escolha qual será o depósito padrão para as ações: Importar pedido , Importar produtos e Enviar estoque.

Observação:
O campo Depósito a ser considerado na integração será exibido nas contas que possuem a extensão Depósitos de estoque instalada.

Sincronização de produtos:

Enviar imagens dos produtos ao sincronizar: Escolha uma das opções Sim ou Apenas para novos produtos para enviar as imagens dos produtos quando houver o envio para WooCommerce.
Ao importar produtos: Defina se na importação dos produtos as imagens serão consideradas como Anexos ou será importada somente as URLs das imagens. Através das opções: Importar imagens como anexos ou Apenas importar a URL externa das imagens.
Na importação de produtos, ao atualizar um produto, atualizar o Código (SKU): Habilite este campo para atualizar o Código (SKU) sempre que os produtos forem importados do e-commerce.
Enviar categoria no envio de produtos: Selecione a opção Sim quando enviar os produtos do Tiny ao e-commerce será enviada a categoria do produto. O Tiny envia somente uma categoria para cada produto no e-commerce.

Sincronização de pedidos:

Importar forma de recebimento nos pedidos: Habilite a opção para receber a forma de recebimento na importação dos pedidos. A configuração das formas de recebimento devem ser realizadas na aba Formas de recebimento.
Importar valor do frete nos pedidos: Habilite a opção se desejar importar o valor do frete na importação dos pedidos.
Enviar rastreamento ao alterar a situação no Tiny para enviado: Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no Tiny, o código de rastreio será enviado de forma automática para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
Marcar pedido como entregue ao alterar a situação no Tiny: Ao habilitar este parâmetro, sempre que um pedido for alterado para a situação Entregue no Tiny, o mesmo também terá o seu status alterado na plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
Completar endereço do cliente a partir do CEP na importação de pedidos: Escolha a opção Sempre e na importação dos pedidos o CEP será validado junto ao Correios para obter o endereço da venda. Assim, ignorando os dados de endereço obtidos na plataforma de e-commerce.
Destino dos pedidos importados: Selecione como as vendas serão importadas, se como pedidos de venda ou notas fiscais.

* Selecione a opção pedidos de venda caso utlize a funcionalidade OMS

Formatar nome dos contatos no recebimento dos pedidos: Ao habilitar este campo, o nome do cliente na importação dos pedidos será formatado com as iniciais maiúsculas em seu Nome e Sobrenome.
Adicionar o endereço do cliente nas observações da venda: Habilite esta opção para adicionar o endereço do cliente nas observações da venda, ao importar o pedido do e-commerce.
Campo relacionado ao número do pedido na plataforma: Escolha como será importado o número do pedido em sua conta no Tiny, entre as opções: Número ou Identificador.
Marcar pedido como enviado ao enviar o código de rastreio: Ao habilitar este campo, quando enviar o código de rastreio, o pedido será marcado como enviado.
Importar valor de taxa nos pedidos: Habilite este parâmetro para que as informações do campo fee_lines seja considerado despesa no pedido de venda.

Notificações por e-mail

Enviar rastreamento ao alterar a situação no Tiny para enviado: Se este parâmetro estiver ativo, sempre que o pedido for alterado para Enviado no Tiny, o código de rastreio será enviado de forma automática para a plataforma. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
Enviar e-mail de entrega ao alterar a situação no Tiny para entregue: Se este parâmetro for ativado, quando a situação do pedido no Tiny for alterada para Entregue, um e-mail será encaminhado automaticamente ao destinatário da venda, informando a entrega. Saiba mais sobre isso através da ajuda Atualizar situação de envio dos pedidos.

5. Na aba Dados Fiscais, no campo Natureza de operação para venda desta integração selecione uma Natureza de venda padrão para essa plataforma. A natureza selecionada será atribuída na Importação dos pedidos no Tiny e no momento em que gerar a Nota Fiscal através do pedido importado.
Observação:
Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o Tiny identificar que o pedido de venda trata-se de um cliente contribuinte.

Observação:
Além disso, você pode Habilitar ou Desabilitar o campo Definir natureza de operação diferente para destinatários contribuintes do ICMS. Habilitando esse campo, você poderá selecionar uma natureza de operação específica, a qual será aplicada no momento em que o Tiny identificar que o pedido de venda trata-se de um cliente contribuinte.

6. Na aba Gestão de preços, defina qual será a regra de preços para a integração, tanto para importação, quanto para envio de produtos ao e-commerce.
• Preço fixo: conforme o preço do produto, o anúncio pode receber um valor fixo de preço de venda, levando em consideração acréscimos e descontos aplicados individualmente;
• Conforme regras de preço: trata-se de todas as regras do marketplace no que diz respeito ao percentual de comissão, adicional de frete para produtos com preço mínimo e/ou por faixa de peso cubado dos produtos e fórmula de cálculo para aplicar os valores adicionais;
• Conforme lista de preços: para uso de listas de preços dos produtos, específicas para o e-commerce ou marketplace.

Ao definir a regra como Conforme lista de preços, no campo Lista de preços utilizada nos produtos, selecione a lista de preços que será utilizada na importação de pedidos do e-commerce. Saiba como configurar Listas de preços.
Ao definir a regra como Conforme regras de preço, siga a configuração de Precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.

7. Ao acessar a aba Campos personalizados pode-se mapear campos (CPF, CNPJ, Bairro, Número e IE) que serão importados na importação dos pedidos ou produtos. Para mapear os campos informe suas descrições do e-commerce.
8. Para mapear as categorias dos produtos, é necessário acessar a aba Categorias e no botão buscar pela categoria no e-commerce.

Caso ainda não possua categorias cadastradas em sua conta no Tiny, as instruções para incluir categorias estão disponíveis em Como cadastrar categorias de produtos.

As instruções pra vincular as categorias no cadastro de produtos, estão disponíveis em Como cadastrar um produto -(Passo 3).

9. Todas as situações dos pedidos no e-commerce podem ser mapeadas para as situações de pedidos no Tiny.

Ao clicar em Adicionar situações padrão, é adicionado as situações presentes no e-commerce e as mesmas serão listadas na coluna Código da situação no E-commerce. Abaixo, em Sequência das situações no Tiny é apresentado um fluxo de situações dos pedidos. No campo Permite retroceder situação dos pedidos na sincronização de situações ao Habilitar a opção será possível alterar as situações dos pedidos para anteriores da situação atual, por exemplo, um pedido Enviado voltar para a situação Preparando Envio.

Em Situação no Tiny, selecione a situação correspondente no Tiny. Existe também, a possibilidade de adicionar novas situações ao acessar Adicionar mapeamento de situação.

Observação:
Ao importar um pedido de venda do e-commerce para o Tiny, o pedido assume a situação configurada. Caso não seja realizada a configuração o pedido será importado e atribuído a situação Em aberto.

10. Na aba Formas de Recebimento, pode-se relacionar as formas de pagamento dos seus pedidos da loja virtual com a forma de pagamento no Tiny. Esta configuração fará com que suas contas a receber sejam geradas corretamente no Tiny, com as mesmas informações.

Ao habilitar o parâmetro Importar forma de recebimento nos pedidos, será possível realizar o mapeamento das formas de pagamento presentes em sua plataforma com os respectivos destinos no Tiny.

Na configuração Forma de recebimento padrão para os pedidos importados deste e-commerce, selecione a forma de recebimento que será utilizada caso o pedido seja importado sem nenhuma forma mapeada.

Logo abaixo, em Relacione as formas de recebimento do Tiny com as da integração, no campo de Forma de recebimento , selecione a forma de recebimento do Tiny que deseja mapear.

Depois, através do campo Código na integração, clique sobre o botão Relacionar forma de recebimento.

Na janela que será exibida, informe o Identificador do pedido na integração para que o Tiny realize a busca de qual forma de recebimento está inserida no mesmo para que o vínculo seja realizado. Desta forma, todas as vendas com a mesma forma de recebimento do pedido utilizado como exemplo, serão identificadas com a forma escolhida anteriormente.

Caso você já possua a informação de qual código deverá utilizar para realizar o vínculo, clique em Informar código manualmente.

Após realizar o vínculo, clique em Selecionar.

Para incluir uma nova forma de recebimento, clique em Adicionar forma de recebimento. Caso não possua nenhuma forma de recebimento e deseje cadastrar, acesse a ajuda Formas de Recebimento.

Observação:
Sempre que um pedido for importado sem uma forma de recebimento mapeada, a forma selecionada no campo Forma de recebimento padrão será utilizada.

11. Em Formas de frete pode ser realizado o mapeamento das formas de frete presentes no e-commerce, com as formas de envio cadastradas em sua conta no Tiny.

Para isso, no campo Forma de envio e Forma de frete, selecione a forma de frete que deseja mapear.

Em Código na integração, clique no botão Relacionar forma de frete.

Na janela que será exibida, informe o Identificador do pedido na integração para que o Tiny realize a busca de qual forma de frete está inserida no mesmo para que o vínculo seja realizado. Desta forma, todas as vendas com a mesma forma de envio do pedido utilizado como exemplo, serão identificadas com a forma escolhida anteriormente.

Se a forma de envio não for localizada na busca pela venda e você tiver o código para mapeamento, clique no botão Informar código manualmente e insira a respectiva informação.

Caso precise adicionar novas formas de frete, clique em Adicionar.

Observações:
• Ao adicionar as formas de frete selecionadas o Tiny busca as formas de envio já configuradas em sua conta.
• Para mapear as formas de frete da Frenet, acesse a ajuda Mapear formas de frete Frenet.

12. Ao final, não esqueça de Salvar as configurações.

Recepção de pedidos do e-commerce no Tiny
Os pedidos realizados na WooCommerce serão listados em Menu → Vendas → Pedidos do e-commerce → Selecione a loja virtual.

Vale lembrar que é possível Filtrar os pedidos por situação e por período. Após isso, Selecione os pedidos e clique em Receber pedidos.

Observação
Os pedidos serão importados para o Tiny, em Pedidos de Venda ou Notas Fiscais, conforme a opção que selecionou no campo Destino dos pedidos importados na configuração do e-commerce no Tiny.

Recepção de produtos do e-commerce no Tiny

1. Os produtos cadastrados em sua loja virtual, podem ser recebidos em sua conta no Tiny. Para isso, acesse Menu → Cadastros → Produtos → Receber do e-commerce.

2. A seguir, selecione o E-commerce para recepção dos seus produtos e clique em Avançar.

Os campos importados são:

• Código (SKU)
• Descrição
• Descrição complementar
• Peso líquido
• Peso bruto
• Preço de venda
• Preço promocional
• Estoque atual
• Imagens
• Código da categoria no e-commerce
• Variações
• Altura embalagem
• Largura embalagem
• Comprimento embalagem
• Slug

3. Primeiramente, escolha o que deseja receber entre as opções: Todos os anúncios , Apenas anúncios novos ou Anúncio individual.

Se selecionou a opção Anúncio individual, será necessário preencher o campo Identificador do anúncio para localizar o anúncio.

Abaixo, defina as opções de atualizações dos dados dos produtos, podendo selecionar Atualizar dados do produto , Atualizar preço do produto , Atualizar o estoque , Atualizar imagens.

Além disso, ao selecionar a opção Preencher dados fiscais (NCM, Origem, Unidade) poderá preencher informações padrão para estes campos, que serão consideradas no recebimentos dos produtos.

Para concluir o processo de recebimentos dos produtos, clique em Importar.

Observação:
A opção Criar exceções na lista de preços vinculada ao e-commerce refere-se a lista de preço selecionada na configuração do e-commerce no Tiny. Ao marcar essa opção, os produtos que estão na lista de produtos com preços diferentes serão criados e atualizados.

4. Se durante a importação dos produtos ocorrer algum imprevisto e for necessário interromper a ação ou então ocorrer algum problema devido ao grande número de produtos a serem importados, é possível Interromper a recepção de produtos para continuar a importação num momento posterior.

Com a ação Interromper, é possível continuar a importação num outro momento, continuando do ponto em que parou. É possível retomar esta importação em até 7 dias corridos.

Como enviar produtos do Tiny para o WooCommerce

Atenção!
A funcionalidade de envio de produtos do Tiny para WooCommerce, está disponível para integrações a partir da versão 3.0.

Para enviar o cadastro de produtos do Tiny para o WooCommerce, acesse Menu → Cadastros → Produtos → Marque o item que deseja enviar na lateral esquerda → Enviar para o e-commerce.

Campos enviados:

• Código (SKU)
• Descrição
• Descrição complementar
• Peso bruto
• Preço de venda
• Preço promocional
• Estoque atual
• Imagens
• Variações
• Comprimento embalagem
• Largura embalagem
• Altura embalagem
• Código da categoria principal no e-commerce
• Slug

Para enviar a lista completa dos produtos no Tiny para o e-commerce, acesse a ajuda Enviar produtos em lote ao e-commerce.

Informações relacionadas

Sincronizar situação dos pedidos

1. Atenção!
Para realizar a sincronização da situação dos pedidos, é necessário que tenha configurado a importação dos pedidos do e-commerce para Pedidos de venda e realizado o Mapeamento das situações. Caso não tenha realizado essas configurações, realize as mesmas com o auxílio da ajuda Configurar integração com o WooCommerce.

2. Acesse Menu → Vendas → Pedidos do e-commerce → Selecione a loja virtual → Marque os pedidos que já foram enviados e clique em Sincronizar situação.

Observação:
Ao sincronizar situação, o status presente em Situação no Tiny corresponderá a situação do pedido no e-commerce conforme o mapeamento realizado.

Enviar estoque dos produtos no Tiny ao e-commerce

Enviar quantidade em estoque em lote

1. Para realizar o envio da quantidade em estoque dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar estoque ao e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque dos produtos. Na lista que será exibida, selecione as integrações que deseja enviar a quantidade em estoque.

Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.

Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.

Para concluir o processo de envio, clique em Enviar.

Enviar quantidade em estoque de forma individual

1. Caso queira enviar somente a quantidade em estoque de um produto específico, acesse o Menu de contexto do produto e clique em Enviar estoque ao e-commerce.

2. No campo Plataforma você pode selecionar mais do que uma integração para o envio da quantidade em estoque do produto. Na lista que será exibida, selecione aquelas que deseja enviar a quantidade em estoque.

Após selecionar as integrações, defina se será enviado o saldo Físico ou Disponível dos produtos.

Clique no botão Selecionar. A seguir, serão exibidos os dados deste produto como: Identificador do anúncio, Descrição, Código (SKU) e Preço.

Para concluir o processo de envio, clique em Enviar.

Enviar preço dos produtos no Tiny ao e-commerce

Enviar preços em lote

1. Para realizar o envio dos preços dos produtos ao e-commerce em lote, acesse em Menu → Cadastros → Produtos → Selecione os produtos → Mais Ações → Enviar preços para o e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.

Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.

Para concluir o processo de envio, clique em Enviar.

Enviar preço de forma individual

1. Caso queira enviar somente o preço de um produto em específico, acesse o Menu de contexto do produto e clique em Enviar preços para o e-commerce.

2. Agora, no campo Plataforma você pode selecionar mais do que uma integração para o envio dos preços. Na lista que será exibida, selecione aquelas que deseja enviar os preços desses produtos.

Após definir para qual ou quais integrações receberão o envio dos preços, clique em Selecionar.

Para concluir o processo de envio, clique em Enviar.

Reajustar preço dos produtos no Tiny e atualizar no WooCommerce

1. Para realizar os ajustes nos preços dos produtos cadastrados no Tiny e após atualizar na loja virtual, acesse em Menu → Cadastros → Produtos → Mais ações → Reajustar preço dos produtos.

2. Utilize as opções de Filtros caso deseje, ou clique direto em Listar produtos.

3. Após isso, será exibido a lista dos produtos, clique em Informar reajuste.

4. Selecione os produtos que deseja atualizar os preços, utilize uma das opções disponíveis para atualizar os preços, por reajuste de Percentual, ou adicione o novo preço em cada produto na coluna Novo preço, marque a opção Atualizar preços no e-commerce e selecione a integração correspondente, por fim clique em Salvar.

Enviar código de rastreio para o WooCommerce

1. Atenção!
Para enviar o código de rastreamento para o WooCommerce, é preciso informar no pedido ou nota fiscal o transportador, sendo ele Correios ou Transportadora. O campo será preenchido no Pedido de Venda ou na Nota Fiscal e por fim, gerar o agrupamento (PLP ou Coleta) no módulo de Expedição. Veja como gerar a Expedição.

2. Acesse o módulo de Expedição, selecione a forma de envio Correios → Aba Concluídas → Clique no menu de contexto ao lado da expedição gerada → Enviar código de rastreio para o e-commerce.

Observação:
Além do envio do código de rastreio, também é atualizada a situação do pedido para Enviado no WooCommerce. Para isso, acontecer é necessário que na configuração da integração tenha realizado o mapeamento das situações - (passo 8) dos pedidos do e-commerce com o Tiny, inclusive a situação Enviado.

3. Após isso, ao acessar a expedição será adicionado um Marcador que identifica quando o código de rastreio já foi enviado ao WooCommerce.

Marcar pedidos como entregues no WooCommerce

1. Ao marcar os pedidos como entregue no Tiny, os mesmos serão sincronizados com o status Entregue no WooCommerce. Para isso, acesse Menu → Vendas → Expedição → Selecione a forma de envio → Aba Concluídas → Clique no menu de contexto ao lado da expedição gerada → Marcar pedidos como entregue.

2. Após isso, será adicionado na expedição um Marcador que identificará que a venda já foi marcada como entregue e sincronizada na WooCommerce.

Liberar a utilização do serviço de OMS na WooCommerce

1. Em sua conta no Tiny, acesse a configuração de integração com WooCommerce. A seguir, clique em Gerar link para usar a importação automática de pedidos.

2. Será exibido na tela o link gerado, é necessário que Copie essa url de endereço e Cole no painel administrativo da sua loja na WooCommerce.

3. Ao acessar o painel administrativo da WooCommerce, no menu lateral acesse Seção WooCoommerce → Configurações → Aba Avançado → Webhook e clique em Adicionar webhook.

4. Para incluir o webhook, preencha os seguintes campos abaixo:

Nome: Informe a Descrição do webhook.
Status: Selecione neste campos a opção Sim.
Tópico: Indique a situação dos pedidos a serem importados, entre as opções: Pedido Criado ou Pedido Atualizado.
URL de entrega: É necessário Colar o link gerado em sua conta Tiny. Conforme o passo 1 da ajuda.
Segredo: Este campo será preenchido automaticamente quando Salvar o webhook. Não é necessário preencher neste momento.
Versão da API: Selecione a versão de API Integração com WP REST API v2.

5. Agora, clique em Salvar webhook.

6. Pronto! Com o webhook criado na WooCommere você já pode utilizar o serviço de OMS em sua conta no Tiny.

Mapear formas de frete da Frenet

1. Primeiramente, acesse o painel administrativo da Frenet com seu Usuário e Senha.

2. Agora, no menu lateral, acesse a opção Transportadoras. A seguir, serão listadas todas as transportadoras possíveis de serem integradas. As transportadoras que já integrou com seu e-commerce são identificadas pelo marcador em destaque, conforme imagem abaixo:

3. Para localizar código do serviço da transportadoras para mapear a forma de frete no Tiny, é necessário acessar a transportadora desejada.

4. A lista de serviços de entrega exibe os serviços disponíveis e os quais já possui integração ativa. Para mapear a forma de frete no Tiny é necessário que informe o Código do serviço, conforme imagem abaixo:

5. O próximo passo, é acessar a configuração do e-commerce em sua conta no Tiny. Para isso, acesse Menu → Configurações → Aba E-commerce → Integrações e clique sobre a sua Integração.

6. Na aba Formas de frete o mapeamento será realizado diretamente pela transportada. Clique em Adicionar mapeamento de frete.

Agora, no campo Código no e-commerce informe o código localizado na Frente, conforme o Passo 4. Ao lado, em Forma de envio selecione a forma de frete, caso ainda não tenha cadastrada será necessário incluir uma forma de envio. A Forma de frete é selecionada conforme cadastrou a forma de envio.

7. Ao finalizar o mapeamento da forma de frete, clique em Salvar.

Dicas e informações adicionais

• Caso seja necessário realizar a exclusão dos mapeamentos dos produtos com a sua plataforma, acesse Configurações → Aba E-commerce → Integrações e marque a integração desejada. Depois, clique em Mais ações → Excluir todos os anúncios no Tiny. É importante mencionar que esta ação, depois de concluída, não poderá ser desfeita.
• Atualmente, é possível enviar produtos do Tiny para o WooCommerce, a partir da versão "3.0".
• A forma de frete presente no pedido no WooCommerce é enviada ao Tiny, no momento da importação dos pedidos.
• Após importar um pedido, é possível realizar o cadastro, do produto no Tiny, através do lançamento de estoque, disponível no menu de contexto, localizado ao lado do pedido ou da nota → Lançar estoque.
• Se desejar, você pode realizar a importação através de planilha de acordo com o nosso layout disponibilizado em Importador de produtos.
• Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.