Versões comparadas

Versão antiga 2

changes.mady.by.user Mario Augusto Boschiero Moretto

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Kevenny Capitulino Costa

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice

Índice
indent20
excludeÍndice
stylenone
printablefalse

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.


Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 1:

1- Gerar o UUID da Loja

O primeiro passo para ativar uma loja para operar com a 99 Foods no sistema é gerar um identificador único, conhecido

...

como UUID (Universally Unique Identifier). Esse identificador será utilizado para vincular a loja ao serviço da 99 Foods de forma segura e exclusiva. 

Para gerar um UUID, recomendamos utilizar a ferramenta online disponível em: 

...

🔗 https://www.guidgenerator.com/ 

Acesse o site e clique no botão “Generate” para criar o identificador.

O UUID gerado terá um formato semelhante a este: 

Image Modified



🌐

Image Removed

Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
title🌐 URLs e Endpoints da Aplicação
Passo 2:

Image Added

1- Link de Vinculação

  1. Acesse o portal developer da 99Food pelo link: https://developer-food.99app.com/
  2. Clique em Entrar, insira o DDD do Brasil, insira o número de telefone 14 981431960 e a senha Hubd3l1v3ry!! e clique no botão Entrar

  3. No portal Gerenciamento de Aplicativo, acesse:

    1. Gerenciamento da Loja

    2. Aba Vincular Estabelecimento

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

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

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

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

Image Added




Image Removed

Com o UUID gerado, o próximo passo é realizar o vínculo da loja com a 99 Foods por meio do portal de desenvolvedores. Siga as etapas abaixo:1.  Acesse o portal de desenvolvedor da 99 Foods: 🔗 https://developer-food.99app.com/pt-BR/home 
Importante: Faça login utilizando as credenciais fornecidas pelo time de suporte. Esse acesso é necessário para visualizar e alterar os dados da integração.

2. Navegue até o menu de gerenciamento da loja:

  • Após o login, clique na aba "Gerenciamento de Aplicativo". 
  • No menu lateral, selecione a opção "Gerenciamento da Loja"

3. Vincule o estabelecimento:

  • Clique em "Vincular estabelecimento". 
  • Preencha os seguintes campos: 
  • UUID: cole o identificador gerado no passo anterior. 
  • Nome da loja: insira o nome comercial da loja que será integrada. 

Após preencher os dados, confirme a operação. 

Dica: Verifique se o UUID foi colado corretamente e se o nome da loja está de acordo com o cadastro interno do seu sistema. 

Exemplo Visual: 

Image Removed
Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 1: Vincular a Loja no Portal da 99 Foods 
3:

Image Added

2 - Autorização da Loja

Faça o login com o usuário e senha da loja 99Food do cliente, é necessário que a permissão do usuário seja de Super-administrador;

*Quando se tratar uma grande rede de lojas (ex: Milky Moo, Halipar), o usuário super-administrador, na maior parte dos casos é controlado pela franqueadora e não pela loja..

Abra o link, selecione a loja que irá integrar e clique em Autorizar.

Image Added


Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 4:

Image Added

3- Vinculação da Loja

  1. A integradora visualizará na aba Vincular estabelecimento todas as lojas autorizadas

  2. Clicar em Vincular

  3. Preencher o campo appshopid que será a identificação da loja (gerar no formato UUID)

  4. Confirmar

Image Added


Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 5:

Image Added

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.

Image Added


 
Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 2: 6:  

Image Added

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

Image Removed

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. 

Aviso

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


 

...

One 
Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 3: 7:  

Image Added

6- Incluir a 99 Foods como Parceiro no Degust

Image Removed

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 UUID gerado no primeiro passo AppShopId gerado anteriormente (UUID/GUID). 
     Exemplo: 4e5b6fd081546f00-2c7d80ab-40fd485e-b73eafda-20a91f889bf6 5594be9738bc

 

  • ClientId: 
     Sempre utilize o prefixo 5764607629039502650_ seguido do UUID AppShopId. 
     Exemplo: 5764607629039502650_4e5b6fd081546f00-2c7d80ab-40fd485e-b73eafda-20a91f889bf6 5594be9738bc

 

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

 

Nota

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: 

Image RemovedImage Added


Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 48:

Image Added

7- Configuração das Formas de Pagamento 

Image Removed

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.

Se preferir, pode subir a seguinte planilha na retaguarda para carregar automaticamente os finalizadores:

View file
nameReceitas 99Food.xlsx
height250

Apenas se certifique de validar se os códigos de finalizadores já não estão sendo utilizados pela loja, nesse caso, basta apenas substitui-los por outros que estão livres.


Image Removed

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. 

  1. Navegue até o cardápio da loja
  • No painel da loja, acesse o menu de Cardápio.
Passo 6:
Painel
titleColor#FFB200
borderWidth3
titleBGColor#5B2E90
titlePasso 5: Vincular os SKUs dos Produtos ao Cardápio da 99 Foods 
9:

Image Added

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. 

Aviso

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: 


 

Dica
titleChecklist 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. 

...