| Índice |
|---|
| indent | 20 |
|---|
| exclude | Índice |
|---|
| style | none |
|---|
| printable | false |
|---|
|
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 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 1: |
|---|
|
1- Gerar o UUID da LojaO 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
|
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | 🌐 URLs e Endpoints da Aplicação |
|---|
| 🌐
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 1: Passo 2: |
|---|
|
2- Vincular a Loja no Portal da 99 Foods |  Image RemovedCom 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: 
|
...
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 2: 3: |
|---|
|
3- 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. |
 |
...
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 3: 4: |
|---|
|
4- Incluir a 99 Foods como Parceiro no Degust | One OneCom 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.
Exemplo: 4e5b6fd0-2c7d-40fd-b73e-20a91f889bf6
- ClientId:
Sempre utilize o prefixo 5764607629039502650_ seguido do UUID.
Exemplo: 5764607629039502650_4e5b6fd0-2c7d-40fd-b73e-20a91f889bf6
- 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: 
|
...
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 45: |
|---|
|
| 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. 
|
...
| Painel |
|---|
| titleColor | #FFB200 |
|---|
| borderWidth | 3 |
|---|
| titleBGColor | #5B2E90 |
|---|
| title | Passo 5: 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.
- 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.
- Navegue até o cardápio da loja
- No painel da loja, acesse o menu de Cardápio.
Passo 6: |
6- 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: - Clique para editar o item.
- 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).
- 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: 
|
...