Escopo
Esta base de conhecimento visa orientar como realizar a configuração da integração Tray Corp Exclusive através da rotina [R10 - Meu e-Commerce].
Parâmetros utilizados
Para a integração Tray Corp Exclusive é necessário que os parâmetros [1113 - Tipo de Modelo do E-Commerce] abaixo estejam configurados. A configuração é realizada na rotina [R29 - Parâmetros por empresa] como exemplo a baixo:
Configuração de um novo e-Commerce
Para cadastrar um novo e-Commerce, basta abrir a rotina [R10 - Meu E-Commerce], clicar em Novo E-Commerce.
Dados obrigatórios:
O "Code" é um código de autorização que representa a loja do e-commerce, e para se obter este código é preciso solicitar a instalação do App MOVERE na aba "Meus Aplicativos" na área de configuração da Tray, caso o App não esteja disponível para instalação realizar contato com o suporte Tray. Após o aplicativo estar na loja do cliente, ao ser acessado será gerado o "Code" e a URL Api.
Campo | Descrição |
---|---|
Code | Código de autorização |
URL Api | URL para utilização da Api da loja |
Código Status Pedido Aprovado | Código utilizado pelo Movere para identificar um pedido Aprovado no E-Commerce |
Logo abaixo imagem da rotina [R10 - Meu E-Commerce] para preenchimento das informações:
Dados obrigatórios:
As informações dos produtos enviados (preços, estoque, etc) serão as informações que estão relacionadas com os valores informados nos campos abaixo:
- Nome do e-Commerce
- Estabelecimento principal
- Tabela de preços
- Entrada/Saída
- Estabelecimentos/Depósitos
- Code
- Url Api
- Status Pedido Aprovado
Observações:
- Hoje não é possível a exclusão de um e-Commerce, somente é possível inativar. Qualquer informação modificada na tela a mesma será salva automaticamente.
- O campo "Status Pedido Aprovado" representa o status de um pedido que teve seu pagamento confirmado na plataforma.
- Atualmente MOVERE envia para plataforma Tray apenas o status "Documento fiscal enviado". Os demais status existentes no e-commerce devem ser gerenciados diretamente pela plataforma ou através de outras integrações.
Marketplace: Consiste em um site desenvolvido para promover a venda de produtos através da internet, reúne produtos de diferentes lojas e oferece uma gama de itens mais ampla do que o e-commerce de uma única marca. Por isso, é comum pensar nessa plataforma como um shopping center virtual. Exemplos: (Lojas Americanas, Mercado Livre, Magazine Luiza).
Atenção: Para pedidos realizados e pagos através de Marketplaces são representados por um status diferente, pois a plataforma Tray não possui a informação se o pagamento foi confirmado pelo cliente final. Dessa forma é preciso atualizar o status do pedido manualmente dentro da plataforma Tray para que seja sincronizado com o MOVERE. |
Sincronização dos produtos
Para a realização da sincronização dos produtos com o e-Commerce é preciso estar habilitada a opção "Participa da Integração com e-Commerce?" na rotina [R135 - Itens/Estabelecimento] como exemplo a baixo:
Observações: As opções sinalizadas definem se o item participa da integração com a plataforma e se nas sincronizações do item a descrição e descrição detalhada serão atualizadas, esta flag passa a valer a partir na segunda integração do item, visto que na primeira integração todas as informações do item devem ser enviadas, quando a opção de atualização é desmarcada as descrições do item no e-commerce serão mantidas. estas opções devem ser habilitadas no item correspondente ao estabelecimento que faz parte da integração com o e-Commerce de acordo com as configurações realizadas na [R10 - Meu E-Commerce], segue exemplo a baixo:
A sincronização dos produtos possui um intervalo de 15 minutos para envio de produtos novos ou modificados, é possível visualizar os detalhes na [R10 - Meu E-Commerce] na aba de Produtos, poderá acompanhar detalhes de sincronização ou mensagens de erro caso houver para melhor apoio ou orientação do suporte, como imagem abaixo:
Importante:
- Para que os produtos sejam sincronizados, eles precisam possuir preço (Para a embalagem padrão do produto) configurado na tabela de preço vinculada ao e-commerce.
Atenção: Os itens sincronizados com a plataforma Tray, são atualizados com a informação SKU na [R179 - Itens/ Embalagens Venda], o SKU representa a ligação entre os sistemas e com isso o item não deve ser removido na plataforma e sim inativado, pois é preciso para manter a consistência das integrações e evitar possíveis problemas de sincronização dos itens. |
Ofertas de Itens
As ofertas cadastradas na [R218 - Itens em Oferta] podem ser enviadas para o e-Commerce realizando a configuração na [R10 - Meu e-Commerce] na aba "Configurações" habilitando a opção "Integração de ofertas".
As ofertas para envio devem estar ativas e com datas vigentes ou programadas para o futuro, devem também pertencer os itens que participam da integração, atendendo as configurações de estabelecimento e tabela de preço padrão do e-Commerce.
Itens que estão em oferta são sinalizados na aba "Produtos" demonstrando o preço de venda original e preço de oferta vigente.
Esta funcionalidade de envio de ofertas para e-Commerce atualmente é de uso exclusivo para integrações Tray Exclusive.
As seguintes funcionalidades relacionadas a ofertas estão comtempladas:
- Oferta por data
- Oferta por quantidade
- Oferta por valor
- Oferta por percentual
Demais funcionalidades relacionadas a ofertas presentes na R218 não está contemplada na integração.
Recepção dos Pedidos Aprovados na Tray
Para que ocorra a sincronização de todos os pedidos com suas informações de pagamento corretamente é preciso realizar o vinculo da forma de pagamento do e-Commerce com o portador e condição de pagamento no Movere na [R518 - Tipos de Pagamento para E-Commerce] como exemplo abaixo:
Ressaltando que o campo [Forma de pagamento no e-Commerce] precisa ser idêntico a forma de pagamento configurada na Tray.
A recepção de um pedido da Tray inicia-se quando o cliente finaliza todo o processo de pagamento para que seja possível realizar a emissão de documento fiscal posteriormente no Movere.
A sincronização dos pedidos possui o mesmo intervalo da sincronização de produtos, aproximadamente 15 minutos. Ao realizar a recepção de pedidos novos ou modificados, é possível visualizar os detalhes na [R10 - Meu E-Commerce] na aba de Pedidos, podendo acompanhar detalhes da sincronização ou mensagens de erro, caso houver. Exemplo imagem abaixo:
Após conclusão da sincronização do pedido, o orçamento em aberto estará presente na [R419 - Vendas no varejo] como demonstrado na imagem abaixo:
Observações: Durante a recepção dos pedidos os dados dos clientes novos serão automaticamente cadastrados na [R43 - Clientes] ou atualizados, caso já existam.
Imagens: As imagens são fornecidas para a Tray no formato de URL de acesso público e com isso é preciso definir o parâmetro por empresa [P1244 - Endereço / URL do MOVERE],
Configuração de Retirada dos Pedidos na Loja
Para que seja realizado a retirada de um pedido em uma determinada loja deve ser realizado a configuração do estabelecimento de retirada na [R1179 - Configuração de Retirada dos Pedidos na Loja], para mais informações clique aqui.
Envio do XML DANFE para o e-Commerce
Após faturamento e emissão da nota fiscal da venda, no intervalo aproximado de 15 minutos o Movere realizará o envio das informações básicas da nota fiscal e XML completo da DANFE (Documento Auxiliar de Nota Fiscal Eletrônica).