NuvemShop: autorizar a loja, o bloqueio por domínio e remover a integração

O QUE VOCÊ ENCONTRA AQUI

São três coisas da NuvemShop: autorizar a loja, entender o aviso vermelho que impede a autorização em certos endereços e remover a integração. O roteiro comum aos canais de venda, o de-para de situações e as travas de autorização estão no conteúdo de Marketplaces e e-commerce. O índice das integrações, o vínculo por loja e o efeito de remover estão no conteúdo geral de Integrações. Aqui fica só o que é próprio da NuvemShop, e há uma coisa que é exclusiva dela.

ONDE FICA A TELA DE INTEGRAÇÃO

A tela fica dentro do aplicativo da NuvemShop, em Integrações. Se você tem um favorito antigo salvo da tela de autorização, ele continua funcionando: o sistema leva você sozinho para a tela de Integrações. Não precisa arrumar favorito por causa disso.

A tela só desenha depois que os dados da integração carregam. Nos primeiros instantes a área fica vazia, e isso é normal.

Carregada, ela sempre mostra a mesma apresentação da integração, com a chamada "Realizando esta integração você vai conseguir:" e uma lista fechada de cinco itens: sincronize pedidos automaticamente, gerencie produtos com facilidade, acompanhe suas vendas em tempo real, emita notas fiscais com agilidade e simplifique sua operação online. São exatamente esses cinco, não há outros. Essa lista é texto de apresentação. Ela não indica se você já está integrado.

AUTORIZAR A LOJA

Enquanto a loja não está autorizada, a tela mostra o botão verde Adicionar integração.

Esse botão só leva ao portal da NuvemShop se o sistema tiver recebido as credenciais do aplicativo. Quando tem, o clique sai do sistema e abre a página de autorização da NuvemShop, na mesma aba. O resto acontece lá, no portal do parceiro, que é tela dele e muda sem aviso.

Quando o sistema não tem essas credenciais, o botão continua na tela, com o mesmo nome e a mesma cor, mas ele não navega para lugar nenhum. Ao ser clicado, ele troca o próprio conteúdo por um aviso vermelho. É exatamente por isso que muita gente abre chamado dizendo que clicou e não aconteceu nada. Aconteceu: o que apareceu no lugar do botão foi o aviso.

O AVISO VERMELHO DE DOMÍNIO

Esta é a peculiaridade da NuvemShop. É o único canal de venda que monta na própria tela uma mensagem com o endereço pelo qual você está acessando. Outros canais também mostram aviso vermelho quando não conseguem oferecer a autorização, mas ali o texto vem pronto e pode dizer outra coisa. Aviso vermelho citando o seu domínio de acesso, escrito assim, é NuvemShop.

São dois avisos possíveis, e só esses dois. A diferença entre eles muda o que fazer.

O primeiro é: não é possível autorizar a integração pelo domínio X, tente acessar pelo domínio Y. Aqui o sistema conhece o domínio principal da empresa, mostra ele como Y e ainda oferece o link para você clicar e ir direto.

O segundo é mais curto: não é possível autorizar a integração pelo domínio X. Sem sugestão e sem link, porque nesse caso o sistema não tem um domínio principal para indicar.

Nos dois, o X é o endereço pelo qual você está acessando o sistema naquele momento. Não é o endereço da sua loja NuvemShop. É a barra de endereços do navegador.

O QUE FAZER COM ELE

O próprio aviso já diz o caminho: tentar pelo domínio indicado. Em ambiente white label a mesma empresa costuma ter mais de um endereço de acesso, e o cliente entra por um alternativo sem perceber: um link antigo de e-mail, um atalho salvo há muito tempo, um endereço de teste que alguém passou, o endereço que ficou gravado no navegador do outro computador. Todo dia funciona igual, o sistema abre, o login entra, tudo normal. Só a autorização da integração não sai.

A orientação é simples e resolve a maioria dos chamados: saia do sistema, entre de novo pelo domínio indicado no aviso e repita o Adicionar integração. Quando o aviso trouxe o link do domínio Y, use esse link.

Isso não é erro da NuvemShop. Não é senha errada, não é conta bloqueada no parceiro e não é falta de contratação. É o endereço de acesso.

Se você já está acessando pelo domínio indicado e o aviso continua aparecendo, o caso sai do comum: guarde o endereço que está usando e o print do aviso e leve para o atendimento verificar.

Um detalhe prático: depois que o aviso aparece, o botão Adicionar integração sai da tela. O aviso tem um X para fechar, mas fechar só apaga a mensagem, não devolve o botão. Recarregue a página para o botão voltar.

A VOLTA DO PORTAL

Terminada a autorização no portal, a NuvemShop devolve você para o sistema com um código. O sistema lê esse código sozinho e conclui a integração. Você não precisa copiar nada, e ninguém do atendimento vai pedir esse código, nem token, nem chave, nem senha. Se você já enviou alguma dessas coisas em uma conversa, gere outra no portal do parceiro e descarte a antiga.

Dando certo, o sistema mostra a mensagem de sucesso e leva você para a tela inicial do aplicativo da NuvemShop. Se você integrou e caiu na tela inicial, integrou mesmo.

Dando errado, o sistema mostra a mensagem de erro que voltou e você continua na mesma tela de integração, que recarrega os dados. Essa mensagem vem do parceiro. Guarde o print dela antes de qualquer outra coisa, porque ela é o diagnóstico.

REMOVER A INTEGRAÇÃO

Quando a loja já está autorizada, o botão verde some e no lugar dele aparece o botão vermelho Remover integração.

Ao clicar, o sistema pede confirmação nomeando a NuvemShop, para você não desfazer a integração errada por engano. Confirmando, o vínculo é desfeito, o sistema mostra o retorno da operação e recarrega os dados da tela, que volta a oferecer o Adicionar integração.

O que remover a integração significa para pedidos, produtos e vendas já existentes está no conteúdo geral de Integrações.

ESTA LOJA NÃO ESTÁ INTEGRADA AO NUVEMSHOP

Existe uma mensagem de aviso com esse texto. Ela aparece quando a tela de integração é aberta por um redirecionamento, ou seja, quando você não clicou em Integrações no menu: foi levado até ali. Abrindo a tela pelo menu, essa mensagem não aparece.

Ela é mal interpretada com frequência. Ela não está dizendo que a empresa não tem integração. Está dizendo que a loja selecionada não tem vínculo. O vínculo da NuvemShop é gravado por empresa e por loja, as duas coisas juntas.

Então, quando alguém diz que integrou ontem e hoje as telas dizem que a loja não está integrada, quase sempre trocou de loja. Confira qual loja está selecionada. O vínculo por loja está explicado no conteúdo geral de Integrações e no conteúdo de Marketplaces e e-commerce.

O QUE É DO APLICATIVO E O QUE É DO ERP

Dentro do aplicativo da NuvemShop existem telas que são do próprio aplicativo e telas que são do ERP, reaproveitadas ali.

São do aplicativo: integrações, tela inicial, pedidos, produtos e clientes do canal, situações e meios de pagamento.

São do ERP, apenas exibidas dentro do aplicativo: marcas, grades e campos extras de produtos, lojas, usuários, grupos de usuários, permissões, planos, registros de acesso e a ajuda. Os formulários de cadastro e edição de produto e de cliente também são os do ERP.

Isso importa na hora de tirar dúvida. Se a dúvida é sobre um campo do cadastro de produto ou de cliente, a resposta é a mesma do ERP, mesmo que a tela esteja sendo vista por dentro da NuvemShop: não existe regra diferente só porque a tela foi aberta pelo aplicativo.

ORDEM DE DIAGNÓSTICO PARA NÃO CONSIGO INTEGRAR

Siga nesta ordem. Ela vai do problema mais grosseiro para o mais fino.

Primeiro: a tela de integração abre? Se não abre para ninguém, nem para o usuário master, o assunto é contratação e permissão, não é autorização. Veja o conteúdo de permissões.

Segundo: aparece o aviso vermelho falando de domínio? Então entre pelo domínio indicado no aviso e repita. Não é caso de senha, de token nem de chamado com o parceiro.

Terceiro: o botão leva ao portal, você autoriza e volta com erro? Guarde a mensagem que voltou. Ela vem do parceiro e é ela que diz o motivo.

Quarto: integrou, mas as telas do aplicativo dizem que a loja não está integrada? É outra loja selecionada. Confira a loja.

O QUE COSTUMA DAR ERRADO

Cliquei em adicionar integração e não acontece nada. Causa real: o botão trocou de conteúdo e virou aviso de domínio. Role a tela e leia o aviso.

Entrei pelo link que sempre uso e não autoriza. Causa real: esse link é um domínio alternativo. Entre pelo domínio indicado no aviso.

O aviso apareceu e agora sumiu o botão. Causa real: o botão sai da tela quando o aviso aparece, e fechar o aviso no X não traz ele de volta. Recarregue a página.

Já entrei pelo domínio indicado e o aviso continua. Causa real: não é mais o caso comum. Junte o endereço usado e o print do aviso e leve para o atendimento verificar.

Perdi a integração do nada. Causa real quase sempre: a loja selecionada é outra, ou alguém clicou em Remover integração. A remoção pede confirmação nomeando a NuvemShop, então dificilmente foi acidente de clique sem leitura.

Integrei ontem e hoje diz que a loja não está integrada. Causa real: loja selecionada diferente. O vínculo é por empresa e por loja.

Voltei do portal e deu erro. Causa real: veio do parceiro. A mensagem exibida é a resposta dele.

O QUE NÃO SE RESOLVE POR AQUI

As telas do portal da NuvemShop são do parceiro e mudam sem aviso, então os passos de lá dentro não estão descritos aqui. Onde ficam cadastradas as credenciais do aplicativo também não se vê por essa tela. Preço, taxa, tarifa e plano são assunto do comercial e do parceiro.