Documentação de software

Essa página está em modo somente de leitura. Você pode visualizar a fonte, mas não alterá-la. Informe-se com o administrador do Wiki, caso você ache que isso está incorreto.
======ISA - IntelliStock Android======

====== PRÉ-REQUISITOS PARA UTILIZAÇÃO DO ISA ======

O INTELLISTOCK ANDROID trabalha em um ambiente de **rede local (LAN)** e por isso é necessário que alguns parâmetros de rede sejam definidos para que a comunicação entre o serviço e a aplicação ocorra sem problemas.

<note important>SOLICITE AO RESPONSÁVEL PELA INFRAESTRUTURA DO SEU NEGÓCIO PARA REALIZAR AS ALTERAÇÕES NECESSÁRIAS PARA O FUNCIONAMENTO DO ISA.</note>

O primeiro pré-requisito para a utilização do ISA é a disponibilidade de um aparelho que opere o **Sistema Operacional Android** 6 ou superior.

O equipamento (seja um smartphone ou um coletor de dados), precisa estar conectado a uma rede WI-FI, que **SEJA A MESMA** rede do ambiente cabeado. Por exemplo, se a rede WI-FI tralha na rede 192.168.0.1 e o servidor do ISA esta em uma máquina com o IP 192.168.1.1 e as redes forem isoladas, não haverá comunicação entre o serviço e a aplicação.

Além desse requisito básico, há os requisitos de regurança da rede que precisam ser averiguados antes da intlação do ISA.

Se houver bloqueio de IPs ou Portas na rede, estas pecisam ser liberadas. Por padrão o ISA sugere a utilização da porta 8033, mas pode ser outra qualquer. Além disso, é recomendável que **UTILIZE IP FIXO** no equipamento móvel para evitar perda de comunicação com o serviço. 

Faça a verficação de PING entre o servidor e o equipamento móvel.

===== Apresentação =====

O ISA, assim como o IS, possui uma [[http://iws.com.br/produtos/is/isa/|página]] onde são disponibilizados os instaladores das últimas versões. 

Além dos instaladores, existem dois links diferentes para se fazer download dos **Apps**. O primeiro é no texto **Download APK** próximo a cada imagem dos Apps. Este link permite baixar para o computador ou diretamente no smartphone o arquivo de instalação para **Android**.

<note warning>Este link para download do APK foi criado com o intuido de ser possível disponibilizar versões de **Hot Fix**. Portanto, nem sempre a versão do APK direto será igual a versão da Play Store.</note>

O Segundo link é no logo de cada aplicação que direciona para a página da **Play Store**.

{{ ::linksapks.png |}}

(http://iws.com.br/produtos/is/isa/)


===== Instalação =====

Execute o intalador **NO MODO DE ADMINISTRADOR** e siga as etapas de Instalação para iniciar a utilização do ISA.

<note warning>DURENTE AS ETAPAS PODE SER SOLICITADO A FECHAR OUTRAS APLICAÇÕES ANTES DE PROSSEGUIR. **DESMAQUE A OPÇÃO PARA DE FECHAR OUTRAS APLICAÇÕES**. ISSO PODE ENCERRAR O ENTERPRISE SERVER SE A INSTALAÇÃO ESTIVER OCORRENDO NO SERVIDOR. </note>


{{ :intellistock:iss_install1.png?nolink |}}

{{ :intellistock:iss_install2.png?nolink |}}

{{ :intellistock:iss_install3.png?nolink |}}

{{ :intellistock:iss_install4.png?nolink |}}

{{ :intellistock:iss_install4_1.png?nolink |}}

{{ :intellistock:iss_install4_2.png?nolink |}}

==== Instalação de APK no SMARTPHONE ====

Conecte o Samrtphone no cabo USB e habilite a opção de **Transferência de arquivos**

{{ :intellistock:isa_install1.png?nolink |}}

{{ :intellistock:isa_install2.png?nolink |}}

Copie os arquivos **.apk** para do computador para o samrtphone.

{{ :intellistock:iss_install5.png?nolink |}}

{{ :intellistock:iss_install6.png?nolink |}}

{{ :intellistock:iss_install7.png?nolink |}}

Em seguida, abra o gerenciador de arquivos no Samartphone e execute os arquivos **.apk** para a instalação.

<note important>Para instalar um APK no smartphone é preciso conceder permissão para instalação de apps de fontes desconhecidas. O Android encaminha para a configuração durante a instalação.</note>

====== Entrerprise ISA ======
A partir da versão **1.0.1.9** o ISA faz a conexão com o banco de dados utizando o Enterprise Server.

{{ ::enterprise_isa.png |}}

<note important>O Enterprise deve ser executado no servidor do banco de dados do **IntelliCash **. A porta padrão de comunicação é a **5033**</note>

<note tip>Quando o **ISA** está instalado na mesma máquina que o servidor é possível configurá-lo para executar o Enterprise se ele estiver fechado.
A configuração do **.INI** é: **INITES=1** dentro de **[DBCONNECTION]**

Mas para isso funcionar o Enterprise deve permanecer na página de instalação do ISA/ESServer/ES_ISA.exe</note>

Uma versão recente do ES está modificada para alterar a cor do ícone para ver se o parâmetro do **ES_ISA.INI** estiver configurada par ao isa: 

  [Produto]
  Tipo=ISA


====== Aplicação Servidora ======

{{ ::main.png?nolink |}}

No menu superior encontram-se 3 opções: **Servidor**, **Configurações** e **Sobre**.

=====Servidor =====

Exibe o log de comunicação entre um terminal e o servidor.

{{ ::servidor.png?nolink |}}


====Configurações====
Neste menu estão disponíveis as opções de configuração da conexão com o banco de dados, opções de configuração de uso do programa e configuração de etiquetas.

===Conexão===
{{ ::configuracao.png |}}

**Dados de Conexão** Nesta seção são informados os dados de conexão com o Banco de dados do IntelliCash.

**Dados de Liberação** Nesta seção são informados os dados para a liberação do produto pela aplicação **IWBServer**.

<note important>Esta chave é única e não pode ser compartilhada com outras pessoas.</note>


===Opções===

Exibe uma interface que permite configurar o diretório de destino dos arquivos enviados pelos smartphones, como arquivos de recebimento de notas, coletas de inventários e impressão de etiquetas.

Além disso, é possível visualizar quais são os usuários do IS cadastrados no IC por meio do botão **Usuários** e ainda os dispositivos cadastrados no IS.

<note important>O ISA é uma versão Android do IS, logo, todas as informações produzidas pelo ISA são armazenadas da mesa forma que as informações do IS.</note>

{{ ::configuracoes.png |}}

A configuração da **PORTA HTTP** é a mesma que deve ser indicada nos Apps. Dependendo das configurações de rede do ambiente em que o sistema estará operando, será necessário incluir no firewall uma exceção para a porta. Isso pode ser feito por meio do botão **ADD FIREWALL EXCEPTION**.

Depois de efetuar as alterações nos campos, é necessário **SALVAR**.
===Editar Etiqueta===
Esta opção permite que as configurações de impressão das etiquetas sejam alteradas, assim como no IC.


====== Servidor de Impressão ======

Algumas vezes a impressora de etiquetas pode ser de um modelo antigo, o que torna o envio do template de impressão como "imagem" muito lento para elas. Dessa forma, a **IWS** criou um servidor de impressão que envia para a impressora os dados no formado de linguagem de impressora. Como explicado [[manuais:servidor_impressao_etq|nesse manual]].

O Aplicativo do **ISA - Controle de Preços** na versão 1.0.3.1 permite a escolha de um template para impressão, que pode ser o template de impressão do servidor de impressões.

Mas para que a impressão ocorra de fato, o **ISService.ini** precisa esta configurado para isso ([CFG] PRINTSVR=1). 

  ...
  [CFG]
  empresa=1
  HTTPPORT=8033
  FDIR=C:\IWS\COLETAS
  PRINTSVR=1
  PRT_TEMPLATE=Etiqueta Svr
  [DBCONNECTION]
  ...

Mas isso não é o suficiente. O banco de dados do **IC** também deve estar configurado corretamente:

**1º -** Tabela SERVER_ETQ_PRINT id 1; host <ip_maq_impressora>; port 5075 (padrão para porta mas é configurável)

**2º - **Tabela MODELOS_IMPRESSAO 

  INSERT INTO MODELOS_IMPRESSAO (ID, DESCRICAO, DESCRICAO_PRINT, P_ID, ATIVO, ID_SERVER_ETQ_PRINT) VALUES (gen_id(newidgeral,1000), 'Etiqueta Svr', 'Etiqueta Svr', 1, 1, 1);

**3º -** Tabela REPORTS 

  INSERT INTO REPORTS (ID, CLASSE, NOME, DESCRICAO, NIVEL, DLL) VALUES (gen_id(newidgeral,1000), 151, 'Etiqueta Svr', 'Etiqueta Svr', '5', NULL);

**4º -** Template 

  INSERT INTO REPTEMPLATE (ID, IDREP, LOCAL, TEMPLATE) VALUES (gen_id(newidgeral,1000), <id_tabela_reports>, 'Svr', 
  'txt;N;2;2;2;3;3;<@cdsLabels.Descricao@>;0;1;
  txt;N;2;2;1;8;3;<@cdsLabels.Obs@>;0;0;
  br;N;0;2;2;13;5;<@cdsLabels.ean@>;10;1;
  cx;10;32;56;13;1;1;
  txt;N;3;3;2;16;35;R$;
  txt;N;3;4;4;12;50;<@cdsLabels.Preco[2]@>;');
====== Aplicações Android ======

=====Configurações Gerais=====
Configurações gerais referen-se as configurações que são iguais para todas as aplicaçoes do ISA, seja **Recebimento de Notas**, **Inventários**, **Impressão de Etiquetas**, **Consulta de Preços Concorrentes** e **Sugestão de Preços**.

Normalmente a primeira tela apresentada é a tela de **Login**.

{{ ::isa_login.png |}}

Os usuário são carregados automaticamente toda vez que o App é executado. Mas para que isso seja possível, as configurações de conexão precisam estar preenchidas de forma correta.

Para acessar a tela de **Configurações**, clique no botão **Voltar** na tela de **Login**.

{{ ::isa_cfg.png |}}


No campo **Nome** deve ser informado um nome que identifique o samrtphone para o sistema.

No campo **IP** deve ser informado o IP da máquina onde o Servidor do ISA está instalado, seguido da **Porta de Conexão** (":8033").

<note important>Não altere ou esqueça de preencher a informação da porta. Caso não seja possível utilizar esta porta, entrar em contato com o Atendimento.</note>

=====Inventário=====

====Menu Principal====

No menu principal do App de Inventário são apresentadas opões para a contagem de situações específicas como: **Inventário**, **Troca**, **Devolução**, **Perda** e **Consumo**. Cada opção irá gerar um arquivo próprio, facilitando a identificação de cada contagem.



Na parte inferior, existem três opções: **Enviar Arquivos**, **Atualizar Produtos** e **Voltar**.

**Enviar arquivos**: envia para o **Servidor** as contagens em aberto. Constagens em aberto deixarão o botão correspondente na cor roxa.

**Atualizar Produtos**: busca no servidor a relação de todos os produtos cadastrados, seja no IC ou no próprio ISA. Essa ação permite que a consulta de produtos possa ocorrer de forma offline.

**Voltar**: volta para a tela de login.

{{ ::isa_inv_menuprincipal.png?200 |}}

**Listas**: é a opção para coleta de inventário com itens definidos no IC. Nesse modo é possível fazer a contagem apenas dos itens contidos em uma lista.

==== Abertura de Contagem ====

Ao escolher dentre uma das opções de coleta (inventário, devolução, troca, etc...) será possível escolher uma contagem em aberto ou criar uma nova contagem.

{{ ::isa_inv_calendario.png?200 |}}

As contegens ficam organizadas por data de criação, assim a seleção das coletas não se misturam. Por esse motivo também foi incluído um recurso de enumerar arquivos com o mesmo nome.

{{ ::isa_inv_nome1.png?200 |}}

Por padão, o nome sugerido é composto do data e hora atual. Mas o nome pode ser personalizado de acordo com a ocasião.

{{ ::isa_inv_teste.png?200 |}}

Ao criar uma segunda contagem com o mesmo nome de alguma outra, esse nome será versionado.

{{::isa_inv_teste2.png?200 |}}{{isa_inv_2arquivos.png?200 |}}

==== Contagem ====

A coleta pode ser feita a partir de uma leitura de código de barras com a câmera, pelo sensor de leitura (coletores de dados android) ou por digitação.

{{ :intellistock:isa_inv_coleta0.png?200 |}}



A tela de contagem apresenta um **Título** indicando qual é o tipo de contagem que está sendo realizada. O toque no título abre uma tela de **Produtos Contados**

Abaixo do Título, são exibidas as informações do último item contado.

Na parte inferior, são exibidos os campos para a contagem atual: **Código Ean** e **QTDE** (quantidade).


O botão **LER CÓDIGO** abre a câmera do samrtphone para a captura do codigo de barras. Ao ler o código do produto, suas informações são consultadas e a quantidade é solicitada.

{{ ::isa_cam.png?nolink |}}

O botão confirmar Insere o Item no inventário.

Quando o produto não é encontrado nem nos dados locais e nem pela rede, é sugerido que se dê um nome para o item coletado. Isso facilita identificação do produto na importação do IC.

{{::intellistock:isa_inv_naoencontrado1.png?200 |}} {{ ::isa_inv_naoencontrado2.png?200 |}}

Tocar sobre o nome do produto não encontrado também abre a caixa pra dar nome ao produto.

Esta opção também está disponível na lista de itens onde qualquer produto pode receber um nome temporário.

{{ ::isa_inv_naoencontrado3.png?200 |}}


==== Leiaute do Arquivo ====

Os Arquivos gerados pelo app de inventário possuem um padrão de campos que é utilizado para identificar diversas informações da coleta e do produto.

  código | quantidade | data | usuário coletor | hk coletor | hora | lote | fabricacao | validade | endereco | impresso | descricao | id motivo
  00000000000055|55.0|20/06/2025|736127001|280eb147-ba54-4706-885e-e166714557f6|16:46:58|null|null|null|null|0|OVOS GRANJA DUZIA BRANCO|0


===== Recebimento de Nota Fiscal =====

No menu principal do recebimento de notas há botões para **Receber Nota**,**Nota Cega**,**Enviar Arquivo**,**Backup do Banco**,**Atualizar Produtos** e **Voltar**.

{{ :recebimento.png?300 |}}

**Receber Nota**: Preenchendo a data do __recebimento__,será encaminhado para uma tela onde os dados da nota devem ser informados.

{{ :recebimentocalendario.png?nolink&300 |}}

{{ :localizarnota.png?nolink&300 |}}

A captura da chave do DANFe pode ser feita pela opção **LER CÓDIGO** que irá ativar a câmera do samrtphone.

Ao capturar a chave, os outros dados serão preenchidos automaticamente.

Também é possível iniciar o recebimento informando apenas o CNPJ e o Número da nota.

Na tela de recebimento há um **Título** que corresponde ao número da nota que está sendo conferida. Um toque nesse título abre uma tela com os produtos já conferidos.
{{ :titulonf.png?nolink&300 |}}

{{ :lista_de_produtos.png?nolink&300 |}}

A contagem dos produtos pode ser realizada pela captura do código de barras, quantidade de itens e a validade, de acordo com configurações do ISA e do IC.

{{ :localizar_produto.jpg?nolink&300 |}}


Se faz possível a alteração da quantidade de um produto clicando sobre ele, e inserindo a nova quantidade.

{{ :alterar_quantidade.jpg?nolink&300 |}}


{{ :alterar_quantidade2.png?nolink&300 |}}

===== Atualizações 1.1.1.0 =====

Nesta versão a tela de consulta apresenta duas alterações principais:

1 - Botão de informações: 

<imagem tela de coleta>
Exibe informações personalisáveis sobre o produto.
<imagem relatorio>

2 - Botão de Embalagem:
<imagem botao embalagem>
Quando o produto lido é embalagem de outro produto, sugere a conversão e multiplicação de quantidades automaticamente.

<note>Ao incluir um produto que já consta como coletado, aparecerá uma caixa de dialogo perguntando qual ação o usuário quer tomar: 

-**DESCARTAR** o produto:  a nova coleta será descartada. Mantendo assim intacto o registro do produto realizado na coleta anterior.

-**SUBSTITUIR** o produto: a coleta anterior do produto será descartada.

-**SOMAR** o produto: a nova coleta será somada a coleta anterior.</note>

{{ ::alert_dialog_dss.png?nolink&200 |}}


==== Consulta de Código Interno de Produtos ====

Foi incluído no campo do EAN um botão que lista os itens de código interno, definidos no IC. Por eles é possível realizar o lançamento na nota diretamente pela lista.

{{ ::nf_internos.png |}}


{{ ::nf_internos_itens.png |}}

{{ ::nf_internos_qtde.png |}}


==== Ordens de Recebimento ====

A opção de O.R. Exibe a lista de Ordens de Recebimento disponível para o dispositivo. Há um botão para editar e um botão para enviar em cada uma das opções.

{{ :nota_cega.png?nolink&300 |}}

=== Recebimento Cooperativo ===
A partir da versão 1.0.2.1 o app de recebimento de notas permitirá realizar o recebimento de O.R.s em mais de um aparelho simultaneamente.

A nova função é chamada de **Cooperar**.

{{ :btncooperaron.png?300 |}}

O botão do canto superior direito permite que outros usuários visualizem a O.R.

{{ ::cooperaropen.png?300 |}}

Após a ação de abrir para recebimento cooperado, o "proprietário" da O.R. vai exibir a tela de conferência com o botão desabilitado.

Entende-se "proprietário" o aparelho que abrir a O.R. primeiro.

{{ ::btncooperaroff.png?300 |}}

Os dispositivos que estão auxiliando a coleta da O.R. não irão alterar o status do recebimento, e irão apresentar uma mensagem informativa.

{{ ::cooperar_envio2.png?300 |}}

<note warning>É IMPORTANTE QUE OS EQUIPAMENTOS AUXILIÁRES ENVIEM AS COLETAS **ANTES** DO EQUIPAMENTO "PROPRIETÁRIO" PARA QUE A O.R. NÃO ALTERE O STATUS PARA PENDENTE!!</note>


===== Consulta Preço =====

O menu principal da aplicação apresenta os campos e botões para definir as configurações de conexão e parâmetros de funcionamento do APP.

{{ :isacp_main.png?200 |}}


A primeira informação é o Alias, ou apelido do celular. Esse nome irá identificar a pasta onde os arquivos enviados pelo APP serão salvos. Sendo assim, é importante verificar se não há dois dispositivos com o mesmo nome, uma vez que é sugerido o nome não comercial do aparelho.


Nas configurações de conexão há dois campos, um para o IP da máquina onde o servidor do ISA está instalado e outro para a PORTA, que por padrão é a 8033, por onde o servidor receberá as requisições do APP.


Nas **Opções Avançadas** existem switches e um botão. Sguindo a ordem de cima para baixo temos:


**botão LAYOUT DE IMPRESSÃO:** este botão carrega do servidor uma lista de layouts configurados para impressão de etiquetas no **IC**. Uma vez escolheido o layout, esta configuração fica armazenada no aplicativo.

{{ :isacp_layoutimpressao.png?200 |}}

Em seguida seguem os //switches//


**Ocultar botão de leitura:** quando o app é executado em coletores de dados que possuem botões físicos para ativar o leitor de códigos, o botão de leitura do app se faz desnecessário. Além de abrir espaço para os elementos da interface que é limitado pelo tamanho reduzido que geralmente esses quipamentos possuem;


**Buscar listas de concorrentes:** essa opção determina se o servidor será ou não consultado sobre listas personalizadas de itens para cotação de concorrentes;


**Usar impressora bluetooth:** atualmente app está homologado para sincronizar a impressão de etiquetas com a impressora portátil Sewoo LK-P400. Essa opção habilida a configuração seguinte que é Pedir Quantidade e o tempo de intervalo entre impressões;


**Pedir Quantidade:** quando habilidata essa opção, ao enviar o comando de imprimir para a impressora, será exibido um diálogo solicitando a quantidade de etiquestas a serem impressas;


**Tempo de Intevalo de IMpressões:** esse slite irá definir quanto tempo se deve esperar entre uma impressão e outra. A finalidade dessa configuração e evitar que a impressora trave ou superaqueça durante as impressões;


**Botão SALVAR**: todas as alterações realizadas nessa etapa serão guardadas nas configurações do APP e a navegação leva a página de login.


==== Login ====

Nesse aplicativo a tela de login pode exibir ou não um botão para sincronização com a impressora Bluetooth. Isso vai depender se a configuração **Usar impressora bluetooth** estiver ativado.

{{ :isacp_login.png?200  |}}


O Botão impressora irá buscar a impressora quando ela já estiver pareada no bluetooth do celular.

<note important>É de fundamental importância que a impressora esteja pareada com o celular ou coletor de dados antes da inicialização do aplicativo, uma vez que o app buscará pela impressora na lista de equipamentos pareados.

Observe na impressora se o ícone de pareamento bluetooth está colorido.</note>


==== Menu Principal ====


O menu principal traz alguns recursos novos a partir da **versão 1.1.0.0**.


{{ :intellistock:isacp_menu.png?200  |}}


Seguindo a ordem dos botões apresentados, segue a explicação de cada um:

=== **PARA IMPRIMIR:** ===
Abre a tela de consultas e envia a etiqueta diretamente para a impressora;

{{ :isacp_enviando_impressao.png?200|}}
{{ :isacp_paraimprimir.png?200 |}}


{{ :intellistock:isacp_impressao_enviada.png?200|}}
{{ :intellistock:isacp_impressao_falhou.png?200 |}}


=== **PARA ARQUIVAR:** ===
 semelhante a opção anterior porém as etiquetas lidas devem ser salvas em uma lista. Essa lista pode ser consultada posteriormente na opção **Consulta do dia** e **Coletas**; 


{{ :intellistock:isacp_adicionadonalista.png?200|}}
{{ :intellistock:isacp_paraarquivar.png?200 |}}


=== CONSULTAS DO DIA: ===
Após selecionar o dia da coleta, a lista de coletas salvas naquele dia é exibida;

{{ :intellistock:isacp_lista_do_dia.png?200 |}}

Nota-se que há diferentes status para cada etiqueta sendo eles pendente, conferido e impresso.

O status **pendente** significa que a etiqueta aparecerá na lista de envio para o servidor. Depois de enviar através do menu **COLETAS** o status é alterado para **conferido** e não aparecerá mais para envio, a não ser que o status seja apagado. 

Cada item dessa lista permite 3 ações que irão alterar o status da etiqueta.

== Deslizar para Direita ==
Altera a etiqueta para o status **CONFERIDO**;

== Deslizar para Esquerda ==
Remove o status da etique para ficar como pendente;

== Pressionar por um tempo ==
Manter pressionado a etiqueta envia para impressão e altera o satus dela para **IMPRESSO**;

=== CONCORRENTES ===

Se a opção estiver desmarcada, a tela de coleta é carregada em seguida.

{{ :intellistock:isacp_concorrente.png?200 |}}

Caso não seja possível ler o código do produto, é possível fazer uma busca dos produtos com o botão de Lupa e digitando parte do nome ou o código do produto;

{{ :intellistock:isacp_buscarproduto.png?200 |}}

** Lista personalizada do concorrente **

Para carregar as listas personalizadas definidas no Intellicash, é necessário que o Switch de configurações no aplicativo do ISA esteja ativado. 

{{ :02_lista_conc.png?200  |}}

Na tela de concorrentes, ao clicar no botão "+", as listas serão carregadas. Basta selecionar a desejada para iniciar a coleta de preços.

{{ :03_lista_conc.png?200  |}}

O usuário será direcionado a lista de produtos:

{{ :04_lista_conc.png?200  |}}

Clicando sobre o produto irá abrir uma janela para adicionar o preço, após adiciona-lo basta clicar em salvar
{{ :05_lista_conc.png?200  |}}



=== CONFERÊNCIA ===



=== COLETAS ===




===== Entregas =====

===Download do aplicativo===

O aplicativo está disponível na Play Store. Clique em "Instalar" para que seja instalado no seu dispositivo.
{{ :playstore.png?nolink&300 |}}

Ao iniciar o aplicativo pela primeira vez, uma janela com os termos de uso será exibida. É necessário clicar em "Li e Aceito" para concordar com os termos de uso.

{{ :primeiro_termo_de_uso.png?nolink&300 |}}

Em seguida, uma janela informando que você aceitou os termos de uso será exibida. Clique em "OK" e depois em "Permitir" para autorizar o acesso aos diretórios do dispositivo.
{{ :juntos.png?nolink&300 |}}

O aplicativo estará em modo de demonstração, portanto, é necessário realizar a ativação do aplicativo para acessar todas as funcionalidades disponíveis. Para ativar o aplicativo, selecione o ícone da engrenagem laranja no canto superior direito da tela e, em seguida, insira o endereço IP do servidor do programa ISA.

{{ :ip_juntos.png?nolink |}}

Se a ativação foi bem-sucedida, uma janela aparecerá informando que tudo ocorreu corretamente.

{{ :liberacao_ok.png?nolink&300 |}}

Após essa notificação, é preciso inserir o nome de usuário e senha, e prosseguir para a próxima tela, que é a tela de seleção de veículos. Nesta etapa, você deve escolher o veículo que será usado para as entregas.

{{ :seleciona_veiculo.png?nolink&300 |}}

**Menu Principal:**

Botão **"Abrir Lista**": Ao selecionar este botão, você será direcionado para iniciar a criação do itinerário das entregas. Isso envolve adicionar os cupons que serão carregados pelo entregador.

Botão "**Lista de Entregas**": Nesta opção, você encontrará as entregas que já foram adicionadas ao itinerário. (As informações nesta tela só serão exibidas quando o botão "**__Abrir Lista__**" estiver definido como "**__Confirmar Entregas__**"; este tópico será abordado mais adiante.)

**Enviar Pendentes**: Caso existam entregas que ainda não foram enviadas ao servidor e estão armazenadas no celular, você pode reenviá-las através deste botão.

{{ :menu_opcoes.png?nolink&300 |}}

**ABRIR LISTA:**

Nesta tela, você encontrará o campo onde os cupons adicionados ao itinerário serão exibidos, juntamente com quatro botões:

**Ler Cupom de Entrega**: Utilize esta opção para fazer a leitura do QR code do cupom de entrega.

**Digitar Cupom**: Se não for possível ler o QR code no cupom de entrega, o aplicativo permite que você insira manualmente as informações do cupom.

**Limpar Lista** de Entrega: Este botão apagará todas as entregas adicionadas à lista.

**Pronto para Entrega**: Selecione este botão somente após inserir todos os cupons das entregas na lista, a fim de iniciar a rota de entrega.

{{ :tela_inserir_cupom.png?nolink&300 |}}

Após a inclusão dos cupons de entrega, é essencial clicar no botão **'PRONTO PARA ENTREGA**' para que o usuário retorne ao menu principal.

{{ :pronto_para_entrega.png?nolink&300 |}}


Se estiver usando o aplicativo pela primeira vez, será preciso conceder duas permissões de localização. A primeira permissão é para a localização em primeiro plano, e após aceitá-la, será necessário conceder a permissão para a localização em segundo plano, como ilustrado na imagem.

{{ :permissao_primeiro.png?nolink&300 |}}
{{ :segundo_permissao.png?nolink&300 |}}

Após concluir as etapas anteriores, o aplicativo entrará no modo de entrega. Isso será evidenciado pela notificação do aplicativo e pela mudança do rótulo do botão "**ABRIR LISTA**" para "**CONFIRMAR ENTREGAS**". Ao clicar em "CONFIRMAR ENTREGAS", você será redirecionado para a tela onde os cupons de entrega são exibidos, permitindo que você confirme cada entrega no local correto.

{{ :menu_confirmar.png?nolink&300 |}}

Exemplo de confirmação de cupom, ao realizar a entrega ao cliente
{{ :tres.png?nolink |}}


Seguindo o fluxo de uso, uma vez que a rota de entrega é concluída e você retorna ao estabelecimento, é essencial enviar o arquivo de entrega para o servidor. Para fazer isso, basta selecionar o botão '**LISTA DE ENTREGAS**' no menu principal. Ao fazer isso, você será redirecionado para uma tela que exibe o resumo do itinerário, contendo todos os cupons da rota, incluindo os que foram confirmados e os que não foram.

{{ :enviar_entregas.png?nolink&300 |}}

Para enviar o arquivo ao servidor, é fundamental escolher o botão '**ENVIAR ARQUIVO**' localizado na parte inferior da tela. Após clicar em 'SIM' na janela de confirmação que aparecerá, um resumo da rota será exibido, incluindo informações como a distância percorrida, o tempo e um mapa. Na janela do mapa, é necessário selecionar '**CONFIRMAR**' para tentar enviar o arquivo de entregas para o servidor.

{{ :envio.png?nolink& |}}

"Se o envio for realizado com sucesso, uma mensagem de confirmação será exibida, informando que as entregas foram enviadas. Caso contrário, haverá a opção de selecionar '__Salvar as entregas__'.

Uma mensagem será exibida na parte inferior do Menu Principal, indicando a presença de '__ENTREGAS PENDENTES__'. Para enviá-las, basta clicar em '**__ENVIAR PENDENTES__**'.

//Observação: O aplicativo somente permitirá o início de outra rota após o envio ou a salvaguarda das entregas pendentes.
Observe que o botão anteriormente rotulado como 'CONFIRMAR ENTREGAS' foi alterado para 'ABRIR LISTA NOVAMENTE' após o envio ou a salvaguarda das entregas.//

{{ :salvar.png?nolink |}}


===== ISA - Expedição =====

Este aplicativo nasce da necessidade de verificar a integridade das mercadorias expedidas pelo depósito em relação à emissão de notas fiscais.

A tela inicial do aplicativo permite configurar o IP, porta e nome do dispositivo. Em "Opções Avançadas", é possível ativar a "Leitura Automática", que inicia a câmera para leitura de produtos automaticamente, e ajustar a velocidade de abertura da câmera.
{{ :xpd1.png |}}

Na tela de login, insira suas credenciais como em outros aplicativos.

{{ :xpd2.png |}}

Após o login, a lista de ordens de expedição disponíveis será exibida. As cores indicam o status: branco para "Aberto", verde para "Recebendo" e vermelho para "Divergência". Use o botão "Atualizar" para sincronizar as ordens.

{{ :xpd4.png |}}

Os botões "Editar" e "Enviar" aparecem para cada ordem. Ao clicar em "Editar", você será direcionado à tela de leitura de produtos.

{{ :xpd5.png |}}

Clicando em "Leitura" abrirá a câmera para a leitura do código de barras. Se a "Leitura Automática" estiver ativada, basta clicar uma vez em "LER CÓDIGO".

{{ :xpd6.png |}}

Após a contagem, clique em "Enviar". Se estiver em conformidade, a ordem desaparecerá da lista.

<note tip>Para entender o processo do retaguarda **(IC)**, veja o manual de [[manuais:intellicash:estoque:notas_fiscais:ordem_de_expedicao|Ordem de Expedição]]</note>
====== IDENTIFICAÇÃO DE PROBLEMAS ======

Muitas vezes acontece do cliente reclamar que não está havendo comunicação entre a aplicação mobile e a aplicação servidora. Neste caso há um passo a passo para se identificar os possíveis problemas.

Antes de começar, tenha certeza de que a versão da aplicação servidora e do App são as mesmas!!!

  1 - Abra a aplicação servidora e clique na opção servidor para verificar os logs de comunicação.  
  
  2 - Abra o menu Configuração -> Opções e verifique a porta HTTP que está configurada e 
  verifique qual é o ip da máquina em que a aplicação servidora está instalada.
  
  3 - É possível realizar teste de consulta ao serviço do isa pelo navegador do PC. Abra o 
  navegador e coloque o link da consulta (GET): 
    http://<ip>:<porta>/iws/api/TControllerProduto/Ping  
  retorna {"result":[{"CONNECTED":"TRUE"}]} se estiver comunicando
  Consulta de um produto pra gerar log no server:
    http://<ip>:<porta>/iws/api/TControllerProduto/Produto/0000000000001
  retorna um Json com dados do produto.  
  
  4- Se não aparecer nada, verifique se a aplicação servidora está sendo bloqueada 
  pelo firewall, tente usar a opção de "ADD FIREWALL EXCEPTION" em Configurações -> Opções. 
    Pode ser tentado desativar temporariamente o Firewall para fins de testes.
    Pode tentar usar o Telnet para verificar a porta também.
  
  5 - Peça acesso via Anydesk ao celular e verifique se a configuração de IP está 
  apontando para IP:PORTA corretamente.
  
  6 - Verifique se o celular está conectado no WI-FI da rede LAN.
  
  7 - Salve as configurações do celular e verifique na aplicação servidora se há logs 
  de consulta de Liberação e Download de Usuários.
  Se houver log de comunicação, pule para o passo 9.
  
  8 - Verifique se o celular está com um IP da mesma rede em que está o pc da aplicação 
  servidora (Ex. de erro: PC=192.168.0.30 Cel=192.168.1.128). Neste caso pode ser necessário 
  configurar um IP Fixo no celular. (Peça para o responsável de Infraestrutura de Redes 
  do cliente liberar este novo IP Fixo do celular.
  
  9 - Se houver logs de comunicação entre o celular e o servidor (do ISA), verifique a 
  conexão com o banco de dados em Configurações -> Conexão.
    Aqui a configuração é de conexão com o banco de dados do IC! Pode copiar de lá dele o ip.
  
  10 - Se o App abre a tela de login no modo demonstração e no servidor retorna log com LIB:FALSE, 
  verifique o limite de dispositivos permitidos para o cliente.
    Abra o menu Configurações -> Opções e veja se é possível remover algum dispositivo se for o caso de limite.
  
  11 - Se retorna LIB:TRUE e mesmo assim o app entra no modo demonstração, tente reiniciar o app.
  
  12 - Se o problema é etiqueta, abra a plicação servidora e acesse o menu Configurações -> Editar Etiqueta (Atacado).
    Configure os RTMs, verifique a imporessora, o DATA(fonte de dados), salve como arquivo com os 
  nomes respectivos (EtiquetaProduto.rtm e EtiquetaProdutoAtacado.rtm).
    Faça testes configurando a impressora para PDF Printer e faça um Preview. Teste mandando 
  imprimir pelo navegador: http://<ip>:<porta>/iws/api/TControllerProduto/Print/0000000000001.
  
  13 - Verifique se a impressora está devidamente instalada.
  
  14 - Os arquivos não aparecem na pasta correta: Verifique o caminho em Configurações -> Opções.
    Verifique se é uma pasta compartilhada e se usa o IP ao invés do alias da rede, se há permissão 
  para gravação na pasta, se o programa está sendo executado como ADM. 
    
===== Modos de espelhamento da tela =====
Utilize programas que possibilitem o espelhamento da tela do seu smartphone no computador para que os técnicos do suporte possam acessar as funcionalidades do ISA durante o atendimento remoto.

==== Anydesk ====

Para a instalação do aplicativo Anydesk é necessário seguir os seguintes passos:

**1-**Procurar na **Playstore** o aplicativo Anydesk, após encontrá-lo clicar em instalar:

{{ :localizar_na_playstore2.jpg?nolink&300 |}}


**2-**Após a instalação, abrir o aplicativo e clicar **OK**, em todas as telas que aparecerem:

{{ :clicando_em_ok2.jpg?nolink&300 |}}

**3-** Aparecerá uma tela informando que é necessário um **Plugin** para que seja possível o acesso remoto. Clicar em **OK**. Uma nova janela da **Playstore** irá aparecer. Basta clicar em instalar.

{{ :ok_plugin.jpg?nolink&300 |}}

{{ :install_plugin2.jpg?nolink&300 |}}

**4-** Será necessário habilitar o plugin, Para isso basta clicar selecionar Anydesk control service AD1, e depois arrastar o botão de ativação. Logo após clicar em **Permitir** na nova janela que abrirá.

{{ :habilitar_plugin.jpg?nolink&300 |}}


{{ :arrastando_sim.jpg?nolink&300 |}}

{{ :permitir_sim.jpg?nolink&300 |}}

**5-**Volte ao aplicativo Anydesk após esses passos. Uma mensagem de otimização de bateria irá aparecer, selecione Sim. Em seguida será exibido o número para acesso remoto. **Esse número deverá ser informado ao analista!**.

{{ :otimizacao_bateria.jpg?nolink&300 |}}


{{ :numero_do_anydesk.jpg?nolink&300 |}}


**6-** Depois de informado o número ao analista, Será exibido uma mensagem para aceitar o acesso. Clique em **Aceitar**. E em **Perfil de permissão** selecione __**Acesso integral**__. Aceite a solicitação de acesso remoto, e depois clique em **Iniciar**

{{ :aceitar_contato_anydesk.jpg?nolink&300 |}}


{{ :proecao_contra_fraude.jpg?nolink&300 |}}

{{ :acesso_integral.jpg?nolink&300 |}}

{{ :aceitar_contato_final.jpg?nolink&300 |}}

{{ :aceitar_tranmissao.jpg?nolink&300 |}}

















https://fossbytes.com/android-screen-mirroring-apps-pc/

Para os programas que não requerem a instalação de um app no smartphone, o modo de depuração deve ser habilitado no aparelho.

  1- Acesse as configurações;
  2- Acesse a opção SOBRE O DISPOSITIVO;
  3- Localize a informação "Número da versão" e toque 6 vezes rápidamente, ou até que a mensagem "Agora você é um desenvolvedor" apareça.
  
{{ ::android-pie-developer-options.jpg}}
  
{{ :usb-debugging-prompt-allow.jpg}}

**Ativar WebGL mp chrome**
  Ative o WebGL no Google Chrome
  Abra o Google Chrome. Na barra de endereço, digite chrome://flags/e pressione Enter;
  Role para desabilitar WebGL-ativar. 
  Esta opção impede que aplicativos da Web acessem a API WebGL e clique em habilitar.
  Ir para chrome://settings
  Clique no botão Advanced na parte inferior da página;
  Na seção sistema, verifique se a caixa de seleção usar aceleração de hardware quando disponível está marcada.


===== StartUp =====

O instalador cria um registro no windows para inicialização do programa com a chave IntelliStockA. As vezes são registrados em dois lugares diferentes:

  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\StartupApproved

e

  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run

Sendo assim, pode ser possível apagar um ou outro para evitar confitos de inicialização.

{{ ::registro_startup.png |}}

====== VERSÕES ======

====1.0.4.2====






=== Melhoria no ISA CP aba histórico do dia ===

Seguindo a demanda da tarefa #9624. Foi corrigido o problema, onde o usuário coletava etiquetas de produtos para arquivar, e ao enviar os produtos para o servidor, os mesmos não tinham o status alterados, de pendente para impresso(cor alterada de preto para verde).


{{:etq4.png|}}



====1.1.1.0====

===Melhorias===

==Melhoria na observação da entrega==
Observações de entregas como: Pegar sacola de frios; Caixas 1234/4567/8947. Poderiam vir com quebra de linha do EasyCash como por exemplo.
Caixas:
-1234
-4567
-8947

Desta maneira como o aplicativo de entrega trabalha com arquivos, essas informações causavam problemas.
Para corrigir isso foi feito um tratamento no aplicativo ISA_Entregas para que essas observações sejam formatas e que seu conteúdo não ultrapasse o tamanho de 50 caracteres.


==Ordenação Lista Etiqueta==

Foi adicionado um menu no canto superior direito da tela das listas de etiquetas no aplicativo ISA_CP, conforme mostrado na imagem. Nele, é possível realizar a ordenação em ordem alfabética (A–Z, Z–A) e também por ordem de tempo (mais recente, mais antigo). A ordem de tempo leva em consideração o momento em que o item foi inserido no aplicativo, seja por arquivamento no próprio aplicativo ou por inserção via lista.

{{:lista_ordenacao.png|}}

==Melhoria na coleta de itens da lista de inventário==

Corrigido problema de layout irregular ao ter duas coletas do mesmo produto. 

{{:layout_itens.jpg|}}

Corrigido agrupamento da coleta de itens na lista, para que tenha a quantidade correta no intellicash.
Ao enviar a lista de inventário, a tela é atualizada também. 

==Padronização de inserção de validade no aplicativo de Inventários==

Nas versões anteriores a __1.1.1.0__, só era possível adicionar a validade em Inventários através do Botão **INVENT. VALIDADE**.
Apartir da versão  __1.1.1.0__ será possível adicionar validades a todos os tipos de coletas dentro do aplicaitovo ISA_inventario.

Para isso deve-se setar a configuração **Pedir validade** no menu de configurações do aplicativo.

{{:swtch_pedir_validade.jpg|}}

Após setado esta configuração, basta selecionar o tipo de coleta desejada.
<note important>O botão **INVENT. VALIDADE** foi desativado.</note>

{{:menu_sem_botao_invent_validade.jpg|}}

Ao inicar a coleta desejada, caso a configuração Pedir Validade esteja selecionada, aparecerá o campo Validade. Caso contrário, o campo validade não aparecerá.
{{:tela_coleta_pedido_botao_setado_ou_nao.jpg|}}


<note tip>Para padronização do aplicativo, a unica maneira de adicionar valdiade a um item, é selecionando a opção Pedir validade no menu de configurações, desta maneira a mensagem que aparecia ao selecionar o botão Listas. Não aparecerá. </note>


{{:nao_exibe_pedir_validade_lista.png|}}


==Layout de itens ultrapassando layout dos botões==

Corrigido o layout dos botões para que os itens não fiquem ocultados.

{{:layout_final_lista.jpg|}}


==Coleta de preços concorrente separados por seção==

Feito melhoria para que o usuário consiga seperar as coletas de preços de concorrentes por seções.
Para isso basta:
Nas configurações do aplicativo, ligue o toggle switch(interruptor) __Classificar concorrente por seção__ .

{{:01_swt_habilitado.jpg|}}

Na tela de concorrentes ao selecionar o botão **__+__** , será exibido o calendário para selecionar a data da coleta.

{{:02_mudanca_calendario.jpg|}}


Após selecionar a data o usuário será direcionado para a tela das coletas do dia selecionado.
Caso a intenção seja continuar uma coleta já existente, basta clicar no lápis.
Para criar uma nova coleta com uma nova seção, clique no botão **__+__**
no canto inferior direito, conforme mostrado na imagem abaixo
{{:03_escolha_secao.png|}}


==Divergências de quantidades coletadas no aplicativo ISA NF==

Foi corrigido o problema das quantidades coletadas na recontagem das Ordens de recebimentos.
Anteriormente em alguns casos, os produtos coletados na recontagem não eram exibidos corretamentes no aplicativo.
<note important>No intellicash as quantidades eram exibidas normalmente.</note>

==Possibilidade de envio de Ordem de Recebimento sem coleta==
Foi bloqueado o envio de coleta de ordem de recebimento sem produtos contados. Ao tentar enviar uma coleta que não possui contagem, é exibido a seguinte caixa de diálogo:

{{:msg_qtde_vazia_itens_or.jpg|}}
Documentação de software

Ferramentas do usuário

Ferramentas do site

Ferramentas da página
