1. Acesse o Painel de administração da sua loja Magento.

2. No menu System , opção WebServices , deve ser criado um papel ( Role ou SOAP/XML-RPC - Roles ).

    

   

   Na tela a seguir, acesse Add new role para criar o papel que deve ser vinculado ao usuário.

    

   

   No campo Role Name , informe a descrição. Abaixo, deve-se informar a senha do administrador e após salve no botão Save role.

    

   

   Agora em Role resources , atribua todas as funções no campo Resource Access. Após isso salve em Save role.

    

   

3. Ainda no painel de administração da sua loja Magento. Para criar o usuário, acesse menu System , opção WebServices , deve ser criado um usuário ( Users ou SOAP/XML-RPC - Users ).

    

   

   A seguir, acesse no botão Add New User , para incluir o usuário.

    

   

   Preencha os Dados referentes ao usuário e após salve no botão Save User.

    

   

   Observações:

   1. Current Admin Password: deve informar a senha do administrador do painel de administração da sua loja Magento.
   2. API Key: informe a senha de acesso ao usuário que esta cadastrando.
   3. API Key Confirmation: repita a senha do usuário informada no campo "API Key".

   Após ter salvo o usuário, deve vincular o mesmo ao papel de administrar, realizado no Passo 2. Para isso, acesse User role e marque a opção Admin e salve em Save User.

4. Para iniciar a configuração no Tiny, acesse menu → início → integrações .

   Observações:

   Caso já possua integrações configuradas em sua conta, elas serão exibidas e indicadas da seguinte forma:

   • Ativa: Indica que a integração foi realizada com sucesso e encontra-se pronta para uso.
   • Inativa: Indica a inatividade desta loja no Tiny, ou seja, a loja não estará disponível para sincronização de pedidos, produtos e demais ações pertinentes.
   • Não conectada: Indica que a configuração ainda não foi realizada.

   Somente as integrações Ativas serão exibidas para uso nas sincronizações, importações e demais ações no Tiny.

5. Clique em adicionar integração, busque por Magento e clique em instalar.
6. Na aba integração, campo nome informe o nome da integração no Tiny.
   
7. Na seção autenticação , preencha os campos abaixo:

   URL da loja	Neste campo, informe a URL da sua loja virtual.
   Versão	Selecione a versão da sua plataforma, Magento 1 ou Magento 2.
   Usuário e Senha	Os campos Usuário e Senha devem ser cadastrados no Magento, específico para essa integração.

   Clique em testar configurações para validar as credenciais de login.

8. Em configurações , defina os seguintes campos abaixo:

   Regras de estoque

   Atualizar estoque na loja virtual a partir do Tiny	Selecione umas opções disponíveis para atualização do estoque, sendo elas: não atualizar, enviar saldo físico (estoque total) ou enviar saldo disponível (estoque total considerando a reserva de estoque).
   Depósito a ser considerado na integração	Selecione o depósito padrão para: importar pedido, importar produtos e enviar estoque.
   Estoque mínimo	Selecione umas das opções disponíveis para envio da informação de produtos com estoque mínimo ao e-commerce: enviar para quantidade mínima para exibir produto como disponível (min_qty), enviar para quantidade mínima para notificar estoque baixo (notify_stock_qty) ou não enviar.

   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	Selecione umas das opções disponíveis para que as imagens do produto, no Tiny, sejam enviadas para o e-commerce.
   Enviar imagens do produto pai nas variações	Habilite essa opção para que ao enviar um produto para o e-commerce, as imagens do produto pai sejam enviadas para as variações que não possuem imagens.
   Ao importar produtos	Selecione umas das opções disponíveis para que o Tiny receba, em cadastro de produto, as imagens dos produtos importados do e-commerce.
   Enviar categoria na atualização do produto	Habilite essa opção para que a categoria do produto seja enviada ao atualizar os produtos já existentes no e-commerce.
   Na importação de produtos, ao atualizar um produto, atualizar o código (SKU)	Habilite essa opção para que o código SKU do produto do produto seja importado para o Tiny, ao atualizar os produtos.
   Envio e importação de produtos com variações (beta)	Habilite essa opção para que os produtos com variações sejam enviados e importados. * Configuração válida apenas para loja virtual com versão igual ou superior a 2.3
   Atualizar o produto em todos os escopos	Habilite essa opção para que os produtos sejam atualizados em todos os store modes. * Configuração válida apenas para loja virtual com versão igual ou superior a 2.3

   Sincronização de pedidos

   Sincronização automática de pedidos	Habilite essa opção para utilizar o recurso de OMS na integração com seu e-commerce. Saiba mais sobre o recurso em OMS.
   Importar valor do frete nos pedidos	Habilite essa opção para importar o valor do frete na importação dos 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 campo "shipping_description" como:	Selecione entre as opções transportadora ou transportadora + prazo de entrega para definir o local da informação.
   Importar transportadora ou forma de frete	Habilite essa opção para que a forma de frete de transportadora seja importada para o Tiny.
   Shipping Carrier para envio de código de rastreio	Preencha esse campo para que o código de rastreio do Tiny seja enviado para a loja virtual. * Esta informação é obtida no campo Shipping Carrier da sua loja virtual.
   Enviar rastreamento ao alterar a situação no Tiny para enviado	Habilite este parâmetro para que o código de rastreio seja automaticamente enviado para a plataforma sempre que a situação do pedido for alterada para Enviado. Saiba mais sobre essa rotina através da ajuda Atualizar situação de envio dos pedidos.
   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	Habilite este campo para que o nome do cliente, ao importar os pedidos, será formatado com as iniciais maiúsculas em seu Nome e Sobrenome.
   Importar campo COMPANY quando cliente for pessoa jurídica	Habilite essa opção para que o campo "company" seja importado para o Tiny sempre que o cliente for pessoa jurídica. Quando desabilitado, as informações importadas serão os campos firstname e lastname.
   Completar endereço do cliente a partir do CEP na importação de pedidos	Habilite essa opção para que o endereço do cliente seja preenchido no Tiny, ao importar os pedidos, de acordo com a opção escolhida * Escolhendo a opção Sempre, o CEP sempre será validado junto ao Correios para preenchimento do endereço do cliente. Assim, os dados de endereço obtidos na plataforma de e-commerce serão ignorados.
   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.
   Inclui observação no pedido do Magento com o número da nota fiscal ou venda	Habilite essa opção para que os números da nota fiscal ou da venda sejam incluídos na observação do pedido.
   Enviar e-mail, através da plataforma, ao enviar rastreamento ao Magento	Habilite essa opção para que, ao enviar o rastreamento para a plataforma, um e-mail seja enviado.

   Notificações por e-mail

   Enviar e-mail de entrega ao alterar a situação no Tiny para entregue	Habilite esse parâmetro para que, sempre que um pedido for alterado para a situação entregue no Tiny, um e-mail será enviado de forma automática, conforme layout estabelecido nas configurações da expedição.

   Configurações adicionais

   Envio de dados da NFe	Selecione esta opção para enviar os dados na NFe ao e-commerce. Para envio manual consulte maiores informações em Enviar dados da NFe ao e-commerce (Manual).
   Layout da mensagem do envio de dados da NFe	Preencha a caixa de texto para configurar a mensagem do envio de dados da NFe.

   Observação:

   As informações enviadas pelo campo envio de dados da NFe são: XML da NFe, chave de acesso da NFe, data de envio, número, série e CFOP do primeiro item da NFe.

9. Na aba dados fiscais, selecione a informação natureza de operação para venda nesta integração. A natureza selecionada será atribuída de forma padrão na importação dos pedidos no Tiny e no momento em que gerar a nota fiscal através do pedido importado.

   Observação:

   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.
10. Na aba campos personalizados, caso sua loja virtua possua essas informações, preencha os campos que serão importados com os pedidos ou produtos, conforme as descrições do e-commerce. 
    Atenção!
    

    Estas informações somente devem ser preenchidas se a sua loja virtual foi alterada para incluir as mesmas.

    Se você não efetuou alterações na sua loja para incluir as informações apresentadas, deixe-as em branco.

11. 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. Ao definir essa regra, siga a configuração de precificação de anúncios com base nas regras das plataformas de e-commerce e marketplaces.
    • Conforme lista de preços: utiliza de listas de preços dos produtos, específicas para o e-commerce ou marketplace. Ao definir essa regra, no campo lista de preços utilizada nos produtos, selecione a lista de preços a ser considerada na importação de pedidos do e-commerce. Saiba como configurar  em listas de preços.
12. Na aba categorias, relacione as categorias de produtos no Tiny com as categorias do e-commerce, assim os produtos já serão enviados nas categorias mapeadas previamente. 

    Categorias já cadastradas serão apresentadas em categoria no Tiny. Adicione o código da categoria no e-commerce clicando no botão configurar categoria no e-commerce 

    Observações:

    • Caso ainda não possua categorias cadastradas em sua conta no Tiny, verifique as instruções para inclusão de categorias em como cadastrar categorias de produtos.
    • As instruções para vincular as categorias no cadastro de produtos, estão disponíveis em como cadastrar um produto simples.
13. Na aba situações, é possível relacionar a situação dos pedidos no e-commerce com as respectivas situações no Tiny, assim como o fluxo da sequência das situações no Tiny.

    Adicione as situações presentes no e-commerce, clicando em adicionar situações padrão.

    Para adicionar novas situações, clique em adicionar mapeamento de situação.
    

    Para alterar a situação de um pedido para uma situação anterior à atual, habilite o campo permite retroceder situação dos pedidos na sincronização de situações, assim, por exemplo, um pedido enviado poderá voltar para a situação preparando Envio.

    Em situações personalizadas, é possível adicionar filtros personalizados que serão exibidos na listagem dos pedidos do e-commerce, além dos status padrões, que já são preenchidos automaticamente.

    Para adicionar novos filtros preencha os campos código da situação, descrição da situação e confirme a inclusão do filtro personalizado.

    Observação:

    Ao importar um pedido de venda do e-commerce para o Tiny, o pedido assume a situação configurada. Caso a situação não esteja configurada, o pedido importado terá a situação em aberto atribuída.
    

Sincronizando a situação dos pedidos