Loja Integrada — Autorização: a chave da API, o vínculo e o desvincular
AUTORIZAÇÃO DA LOJA INTEGRADA: A CHAVE DA API, O VÍNCULO E O DESVINCULAR
A tela de Autorização fica dentro do aplicativo da Loja Integrada, em Configurações, com o título "Autorização". É por ela que a sua loja virtual passa a conversar com o sistema, e é ela que responde quase todas as dúvidas de "integrei e não funciona".
Repare numa coisa antes de tudo: essa tela não faz nenhuma checagem de vínculo. Ela abre sempre, esteja a integração feita ou não. Quem checa são as listagens do aplicativo — Clientes, Produtos, Pedidos, Meios de pagamentos e Situações — e o Início.
OS DOIS ESTADOS DA TELA
A tela tem dois estados, e é isso que confunde. A lista é fechada, não existe um terceiro:
1) Sem vínculo, ou em edição: aparece o formulário, com um único campo obrigatório chamado "Chave da API", e o botão verde "Integrar". Quando você chega nesse formulário pelo botão "Editar integração", o mesmo botão passa a se chamar "Atualizar".
2) Já vinculada: o formulário some. No lugar aparece um aviso verde dizendo que a sua conta da Loja Integrada está vinculada com o nosso sistema, e apenas dois botões: "Editar integração" e "Desvincular".
Ou seja: se você abriu a tela e não viu campo nenhum, isso não é erro. É a confirmação de que a chave já está salva.
PEDE DUAS CHAVES E SÓ TEM UM CAMPO — POR QUÊ
Essa é a dúvida número um da tela, e a resposta é simples.
O texto de instrução da própria tela manda você acessar a ajuda da Loja Integrada e ver como pegar "a chave da API" e "a chave da aplicação". Mas o formulário tem um campo só. Não falta campo, não é falha da tela.
A chave de aplicação não é digitada por você: ela já fica guardada na configuração do sistema. Você fornece só a chave da API, que é a sua.
Então, quando o cliente disser "o portal me deu duas chaves e aqui só tem um lugar", a resposta é: cole apenas a chave da API. A chave de aplicação você ignora.
A CHAVE "SUMIU" DEPOIS QUE SALVEI
Também não é erro, e o comportamento é proposital.
Assim que a integração é salva com sucesso, o sistema limpa o campo na tela, mostra a mensagem de sucesso e recarrega os dados. Ao recarregar, ele vê que já existe chave gravada e troca o formulário pelo aviso verde. Resultado: a chave nunca volta escrita na tela, em nenhum momento.
E tem mais: quando você clica em "Editar integração", o campo reabre VAZIO. Ele não vem preenchido com a chave antiga. Isso assusta, mas é o mesmo motivo — a chave não é devolvida para a tela.
Por isso, "sumiu" e "não salvou" não são a mesma coisa. Se o aviso verde está lá, salvou. Se você abriu a edição e desistiu, saia da tela sem clicar em "Atualizar"; não apague nada nem deixe o campo vazio de propósito.
COMO TROCAR A CHAVE
Gere uma chave nova no portal da Loja Integrada, abra a tela de Autorização, clique em "Editar integração", cole a chave inteira no campo "Chave da API" e clique em "Atualizar". Como o campo abre vazio e é obrigatório, não dá para "corrigir um pedaço": é sempre a chave completa, colada de novo.
Nunca mande a chave para o atendimento, nem por chat, nem por e-mail. Se você já enviou a sua chave para alguém, gere outra no portal da Loja Integrada e refaça a autorização com a nova.
O BOTÃO DESVINCULAR
O "Desvincular" fica ao lado do "Editar integração", em vermelho, e roda na hora que você clica. Não existe tela de confirmação nem "tem certeza?". Clicou, foi.
Depois de desvincular, a tela volta ao estado 1: o formulário reaparece pedindo a Chave da API, com o botão "Integrar". Para voltar a integrar, é colar a chave da API de novo.
O que remover o vínculo significa para os dados e para o que já foi sincronizado está explicado no conteúdo geral de Integrações. Este texto não repete aquilo.
QUANDO NÃO HÁ VÍNCULO: O QUE VOCÊ VÊ
Sem autorização feita, as listagens do aplicativo e o Início perguntam ao sistema se existe loja configurada. Quando não existe, a resposta é o aviso "Você ainda não possui uma loja virtual configurada em nosso sistema!", e o sistema leva você de volta para o início do aplicativo da Loja Integrada. Enquanto isso, a listagem não desenha nada: nem o título, nem a lista.
No início, nesse caso, não aparecem os cartões de menu. Aparece só o texto de apresentação da Loja Integrada e um botão verde "Configurar Integração", que leva exatamente para a tela de Autorização.
Então "aparece só o botão Configurar Integração" e "diz que não tenho loja virtual configurada" são a mesma situação, com a mesma causa: não há loja virtual configurada para esse acesso. Não é permissão, não é menu escondido.
Com o vínculo feito, o início passa a mostrar os cartões. A lista é fechada: Clientes, Produtos, Pedidos, Meios de pagamentos, Situações, Configurações e Usuários.
A CONTRATAÇÃO É VALIDADA POR LOJA
Detalhe que explica muito caso estranho: a Loja Integrada é liberada por LOJA, não pela empresa inteira.
Na prática, a mesma empresa pode ter uma loja com o recurso liberado e outra não, e o comportamento vai ser diferente em cada uma. Antes de investigar chave, confirme em qual loja o usuário está logado. Entrar pela loja errada é engano comum.
As travas de autorização que valem para os canais de venda estão na pasta Marketplaces e e-commerce. É lá que está o desenho comum: de-para de situações e meios de pagamento, quem é dono do pedido, do estoque e do preço.
O QUE COSTUMA DAR ERRADO
"Integrei e não funciona": primeiro olhe o estado da tela. Se o aviso verde não está lá, a chave não foi gravada. Se está lá, o vínculo existe e o problema não é a chave — vá para as travas comuns dos canais, na pasta Marketplaces e e-commerce.
"Colei a chave e ela sumiu": comportamento normal, explicado acima. O campo é limpo depois de salvar e a tela troca para o aviso verde.
"Cliquei em Editar integração e o campo estava vazio, achei que tinha perdido": também normal. O campo nunca vem preenchido.
"Copiei a chave com espaço ou pela metade": a tela só verifica que o campo não está vazio; ela não confere o conteúdo da chave. Cole sempre a chave inteira, sem espaço no início ou no fim. Se depois de salvar nada chegar, refaça a autorização colando a chave completa antes de abrir chamado.
"Desvinculei sem querer": não há confirmação, então isso acontece. Volte à tela de Autorização e refaça a integração colando a chave da API.
"Integrei numa loja e a outra não funciona": o recurso é liberado por loja. Confirme em qual loja o usuário está antes de mexer na chave.
"Não acho onde coloco a chave": pelo início do aplicativo da Loja Integrada, botão "Configurar Integração" quando não há vínculo; ou pelo cartão "Configurações" quando já há.
Os passos dentro do painel da Loja Integrada são do parceiro: a própria tela do sistema traz o link da ajuda oficial para gerar as chaves. E cadastro de cliente, produto, forma de pagamento, venda e nota fiscal são do ERP — esses assuntos têm conteúdo próprio.