OSMobile Força de Vendas Sumário 1 REQUISITOS DE HARDWARE E SOFTWARE...3 1.1 Bluetooth... 3 1.2 Internet (Wi-fi / 3G)... 3 1.3 Armazenamento (SDCARD / Armazenamento do Aparelho)...3 1.4 GPS (Satelite)... 3 1.5 Android API 8 2.2+... 3 2 INSTRUÇÕES DE INSTALAÇÃO E CONFIGURAÇÃO...3 3 OSCARGA...4 3.1 Configurando Ambiente de Homologação...5 3.2 Configurando uma base de Demonstração...6 4 OSFOTO...7 5 OSMOBILE...8 5.1 Mensagens... 8 5.2 Catálogo de Produto...10 5.3 Calculadora... 10 5.4 GEOLOCALIZAÇÃO... 11 5.4.1 Geolocalização de Vendedor...11 5.5 RELATÓRIOS... 13 5.5.1 Relatório de Pedido por Cliente...13 5.5.2 Relatório de Produtos Vendidos...13 5.6 PRODUTOS E TABELAS DE PREÇO...13 5.7 CLIENTES... 13 5.8 PEDIDOS... 14 5.9 PEDIDOS E NOTA FISCAL EMBARCADA (NF-e)...15 5.9.1 GERAÇÃO E IMPRESSÃO...15 5.9.2 CANCELAMENTO... 20 5.9.3 EXCLUSÃO... 21 5.9.4 INFORMAÇÃO... 21 5.10 SINCRONISMO... 21 6 TROCA DE VENDEDORES...21 7 CONTROLE DE ESTRUTURA DO BANCO DE DADOS OSMOBILE.DB..22
FAQ...23 CLIENTES... 23 PEDIDOS... 23 Novo Pedido... 23 2
1 REQUISITOS DE HARDWARE E SOFTWARE 1.1 Bluetooth O Bluetooth é utilizado na aplicação para realizar interações geralmente com impressoras bluetooth necessárias em alguns casos. 1.2 Internet (Wi-fi / 3G) O acesso a internet é necessário para a grande parte da interação da aplicação com os servidores. 1.3 Armazenamento (SDCARD / Armazenamento do Aparelho) Utilizado para manter o backup de informações pertinentes aos pedidos criados na aplicação, caso precisem ser restaurados, assim como auxiliar no chaveamento do ambiente de homologação e produção. 1.4 GPS (Satelite) O GPS via satélite é utilizado para captar a posição do vendedor que utiliza os recursos de geolocalização. 1.5 Android API 8 2.2+ A versão do Android 2.2 é a versão mínima necessária para executar a aplicação OSMobile, funcionando assim em todas as versões superiores a mesma. 2 INSTRUÇÕES DE INSTALAÇÃO E CONFIGURAÇÃO O processo de download e instalação da aplicação OSMobile é feito através da loja do Google Play e pode ser acessada pelo https://play.google.com/store/apps/details?id=com.orasystems.osmobile. link: Além disso, a aplicação pode ser encontrada digitando o termo OSMobile na pesquisa do Google Play. Na página da aplicação já é possível realizar o download e a instalação através do botão instalar como ilustra a figura 1. 3
Figura 1 Download e instalação da aplicação OSMobile Após a instalação já é possível perceber os ícones da aplicação no menu do dispositivo, compostos pelo OSCarga, OSFoto, OSMobile e OSRestaurar. OSMobile Aplicação de Força de Vendas e Gestor de Pedidos onde é realizado todo o processo de vendas. OSCarga Utilizado para realizar a carga inicial dos dados onde é necessário informar o CNPJ da empresa e o documento do vendedor. OSFoto Utilizado para realizar o sincronismo de fotos dos produtos que possuem fotos no pedido online. OSRestaurar Utilizado para realizar a restauração de dados do banco. 3 OSCARGA O processo de carga de dados é utilizado para realizar a carga do banco de dados osmobile, gerado pelo retaguarda OSAndroid com base nos dados 4
do sistema. A base gerada é do tipo SQLite e é utilizada na maior parte da aplicação somente a titulo informativo. A base gerada pelo OSAndroid é enviada via FTP e armazenada de acordo com as especificações de empresas e vendedores no momento da geração. A carga de dados é obtida através do download a partir da consulta ao Webservice que devolve o caminho do FTP em que foi feito o upload da base SQLite compactada. O processo completo de carga pode ser visto na figura 2. Figura 2 OSCarga Processo de Carga de Dados Fluxo de Informações Para realizar o processo de carga é necessário informar os dados de CNPJ da empresa e Documento do vendedor e iniciar o processo de carga de dados, ao término do processo já será possível utilizar a aplicação. 3.1 Configurando Ambiente de Homologação Para configurar o OSMobile para ambiente de homologação é necessário adicionar alguns arquivos ao armazenamento do dispositivo (SDCard ou Armazenamento Interno), os arquivos devem ficar na pasta OSMobile localizada na raiz do armazenamento. Os arquivos podem ser encontrados no diretório: G:\Sistema de Força de Vendas - ANDROID\Android. 5
O arquivo wsdl.cfg serve para todas as operações realizadas na aplicação referentes ao webservice, salvo operações referentes a NF-e, e deve conter o conteúdo abaixo, em que hoje refere-se ao IP de homologação. http://186.232.109.249:8080/wsorasystemsonline/wspedidos?wsdl O arquivo wsdlnew.cfg serve para as operações realizadas no webservice novo do pedido e deve conter o conteúdo abaixo, em que hoje refere-se ao IP de homologação. http://186.232.109.249:8080/wsorasystemsonlinenew/wspedidosnew?wsdl O arquivo wsdlnfe.cfg serve para todas as operações realizadas ao processo da NF-e, e deve conter o conteúdo abaixo, em que hoje refere-se ao IP interno de homologação http://186.232.109.249:8080/oswsnfe/wsorasystemsnfe?wsdl Após este processo já é possível perceber que ao abrir o OSCarga temos o endereço referente ao dos arquivos de homologação. 3.2 Configurando uma base de Demonstração Para realizar a carga de uma base de demonstração vamos abrir o OSCarga e realizar o processo de carga com os dados do vendedor DEMO. Para inserir automaticamente os dados do vendedor DEMO nos campos CNPJ e Documento devemos clicar no canto superior direito sobre o botão Demonstração Desativada, a qual irá ativar a demonstração inserindo os dados nos campos, caso preciso realizar o processo manualmente utilizar o CNPJ: 06104769000136 e o Documento: 01234567890. O processo de configuração de uma base de demonstração pode ser visto na figura 3. Atenção este processo não funciona em ambiente de homologação. 6
Figura 3 OSCarga Configurando base de demonstração 4 OSFOTO O sincronismo de fotos realiza o download de fotos de produtos que possuem fotos no pedido online, este processo é feito através do OSFoto clicando no botão de sincronismo. O sistema busca no FTP as fotos dos produtos de acordo com seu ID e realiza o download colocando-as na pasta OSMobileFotos no diretório raiz do armazenamento, ao final do processo o sistema emite um relatório de quantas fotos foram baixadas, quantas fotos são novas e quantas fotos foram atualizadas, conforme ilustra a figura 4. 7
Figura 4 OSFoto processo de sincronismo 5 OSMOBILE Fazer uma descrição sobre o escopo do projeto. 5.1 Mensagens Mensagens - O acesso a lista de mensagens recebidas e lidas pode ser visto no item Mensagens do menu principal da aplicação. O envio de mensagens para o dispositivo do vendedor se dá por meio da aplicação OSMobile que envia a mensagem para o Webservice armazenar, posteriormente no momento da inicialização da aplicação, a mesma busca e exibe as mensagens não lidas, só então devolve uma confirmando que o vendedor está ciente da leitura da mensagem. O recebimento de uma mensagem enviada pelo OSAndroid pode ser vista na figura 5. 8
Figura 5 Recebimento de uma mensagem A interação dos processos que envolvem o envio, recebimento, leitura e confirmação da mensagem podem ser vista na figura 6. Figura 6 OSMobile Mensagem Fluxo de Informações 9
5.2 Catálogo de Produto Acesso ao catálogo - O catálogo de produto pode ser acessado na tela listagem de produtos no ícone de listagem no canto superior direito. A aplicação possui um catalogo de produto que contém os produtos que possuem fotos baixadas pelo sincronismo, este catálogo trabalha em cima do parâmetro dinâmico e busca os códigos de acordo com o parâmetro ORIGEM_CODIGO_FOTO o qual possui os valores 1 para Código Principal e 2 para Código Varejo, a figura 7 ilustra a exibição do catálogo de produto. Figura 7 Catálogo de Produto 5.3 Calculadora Calculadora O acesso a calculadora pode ser visto no item Calculadora do menu principal da aplicação, ou na tela de pedidos. Todas as chamadas a calculadoras dentro da aplicação utilizam o aplicativo Calculadora Plus Grátis mantido pela por terceiros (Digitalchemy, LLC), conforme figura 8, caso a aplicação não esteja instalada é feita uma chama á calculadora nativa do sistema operacional do dispositivo. 10
Figura 8 Calculadora Plus Grátis O download do aplicativo está disponível através do endereço: https://play.google.com/store/apps/details? id=com.digitalchemy.calculator.freedecimal. 5.4 GEOLOCALIZAÇÃO 5.4.1 Geolocalização de Vendedor O processo de geolocalização de vendedores no OSMobile acontece de forma transparente para o vendedor, de modo que a geolocalização é obtida através uma taxa específica de distância do ponto anterior do GPS (caso esteja disponível o serviço de GPS e ATIVO no dispositivo) e do próximo ponto, ou seja, só é salvo um ponto caso este ponto esteja a uma distancia aceitável do ponto anterior. Todo novo ponto geográfico capturado (composto por latitude e longitude) é enviado automaticamente para o WebService caso haja conexão de dados, caso contrário este processo será realizar posteriormente através de uma varredura em registros que não foram sincronizados, este processo ocorre de 15 em 15 minutos. O serviço responsável por realizar este processo é executado em background e chama-se ServiceBackground como mostra a figura x. A inicialização do serviço ocorre no momento em que a aplicação OSMobile inicializa. 11
Figura 9 Serviço de geolocalização de vendedor O processo de ativação automática de GPS ocorre apenas em versões do Android anteriores á 3.0 por diretivas de seguranças impostas pela Google Inc, em caso de versões superiores o serviço de GPS deve ser ativado manualmente na parte de Configurações no item Localização, deve-se ativar a opção de rastreamento de GPS via satélite. A ativação do GPS via satélite pode ser vista na figura x. Figura 10 Ativação do GPS via satélite O processo de geolocalização de vendedores e sincronismo de dados pode ser visto na imagem x. 12
Figura 11 Geolocalização de Vendedores e sincronismo 5.5 RELATÓRIOS 5.5.1 Relatório de Pedido por Cliente 5.5.2 Relatório de Produtos Vendidos 5.6 PRODUTOS E TABELAS DE PREÇO 5.7 CLIENTES Clientes - A carteira de clientes do vendedor pode ser acessada através do item Clientes do menu principal da aplicação OSMobile, nela é possível filtrar todos os clientes de acordo com os critérios desejados, assim como visualizar seus dados completos clicando no botão, conforme ilustra a figura x. 13
Figura 12 Carteira de Clientes 5.8 PEDIDOS Pedidos - É possível ter uma visão geral sobre todos os pedidos realizados por Clientes através do item Pedidos do menu principal da aplicação OSMobile, conforme ilustra a figura x. Para gerenciar os pedidos é necessário acessar a carteira de clientes através do item Clientes do menu principal da aplicação OSMobile conforme a figura x, posteriormente clicar em vendas e acessar a tela de gerenciamento de pedidos. As ações disponíveis na tela de gerenciamento de pedidos são: Novo Pedido - O processo de criação de um novo pedido pode ser visto na figura x, este processo se divide em etapas, as informações gerais que formam o cabeçalho do pedido, os itens do pedido e os itens de trocas. Todas estas informações são mantidas em um banco SQLite separado chamado movimento.db. 14
Alterar Pedido Processo de alterações segue as mesmas regras de negócio e processos da operação de inclusão. Enviar via e-mail Processo de envio de pedido via e-mail, é preciso ter configurado uma conta de e-mail no dispositivo para realizar este processo. Excluir pedido Exclusão de um pedido e todas as suas dependências do banco de dados. 5.9 PEDIDOS E NOTA FISCAL EMBARCADA (NF-e) A aplicação conta com os recursos de Nota Fiscal Embarcada, caso o parâmetro dinâmico NOTA_EMBARCADA esteja como S. 5.9.1 GERAÇÃO E IMPRESSÃO Gera NF-e - Depois de realizado um pedido é possível gerar NF-e através dos recursos do Webservice, o qual realiza todo o processo de geração em conjunto com o Webservice da Receita Federal através do Retaguarda. O processo de geração depende de serviços externos por isso é necessário ficar aguardando uma resposta do status de geração da NF-e até que esteja pronto para impressão. Após a geração da NF-e ela poderá ser impressa através de duas impressoras homologadas nas formas de DANFE Simplificado e Completo. Para o DANFE Simplificado será utilizado a impressora Leopardo A7 da InputService como ilustra a figura x. Para o DANFE Completo será utilizado a impressora Zebra TLP 2844 adaptada com uma versão Bluetooth fornecida pela RR Engenharia conforme a figura x. 15
Figura 13 Impressora Leopardo A7 (InputService) O DANFE impresso na impressora Leopardo A7 pode ser visto na figura x. 16
Figura 14 DANFE Impresso na Leopardo A7 17
Figura 15 Impressora Zebra TLP 2844 (RR Engenharia) O DANFE impresso na impressora Zebra TLP 2844 pode ser visto na figura x. 18
Figura 16 DANFE Impressora na Zebra TLP 2844 O processo completo de geração e impressão pode ser visualizado na figura x. 19
Figura 17 Processo de geração e impressão Fluxo de Informações 5.9.2 CANCELAMENTO Cancelar NF-e - O processo de cancelamento pode ser feito após a geração de uma NF-e sendo necessário informar o motivo do cancelamento. O processo de cancelamento é feito em conjunto com o Webservice Orasystems e o Webservice da Receita através do Retaguarda. A aplicação então envia para o Webservice Orasystems a solicitação de cancelamento juntamente com a chave da NF-e e ser cancelada enquanto aguarda o processo de cancelamento ser finalizado. Após a finalização do processo é realizado a impressão de um comprovante de cancelamento garantindo a confiabilidade da operação. O processo de cancelamento pode ser visto na figura x. 20
Figura 18 Cancelamento NF-e 5.9.3 EXCLUSÃO Excluir - 5.9.4 INFORMAÇÃO Info NF-e Retorna a ultima Informação recebida pelo WebService Orasystems relacionado ao processo da NF-e. 5.10 SINCRONISMO 6 TROCA DE VENDEDORES Para realizar o processo de troca de vendedores é necessário realizar a desinstalação da aplicação OSMobile através do item Desinstalar e posteriormente a instalação ou apenas realizar a limpeza dos dados da aplicação através do item Limpar Dados, através do item configurações do menu do dispositivo, na seção de aplicativos, como ilustra a figura X. 21
Figura 19 Processo de desinstalação/limpeza de dados da aplicação OSMobile Após o processo acima é necessário excluir a pasta OSMobile e OSMobileFotos do armazenamento do dispositivo para que o processo de criação seja executado novamente, finalmente já é possível realizar a carga de dados novamente. 7 CONTROLE DE ESTRUTURA DO BANCO DE DADOS OSMOBILE.DB A aplicação OSMobile deve trabalhar sempre com a ultima versão do banco de dados, pois todas as operações feitas no banco de dados devem abranger as colunas já existentes e as novas. Caso a versão da aplicação esteja menor que a versão gerada pelo OSAndroid, a aplicação OSMobile é encarregada de alterar toda a estrutura do banco e atualizar sua versão para a última versão, o controle de estrutura do banco de dados osmobile.db pode ser visto na figura x. 22
Figura 20 Controle de Estrutura osmobile.db FAQ CLIENTES PEDIDOS Novo Pedido Erro Tabelas de preços para este cliente estão inconsistentes! Este erro ocorre quanto o cadastro de cliente não possui tabelas de preços relacionadas a ele, na coluna TABPRECO da tabela CLIENTES; 23