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, a descrição detalhada e as informações de imagem, peso e medida serão atualizadas no e-commerce. Essas opções passam a valer a partir da segunda integração do item, visto que, na primeira integração, todas as informações do item devem ser enviadas. Quando as opções de atualização estiverem desmarcadas, as respectivas informações já existentes no e-commerce serão mantidas.
Importante: Atualmente, as informações de medida do item não são sincronizadas pela integração com a Tray Corp Exclusive. Por esse motivo, elas também não são atualizadas no e-commerce, sendo a atualização aplicável apenas às informações de imagem e peso.
Essas 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 abaixo:

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