INTEGRAÇÃO RAPPI
A integração com o Rappi Restaurante permite centralizar os pedidos do Rappi no PDV 2.0 da CPlug, facilitando a operação e reduzindo lançamentos manuais. A integração também permite trabalhar com recebimento automático de pedidos, vínculo de método de pagamento e vendedor, além da exportação do cardápio.
Importante: a CPlug integra somente a modalidade Rappi Restaurante. Outras modalidades do Rappi não são contempladas pela integração.
Informações importantes
| Item | Informação |
|---|---|
| Módulos necessários | Delivery e Integração Delivery |
| PDV | PDV 2.0 |
| Modalidade integrada | Rappi Restaurante |
| Exportação de cardápio | Sim |
| Recebimento automático | Sim |
| Método de pagamento | Pode ser vinculado à integração |
| Vendedor | Pode ser definido como padrão |
| Modelos de integração | Menu Automático ou Self Mapping |
| Pedido de teste | Necessário para validar a integração |
A integração pode ser realizada de duas formas: Menu Automático ou Self Mapping. O Menu Automático é o modelo recomendado, pois reduz a possibilidade de erros no vínculo dos produtos.
1. Solicite as credenciais da integração
Antes de iniciar a configuração, confirme que o cliente utiliza Rappi Restaurante.
Envie os dados da loja no grupo de WhatsApp da Rappi + CPlug:
| Dados necessários |
|---|
| Empresa |
| CEP |
| Endereço |
| Bairro |
| Cidade/UF |
| E-mail da loja no Rappi |
| Modelo de integração: Menu Automático ou Self Mapping |
O prazo informado para retorno das credenciais é de até 24 horas após o envio das informações.
2. Configure a integração no ERP
Acesse:
ERP > Engrenagem > Integrações > Rappi
Selecione a integração Rappi e informe as credenciais recebidas pelo time Rappi.
Nesta configuração, também será necessário definir:
- Método de pagamento online
- Vendedor vinculado à venda
- Código para pedidos
- Código para exportação do cardápio
- Tipo de exportação do menu
3. Escolha o modelo de integração
Menu Automático
É o modelo recomendado para a integração.
Nesse cenário, a comunicação ocorre via API e os produtos são exportados do ERP/CPlug para o Rappi. É o modelo normalmente utilizado para novas contas Rappi.
Self Mapping
Neste modelo, os produtos são vinculados manualmente por meio da chave de integração.
É um cenário menos indicado, pois exige que o usuário replique manualmente as chaves dos produtos no Rappi, aumentando a possibilidade de erros. Normalmente é utilizado quando o cliente já possui uma conta Rappi e deseja realizar o vínculo manual dos produtos.
| Modelo | Como funciona | Recomendação |
|---|---|---|
| Menu Automático | Produtos exportados pela CPlug para o Rappi | Recomendado |
| Self Mapping | Produtos vinculados manualmente pela chave de integração | Menos indicado |
4. Menu Automático
4.1 Crie uma lista de preços
Crie uma Lista de Preços contendo os produtos que serão disponibilizados no Rappi.
Caminho:
ERP > Estoque > Produtos
A lista de preços será utilizada durante a exportação do cardápio.
4.2 Exporte o cardápio
Após selecionar os produtos:
- Clique em Exportar para Delivery.
- Selecione a integração Rappi.
- Defina o tipo de exportação.
- Selecione a Lista de Preços.
- Clique em Exportar.
Tipos de exportação
| Opção | Funcionamento |
|---|---|
| Venda pausada | Os produtos são enviados ao cardápio do Rappi, mas permanecem pausados e não ficam disponíveis para compra. |
| Disponível para venda | Os produtos são enviados ao cardápio e ficam disponíveis para o cliente final. |
Para maior segurança, o material recomenda realizar inicialmente a exportação como venda pausada, permitindo conferir os produtos antes de disponibilizá-los para venda.
5. Self Mapping
No modelo Self Mapping, o vínculo dos produtos é realizado diretamente no Portal Partners do Rappi.
Acesse:
Partners Rappi > Cardápio/Menu
Selecione individualmente cada produto que deseja integrar.
No campo SKU, informe a Chave de Integração correspondente ao produto cadastrado no ERP/CPlug.
Como consultar a chave de integração
No ERP:
ERP > Estoque > Produtos
Ative a opção Exibir chave de integração para visualizar a chave correspondente ao produto.
6. Integração de atributos
Os produtos que utilizam atributos também podem ser integrados.
| Modelo | Funcionamento dos atributos |
|---|---|
| Menu Automático | Os atributos são exportados automaticamente. |
| Self Mapping | É necessário relacionar manualmente a chave de integração de cada atributo na seção Toppings do Partners/Rappi. |
No Self Mapping:
- Acesse o respectivo Topping no Partners/Rappi.
- Informe a chave de integração correspondente ao atributo cadastrado no ERP/CPlug.
- Clique em Editar Topping.
- Após finalizar os vínculos, clique em Enviar para revisão.
7. Ativação e teste da integração
Após concluir a configuração no ERP e o cadastro ou exportação dos produtos, o analista CPlug deve acionar o time Rappi no grupo de WhatsApp para:
- Agendar a integração.
- Solicitar o envio de um pedido de teste.
Após o recebimento do pedido de teste no PDV, a integração é considerada funcional e validada.
8. Boas práticas para recebimento dos pedidos
Caso os pedidos não estejam chegando ao PDV, verifique os seguintes pontos:
| Verificação | O que conferir |
|---|---|
| Integração no Rappi | Deve estar ativa e funcionando corretamente. |
| Java | Manter a versão mais recente instalada. |
| PDV e CPServer | Utilizar versões atualizadas. |
| Credenciais | Conferir as credenciais cadastradas no ERP. |
| Servidor | Se houver mais de um servidor, conferir o vínculo no ERP. |
| Cardápio | Confirmar a exportação pela lista de preços configurada para a integração. |
| Sincronização | Sincronizar o PDV após alterações realizadas no ERP. |
| Horários | Conferir se a loja está aberta e com os horários configurados no Partners Rappi. |
| Portal Aliados | Confirmar que o portal Aliados esteja fechado. |
Essas verificações ajudam a garantir que os pedidos sejam corretamente recebidos no PDV.
9. Novidades no PDV 2.0
A partir da versão 2.10.7, a integração Rappi passou a contar com melhorias no gerenciamento dos pedidos.
Abertura e fechamento da loja
É possível realizar a abertura e o fechamento da loja diretamente pela Área Administrativa do PDV.
Para utilizar esse recurso, o horário de funcionamento da loja deve estar previamente configurado no portal Rappi.
Código de coleta do motoboy
O código de coleta atribuído ao motoboy passou a ser exibido na tela de pedidos delivery e também na impressão do pedido.
Isso facilita a conferência do pedido no momento da retirada e melhora a rastreabilidade da entrega.
Dúvidas frequentes
| Dúvida | Resposta |
|---|---|
| É possível integrar qualquer modalidade do Rappi? | Não. A integração contempla somente o Rappi Restaurante. |
| É possível exportar o cardápio? | Sim. O Menu Automático permite exportar os produtos do ERP/CPlug para o Rappi. |
| É possível fazer o vínculo manual dos produtos? | Sim, pelo modelo Self Mapping. |
| Qual modelo é recomendado? | Menu Automático, por reduzir a possibilidade de erros manuais. |
| É possível integrar atributos? | Sim. No Menu Automático são exportados automaticamente; no Self Mapping, devem ser vinculados manualmente pelos Toppings. |
| É possível receber pedidos automaticamente? | Sim. |
| É necessário realizar pedido de teste? | Sim. O pedido de teste deve ser solicitado ao time Rappi após a configuração. |
| Como validar a integração? | Após o recebimento do pedido de teste no PDV. |
Atenção: as configurações e procedimentos de integração podem ser atualizados pelo Rappi. Em caso de divergência, consulte os procedimentos vigentes junto ao time responsável pela integração.
Com a configuração concluída e o pedido de teste recebido no PDV, a integração Rappi estará validada e pronta para a operação.