01. Visão geral
Esta integração visa atender a demanda de clientes no segmento de lojas que desejam sincronizar o inventário de seus produtos no TOTVS Food Service com o Rappi CPGs.
IMPORTANTE: Essa integração não contempla o segmento de restaurantes, que por usa vez possuí uma integração específica dentro do Rappi.
02. Como funciona?
A Integração atende a sincronização de alguns campos sensíveis do cadastro de produtos da Retaguarda do TOTVS Varejo Food Service com a plataforma Rappi CPG.
Quaisquer alterações nos campos listados a seguir ativará a integração:
- Nome do Produto
- Descrição do Produto
- Preço
- Quantidade
- Unidade de medida Rappi CPG
- Desconto Rappi CPG
- Descrição Rappi CPG
- Disponível Rappi CPG
Dica |
---|
|
Os campos acima que contém no nome o sufixo "Rappi CPG" são campos disponibilizados através da funcionalidade "campo customizáveis" da Retaguarda do TOTVS Varejo Food Service, criados especificamente para atender o modelo de produto do parceiro Rappi CPG. A integração é feita por meio de um serviço que é executado a cada 1 minuto do lado TOTVS e a cada 5 minutos do lado Rappi. |
03. Configurações
Retaguarda do TOTVS Varejo Food Service
Configuração ambiente ChefWeb:
Para habilitar a integração RAPPI CPG, é necessário habilitar o parâmetro no ambiente de ADMINISTRAÇÃO do ChefWeb.
Totvs custom tabs box |
---|
tabs | Passo 1: Acessar o Site ChefWeb, Passo 2: Acessar Menu Lojas, Passo 3: Selecionado a Loja, Passo 4: Acessar as parametrizações, Passo 5: Selecionando e Adicionando a parametrização, Passo 6: Habilitando a parametrização |
---|
ids | passo1,passo2,passo3,passo4,passo5,passo6 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo1 |
---|
| Para habilitar o parâmetro, basta seguir os seguintes passos: - Acessar o site Plataforma - http://chefwebcloud.chef.totvs.com.br/Login
- Efetue o Login.
- Selecione o ambiente "Administração"
![](/download/attachments/545251409/image2020-4-2_11-47-22.png?version=1&modificationDate=1585838842540&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2 |
---|
| - Selecione o Menu "Lojas"
![](/download/attachments/545251409/image2020-4-2_11-48-43.png?version=1&modificationDate=1585838923420&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| - Selecione a loja que deseja habilitar o parâmetro.
- Clique em "EDITAR".
![](/download/attachments/545251409/image2020-4-2_11-53-48.png?version=1&modificationDate=1585839228287&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| - Clique no botão "+ Adicionar Parametrização".
![](/download/attachments/545251409/image2020-4-2_11-55-53.png?version=1&modificationDate=1585839353497&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| - Selecione o seguinte parâmetro "RAPPI CPG"
- Clique em "Selecionar"
![](/download/attachments/545251409/image2020-4-2_11-57-1.png?version=1&modificationDate=1585839421863&api=v2)
![](/download/attachments/545251409/image2021-2-18_8-54-43.png?version=1&modificationDate=1613649284003&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo6 |
---|
| - Será adicionado a parametrização no grid.
- IMPORTANTE será necessário "MARCAR" o campo "Habilitar".
- Depois clique em "Salvar"
![](/download/attachments/545251409/image2021-2-18_8-56-44.png?version=1&modificationDate=1613649404593&api=v2)
|
|
Portal de configurações de integrações do TOTVS Varejo Food Service
Totvs custom tabs box |
---|
tabs | Passo 01: Cadastrando Estabelecimento, Passo 02: Vinculando Estabelecimento Integração Rappi CPG, Passo 03: Adicionando Integração, Passo 04: Configurando parâmetros Integração |
---|
ids | passo1integracao,passo2integracao,passo3integracao,passo4integracao |
---|
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo2integracao |
---|
| - No Menu Integração → Integração Estabelecimento;
- Informe a licença do cliente;
- Vincular Estabelecimento a integração RappiCPG;
- Na tela de estabelecimento click no botão "+" para incluir a integração RAPPICPG
![](/download/attachments/545251409/image2021-2-18_8-22-3.png?version=1&modificationDate=1613647324337&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3integracao |
---|
| - Deverá adicionar as informações para configuração da RAPPICPG
![](/download/attachments/545251409/image2021-2-18_8-23-8.png?version=1&modificationDate=1613647388797&api=v2)
Preencher o cadastro conforme os parâmetros da tabela abaixo:
Chave | Valor |
---|
Tipo Operação | Pedido | Fluxo do Pedido | Entrada | Integração | RAPPICPG | Descrição | Informar a descrição DA integração apenas para visualização, sugestão "RAPPICPG" |
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4integracao |
---|
| - Com a integração adicionada, clique no botão "EDITAR" na coluna de ações da integração
- preencha os parâmetros que constam na combobox
- api_key este valor é informado pela Rappi.
![](/download/attachments/545251409/image2020-7-13_10-21-6.png?version=1&modificationDate=1594740026087&api=v2)
|
|
Disponibilização dos campos customizáveis:
Para contemplar na Retaguarda do TOTVS Varejo Food Service os campos específicos para o modelo de produto do Rappi CPG, é necessário executar alguns procedimentos diretamente no banco de dados do clientes (CHEF967XXXXX):
Button |
---|
Cor | #0000CD |
---|
Texto | DOWNLOAD SCRIPTS |
---|
Link | https://drive.google.com/file/d/1mdQjXKi6MfgfyDC5ySFOUMXgn3w7yjy0/view?usp=sharing |
---|
|
Ordem de execução:
- AJUSTE_STORECODE_ESTABELECIMENTO.sql
- CRIAÇÃO TRIGGER RAPPI CPG
- INSERT CAMPOS CUSTOMIZAVEIS RAPPI CPG
Aviso |
---|
|
Se atentar aos dados informados nos scripts para abertura da GMUD |
Campos customizáveis no cadastro de produtos:
Após a execução dos scripts acima na base de dados do cliente, serão disponibilizados os seguintes campos:
- Rappi CPG : Indica se o produto será integrado com o Rappi CPG.
- Disponível Rappi: Campo para informar se o produto deve estar disponível para comercialização no Rappi CPG.
- Descrição Rappi: Campo texto para informar a marca do produto que será integrada no Rappi CPG.
- Unidade de Medida Rappi: Campo texto para informar a Unidade de medida no Rappi CPG
- Valores aceitos:
- U (para unidade)
- WB e WW (para gramas)
- Código Produto Rappi: Campo texto para informar o código de produto que será integrado com o Rappi CPG.
- Desconto(%) Rappi: Campo texto para informar o percentual de desconto que será utilizado no Rappi CPG.
![](/download/attachments/545251409/image2021-2-19_12-52-22.png?version=1&modificationDate=1613749942627&api=v2)
Preço Venda 2 no cadastro de produtos:
No cadastro de produtos será liberado o campo "Preço Venda 2", este preço de evnda será utilizado na venda pelo PDV.
![](/download/attachments/545251409/image2021-2-18_9-0-4.png?version=1&modificationDate=1613649604533&api=v2)
Configuração ambiente PDV:
No Configurações.exe → Vendas → habilitar a opção "Usar Preço Integração"
![](/download/attachments/545251409/image2021-2-18_9-4-35.png?version=1&modificationDate=1613649876247&api=v2)
04. Exemplo de utilização
As informações serão sincronizanadas com a RAPPI CPG, quando ocorrer as seguintes operações abaixo:
No cadastro do produto ocorrer alguyma alteração nos seguintes campos:
- Nome do Produto
- Descrição do Produto
- Preço de Venda 2
- Unidade de medida Rappi CPG
- Desconto Rappi CPG
- TRADEMARK Rappi CPG
- Disponível Rappi CPG
Nas rotinas de movimentação de estoque:
- Entrada de mercadoria
- Inventário
- Venda
- Transferência de estoques
- Entre outras operações que movimentar a quantidade estoque da tabela ESTOQUE.
Operação TOTVS Food Service PDV
Na operação de venda quando utilizar:
- Preço Venda
- Ao selecionar "Preço Venda" todos os produtos lançados serão com o preço venda padrão de venda do sistema.
- Preço integração
- Ao selecionar "Preço Integração" no lançamento será lançando o preço venda 2 que esta cadastrado no produto, (lembrando que o preço venda 2 é cadastrado no ChefWeb).
- Após a escolha e inicio do lançamento todos os produtos serão lançados com o preço de venda 2, caso o produto não tenha preço venda 2 cadastrado ele será lançado com preço 0,00 seguindo a regra de lançamento de itens com preço 0,00.
![](/download/attachments/545251409/precointegracao.gif?version=1&modificationDate=1613651277887&api=v2)