🚀 Novo Fluxo de Criação de Aplicativos de Integração (API V2)

Fala, comunidade!

Temos novidades quentes no Portal do Desenvolvedor! Reformulamos o processo de criação de Aplicações de Integração (API V2) para tornar sua jornada muito mais ágil e focada no que importa: a sua solução de negócio.

:rocket: O que mudou? A principal mudança é que agora não teremos mais um ambiente de sandbox separado. O fluxo agora é direto para o ambiente de produção, mas com toda a segurança que você precisa.

Enquanto sua aplicação estiver no estado de Rascunho, ela permanece isolada e não fica visível para nenhum lojista da base produtiva. Nesse estágio, você pode (e deve!) realizar todos os seus testes técnicos utilizando as Lojas de Teste vinculadas à sua conta de desenvolvedor.

A grande sacada: Mesmo com o app em rascunho, você já consegue gerar o code (AUTHORIZATION_CODE) diretamente no portal para sua loja de teste. Isso permite que você valide o fluxo completo da sua aplicação em ambiente real antes mesmo de solicitar a homologação para toda a base.

:hammer_and_wrench: Passo a Passo para sua Nova Integração:

  • Seleção do Tipo: Ao iniciar o cadastro, escolha a opção “Aplicativo de Integração”. Este fluxo é exclusivo para quem vai gerenciar pedidos, itens e o funcionamento interno das lojas via API V2.

  • Informações e CNPJ: Preencha os dados técnicos e de contato. Fique atento: o sistema valida o CNPJ automaticamente e não permite avançar se houver inconsistências.

  • Escopos e Categoria: Defina se sua solução atende Restaurantes, Mercados, Logística ou Soluções e marque exatamente quais dados de escopo (Pedidos, Itens ou Loja) você precisará acessar.

  • Identidade e Design: É obrigatório seguir nossas Diretrizes de Design. Isso inclui padrões para o nome da aplicação, logotipo e a clareza nas URLs de Termos de Uso e Privacidade. Certifique-se de que tudo esteja visualmente correto antes de enviar para análise.

  • Credenciais: Revise tudo no preview e gere seu Client ID e Client Secret na hora. Lembre-se de guardá-los em local seguro!


:counterclockwise_arrows_button: Ciclo de Aprovação:

  1. Rascunho: Edite o que precisar e aproveite para gerar o code e testar sua integração em sua loja de teste.

  2. Solicitar Aprovação: Tudo pronto e testado? Clique no botão no dashboard. O status mudará para “Em Revisão” e o time aiqfome validará as informações (nesta fase, a edição fica bloqueada).

  3. Publicado: Uma vez aprovado, seu app ganha o status “Publicado” e, finalmente, torna-se funcional para integração com lojas reais de toda a base de Sellers do aiqfome!

:warning: Ponto de atenção: Após a publicação, os dados tornam-se imutáveis para garantir a segurança dos lojistas. Além disso, por segurança operacional, aplicações de integração não possuem opção de desativação manual pelo parceiro.