Integração Tiny com o KaBuM

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. Agora, selecione KaBuM no campo Integração. Abaixo, no campo Nome informe o nome da sua loja.

   Na seção Autenticação , é necessário inserir a Chave da API de integração presente no painel administrativo da sua conta no KaBuM. Saiba como localizar o seu Token.

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.

   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 Kabum.

   Sincronização de pedidos

   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.
   Adicionar o endereço do cliente nas observações da venda	Habilite esta opção para adicionar o endereço do cliente nas obervações da venda, ao importar o pedido do e-commerce.
   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.
   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.

   Configurações adicionais

   Envio de dados da NFe	Selecione a opção Automático ao autorizar a nota fiscal , assim sempre que a nota fiscal for atualizada o envio dos dados da NFe ao e-commerce será automático. As informações sobre envio de dados da NFe de forma Manual , estão disponíveis na ajuda Enviar dados da NFe ao e-commerce (Manual).
   Intermediador	Neste campo, selecione o intermediador de suas operações. Saiba mais através da ajuda Como utilizar e configurar os intermediadores de operações.

   Observação:

   • Referente ao campo Envio de dados da NFe , é enviado ao KaBuM o XML da NFe , Chave de acesso da NFe , Data de envio , Número , Série e o CFOP do primeiro item da NFe.
   • Após enviar os dados da NFe, o seller poderá acessar o painel da KaBuM e realizar o download da NFe.

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.

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. Para mapear as categorias dos produtos, é necessário acessar a aba Categorias e no botãobuscar 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).

8. 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.

9. 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.

10. 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.

    A seguir, na listagem exibida, selecione a forma de envio correspondente em sua plataforma.

    Se a forma de envio não for exibida na busca pela integração 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.

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

Os pedidos realizados no KaBuM 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.

1. O envio dos produtos do Tiny para o KaBuM pode ser realizado em Menu → Cadastros → Produtos → Selecione os produtos que desejar enviar → Enviar para o e-commerce.

   Os campos enviados são:

   • Código (SKU)
   • Descrição
   • Peso bruto
   • GTIN
   • Descrição complementar
   • Largura embalagem
   • Altura embalagem
   • Comprimento embalagem
   • Imagens
   • Variações
   • Atributos

2. O Tiny organiza os produtos em lotes para serem enviados ao KaBuM e, para ser compatível com o limite de cada canal, este processo de envio se inicia em 1 hora.

   Também, é possível selecionar as opções Atualizar estoque no e-commerce e Parar o envio em lote caso algum produto seja rejeitado.

   Ao clicar, em Avançar serão listados os produtos a serem enviados.

3. No momento que clicar em Enviar , será realizada uma consulta diária e automática pelo Tiny, para verificar a situação de cada produto enviado, que podem ser aprovados ou rejeitados:

   • Quando o produto for aprovado pelo KaBuM, será enviada a oferta de preço automaticamente e você já poderá começar a vender;
   • Se o produto foi rejeitado, será atualizada a informação do anúncio no mapeamento no produto.

4. Quando todos os produtos forem enviados para os marketplaces, o usuário será notificado no Tiny.

Como acompanhar o processamento dos anúncios enviados

Para acompanhar o retorno do processamento em sua conta no Tiny, retorne à tela de Produtos e acesse o menu Mais ações e clique em Consultar anúncios enviados em lote (beta).

A seguir, Selecione a integração e clique em Buscar protocolos.

Serão listados todos os protocolos independente de sua situação Pendente ou Finalizado. Lembramos que protocolos com a situação Finalizado só permencerão para consulta no período de 7 dias.

Você pode selecionar o protocolo desejado e clicar em Consultar protocolo.

Após clicar em consultar protocolo é possível visualizar os anúncios que foram Enviados com sucesso , Com erro e os que estão Em processamento.

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 Kabum.

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.

O envio de dados da chave de acesso ao e-commerce pode ser realizado dentro do Tiny pelos módulos de Expedição ou Nota Fiscal.

Envio pela expedição

1. Ao acessar o módulo de expedição, no primeiro Filtro ao lado do campo de busca, selecione por Pedidos e no filtro, ao lado selecione Transportadora.

2. Agora, localize a expedição, clique no Menu de contexto e selecione Enviar chave de acesso para o e-commerce.

   Observação:

   Além da chave de acesso da Nota Fiscal, também é enviado o XML da NFe , sendo que é necessário a Nota Fiscal estar Autorizada no Sefaz , para o envio das informações ocorrer com sucesso. O status do pedido no Kabum será atualizado para Faturado.

Envio pelas notas fiscais

Ao acessar o módulo de notas fiscais, clique na aba Emitidas e Selecione as notas que deseja enviar os dados para o e-commerce. A seguir, acesse a opção Mais Ações e clique em Enviar dados da NFe para e-commerce.

1. Atenção!

   Para enviar o código de rastreamento para o KaBuM, é preciso informar no Pedido de Venda , Nota fiscal ou na Expedição o Transportador e a URL de rastreio , sendo ele Correios ou Transportadora. Saiba como gerar a Expedição.

2. Acesse o módulo de Expedição e utilize o filtro para buscar a Forma de envio desejada. Na sba Concluídas , acesse o menu de contexto ao lado da expedição gerada e clique em Enviar código de rastreio para o e-commerce.

   Observação:

   Ao enviar o código de rastreio, também são enviados o Transportador , a URL de rastreio e os pedidos são marcados como Enviado no KaBuM.

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

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ç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.

1. Acesse o painel administrativo da sua conta no KaBuM.

2. Agora em sua conta, clique sobre os Dados do usuário localizado no menu superior.

    

   

3. Acesse a aba Chave de API e clique em Copiar para área de transferência para informar essa Chave de API na configuração da integração no Tiny.

    

   

• 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.
• Sempre que um pedido é importado, o cliente automaticamente é cadastrado em Cadastros → Clientes e fornecedores.