Diferente de outras plataformas, o próprio cliente ou o suporte (com o acesso do cliente) autoriza a Alterdata como software integrador.

1. Acesse o Portal do Parceiro iFood.

2. Vá em Serviços / Aplicativos.

3. Busque por Alterdata ou Spice.

4. Clique em Autorizar. Após a autorização, o iFood libera as chaves de acesso para a integração.

 Para configurar o Hub, você precisará identificar os dados exclusivos da loja.

1. No Portal do Parceiro iFood, anote o ID da Loja (geralmente visível na URL do navegador ou nas configurações de perfil).

2. Certifique-se de que o status da loja aparece como "Integrado" após o aceite no passo anterior.

Com a autorização realizada, o Suporte Alterdata deve vincular a loja ao nosso ecossistema.

1. Acesse o Portal Delivery Alterdata.

2. Cadastrar Loja: Utilize o ID da Loja (ID Externo) coletado no portal do iFood.

3. Criar Aplicativo: Vá em criar novo aplicativo e utilize o padrão: iFood - CRM - [Nome da Empresa].

4. Configurar Chaves: Insira o Client ID e Secret fornecidos pela integração padrão do iFood para a Alterdata.

A etapa final ocorre dentro do software PDV para garantir que o pedido chegue à cozinha.

1. No Spice, acesse Funções Administrativas / Configurações / Integrações / Hub de pedidos.

2. Marque a opção "Recebo e controlo pedidos de parceiros pelo Spice".

3. De-Para de Formas de Pagamento: Relacione as formas de pagamento do iFood (ex: iFood Online, iFood Offline) às cadastradas no Spice.

4. Produto Genérico: Em Integração / Produto, defina o Produto Genérico para evitar cancelamentos caso algum item do cardápio não esteja vinculado.

5. Configurações Gerais:
   
   

   • Defina a Máquina integradora (Servidor).

   • Marque "Esse terminal recebe pedidos do Hub".

   • Habilite o "Alerta sonoro para novos pedidos".
     
     

6. Pressione F9 (Confirmar) e certifique-se de que o Integrador.exe está em execução.

Dicas:

• Sincronização: Se os produtos não aparecerem, utilize a opção Exportar Produtos dentro do menu de integração do Spice para enviar seu cardápio ao Hub.
  
  Para identificar o Código do produto no PDV para fazer o vínculo com o iFood:
  
  

  1. Clique sobre o botão “Exportar Produtos / Exportar Planilha”, assim serão listados os itens e na coluna “Código PDV no provedor”.

  2. Feito isso, no portal do iFood, acesse a área “Cardápios” para cadastro do item ou edição.

  3. Informe o Código PDV na plataforma do iFood.
     Agora o cliente já pode fazer os pedidos no site ou no app do iFood.
     
     

• Logs: Em caso de erro na chegada de pedidos, verifique a opção "Esse terminal gera logs detalhados" para identificar falhas de comunicação.

 A integração utiliza o padrão Open Delivery, exigindo chaves específicas para autenticação.

1. Entre em contato com a equipe da Epadoca pelos canais:
   
   

   • WhatsApp: (11) 2770-0676

   • E-mail: suporte@epadoca.com
     
     

2. Solicite as seguintes credenciais:
   
   

   • MerchantID (ID do Lojista)

   • ClientId

   • ClientSecret

Com as chaves em mãos, é necessário que o suporte técnico da Alterdata habilite a plataforma na retaguarda do sistema.

1. Acesse o chat de suporte ao cliente (Karoo).

2. Informe ao atendente que possui as chaves da Epadoca e solicita a liberação da integração no Hub de Pedidos.

Para que o Spice reconheça os itens vendidos na Epadoca, os códigos internos do sistema (Código PDV) devem estar configurados na plataforma de pedidos.

1. No Spice, acesse Funções Administrativas / Configurações / Integrações / Hub de pedidos.

2. Marque a opção Recebo e controlo pedidos de parceiros pelo Spice.
   
   

   1. Realize o De-Para de Formas de Pagamento, relacionando as formas da Epadoca às cadastradas no Spice.

   2. Realize o De-Para de Taxa do Hub, relacionando as taxas do Spice.
   3. Em Integração / produto, informe o Produto genérico que substituirá produtos que não estiverem vinculados corretamente ao receber o pedido, evitando que o pedido seja cancelado por esse motivo.
   4. Em Exportar Produtos, escolha ação no processo de Exportação do Cardápio.
      
      

      1. Selecione a opção Exportar Planilha e clique em Avançar.

      2. Selecione os itens desejados e clique em Confirmar.

      3. O sistema gerará um arquivo. Clique em Abrir local do arquivo para salvar a planilha.
         
         

   5. Envie esta planilha ao suporte da Epadoca para que eles realizem o "De-Para" dos códigos no painel deles.
   6. Em Configurações gerais da integração:
      
      
      1. A Máquina integradora do Hub de Pedido.
         
      2. Marque a opção Esse terminal recebe pedidos do Hub para que esta máquina receba os pedidos do Hub.
         Faça isso no terminal que receberá os pedidos.
      3. Marque a opção Esse terminal gera logs detalhados e poderá  abrir a pasta de logs.
      4. Marque a opção Alerta sonoro para novos pedidos para habilitar as opções relacionadas.
         
         
3. Pressione F9 ou clique em Confirmar.

 O técnico do suporte Alterdata deve coletar os dados com o cliente e solicitar a ativação.

1. Coleta de Dados: Solicite ao cliente o ClientId, ClientSecret, MerchantId e o CNPJ/CPF.

2. Solicitação:
   
   

   • Se for Matriz: Preencha o Formulário de Liberação HUB - Jota Já.

   • Se for Unidade/Franquia: Abra um chamado para o setor de Canais solicitando a liberação.
     
     

3. Aguarde a confirmação de que a loja está "Ativa" no HUB.

Após a liberação no HUB, o técnico deve configurar o terminal do cliente.

1. Acesse Funções Administrativas / Configurações / Integração / Hub de Pedidos.

2. Marque: "Recebo e controlo pedidos de parceiros pelo Spice".

3. De-Para de Pagamento: Vincule as formas de pagamento do Jota Já às cadastradas no Spice.

4. Produto Genérico: Defina um código para itens sem vínculo (evita queda do integrador).

5. Terminal: Marque "Esse terminal recebe pedidos do Hub" e configure o alerta sonoro.

6. Clique em Confirmar (F9) e verifique se o Integrador.exe está rodando.

 O Cliente deve realizar o vínculo manual no portal do Jota Já para que os itens sejam reconhecidos. O suporte pode orientar fornecendo a planilha.

1. Suporte: Gere a planilha em Exportar Produtos > Exportar Planilha e entregue ao cliente.

2. Cliente: No Portal Administrativo do Jota Já, acesse o Cardápio.

3. Cliente: No campo SKU de cada produto, insira o Código Externo (Iddetalhe) que consta na planilha do Spice.

   Observação: Se o SKU no portal Jota Já estiver diferente do Código Externo do Spice, o pedido será rejeitado ou cairá como "Produto Genérico". 

Dicas

• Cupons de Desconto: O suporte deve orientar o cliente que descontos do Jota Já aparecem como "Subsídio" no Spice.

• Logs: Se o pedido não subir, o suporte deve verificar a pasta de logs no terminal integrador para validar se o erro é de SKU (vínculo de produto).

O processo de aquisição de uma conta na Qlub para o seu estabelecimento, é feito mediante um contato direto com a equipe comercial da plataforma, pois a solução requer uma integração técnica com o seu sistema de caixa (PDV).

1. Acesse o site: Vá para qlub.com.br.

2. Preencha o formulário: Clique em "Solicitar Apresentação". Você precisa informar dados como:
   
   

   • Nome e e-mail corporativo.

   • Sistema de PDV que utiliza.

   • Faturamento mensal estimado.

   • Modo de operação (Mesa ou Comanda).
     
     

3. Aguarde o contato: Um consultor entrará em contato para agendar uma demonstração, validar a compatibilidade com seu software atual e apresentar a proposta comercial.

1. Acesse as Funções Administrativas / Configurações / Integrações / Qlub.
2. Marque a opção Trabalho integrado como o Qlub.
3. Leia as informações sobre essa integração. E clique em OK informar dados como:
   
   Informações Importantes para Ativar essa Integração

   Use apenas números no campo de número da mesa ou comanda, caracteres especiais não são permitidos.
   É preciso ter caixa aberto na máquina onde o Serviço API do Spice está instalado. (na primeira versão desta integração com Spice)
   Pedidos do Abrahão não podem ser pagos parcialmente pela plataforma Qlub. (na primeira versão desta integração com Spice)
   Para pedidos do Abrahão integrarem com Qlub, o Spice não pode ser configurado para trabalhar com mesa fixa.

   
   
   • Nas Configurações gerais, informe Porta de Comunicação do Servidor (utilizada pela API), Domínio (Endereço do domínio da API, se é local ou não) e URL da loja (na plataforma Qlub).

   • Configurações de NFC-e e Automação, você pode definir se ao finalizar o pagamento no celular, se a NFC-e será ou não gerada.

     
     Por padrão, o sistema irá sugerir a marcação da opção Gerar NFC-e automaticamente no Spice apóis o pagamento da conta no Qlub.
     Caso desmarque essa opção, é necessário acessar o ALT + V (Impressão da Venda / Nota - Spice) manualmente para emitir a NFC-e de cada pedido por lá.
     
     
   • (Opcional) Marque a opção Trabalho com o cashback do Qlub e relacione a forma de pagamento ao Cashback.
     
     Cashback que for resgatado pelo Qlub é considerado um desconto na conta. Quando o cliente usar o saldo Qlub para abater a conta, o valor apareça corretamente discriminado no seu fechamento de caixa.
     
     
   • Na parte inferior da tela, relacione as formas de pagamentos do Spice que serão utilizadas por seus clientes no pagamento da conta pelo Qlub.
     
     
4. Pressione F9 ou clique em Confirmar.

 O sistema permite pagamentos parciais mistos (parte no Spice/Comanda e parte no Qlub). O fechamento da mesa ocorrerá conforme as regras abaixo:

• Pagamento via Qlub: Independentemente da configuração de "Liberar mesa ao completar pagamento na POS"*, os pagamentos via Qlub finalizam a venda automaticamente ao atingir o valor total.
  (* Localizada em: Funções Administrativas / Configurações / Comanda Alterdata / Outras configurações.)

• Divisão de Contas:

  • Se o restante da conta for pago no Qlub, o sistema direciona o pagamento para o caixa que possui a API ativa.

  • Se o restante for pago no Spice, o crédito vai para o caixa que realizou a operação manual.

  • Se o restante for pago na Comanda Alterdata, o crédito vai para o caixa ao qual a comanda está apontada.

Observação: Se a tela de recebimento estiver aberta no Spice (computador), o cliente não conseguirá pagar via Qlub simultaneamente para evitar conflitos de dados (Lock de tabela).

• Caixa Aberto: É obrigatório ter um caixa aberto na máquina onde a API está instalada para que os pagamentos apareçam nos relatórios e no ALT+V (Impressão da Venda / Nota - Spice).

• Itens não exibidos no Qlub: Adicionais gratuitos, itens de rodízio, massas e bordas de pizza não aparecem na visualização da conta do cliente no celular, mas o valor total estará correto.

• Pedidos Origem Abrahão: Não permitem pagamentos parciais via Qlub nesta versão.

• Cancelamentos: Estornos de valores devem ser solicitados diretamente pelo painel da Qlub; o Spice registra a baixa, mas não processa a devolução financeira de cartões.

Resumidamente: Basta escanear o QR Code na mesa de um restaurante parceiro e pagar via Pix ou cartão direto no navegador do celular.

• Escaneamento: O cliente escaneia um QR Code na mesa ou aproxima o celular de um dispositivo NFC.

• Visualização: O cardápio digital ou a conta detalhada aparece instantaneamente no navegador do celular (não é necessário baixar nenhum aplicativo).

• Divisão e Gorjeta: A plataforma permite dividir a conta facilmente entre os amigos (por valor ou por itens específicos) e adicionar gorjeta.

• Pagamento: O pagamento é feito via Pix ou cartões de crédito/débito.

A autenticação segue o padrão de chaves inseridas no portal delivery.

1. Acesse o Portal Delivery Alterdata.

2. Cadastrar Loja: Utilize o ID da Loja e o Token gerados no ambiente da VocêQpad.

3. Vincule a loja ao integrador correspondente.

A configuração no Spice garante que os pedidos cheguem à cozinha.

1. No Spice, acesse Funções Administrativas / Configurações / Integrações / Hub de pedidos.

2. Marque a opção Recebo e controlo pedidos de parceiros pelo Spice.

3. Produto Genérico: É obrigatório definir o Produto Genérico.
   
   Como o cliente não tem painel para gerir produtos, o risco de divergência de códigos é alto.
   
   

4. De-Para de Pagamento: Realize o vínculo das formas de pagamento conforme o padrão da VocêQpad.

5. Máquina Integradora: Ative o terminal receptor e o alerta sonoro.

Diferente de outras plataformas, o cliente não possui autonomia total no painel.

1. O Suporte Alterdata deve fornecer a planilha de Código Externo (Iddetalhe) ao cliente.

2. O Cliente deve enviar essa planilha/códigos para o grupo de WhatsApp da VocêQpad e solicitar o cadastro/vínculo dos produtos no App.

O Suporte deve orientar o cliente sobre as seguintes limitações da VocêQpad:

• Sem Retorno de Status: O sistema não avisa o app quando o pedido "Saiu para Entrega" ou foi "Entregue". O controle é apenas interno no Spice.

• Gestão de Pedidos: Não existe painel/gestor de pedidos externo. Tudo deve ser controlado pelo Spice.

• Pedidos "Imortais": O pedido não expira e não finaliza sozinho. O lojista deve obrigatoriamente aceitar e, posteriormente, finalizar ou cancelar cada pedido manualmente.

• Cancelamentos: Não é possível cancelar pelo App. O cliente deve solicitar o cancelamento no grupo de WhatsApp da VocêQpad.

• Status da Loja: A consulta de status não é disponibilizada (a loja pode aparecer como "Restrita" em algumas consultas, mas operando normalmente).