# INTEGRAÇÃO COM RAPPI

# 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.

##### [<iframe allowfullscreen="allowfullscreen" frameborder="0" height="292" src="//www.youtube.com/embed/6CMV6gqaMfg" title="Webinar: Integração CPlug + Rappi" width="520"></iframe>

 ](https://drive.google.com/file/d/1tWrsBZhXm6EdRffJbN2LPeeFCVQ8dvgL/view?usp=share_link)

##### **Informações importantes**

<div id="bkmrk-item-informa%C3%A7%C3%A3o-m%C3%B3du"><div><table class="w-fit min-w-(--thread-content-width)" data-end="1071" data-start="596"><thead data-end="617" data-start="596"><tr data-end="617" data-start="596"><th class="last:pe-10" data-col-size="sm" data-end="603" data-start="596">Item</th><th class="last:pe-10" data-col-size="sm" data-end="617" data-start="603">Informação</th></tr></thead><tbody data-end="1071" data-start="628"><tr data-end="688" data-start="628"><td data-col-size="sm" data-end="654" data-start="628">**Módulos necessários**</td><td data-col-size="sm" data-end="688" data-start="654">Delivery e Integração Delivery</td></tr><tr data-end="710" data-start="689"><td data-col-size="sm" data-end="699" data-start="689">**PDV**</td><td data-col-size="sm" data-end="710" data-start="699">PDV 2.0</td></tr><tr data-end="759" data-start="711"><td data-col-size="sm" data-end="738" data-start="711">**Modalidade integrada**</td><td data-col-size="sm" data-end="759" data-start="738">Rappi Restaurante</td></tr><tr data-end="796" data-start="760"><td data-col-size="sm" data-end="789" data-start="760">**Exportação de cardápio**</td><td data-col-size="sm" data-end="796" data-start="789">Sim</td></tr><tr data-end="833" data-start="797"><td data-col-size="sm" data-end="826" data-start="797">**Recebimento automático**</td><td data-col-size="sm" data-end="833" data-start="826">Sim</td></tr><tr data-end="895" data-start="834"><td data-col-size="sm" data-end="860" data-start="834">**Método de pagamento**</td><td data-col-size="sm" data-end="895" data-start="860">Pode ser vinculado à integração</td></tr><tr data-end="944" data-start="896"><td data-col-size="sm" data-end="911" data-start="896">**Vendedor**</td><td data-col-size="sm" data-end="944" data-start="911">Pode ser definido como padrão</td></tr><tr data-end="1008" data-start="945"><td data-col-size="sm" data-end="973" data-start="945">**Modelos de integração**</td><td data-col-size="sm" data-end="1008" data-start="973">Menu Automático ou Self Mapping</td></tr><tr data-end="1071" data-start="1009"><td data-col-size="sm" data-end="1031" data-start="1009">**Pedido de teste**</td><td data-col-size="sm" data-end="1071" data-start="1031">Necessário para validar a integração</td></tr></tbody></table>

</div></div>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**:

<div id="bkmrk-dados-necess%C3%A1rios-em"><div><table class="w-fit min-w-(--thread-content-width)" data-end="1680" data-start="1509"><thead data-end="1530" data-start="1509"><tr data-end="1530" data-start="1509"><th class="last:pe-10" data-col-size="md" data-end="1530" data-start="1509">Dados necessários</th></tr></thead><tbody data-end="1680" data-start="1537"><tr data-end="1548" data-start="1537"><td data-col-size="md" data-end="1548" data-start="1537">Empresa</td></tr><tr data-end="1556" data-start="1549"><td data-col-size="md" data-end="1556" data-start="1549">CEP</td></tr><tr data-end="1569" data-start="1557"><td data-col-size="md" data-end="1569" data-start="1557">Endereço</td></tr><tr data-end="1580" data-start="1570"><td data-col-size="md" data-end="1580" data-start="1570">Bairro</td></tr><tr data-end="1594" data-start="1581"><td data-col-size="md" data-end="1594" data-start="1581">Cidade/UF</td></tr><tr data-end="1622" data-start="1595"><td data-col-size="md" data-end="1622" data-start="1595">E-mail da loja no Rappi</td></tr><tr data-end="1680" data-start="1623"><td data-col-size="md" data-end="1680" data-start="1623">Modelo de integração: Menu Automático ou Self Mapping</td></tr></tbody></table>

</div></div>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 &gt; Engrenagem &gt; Integrações &gt; 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.

<div id="bkmrk-modelo-como-funciona"><div><div><table class="w-fit min-w-(--thread-content-width)" data-end="3220" data-start="2980"><thead data-end="3021" data-start="2980"><tr data-end="3021" data-start="2980"><th class="last:pe-10" data-col-size="sm" data-end="2989" data-start="2980">Modelo</th><th class="last:pe-10" data-col-size="md" data-end="3005" data-start="2989">Como funciona</th><th class="last:pe-10" data-col-size="sm" data-end="3021" data-start="3005">Recomendação</th></tr></thead><tbody data-end="3220" data-start="3036"><tr data-end="3123" data-start="3036"><td data-col-size="sm" data-end="3058" data-start="3036">**Menu Automático**</td><td data-col-size="md" data-end="3104" data-start="3058">Produtos exportados pela CPlug para o Rappi</td><td data-col-size="sm" data-end="3123" data-start="3104">**Recomendado**</td></tr><tr data-end="3220" data-start="3124"><td data-col-size="sm" data-end="3143" data-start="3124">**Self Mapping**</td><td data-col-size="md" data-end="3202" data-start="3143">Produtos vinculados manualmente pela chave de integração</td><td data-col-size="sm" data-end="3220" data-start="3202">Menos indicado</td></tr></tbody></table>

</div></div></div>##### **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 &gt; Estoque &gt; 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:

1. Clique em **Exportar para Delivery**.
2. Selecione a integração **Rappi**.
3. Defina o tipo de exportação.
4. Selecione a **Lista de Preços**.
5. Clique em **Exportar**.

##### Tipos de exportação

<div id="bkmrk-op%C3%A7%C3%A3o-funcionamento-"><div><table class="w-fit min-w-(--thread-content-width)" data-end="4050" data-start="3772"><thead data-end="3797" data-start="3772"><tr data-end="3797" data-start="3772"><th class="last:pe-10" data-col-size="sm" data-end="3780" data-start="3772">Opção</th><th class="last:pe-10" data-col-size="lg" data-end="3797" data-start="3780">Funcionamento</th></tr></thead><tbody data-end="4050" data-start="3808"><tr data-end="3939" data-start="3808"><td data-col-size="sm" data-end="3828" data-start="3808">**Venda pausada**</td><td data-col-size="lg" data-end="3939" data-start="3828">Os produtos são enviados ao cardápio do Rappi, mas permanecem pausados e não ficam disponíveis para compra.</td></tr><tr data-end="4050" data-start="3940"><td data-col-size="sm" data-end="3968" data-start="3940">**Disponível para venda**</td><td data-col-size="lg" data-end="4050" data-start="3968">Os produtos são enviados ao cardápio e ficam disponíveis para o cliente final.</td></tr></tbody></table>

</div></div>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 &gt; 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 &gt; Estoque &gt; 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.

<div id="bkmrk-modelo-funcionamento"><div><table class="w-fit min-w-(--thread-content-width)" data-end="5263" data-start="5003"><thead data-end="5043" data-start="5003"><tr data-end="5043" data-start="5003"><th class="last:pe-10" data-col-size="sm" data-end="5012" data-start="5003">Modelo</th><th class="last:pe-10" data-col-size="lg" data-end="5043" data-start="5012">Funcionamento dos atributos</th></tr></thead><tbody data-end="5263" data-start="5054"><tr data-end="5124" data-start="5054"><td data-col-size="sm" data-end="5076" data-start="5054">**Menu Automático**</td><td data-col-size="lg" data-end="5124" data-start="5076">Os atributos são exportados automaticamente.</td></tr><tr data-end="5263" data-start="5125"><td data-col-size="sm" data-end="5144" data-start="5125">**Self Mapping**</td><td data-col-size="lg" data-end="5263" data-start="5144">É necessário relacionar manualmente a chave de integração de cada atributo na seção **Toppings** do Partners/Rappi.</td></tr></tbody></table>

</div></div>No Self Mapping:

1. Acesse o respectivo **Topping** no Partners/Rappi.
2. Informe a chave de integração correspondente ao atributo cadastrado no ERP/CPlug.
3. Clique em **Editar Topping**.
4. 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:

<div id="bkmrk-verifica%C3%A7%C3%A3o-o-que-co"><div><table class="w-fit min-w-(--thread-content-width)" data-end="6808" data-start="6095"><thead data-end="6127" data-start="6095"><tr data-end="6127" data-start="6095"><th class="last:pe-10" data-col-size="sm" data-end="6109" data-start="6095">Verificação</th><th class="last:pe-10" data-col-size="md" data-end="6127" data-start="6109">O que conferir</th></tr></thead><tbody data-end="6808" data-start="6138"><tr data-end="6212" data-start="6138"><td data-col-size="sm" data-end="6164" data-start="6138">**Integração no Rappi**</td><td data-col-size="md" data-end="6212" data-start="6164">Deve estar ativa e funcionando corretamente.</td></tr><tr data-end="6267" data-start="6213"><td data-col-size="sm" data-end="6224" data-start="6213">**Java**</td><td data-col-size="md" data-end="6267" data-start="6224">Manter a versão mais recente instalada.</td></tr><tr data-end="6322" data-start="6268"><td data-col-size="sm" data-end="6289" data-start="6268">**PDV e CPServer**</td><td data-col-size="md" data-end="6322" data-start="6289">Utilizar versões atualizadas.</td></tr><tr data-end="6388" data-start="6323"><td data-col-size="sm" data-end="6341" data-start="6323">**Credenciais**</td><td data-col-size="md" data-end="6388" data-start="6341">Conferir as credenciais cadastradas no ERP.</td></tr><tr data-end="6465" data-start="6389"><td data-col-size="sm" data-end="6404" data-start="6389">**Servidor**</td><td data-col-size="md" data-end="6465" data-start="6404">Se houver mais de um servidor, conferir o vínculo no ERP.</td></tr><tr data-end="6559" data-start="6466"><td data-col-size="sm" data-end="6481" data-start="6466">**Cardápio**</td><td data-col-size="md" data-end="6559" data-start="6481">Confirmar a exportação pela lista de preços configurada para a integração.</td></tr><tr data-end="6636" data-start="6560"><td data-col-size="sm" data-end="6580" data-start="6560">**Sincronização**</td><td data-col-size="md" data-end="6636" data-start="6580">Sincronizar o PDV após alterações realizadas no ERP.</td></tr><tr data-end="6736" data-start="6637"><td data-col-size="sm" data-end="6652" data-start="6637">**Horários**</td><td data-col-size="md" data-end="6736" data-start="6652">Conferir se a loja está aberta e com os horários configurados no Partners Rappi.</td></tr><tr data-end="6808" data-start="6737"><td data-col-size="sm" data-end="6758" data-start="6737">**Portal Aliados**</td><td data-col-size="md" data-end="6808" data-start="6758">Confirmar que o portal Aliados esteja fechado.</td></tr></tbody></table>

</div></div>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**

<div id="bkmrk-d%C3%BAvida-resposta-%C3%89-po"><div><div><table class="w-fit min-w-(--thread-content-width)" data-end="8690" data-start="7748"><thead data-end="7769" data-start="7748"><tr data-end="7769" data-start="7748"><th class="last:pe-10" data-col-size="md" data-end="7757" data-start="7748">Dúvida</th><th class="last:pe-10" data-col-size="lg" data-end="7769" data-start="7757">Resposta</th></tr></thead><tbody data-end="8690" data-start="7780"><tr data-end="7900" data-start="7780"><td data-col-size="md" data-end="7836" data-start="7780">**É possível integrar qualquer modalidade do Rappi?**</td><td data-col-size="lg" data-end="7900" data-start="7836">Não. A integração contempla somente o **Rappi Restaurante**.</td></tr><tr data-end="8021" data-start="7901"><td data-col-size="md" data-end="7939" data-start="7901">**É possível exportar o cardápio?**</td><td data-col-size="lg" data-end="8021" data-start="7939">Sim. O Menu Automático permite exportar os produtos do ERP/CPlug para o Rappi.</td></tr><tr data-end="8114" data-start="8022"><td data-col-size="md" data-end="8076" data-start="8022">**É possível fazer o vínculo manual dos produtos?**</td><td data-col-size="lg" data-end="8114" data-start="8076">Sim, pelo modelo **Self Mapping**.</td></tr><tr data-end="8218" data-start="8115"><td data-col-size="md" data-end="8148" data-start="8115">**Qual modelo é recomendado?**</td><td data-col-size="lg" data-end="8218" data-start="8148">**Menu Automático**, por reduzir a possibilidade de erros manuais.</td></tr><tr data-end="8381" data-start="8219"><td data-col-size="md" data-end="8256" data-start="8219">**É possível integrar atributos?**</td><td data-col-size="lg" data-end="8381" data-start="8256">Sim. No Menu Automático são exportados automaticamente; no Self Mapping, devem ser vinculados manualmente pelos Toppings.</td></tr><tr data-end="8440" data-start="8382"><td data-col-size="md" data-end="8432" data-start="8382">**É possível receber pedidos automaticamente?**</td><td data-col-size="lg" data-end="8440" data-start="8432">Sim.</td></tr><tr data-end="8567" data-start="8441"><td data-col-size="md" data-end="8486" data-start="8441">**É necessário realizar pedido de teste?**</td><td data-col-size="lg" data-end="8567" data-start="8486">Sim. O pedido de teste deve ser solicitado ao time Rappi após a configuração.</td></tr><tr data-end="8690" data-start="8568"><td data-col-size="md" data-end="8601" data-start="8568">**Como validar a integração?**</td><td data-col-size="lg" data-end="8690" data-start="8601">Após o recebimento do pedido de teste no PDV.</td></tr></tbody></table>

</div></div></div>> **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.**