EATTAKE
Integração PDV Teknisa
AGO 2024 IMPETK05V1
Conteúdo
1 Observações Iniciais 3
1.1 Pedidos Agendados: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Funcionamento da Integração: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 Parametrização do Delivery 4
2.1 Cliente Padrão e Vendedor Padrão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.2 Centro de Custo de Cliente . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.3 Cadastro Automático de Novos Clientes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 Caixa Associado ao Vendedor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.4.1 Criação de um Novo Caixa (Se Necessário) . . . . . . . . . . . . . . . . . . . . . . 16
2.5 Consumidor Padrão . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.5.1 Cadastro do Endereço do Consumidor Padrão . . . . . . . . . . . . . . . . . . . . 23
3 Associação do Consumidor Padrão à Filial 25
4 Parametrização do Cardápio 28
4.1 Obtenção do Código do Produto no Retail . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
4.2 Enviar os Códigos ao Parceiro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
4.3 Inserir o Código Externo no Site do Parceiro . . . . . . . . . . . . . . . . . . . . . . . . . 30
5 Parametrização da Integração 32
5.1 Cadastro do Subprojeto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
5.2 Cadastro de E-mail do Responsável Técnico . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.3 Cadastrando a Integração com o Order API . . . . . . . . . . . . . . . . . . . . . . . . . . 37
5.4 Configurando os Tipos de Recebimento . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
2
Observações Iniciais
Este manual tem como objetivo detalhar o processo de parametrização da integração com o PDV Teknisa,
abordando configurações iniciais, mapeamento de dados, sincronização de informações e resolução de
problemas comuns.
1.1 PEDIDOS AGENDADOS:
Para habilitar a funcionalidade de pedidos agendados, é necessário enviar um e-mail para o endereço
delivery@teknisa.com solicitando a ativação.
1.2 FUNCIONAMENTO DA INTEGRAÇÃO:
A integração funciona de maneira autônoma, cobrindo desde o recebimento do pedido pelo parceiro até o
envio para a cozinha do restaurante. Após a conclusão da parametrização no Odhen Retail e a validação
dos testes de integração, a equipe do restaurante não deve processar pedidos manualmente, nem utilizar
ferramentas fornecidas pelo parceiro com essa finalidade.
Ferramentas fornecidas pelos parceiros podem ser utilizadas somente se não interferirem no funcionamento
da integração. Em caso de dúvidas, é recomendado que o uso de tais ferramentas seja suspenso e que
seja feito contato com o suporte da Teknisa para obter assistência e esclarecimentos adicionais.
Atenção: A integração depende da configuração do produto Odhen Retail. Para mais informações, entre
em contato com seu representante comercial.
Para garantir o sucesso da integração com a Order API, siga os procedimentos descritos neste manual.
Caso utilize outros produtos da Teknisa (Call Center, Delivery Aplicativo, etc.), é provável que esses itens
já estejam parametrizados no Odhen Retail.
Observação: Certifique-se de selecionar a filial correta durante a configuração para garantir o sucesso
da integração
3
Parametrização do Delivery
A parametrização do Delivery é um processo essencial para assegurar o bom funcionamento do sistema.
Esse processo envolve ajustes e configurações de diversas funcionalidades e parâmetros para garantir
que o sistema atenda às necessidades específicas do negócio e opere de maneira eficiente.
2.1 CLIENTE PADRÃO E VENDEDOR PADRÃO
Essa etapa realiza o vínculo do Cliente Padrão e Vendedor Padrão preexistentes no Retail. Cada filial
precisa de um cliente e vendedor padrão cadastrado. O cliente padrão deverá ser o mesmo para todas as
filiais, enquanto o vendedor padrão é exclusivo para cada filial.
Este manual considera que o Cliente Padrão e o Vendedor Padrão foram criados anteriormente. Caso seja
necessário criá-los, entre em contato com o responsável pelo projeto ou com a equipe de suporte.

1. Para iniciar a configuração, abra o Retail e clique no menu (Figura 1) no canto superior esquerdo.
   Figura 1: Menu
2. Selecione o caminho (Figura 2): Parametrização → Vendas → Parâmetros de Gestão de Vendas →
   Delivery
   4
   Figura 2: Caminho
3. Clique em Unidade (Figura 3) e selecione a unidade a ser parametrizada.
   Figura 3: Unidade
4. Selecione a aba Parâmetros (Figura 4).
   5
   Figura 4: Parâmetros
5. Em seguida, clique em Editar (Figura 5).
   Figura 5: Editar
6. Preencha os campos (Figura 6) Cliente Padrão e Vendedor Padrão, selecionando o cliente e vendedor
   disponíveis.
   6
   Figura 6: Campos
7. Após a configuração, clique em Salvar para finalizar a operação.
   Observação: Os campos Tempo de Entrega Limite (minutos), Taxa de Entrega (R$), Preço Mínimo
   do Pedido (R$) e Distância da Área de Atendimento (Km) não são considerados para a integração
   e seu preenchimento não é obrigatório.
   2.2 CENTRO DE CUSTO DE CLIENTE
   Após configurar o Cliente Padrão, é necessário associar um centro de custo a ele.
8. Clique no menu (Figura 7) no canto superior esquerdo.
   Figura 7: Menu
   7
9. Selecione o caminho (Figura 8): Parametrização → Vendas → Cliente → Centro de Custo por Cliente
   Figura 8: Caminho
10. Na tela de filtro (Figura 9), preencha o campo Cliente.
    Figura 9: Filtro
11. Clique em Aplicar Filtro (Figura 10).
    8
    Figura 10: Aplicar Filtro
12. Será exibida a lista de centros de custo do cliente. Para adicionar um centro de custo, clique em
    Adicionar (Figura 11).
    Figura 11: Adicionar
13. Informe o código e o nome do centro de custo nos campos correspondentes (Figura 12).
    9
    Figura 12: Campos
14. Clique em Salvar para finalizar a operação.
    2.3 CADASTRO AUTOMÁTICO DE NOVOS CLIENTES
    É necessário configurar o Centro de Custo e Tipo de Consumidor para cadastrar novos clientes.
15. Clique no menu (Figura 13) no canto superior esquerdo.
    Figura 13: Menu
16. Selecione o caminho (Figura 14): Parametrização → Vendas → Parâmetros de Gestão de Vendas
    → Parâmetros da Unidade
    10
    Figura 14: Caminho
17. Selecione a filial (Figura 15).
    Figura 15: Filial
18. selecione a aba Frente de Caixa, em seguida Definições de Padrão (Figura 16).
    11
    Figura 16: Definições de Padrão
    Clique em Editar (Figura 17).
    Figura 17: Editar
19. Clique em Parâmetros na Inclusão Automática de Consumidor (Figura 18).
    12
    Figura 18: Parâmetros na Inclusão Automática de Consumidor
20. Preencha os campos Centro de Custo e Tipo Consumidor e clique em Salvar (Salvar 18) para finalizar
    a operação.
    Figura 19: Salvar
    2.4 CAIXA ASSOCIADO AO VENDEDOR
    Os caixas cadastrados com as modalidades relacionadas ao delivery devem ser devidamente associados
    a um vendedor para que a integração seja realizada com sucesso.
21. Clique no menu (Figura 19) no canto superior esquerdo.
    13
    Figura 20: Menu
22. Acesse o caminho (Figura 20): Parametrização → Vendas → Caixa → Cadastro de Caixa
    Figura 21: Caminho
23. Na tela de filtro (Figura 21), selecione a Unidade e a Loja que receberá a associação nos campos
    correspondentes.
    14
    Figura 22: Filtro
24. Clique em Aplicar Filtro (Figura 22).
    Figura 23: Aplicar Filtro
25. Será exibida a lista de caixas cadastrados. Verifique a coluna Modalidade Caixa (Figura 23) dos
    caixas cadastrados para confirmar se podem ser associados a um vendedor.
    15
    Figura 24: Modalidade do Caixa
    2.4.1 Criação de um Novo Caixa (Se Necessário)
    Caso não exista um caixa relacionado ao delivery, siga os passos abaixo para criar um novo caixa.
26. Clique em Adicionar para criar um novo caixa (Figura 24).
    Figura 25: Adicionar Novo Caixa
27. Preencha os campos (Imagem 25) com os dados do novo caixa e certifique-se de que ele tenha uma
    modalidade que permita associação. As modalidades que permitem associação são:

• Restaurante/Comanda/Delivery com venda Balcão
• Delivery Venda Balcão
• Call Center Delivery
• Site Delivery
  16
  Figura 26: Adicionar Novo Caixa

1. Clique em Salvar para finalizar a operação.
2. Após a criação, clique no novo caixa na tela de caixas (Figura 25).
   Figura 27: Caixas
3. Navegue até a aba Parâmetros (Figura 26).
   17
   Figura 28: Parâmetros
4. Selecione Vendedores Associados (Figura 27).
   Figura 29: Vendedores Associados
5. Clique em Adicionar (Figura 28).
   18
   Figura 30: Adicionar
6. No campo Vendedores, será exibida uma lista com todos os vendedores já criados. Selecione o
   vendedor padrão criado anteriormente (Figura 29).
   Figura 31: Vendedor Padrão
7. Selecione Cadastrar Vendedores (Figura 30) para finalizar.
   19
   Figura 32: Cadastrar Vendedores
   2.5 CONSUMIDOR PADRÃO
   Será necessário criar um consumidor padrão para atrelar aos pedidos nos casos em que os parceiros não
   enviem todas as informações do consumidor.
8. Clique no menu (Figura 31) no canto superior esquerdo.
   Figura 33: Menu
9. Acesse o caminho (Figura 32): Parametrização → Vendas → Consumidor → Cadastro de Consumidor
   20
   Figura 34: Caminho
10. Na tela de filtro (Figura 33), selecione o cliente criado anteriormente no campo correspondente.
    Figura 35: Filtro
11. Clique em Aplicar Filtro (Figura 34) para ser direcionado para a tela de cadastro.
    21
    Figura 36: Aplicar Filtro
12. Clique em Adicionar (Figura 35).
    Figura 37: Adicionar
13. Preencha os campos utilizando dados fictícios de um cliente genérico (Figura 36).
    22
    Figura 38: Consumidor
    Observação: É recomendado o nome “Consumidor Padrão”para garantir que não haja associação
    específica com qualquer integração.
14. Clique em Salvar para finalizar a operação.
    2.5.1 Cadastro do Endereço do Consumidor Padrão
15. Selecione novamente o cliente cadastrado e clique na aba Endereço (Figura 37) da janela de
    informações.
    Figura 39: Aba Endereço
16. Clique em Editar (Figura 38) na parte inferior da tela.
    23
    Figura 40: Editar
17. Preencha o endereço nos campos correspondentes (Figura 39) e clique em Salvar para finalizar a
    operação.
    Figura 41: Salvar
    Observação: É recomendado utilizar o endereço da matriz para o cadastro desse consumidor
    fictício.
    24
    Associação do Consumidor Padrão à Filial
    Para atrelar o Consumidor Padrão a uma Filial, siga os passos abaixo:
18. Selecione o menu (Figura 40) no canto superior esquerdo.
    Figura 42: Menu
19. Acesse o caminho (Figura 41):
    Parametrização > Vendas > Parâmetros de Gestão de Vendas > Parâmetros da
    Unidade
    Figura 43: Caminho
20. Selecione a Filial desejada e clique na aba Frente de Caixa (Figura 42) da janela de informações.
    25
    Figura 44: Frente de Caixa
21. Selecione a aba Definições de Consumidor (Figura 43).
    Figura 45: Definições de Consumidor
22. Clique em Editar (Figura 44).
    26
    Figura 46: Editar
23. Na seção Consumidor Padrão Utilizado nos Sistemas (Figura 45), clique no campo novamente para
    selecionar o Consumidor Padrão criado.
    Figura 47: Consumidor Padrão Utilizado nos Sistemas
24. Clique em Salvar para finalizar a operação.
    Nota: É necessário atrelar este consumidor em todas as filiais.
    27
    Parametrização do Cardápio
    Para parametrizar o cardápio, será necessário criar uma relação de equivalência entre os produtos
    cadastrados no Retail e no parceiro. Todo produto cadastrado no Retail precisa ter um produto igual no
    parceiro.
    4.1 OBTENÇÃO DO CÓDIGO DO PRODUTO NO RETAIL
25. Selecione o menu (Figura 46) no canto superior esquerdo.
    Figura 48: Menu
26. Acesse o caminho (Figura 47): Parametrização → Vendas → Produto → Tabela de Preço
    Figura 49: Caminho
    28
27. Na tela de filtro, escolha a filial desejada dentro do campo Unidade e clique em Aplicar Filtro (Figura
    48) para prosseguir.
    Figura 50: Aplicar Filtro
28. Clique na tabela de produtos que será utilizada e selecione a aba Produtos (Figura 49).
    Figura 51: Produtos
29. Copie os códigos dos produtos (Figura 50) que deseja cadastrar.
    29
    Figura 52: Códigos dos Produtos
    4.2 ENVIAR OS CÓDIGOS AO PARCEIRO
    Encaminhe todos os códigos copiados para o parceiro efetuar o cadastro dos produtos na plataforma.
    4.3 INSERIR O CÓDIGO EXTERNO NO SITE DO PARCEIRO
30. Acesse a opção Menus no site do parceiro e acesse o produto que deseja inserir o código, abrindoo para alterações (confira manual EATTAKE PEDIDOS – Criação e Gerenciamento de Menus e
    Produtos, item 3.2).
31. Na tela “Alterando Produto”, insira o Código Externo da Integração (Figura 51) do produto.
    Observação:Não é preciso utilizar a pontuação.
    Figura 53: Código Externo da Integração
    30
32. Clique em Salvar para finalizar a operação.
    31
    Parametrização da Integração
    5.1 CADASTRO DO SUBPROJETO
    Para o Order API funcionar corretamente, é necessário cadastrar o Subprojeto. Este campo identifica o
    parceiro junto ao sistema. Para efetuar o cadastro, solicite ao parceiro que crie um código de 5 caracteres
    para identificá-lo. O parceiro precisará enviar este código nos pedidos.
    Nota: Internamente, este campo se chama “origin”. Em caso de dúvidas, o parceiro deve consultar a
    documentação técnica da integração.
33. Após ter acesso ao código, acesse o caminho (Figura 52):
    Parametrização → Vendas → Parâmetros de Gestão de Vendas → Parâmetros de Integração e
    Aplicativos
    Figura 54: Caminho
34. Dentro da aba Projeto, verifique se o campo Subprojeto (Figura 53) está marcado com SIM.
    32
    Figura 55: Campo Subprojeto
35. Caso não esteja, clique em Editar (Figura 54).
    Figura 56: Editar
36. Altere o campo para SIM e clique em Salvar (Figura 55).
    33
    Figura 57: Salvar
37. Após a alteração, a aba Subprojeto (Figura 56) se tornará visível.
    Figura 58: Aba Subprojeto
38. Selecione a aba Subprojeto e clique em Adicionar (Figura 57).
    34
    Figura 59: Adicionar
39. Preencha os campos da tela e clique em Salvar (Figura 58).
    Figura 60: Salvar
    5.2 CADASTRO DE E-MAIL DO RESPONSÁVEL TÉCNICO
    Se acontecer algum imprevisto durante a integração de um pedido, a integração envia automaticamente
    um e-mail para os endereços cadastrados, informando o ocorrido e detalhando a natureza do problema
    para que possa ser resolvido rapidamente.
    Observação: É possível cadastrar mais de um e-mail para receber essas notificações, porém cadastre
    um e-mail por vez, assegurando que cada endereço seja inserido corretamente para evitar falhas na
    comunicação.
40. Dentro da integração do Order API, selecione a aba E-mail do Responsável Técnico (Figura 59).
    35
    Figura 61: E-mail do Responsável Técnico
41. Clique em Adicionar (Figura 60).
    Figura 62: Adicionar
42. Insira o e-mail do responsável técnico e clique em Salvar (Figura 61) para finalizar o cadastro.
    36
    Figura 63: Salvar
    5.3 CADASTRANDO A INTEGRAÇÃO COM O ORDER API
    O próximo passo é criar a integração com o Order API no Retail. Nesta tela, será necessário inserir o
    Identificador e dar um nome para a Integração. Os outros campos devem ficar em branco ou com o valor
    padrão.
43. Acesse o caminho (Figura 62): Parametrização → Vendas → Integração → Cadastro de Integração
    Figura 64: Cadastro de Integração
44. Clique em Adicionar (Figura 63).
    37
    Figura 65: Adicionar
45. Preencha os campos (Figura 64) necessários:

• Código: Este campo é preenchido automaticamente pelo Retail quando o usuário seleciona o
  Identificador;
• Identificador: Insira o código identificador do Order API, “ORD”;
• Nome: Insira o nome da integração que será exibido na tela anterior. É recomendado “Order
  API”.
  Figura 66: Campos

1. Após preencher todos os campos, clique em Salvar para finalizar a operação.
   38
   5.4 CONFIGURANDO OS TIPOS DE RECEBIMENTO
   Após configurar a integração, é necessário vincular os tipos de recebimentos que serão utilizados.
2. Dentro da tela Cadastro de Integração, clique em Tipo de Recebimento (Figura 65).
   Figura 67: Tipo de Recebimento
3. Será listado todos os tipos de recebimento já configurados. Para inserir um novo tipo de recebimento,
   clique em Adicionar (Figura 66).
   Figura 68: Adicionar
4. Preencha os Campos (Figura 67) Necessários e clique em salvar para finalizar a operação.

Código Externo: Este é o código identificador utilizado pelo EatTake. Ele é enviado junto com
o pedido e é através dele que a forma de recebimento é identificada. Os códigos podem ser
encontrados em “Métodos de Pagamento” de sua loja no EatTake/Admin.
Figura 69: Campos
Observação: As configurações feitas até aqui relacionadas ao tipo de recebimento são globais, ou seja,
são aplicadas a todas as filiais. Caso seja necessário cadastrar um tipo de recebimento para uma única
filial, é necessário fazer esse cadastro por unidade. As regras para criação de tipos de recebimento da
unidade são iguais às regras globais. O tipo de recebimento da unidade sempre se sobrepõe ao tipo de
recebimento global.
40

Código Interno: Este é o código interno da Teknisa do tipo de recebimento a ser cadastrado.
Este campo é preenchido automaticamente e não pode ser alterado;
39

Tipo de Recebimento: Ao clicar neste campo, é exibida uma lista com todos os tipos de
recebimentos disponíveis. Selecione o tipo de recebimento desejado;