Cadastrar Aplicativo de Marketplace

Este guia detalha o fluxo para que parceiros cadastrem produtos na "Loja de APPs", permitindo que sua solução seja apresentada de forma profissional aos lojistas.

Passo 1: Seleção do Tipo de Aplicativo

Ao iniciar o cadastro, o sistema oferece fluxos distintos para diferentes tipos de soluções.

• Ação: Selecione a opção "Aplicativo de Marketplace".
• Finalidade: Este tipo de app é voltado para funcionalidades de ativação imediata, exibidas e utilizadas diretamente no portal do lojista (Geraldo).

Passo 2: Preenchimento de Informações Gerais

Nesta etapa, você define as configurações técnicas básicas da sua aplicação.

• Identificação: Insira o CNPJ ou CPF e o Nome do aplicativo.
• Categoria: Escolha entre as categorias disponíveis: Marketing e Conversão, Atendimento e Experiência, Operação e Gestão, ou Design e Customização.
• Configuração Técnica: Informe a URL de Redirecionamento e a URL da Aplicação (Iframe), onde seu produto será renderizado.
• Escopos da API V2: Selecione quais dados sua aplicação deseja acessar (Gestão de Loja, Pedidos ou Itens).

Passo 3: Aparência e Identidade Visual

A forma como seu app é apresentado na vitrine é crucial para o engajamento do lojista.

• Descrições: Preencha a Descrição Curta (máximo de 100 caracteres para a vitrine) e a Descrição Longa (detalhando as funcionalidades).
• Assets Visuais: Faça o upload do Ícone e de uma Galeria contendo de 1 a 5 imagens da interface da sua solução.
• Documentação e Suporte: Informe o e-mail de suporte, o link da Política de Privacidade e os Termos de Uso.

Passo 4: Preview e Geração de Credenciais

Antes da criação final, o portal permite uma revisão dos dados.

• Preview: Visualize como as informações aparecerão para garantir que tudo esteja correto.
• Geração de Chaves: Ao salvar, o sistema gera e exibe imediatamente o Client ID e o Client Secret da sua aplicação.

Ciclo de Vida e Homologação

Após a criação, sua aplicação entra em um ciclo de vida gerenciado pelo Dashboard de Gerenciamento.

1. Estado de Rascunho (Draft)

• Edição Livre: Enquanto estiver em "Rascunho", você pode editar todos os campos livremente.
• Isolamento: O app não fica visível para nenhum lojista da base produtiva.
• Validação Técnica: O app é injetado automaticamente nas Lojas de Teste vinculadas à sua conta de desenvolvedor para que você valide a renderização e funcionalidade.

2. Solicitação de Homologação

• Gatilho: Quando o app estiver pronto, utilize o botão "Solicitar Publicação".
• Bloqueio: O status mudará para "Em Revisão", e a aplicação ficará bloqueada para edições enquanto o time Aiqfome avalia os dados.

3. Publicação ou Reprovação

• Aprovação: Caso aprovado, o status muda para "Publicado", tornando o app visível na vitrine pública para todos os lojistas.
• Imutabilidade: Um app publicado não permite edição direta para garantir a segurança dos dados. Para atualizações, será necessário criar uma nova versão.
• Reprovação: Caso seja "Reprovado", você receberá o motivo. O app pode retornar ao estado de "Rascunho" para correções.

4. Gerenciamento de Status

• Desativação: Você pode desativar o app a qualquer momento informando um motivo (ex: manutenção). O app sai da vitrine imediatamente e o status passa a ser "Desativado".
• Ativação: Um app desativado pode ser reativado sem necessidade de nova aprovação, voltando a aparecer para toda a base.