Pular para o conteúdo

A Zoppy no Connect

Para o Connect, a Zoppy é mais um sistema do catálogo: o oficial, o primeiro da lista. Ele lê e escreve os dados da loja só pela API de Parceiros da Zoppy (documentação), do mesmo jeito que faria com qualquer outro sistema, e nunca acessa o banco da Zoppy diretamente.

Na primeira integração da loja, o Connect gera sozinho, com o login de quem está construindo, um acesso à API de Parceiros para a loja. Esse acesso:

  • fica guardado cifrado, como um segredo da loja, com o registro de quem o gerou;
  • é usado só em chamadas para a Zoppy (o gateway nunca o manda para outro sistema);
  • nunca aparece para ninguém, nem para o código do conector.

Só lojas com plano pago geram esse acesso (connect.zoppy_free_tier).

  • Só as rotas que o manifesto declara para partners.zoppy.com.br.
  • Nunca apagar: DELETE é sempre recusado.
  • A primeira escrita real na Zoppy espera a sua confirmação, como em qualquer sistema (Primeira escrita).

Se o acesso do Connect for desativado na Zoppy (por exemplo, ao revogar os tokens da loja), a próxima chamada de um conector é recusada pela Zoppy e:

  1. a execução falha;
  2. todos os conectores da loja pausam, com o motivo “acesso à Zoppy revogado”;
  3. os administradores da loja recebem um aviso.

Para voltar, um administrador abre o Connect: ele gera um acesso novo e mostra a prévia para religar os conectores que pausaram por esse motivo. Confirme e eles voltam ao cron.