Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 8 Próxima »

Índice

Introdução 

Este documento tem como objetivo orientar, de forma clara e objetiva, o processo completo de ativação de uma loja para operação com a plataforma 99 Foods por meio do sistema Degust One (retaguarda).

A integração envolve a geração de um identificador único (UUID), o cadastro no portal da 99 Foods, a configuração no Degust One e a vinculação dos produtos e formas de pagamento para garantir o recebimento correto dos pedidos.

O processo é dividido em etapas sequenciais e ilustradas, facilitando a aplicação por equipes técnicas de implantação e suporte.

Ao final do procedimento, a loja estará habilitada a receber e processar pedidos da 99 Foods de forma integrada, segura e automatizada.

Principais pontos abordados:

  • Geração e uso do UUID da loja

  • Vinculação no portal da 99 Foods (developer e merchant)

  • Configuração no sistema Degust One

  • Mapeamento das formas de pagamento

  • Associação dos produtos com o cardápio da 99 Foods

  • Checklist técnico de validação final

Todas as URLs, credenciais e exemplos utilizados neste guia foram validados e são compatíveis com a versão atual da plataforma.

Passo 1:

1- Link de Vinculação

  1. No portal Gerenciamento de Aplicativo, acesse:

    1. Gerenciamento da Loja

    2. Aba Vincular Estabelecimento

  2. Clique em Autorização de solicitação de lote

  3. Escolha o aplicativo de Produção previamente criado

  4. Selecione “Hub Delivery” como tipo de integração (conforme a tela)

  5. Copie o Link do Convite gerado e envie para o administrador da loja


Passo 2:

2 - Autorização da Loja

O manager da loja deve clicar no link recebido, selecionar a loja desejada e clicar em Autorizar para confirmar.

Passo 3:

3- Vinculação da Loja

  1. A integradora visualizará na aba Store Binding todas as lojas autorizadas

  2. Clicar em Bind

  3. Preencher o campo appshopid que será a identificação da loja (ex.: loja3_9303)

  4. Confirmar


Passo 4:

4- Vinculação Finalizada

Agora ao acessar:

  1. Gerenciamento de Aplicativo

  2. Gerenciamento de Loja

  3. Gerenciar estabelecimentos em lote

É possível visualizar todas as lojas vinculadas, inclusive a nova já configurada, com seu AppShopId.

Passo 5:  

5- Vincular os Dados da Loja no Degust One (Retaguarda)

Após a loja ser vinculada com sucesso no portal da 99 Foods, ela passará a aparecer na listagem de estabelecimentos integrados. Agora, o próximo passo é configurar os dados dessa loja no sistema Degust One através da retaguarda administrativa.

1. Acesse o Degust One

🔗 https://degustone.com.br/ 

Realize o login com suas credenciais de acesso. 

2. Selecione a loja desejada

Na tela inicial, escolha a loja que será integrada ao Hub Delivery com a 99 Foods.

3. Navegue até a seção de configuração

No menu principal, siga o caminho: 

Cadastro > Loja > Configuração de Loja > Aba "Hub Delivery" 

Essa aba é responsável por centralizar todas as configurações relacionadas às integrações com plataformas de delivery, como a 99 Foods. 

Atenção: Certifique-se de estar configurando a loja correta antes de prosseguir.


 

Passo 6:  

6- Incluir a 99 Foods como Parceiro no Degust One

Com a aba "Hub Delivery" aberta na configuração da loja no Degust One, agora é hora de adicionar a 99 Foods como parceiro e inserir os dados de integração.

1. Clique em "Incluir Parceiro"

Na aba Hub Delivery, localize e clique no botão "Incluir Parceiro".

2. Selecione a opção 99 Foods

Na lista de parceiros disponíveis, escolha a opção 99 Foods.

3. Preencha os campos de autenticação:

  • X-App-MerchantId: 
     Insira o AppShopId gerado anteriormente. 
     Exemplo: loja3_9303

 

  • ClientId: 
     Sempre utilize o prefixo 5764607629039502650_ seguido do AppShopId. 
     Exemplo: 5764607629039502650_loja3_9303 

 

  • ClientSecret: 9b4188a777b2a3aa850c81f47abd80aa 
     Valor fixo fornecido pela 99 Foods para autenticação: 

 

Importante: Verifique se os campos foram preenchidos corretamente, principalmente o UUID. Um erro de digitação impedirá a autenticação com a 99 Foods. 


Exemplo Visual: 

Passo 7:

7- Configuração das Formas de Pagamento 

Com a loja devidamente vinculada e os dados de integração preenchidos, ela já está apta a receber pedidos da 99 Foods. No entanto, para que os pedidos sejam importados corretamente no sistema Degust One, é essencial configurar as formas de pagamento correspondentes. 

Essa etapa garante que o sistema interprete corretamente os métodos de pagamento utilizados pelos clientes na plataforma da 99 Foods, associando-os às formas existentes no seu PDV.


Passo 8:

8- Vincular os SKUs dos Produtos ao Cardápio da 99 Foods 

Após configurar a loja e as formas de pagamento, é necessário vincular os produtos cadastrados na retaguarda (Degust One) com os itens do cardápio na 99 Foods. Essa etapa garante que, ao receber um pedido, o sistema consiga identificar corretamente os produtos vendidos.

1.  Acesse o portal de gestão de loja da 99 Foods

🔗 https://merchant.99app.com/pt-BR/store 

Faça login com as credenciais da loja.


2. Navegue até o cardápio da loja

  • No painel da loja, acesse o menu de Cardápio. 
  • Localize os itens que estão ativos no cardápio e serão utilizados na integração com o Degust One. 


3. Vincule o Código de Integração

Para cada produto listado: 

  1. Clique para editar o item. 
  2. No campo Código PDV, insira o Código de Integração do produto correspondente no Degust One Retaguarda (esse código é definido no cadastro de produto no sistema). 
  3. Salve a alteração. 

Feito isso, o produto estará configurado corretamente para integração. 

Atenção: Certifique-se de que o Código PDV informado seja exatamente igual ao código de integração no Degust One. Isso é fundamental para que os pedidos sejam associados corretamente no momento da importação. 


Exemplo Visual: 


 

Checklist Final

Checklist Final – Ativação de Loja na 99 Foods via Degust One 

Antes de considerar a configuração finalizada, revise cada item abaixo: 

Configuração Técnica 

  • UUID da loja gerado e salvo corretamente. 
  • Loja vinculada com sucesso no portal de desenvolvedor da 99 Foods. 
  • Loja aparece na listagem de estabelecimentos vinculados. 

Configuração no Degust One (Retaguarda) 

  • Acesso à aba Hub Delivery concluído. 
  • Parceiro 99 Foods adicionado. 
  • Campos preenchidos corretamente: 
  • X-App-MerchantId com o UUID 
  • ClientId no formato 5764607629039502650_<UUID> 
  • ClientSecret com valor fixo 9b4188a777b2a3aa850c81f47abd80aa 

Formas de Pagamento 

  • Formas de pagamento da 99 Foods mapeadas no sistema. 
  • Cada método (online, dinheiro, cartão) vinculado a uma forma válida no Degust One. 

Cardápio e Produtos 

  • Produtos localizados no cardápio da 99 Foods. 
  • Código de Integração do Degust One vinculado corretamente no campo Código PDV de cada item. 

Validação Final 

  • Pedido de teste realizado e recebido no Degust One. 
  • Produtos corretos foram importados. 
  • Formas de pagamento interpretadas corretamente. 
  • Nenhum erro de SKU, valor ou comunicação. 

Se todos os itens acima estiverem marcados como concluídos, a loja está 100% pronta para operar com a 99 Foods. 

  • Sem rótulos