Manual de Instalação

1. Pré-requisitos

Para começarmos a utilizar o TAA, devemos preparar o ambiente onde será

instalado. Acesse a url http://app.odhen.com e procure pelo instalador conforme a

figura abaixo:

Extraia o arquivo para qualquer pasta (exceto C:/TEKNISA e execute o

instalador(Installer.exe) como ADMINISTRADOR.

Selecione a opção de instalação personalizada, como na figura abaixo:

Figura 1: Instalador Teknisa

Figura 2: Instalação Personalizada

1.1 Configuração do Instalador

Quando estiver nesta tela(figura abaixo) primeiro habilite a opção Apache +

PHP (como está o 1 na figura abaixo), troque a versão do PHP de 5.6 para 7.2(está o 2

na figura abaixo) e por fim, habilite a opção SQL Server (Client e ODBC, 3 na figura).

Após verifique se suas configurações são as mesmas da figura abaixo e clique em

Instalar.

Ao fim da instalação (figura 3), clique em finalizar.

Figura 3: Fim da Instalação

2. Preparando a comunicação com os periféricos

Volte a www.app.odhen.com e procure por Periféricos, conforme a figura 4.

Acesse o manual(indicado na figura 4) e siga suas instruções para instalação do

mesmo em forma de serviço.

3. Preparando o TAA

Em app.odhen.com faça o download de Odhen TAA(como na figura 5), descompacte

o arquivo na pasta C:/TEKNISA

Figura 4: Indicação do Manual do Periféricos

Figura 5: TAA download

3.1 Configurando o environment.xml

Abra o arquivo “environment.xml” que está dentro da pasta “TAA/backend” e

configurar os campos “host” e “bdname” respectivamente, para o nome da máquina

que está o TAA e o nome do banco de dados correspondente. Os campos “user” e

“password” devem ser preenchidos com o usuário e senha do banco de dados.

Host: É o nome do servidor especificado no ato da instalação do SQL Server.

Você poderá pegar estas informações abrindo o SQL Server Management Studio e

verá uma tela parecida conforme a figura 6:

Figura 6: Nome do Servidor SQLServer = campo host

Segue um exemplo:

4 Parametrizações no manage

Acesse https://manage.teknisa.com/ e faça o acesso com as credenciais do cliente.

4.1 Parametrização de Caixa

Na aba de pesquisa, busque por cadastro de caixa. Ao entrar, insira a filial e a

loja que você se encontra respectivamente em Unidade e Loja destacados na figura:

Figura 7: Exemplo Preenchimento campos no environment.xml

Figura 8: Buscar por Cadastro de Caixa

Para adicionar um caixa há um botão + na parte inferior da tela escrito

adicionar, ao clicar, abrirá uma aba de configuração de caixa(como na figura 10) que

deve ser preenchido seguindo as seguintes regras:

1 - Todos os campos que possuem * devem ser preenchidos obrigatoriamente.

2 – Em Tipo de Emissão de venda NÃO SELECIONE a opção de Cupom Fiscal (ECF).

2 – Se o Tipo de Emissão for SAT, campos de configuração surgirão e devem ser

preenchidos(como modelo do SAT, código de ativação, etc…).

3 – Em Modalidade de Caixa, selecione Terminal de Auto Atendimento ou Auto

Pagamento de Comanda, qualquer outra opção não corresponde ao TAA.

4 – Tipo de caixa deve ser Venda.

5 - Após configurado clique em salvar.

6 – Deve ser feitas as parametrizações padrões para o NFC-e ou para o SAT,

dependendo do que foi escolhido em Tipo de Emissão de Vendas do caixa

cadastrado.

Figura 9: Filtrar por Filial e Loja

4.2 Parametrização de TEF do caixa

Para cada Caixa, após ele ser criado, ele deve ser parametrizado. Para isso, na

tela de Cadastro de Caixa, aonde você anteriormente clicou em adicionar, clique no

Caixa criado e agora ao lado de Cadastro de Caixa, a aba Parâmetros estará

disponível, entre nela e clique em editar na parte inferior da tela. Segue o exemplo:

Figura 10: Parametrização do caixa

Figura 11: Destaques em Caixa Selecionado, aba Parâmetros e aba TEF

Ao clicar em editar clique no campo utilização de TEF e selecione a opção

Utiliza TEF Dedicado. Nas opções de parametrização que aparecer, vá no campo Tipo

de TEF e selecione Sitef ou Cappta, dependendo do que irá ser utilizado pelo cliente.

Caso Sitef, você deverá parametrizar os 3 últimos campos, Código da Loja TEF,

Código do Terminal TEF e Endereço de IP do TEF.

Caso Cappta, deverá ser parametrizado apenas o campo Código do Terminal

TEF. OBS: Cappta Gpplus deve estar rodando no modo checkout web.

Segue um exemplo da tela abaixo:

4.3 Configuração da Impressora do Totem

Na tela inicial do manage, entre na aba de pesquisa e busque por Cadastro de

Loja, clique na loja correspondente à implantação do sistema e entre na aba

Impressoras por Loja. Nessa aba, clique em adicionar.

Figura 12: Destaques em campo Tipo de TEF e Campos que devem ser parametrizados caso escola Sitef

Na aba de adicionar impressora, preencha os campos Modelo, Nome da

Impressora, Porta de Impressão, Endereço do servidor de periféricos(sempre será o

IP da própria máquina que está rodando o TAA na porta 3000. Ex:

https://192.168.0.1:3000).

OBS: Não deve ser preenchido o campo Endereço de IP da impressora.

Segue um exemplo:

Figura 13: Destaques em Unidade selecionada, aba Impressoras por Loja, botão adicionar

Figura 14: Exemplo Parametrização da impressora

4.4 Configuração de Terminal de Caixa

Vá na aba de busca e procure por Configuração de Terminal de Caixa e daí terá

duas opções:

1 – Criar uma nova configuração de Terminal de Caixa, que é o que faremos a partir

de agora.

2 – Usar uma que já existe (pular para o 4.4.2).

4.4.1 Criando uma nova Configuração de Terminal de Caixa

Clique em adicionar, abrirá uma aba de criação de Configuração PDV como na

figura abaixo e apenas insira o nome e clique em salvar.

4.4.2 Associando caixa(s) a Configuração de Terminal de Caixa

Selecione a Configuração de Terminal de Caixa que você deseja e vá na aba

Caixas associados. Clique em adicionar e após, insira a unidade que está o caixa que

você deseja associar à configuração e depois o caixa em si. No exemplo, associarei a

configuração que foi criado no tópico 4.4.1 com o caixa criado e parametrizado em

4.1.

Figura 15: Criando Configuração de Terminal de Caixa

A partir desse momento, as mudanças efetuadas na Configuração de Terminal

de Caixa aparecerão no TAA associado a ele.

4.4.3 Criando Grupos de Produtos

Os grupos de produtos são criados dentro da Configuração de Terminal de

Caixa. Eles são apresentados como conjuntos de produtos oferecidos no TAA. Ex:

grupo bebidas contém os produtos guaraná, chá-verde e água. Para criar grupos de

produtos, vá na Configuração de Terminal de Caixa correspondente ao que o caixa

está relacionado e entre na aba Grupo de Produtos(imagem abaixo).

Figura 16: Associando Caixas a Configuração de Terminal de Caixa

Ao clicar em adicionar, abrirá uma aba de parametrização como na figura

abaixo e todos os campos obrigatórios devem ser parametrizados.

OBS: Nesta tela você poderá adicionar uma imagem ao grupo de produtos no último

campo de parametrização, “Imagem do Grupo”.

4.4.4 Inserindo Produtos ou Subgrupos

Os Produtos ou SubGrupo são associados a um Grupo de Produtos, para

inserir, clique no Grupo de Produtos referente e vá na aba que deseja inserir,

SubGrupos ou Produtos, clique em adicionar e parametrize os campos obrigatórios,

Figura 17: Destaques para Configuração de Terminal de Caixa selecionado, aba de Grupos de Produtos e botão adicionar

Figura 18: Destaque para campo que coloca imagem no grupo

lembre-se que apesar de não ser obrigatório, o campo de adicionar imagem ao

produto/subgrupo está presente nessa parte.

Se for inserido um produto em um grupo de produtos, não será possível

adicionar SubGrupos a este grupo de produtos, a recíproca é verdadeira, se for

adicionado um SubGrupo a um Grupo de Produtos, esse último não aceitará receber

produtos, apenas mais subgrupos.

Dentro dos subgrupos criados, pode ser adicionados produtos.

No exemplo abaixo, está sendo indicado o caminho para a criação de um

produto:

Na figura abaixo está indicado a criação de um produto dentro de um subgrupo:

Figura 19: Destaques para Grupo de Produtos, aba de Produtos e botão adicionar

Figura 20: Inserindo produtos em um subgrupo contido em um Grupo de Produtos

4.4.5 Grupos de Recebimento

Para adicionar Grupos de Recebimento entre na respectiva Configuração de

Terminal de Caixa e vá na aba Grupos de Recebimento. Nessa aba deverá ser

adicionado um novo grupo de recebimento, parametrizar os campos de criação, e

clicar em salvar. Após sua criação, entre nele e vá na segunda aba, Tipos de

Recebimento, nela, clique em adicionar, na aba de parametrização, deve-se obedecer

algumas regras:

1 – Os recebimentos parametrizados na página 1, deverão ser de tipo genérico,

exemplo: crédito, débito, crédito pessoal e débito consumidor caso houver, etc…).

2 – Os recebimentos parametrizados na página 2, deverão ser bandeiras(Visa, Master,

etc…), por conta da rotina de sangria automática que ocorre no fechamento de caixa.

3 – É sempre necessário colocar dinheiro na página 1 por conta de regra de negócio

da abertura e fechamento de caixa.

Na imagem abaixo há um exemplo de alguns tipos de recebimento

parametrizados:

Figura 21: Exemplo de alguns tipos de recebimento que foram parametrizados

4.4.6 Sugestão de Venda

A sugestão de venda está associada a Configuração de Terminal de Caixa.

Ao entrar na configuração correspondente, entre na aba de Sugestão de Venda para

adicionar produtos que serão recomendados aos clientes que adicionarem algum

produto específico no carrinho.

Para usar essa funcionalidade, primeiro adicione o produto que terá outros

produtos como sugestão, clicando em adicionar na aba de Sugestão de Venda e

selecionando o produto na aba que surgirá. Segue o exemplo abaixo:

Após adicioná-lo e clicar em salvar, clique no produto que foi criado que agora

estará na aba Sugestão de Vendas e vá na aba Produtos da Sugestão(imagem

abaixo).

Figura 22: Destaque para campo que irá inserir produto que quando colocado no carrinho, outros produtos serão recomendados

Nessa aba(da imagem acima) clique em adicionar para parametrizar o produto

ou grupo de produtos que irá ser sugerido caso o cliente coloque o produto

parametrizado primeiramente nesse tópico, no carrinho, no campo Tipo de Sugestão,

se escolhe se oque será sugerido será produto ou grupo de produtos, no último

campo se define qual produto/tipo de produtos especificamente será oferecido

(exemplo na imagem abaixo), clique em salvar e ele aparecerá na aba Produtos da

Sugestão.

Obs: Lembrando que só aparecerão produtos ou grupos de produtos que estão

adicionados a Configuração de Terminal de Caixa selecionada.

Figura 23: Destaque para aba que irá liberar depois de criar um produto da sugestão, selecionando-o após criá-lo

Figura 24: Aba de parametrização de produto que será dado como sugestão