Osmobile Manual 1.3

OSMobile Fora de Vendas
Sumrio
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 INSTRUES DE INSTALAO E CONFIGURAO..............................3

3 OSCARGA...........................................................................................4
3.1 Configurando Ambiente de Homologao.............................................5
3.2 Configurando uma base de Demonstrao...........................................6
4 OSFOTO.............................................................................................7
5 OSMOBILE..........................................................................................8
5.1 Mensagens............................................................................................ 8
5.2 Catlogo de Produto............................................................................10
5.3 Calculadora......................................................................................... 10
5.4 GEOLOCALIZAO............................................................................... 11
5.4.1 Geolocalizao de Vendedor.........................................................11
5.5 RELATRIOS........................................................................................ 13
5.5.1 Relatrio de Pedido por Cliente.....................................................13
5.5.2 Relatrio de Produtos Vendidos.....................................................13
5.6 PRODUTOS E TABELAS DE PREO.......................................................13
5.7 CLIENTES............................................................................................. 13
5.8 PEDIDOS.............................................................................................. 14
5.9 PEDIDOS E NOTA FISCAL EMBARCADA (NF-e)......................................15
5.9.1 GERAO E IMPRESSO................................................................15
5.9.2 CANCELAMENTO........................................................................... 20
5.9.3 EXCLUSO..................................................................................... 21
5.9.4 INFORMAO................................................................................ 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
1 REQUISITOS DE HARDWARE E SOFTWARE

1.1 Bluetooth
O Bluetooth utilizado na aplicao para realizar interaes geralmente
com impressoras bluetooth necessrias em alguns casos.
1.2 Internet (Wi-fi / 3G)

O acesso a internet necessrio para a grande parte da interao da
aplicao com os servidores.
1.3 Armazenamento (SDCARD / Armazenamento do Aparelho)

Utilizado para manter o backup de informaes pertinentes aos pedidos
criados na aplicao, caso precisem ser restaurados, assim como auxiliar no
chaveamento do ambiente de homologao e produo.
1.4 GPS (Satelite)

O GPS via satlite utilizado para captar a posio do vendedor que utiliza
os recursos de geolocalizao.
1.5 Android API 8 2.2+

A verso do Android 2.2 a verso mnima necessria para executar a
aplicao OSMobile, funcionando assim em todas as verses superiores a
mesma.
2 INSTRUES DE INSTALAO E CONFIGURAO

O processo de download e instalao da aplicao OSMobile feito
atravs
da
loja
do
Google
Play
pode
ser
acessada
pelo
https://play.google.com/store/apps/details?id=com.orasystems.osmobile.
link:
Alm
disso, a aplicao pode ser encontrada digitando o termo OSMobile na

pesquisa do Google Play. Na pgina da aplicao j possvel realizar o
download e a instalao atravs do boto instalar como ilustra a figura 1.
Figura 1 Download e instalao da aplicao OSMobile

Fonte: Orasystems, 2013.
Aps a instalao j possvel perceber os cones da aplicao no

menu do dispositivo, compostos pelo OSCarga, OSFoto, OSMobile e
OSRestaurar.
OSMobile Aplicao de Fora de Vendas e Gestor de Pedidos

onde realizado todo o processo de vendas.
OSCarga Utilizado para realizar a carga inicial dos dados onde

necessrio 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 restaurao 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

aplicao somente a titulo informativo. A base gerada pelo OSAndroid
enviada via FTP e armazenada de acordo com as especificaes de empresas
e vendedores no momento da gerao.
A carga de dados obtida atravs 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 Informaes

Para realizar o processo de carga necessrio informar os dados de CNPJ

da empresa e Documento do vendedor e iniciar o processo de carga de dados,
ao trmino do processo j ser possvel utilizar a aplicao.
3.1 Configurando Ambiente de Homologao

Para configurar o OSMobile para ambiente de homologao
necessrio 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
diretrio:
G:\Sistema
de
Fora
de
Vendas
ANDROID\Android.
5
O arquivo wsdl.cfg serve para todas as operaes realizadas na

aplicao referentes ao webservice, salvo operaes referentes a NF-e, e deve
conter o contedo abaixo, em que hoje refere-se ao IP de homologao.
http://186.232.109.249:8080/WSOrasystemsONLINE/WSPedidos?WSDL
O arquivo wsdlnew.cfg serve para as operaes realizadas no

webservice novo do pedido e deve conter o contedo abaixo, em que hoje
refere-se
ao
IP
de
homologao.
http://186.232.109.249:8080/WSOrasystemsONLINENew/WSPedidosNew?wsdl
O arquivo wsdlnfe.cfg serve para todas as operaes realizadas ao

processo da NF-e, e deve conter o contedo abaixo, em que hoje refere-se ao
IP interno de homologao
http://186.232.109.249:8080/OSWSNFe/WSORASYSTEMSNFe?wsdl
Aps este processo j possvel perceber que ao abrir o OSCarga

temos o endereo referente ao dos arquivos de homologao.
3.2 Configurando uma base de Demonstrao

Para realizar a carga de uma base de demonstrao 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 boto
Demonstrao Desativada, a qual ir ativar a demonstrao inserindo os
dados nos campos, caso preciso realizar o processo manualmente utilizar o
CNPJ: 06104769000136 e o Documento: 01234567890.
O processo de configurao de uma base de demonstrao pode ser
visto na figura 3.
Ateno este processo no funciona em ambiente de homologao.
Figura 3 OSCarga Configurando base de demonstrao

4 OSFOTO
O sincronismo de fotos realiza o download de fotos de produtos que
possuem fotos no pedido online, este processo feito atravs do OSFoto
clicando no boto 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 diretrio raiz do armazenamento, ao final do processo o
sistema emite um relatrio de quantas fotos foram baixadas, quantas fotos so
novas e quantas fotos foram atualizadas, conforme ilustra a figura 4.
Figura 4 OSFoto processo de sincronismo

5 OSMOBILE
Fazer uma descrio 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 aplicao.
O envio de mensagens para o dispositivo do vendedor se d por meio da
aplicao OSMobile que envia a mensagem para o Webservice armazenar,
posteriormente no momento da inicializao da aplicao, a mesma busca e
exibe as mensagens
no lidas, s ento 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.
Figura 5 Recebimento de uma mensagem

A interao dos processos que envolvem o envio, recebimento, leitura e

confirmao da mensagem podem ser vista na figura 6.
Figura 6 OSMobile Mensagem Fluxo de Informaes

5.2 Catlogo de Produto

Acesso ao catlogo - O catlogo de produto pode ser acessado na
tela listagem de produtos no cone de listagem no canto superior direito.
A aplicao possui um catalogo de produto que contm os produtos que
possuem fotos baixadas pelo sincronismo, este catlogo trabalha em cima do
parmetro dinmico e busca os cdigos de acordo com o parmetro
ORIGEM_CODIGO_FOTO o qual possui os valores 1 para Cdigo Principal e
2 para Cdigo Varejo, a figura 7 ilustra a exibio do catlogo de produto.
Figura 7 Catlogo de Produto

5.3 Calculadora
Calculadora O acesso a calculadora pode ser visto no item
Calculadora do menu principal da aplicao, ou na tela de pedidos.
Todas as chamadas a calculadoras dentro da aplicao utilizam o aplicativo
Calculadora Plus Grtis mantido pela por terceiros (Digitalchemy, LLC),
conforme figura 8, caso a aplicao no esteja instalada feita uma chama
calculadora nativa do sistema operacional do dispositivo.
10
Figura 8 Calculadora Plus Grtis

download
do
aplicativo
est
disponvel
atravs
do
endereo:
https://play.google.com/store/apps/details?
id=com.digitalchemy.calculator.freedecimal.
5.4 GEOLOCALIZAO
5.4.1 Geolocalizao de Vendedor
O processo de geolocalizao de vendedores no OSMobile acontece de
forma transparente para o vendedor, de modo que a geolocalizao obtida
atravs uma taxa especfica de distncia do ponto anterior do GPS (caso esteja
disponvel o servio de GPS e ATIVO no dispositivo) e do prximo ponto, ou
seja, s salvo um ponto caso este ponto esteja a uma distancia aceitvel do
ponto anterior.
Todo novo ponto geogrfico capturado (composto por latitude e longitude)
enviado automaticamente para o WebService caso haja conexo de dados,
caso contrrio este processo ser realizar posteriormente atravs de uma
varredura em registros que no foram sincronizados, este processo ocorre de
15 em 15 minutos.
O servio responsvel por realizar este processo executado em
background e chama-se ServiceBackground como mostra a figura x. A
inicializao do servio ocorre no momento em que a aplicao OSMobile
inicializa.
11
Figura 9 Servio de geolocalizao de vendedor

O processo de ativao automtica de GPS ocorre apenas em verses do

Android anteriores 3.0 por diretivas de seguranas impostas pela Google Inc,
em caso de verses superiores o servio de GPS deve ser ativado
manualmente na parte de Configuraes no item Localizao, deve-se ativar a
opo de rastreamento de GPS via satlite. A ativao do GPS via satlite
pode ser vista na figura x.
Figura 10 Ativao do GPS via satlite

O processo de geolocalizao de vendedores e sincronismo de dados

pode ser visto na imagem x.
12
Figura 11 Geolocalizao de Vendedores e sincronismo

5.5 RELATRIOS
5.5.1 Relatrio de Pedido por Cliente
5.5.2 Relatrio de Produtos Vendidos
5.6 PRODUTOS E TABELAS DE PREO
5.7 CLIENTES
Clientes - A carteira de clientes do vendedor pode ser acessada
atravs do item Clientes do menu principal da aplicao OSMobile, nela
possvel filtrar todos os clientes de acordo com os critrios desejados, assim
como visualizar seus dados completos clicando no boto
, conforme ilustra
a figura x.
13
Figura 12 Carteira de Clientes

5.8 PEDIDOS
Pedidos - possvel ter uma viso geral sobre todos os pedidos
realizados por Clientes atravs do item Pedidos do menu principal da aplicao
OSMobile, conforme ilustra a figura x.
Para gerenciar os pedidos necessrio acessar a carteira de clientes
atravs do item Clientes do menu principal da aplicao OSMobile conforme a
figura x, posteriormente clicar em vendas e acessar a tela de gerenciamento de
pedidos.
As aes disponveis na tela de gerenciamento de pedidos so:
Novo Pedido - O processo de criao de um novo pedido pode ser
visto na figura x, este processo se divide em etapas, as informaes gerais que
formam o cabealho do pedido, os itens do pedido e os itens de trocas. Todas
estas informaes so mantidas em um banco SQLite separado chamado
movimento.db.
14
Alterar Pedido Processo de alteraes segue as mesmas regras

de negcio e processos da operao de incluso.
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 Excluso de um pedido e todas as suas
dependncias do banco de dados.
5.9 PEDIDOS E NOTA FISCAL EMBARCADA (NF-e)

A aplicao conta com os recursos de Nota Fiscal Embarcada, caso o
parmetro dinmico NOTA_EMBARCADA esteja como S.
5.9.1 GERAO E IMPRESSO

Gera NF-e - Depois de realizado um pedido possvel gerar NF-e
atravs dos recursos do Webservice, o qual realiza todo o processo de gerao
em conjunto com o Webservice da Receita Federal atravs do Retaguarda. O
processo de gerao depende de servios externos por isso necessrio ficar
aguardando uma resposta do status de gerao da NF-e at que esteja pronto
para impresso.
Aps a gerao da NF-e ela poder ser impressa atravs 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 verso 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 gerao e impresso pode ser visualizado na

figura x.
19
Figura 17 Processo de gerao e impresso Fluxo de Informaes

5.9.2 CANCELAMENTO
Cancelar NF-e - O processo de cancelamento pode ser feito aps a
gerao de uma NF-e sendo necessrio informar o motivo do cancelamento. O
processo de cancelamento feito em conjunto com o Webservice Orasystems
e o Webservice da Receita atravs do Retaguarda. A aplicao ento envia
para o Webservice Orasystems a solicitao de cancelamento juntamente com
a chave da NF-e e ser cancelada enquanto aguarda o processo de
cancelamento ser finalizado. Aps a finalizao do processo realizado a
impresso de um comprovante de cancelamento garantindo a confiabilidade da
operao. O processo de cancelamento pode ser visto na figura x.
20
Figura 18 Cancelamento NF-e

5.9.3 EXCLUSO
Excluir -
5.9.4 INFORMAO
Info NF-e Retorna a ultima Informao 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 necessrio realizar a
desinstalao da aplicao OSMobile atravs do item Desinstalar e
posteriormente a instalao ou apenas realizar a limpeza dos dados da
aplicao atravs do item Limpar Dados, atravs do item configuraes do
menu do dispositivo, na seo de aplicativos, como ilustra a figura X.
21
Figura 19 Processo de desinstalao/limpeza de dados da aplicao OSMobile

Aps o processo acima necessrio excluir a pasta OSMobile e

OSMobileFotos do armazenamento do dispositivo para que o processo de
criao seja executado novamente, finalmente j possvel realizar a carga de
dados novamente.
7 CONTROLE DE ESTRUTURA DO BANCO DE DADOS

OSMOBILE.DB
A aplicao OSMobile deve trabalhar sempre com a ultima verso do banco
de dados, pois todas as operaes feitas no banco de dados devem abranger
as colunas j existentes e as novas. Caso a verso da aplicao esteja menor
que a verso gerada pelo OSAndroid, a aplicao OSMobile encarregada de
alterar toda a estrutura do banco e atualizar sua verso para a ltima verso, 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 preos para este cliente esto inconsistentes!

Este erro ocorre quanto o cadastro de cliente no possui tabelas de
preos relacionadas a ele, na coluna TABPRECO da tabela CLIENTES;
23

Osmobile Manual 1.3

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Osmobile Manual 1.3

Enviado por

Direitos autorais:

Formatos disponíveis

OSMobile Fora de Vendas

2 INSTRUES DE INSTALAO E CONFIGURAO..............................3

1 REQUISITOS DE HARDWARE E SOFTWARE

1.2 Internet (Wi-fi / 3G)

1.3 Armazenamento (SDCARD / Armazenamento do Aparelho)

1.4 GPS (Satelite)

1.5 Android API 8 2.2+

2 INSTRUES DE INSTALAO E CONFIGURAO

disso, a aplicao pode ser encontrada digitando o termo OSMobile na

Figura 1 Download e instalao da aplicao OSMobile

Aps a instalao j possvel perceber os cones da aplicao no

OSMobile Aplicao de Fora de Vendas e Gestor de Pedidos

OSCarga Utilizado para realizar a carga inicial dos dados onde

OSFoto Utilizado para realizar o sincronismo de fotos dos

OSRestaurar Utilizado para realizar a restaurao de dados do

do sistema. A base gerada do tipo SQLite e utilizada na maior parte da

Figura 2 OSCarga Processo de Carga de Dados Fluxo de Informaes

Para realizar o processo de carga necessrio informar os dados de CNPJ

3.1 Configurando Ambiente de Homologao

O arquivo wsdl.cfg serve para todas as operaes realizadas na

O arquivo wsdlnew.cfg serve para as operaes realizadas no

O arquivo wsdlnfe.cfg serve para todas as operaes realizadas ao

Aps este processo j possvel perceber que ao abrir o OSCarga

3.2 Configurando uma base de Demonstrao

Figura 3 OSCarga Configurando base de demonstrao

Figura 4 OSFoto processo de sincronismo

no lidas, s ento devolve uma confirmando que o

vendedor est ciente da leitura da mensagem.

Figura 5 Recebimento de uma mensagem

A interao dos processos que envolvem o envio, recebimento, leitura e

Figura 6 OSMobile Mensagem Fluxo de Informaes

5.2 Catlogo de Produto

Figura 7 Catlogo de Produto

Figura 8 Calculadora Plus Grtis

Figura 9 Servio de geolocalizao de vendedor

O processo de ativao automtica de GPS ocorre apenas em verses do

Figura 10 Ativao do GPS via satlite

O processo de geolocalizao de vendedores e sincronismo de dados

Figura 11 Geolocalizao de Vendedores e sincronismo

Figura 12 Carteira de Clientes

Alterar Pedido Processo de alteraes segue as mesmas regras

5.9 PEDIDOS E NOTA FISCAL EMBARCADA (NF-e)

5.9.1 GERAO E IMPRESSO

Figura 13 Impressora Leopardo A7 (InputService)

O DANFE impresso na impressora Leopardo A7 pode ser visto na figura x.

Figura 14 DANFE Impresso na Leopardo A7

Figura 15 Impressora Zebra TLP 2844 (RR Engenharia)

Figura 16 DANFE Impressora na Zebra TLP 2844

O processo completo de gerao e impresso pode ser visualizado na

Figura 17 Processo de gerao e impresso Fluxo de Informaes

Figura 18 Cancelamento NF-e

Figura 19 Processo de desinstalao/limpeza de dados da aplicao OSMobile

Aps o processo acima necessrio excluir a pasta OSMobile e

7 CONTROLE DE ESTRUTURA DO BANCO DE DADOS

Figura 20 Controle de Estrutura osmobile.db

Erro Tabelas de preos para este cliente esto inconsistentes!

Você também pode gostar