Você está na página 1de 11

Descrio da Soluo NAVS

(Navegador Skytef)

SKYTEF
Verso 1.0 25/05/2012

Verer

Verso 1.0 25/05/2012

Pgina 1

Especificao de Interface

Sumrio
1.0 Introduo ________________________________________________________________________ 3 2.0 3.0 3.1 3.2
3.2.1 3.2.2 3.2.3 3.2.4 3.2.5 3.2.6 3.2.7

Descrio Inicial ________________________________________________________________ 4 Detalhamento dos Comandos _____________________________________________________ 5 CONSOLE ...................................................................................................................................... 5 GET ................................................................................................................................................ 5
CARTO ......................................................................................................................................................... 5 ENTRADA NUMERICA .................................................................................................................................. 5 ENTRADA NUMRICA SECRETA ................................................................................................................ 6 AGUARDA TECLA ......................................................................................................................................... 6 CONTROLA SESSO .................................................................................................................................... 6 VALOR MOEDA ............................................................................................................................................. 7 NUMERO DE SRIE ...................................................................................................................................... 7

3.3 3.4 3.5 3.6 4.0 5.0

PRINTER ........................................................................................................................................ 7 CODEBAR ...................................................................................................................................... 7 INIT ................................................................................................................................................. 8 POST .............................................................................................................................................. 8 Descrio da Mensagem do POS ao Servidor ________________________________________ 9 Exemplo de uso ________________________________________________________________ 10

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

1.0 Introduo
NAVS a plataforma de desenvolvimento da Skytef que proporciona s redes de POS flexibilidade nas aplicaes. Possibilita rpido desenvolvimento de novas funcionalidades e servios, atendendo aos mais diversos mercados como redes adquirentes, private label, bancos, financeiras, correspondente bancrio, fidelidade, entre outros. NAVS um navegador que permite que o POS acesse o servidor, utilizando o mesmo tipo de conexo das transaes. O acesso ao servidor possibilita realizar atualizaes das aplicaes e implementar novos servios, o que pode ser feito em toda rede ou em um nico terminal, de acordo com a necessidade do gestor. Vantagens - Reduz tempo nos processos de certificao de aplicaes - Transforma a rede de POS numa rede de servios - Possibilita ativao/desativao de servios nos terminais POS remotamente - Facilita o desenvolvimento, pois uma plataforma amigvel e intuitiva

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

2.0

Descrio Inicial

NAVS uma aplicao que ser carregada no POS e interpretar comandos recebidos do Servidor. Na carga inicial, dever existir um arquivo XML contendo as informaes da primeira comunicao do POS para o Servidor, como uma inicializao. Na resposta, o Servidor dever enviar os comandos XML para terminar a inicializao e iniciar a primeira transao. O POS capturar os dados desta transao e enviar ao Servidor que dever responder com os comandos para terminar a transao e iniciar a prxima.

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

3.0

Detalhamento dos Comandos

Atravs de scripts, o servidor designar os comandos a serem executados pelo POS, como display, impressora, carto, captura de dados, etc. Abaixo o detalhamento de alguns scripts:

3.1

CONSOLE

<CONSOLE> inicia texto para o display, </CONSOLE> finaliza texto para o display. A mudana de linha realizada pelo comando <BR>.

3.2

GET

<GET...> indica a captura de informaes no POS, abaixo os parmetros mandatrios deste comando: TYPE discrimina o tipo da informao a ser capturada. NAME discrimina o identificador do campo que contm a informao capturada. 3.2.1 CARTO Para capturar os dados do carto, devemos passar para o parmetro TYPE o argumento CARD. Neste caso, haver outro parmetro mandatrio: TRACKS, que especifica quais trilhas do carto devero ser coletadas. O comando deve ser passado conforme o esquema abaixo, notando que a ordem dos parmetros no altera o resultado. <GET NAME=CARTAO1 TYPE=CARD TRACKS=X> X pode ser qualquer valor de 0 a 7, da seguinte forma: 0-no envia nenhuma trilha. 1-envia trilha 1 2-envia trilha 2 4-envia trilha 3 3-envia trilhas 1 e 2 5-envia trilhas 1 e 3 7-envia trilhas 1, 2 e 3

3.2.2 ENTRADA NUMERICA Para capturar uma entrada numrica, no secreta, por meio do teclado devemos passar para o parmetro TYPE o argumento FIELD.
Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface Neste caso haver os parmetros mandatrios: SIZE, COL, LIN. SIZE especifica o tamanho em caracteres do campo a ser capturado. COL especifica a coluna da esquerda para direita onde o primeiro caractere capturado ser mostrado no display. LIN especifica a linha de cima para baixo onde o primeiro caractere capturado ser mostrado no display. Devemos notar que na linha onde ser mostrado o campo, todo texto previamente existente ser apagado. O comando dever ser passado conforme o esquema abaixo: <GET NAME=CAMPO1 TYPE=FIELD SIZE=X COL=Y LIN=Z>

3.2.3 ENTRADA NUMRICA SECRETA Para capturar uma entrada numrica, secreta, por meio do teclado devemos passar para o parmetro TYPE o argumento PASS. Neste caso haver os parmetros mandatrios: SIZE, COL, LIN. SIZE especifica o tamanho em caracteres do campo a ser capturado. COL especifica a coluna da esquerda para direita onde o primeiro asterisco referente ao primeiro caractere capturado ser mostrado no display. LIN especifica a linha de cima para baixo onde o primeiro asterisco referente ao primeiro caractere capturado ser mostrado no display. Devemos notar que na linha onde ser mostrado o campo, todo texto previamente existente ser apagado. O comando dever ser passado conforme o esquema abaixo: <GET NAME=CAMPO2 TYPE=PASS SIZE=X COL=Y LIN=Z> 3.2.4 AGUARDA TECLA Para aguardar o pressionamento de qualquer tecla, sem enviar qualquer informao ao Servidor, devemos passar para o parmetro TYPE o argumento ANYKEY. Note que neste caso o parmetro NAME no dever constar no comando. <GET TYPE=ANYKEY> 3.2.5 CONTROLA SESSO Para controlar a sesso da comunicao, devemos passar para o parmetro TYPE o argumento HIDDEN. Os parmetros NAME e VALUE so sempre obrigatrios. Assim, os parmetros NAME=xxx VALUE=yyy so sempre retornados pelo POS. <GET TYPE=HIDDEN NAME=xxx VALUE=yyy>
Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

3.2.6 VALOR MOEDA Para capturar um valor moeda numrica, no secreta, por meio do teclado devemos passar para o parmetro TYPE o argumento VALUE. Neste caso haver os parmetros mandatrios: SIZE, COL, LIN. Ser mostrado com R$, 2 casas decimais e separao com pontos. Ex.: R$1.000.000,00. SIZE especifica o tamanho em caracteres do campo a ser capturado. COL especifica a coluna da esquerda para direita onde o primeiro caractere capturado ser mostrado no display. LIN especifica a linha de cima para baixo onde o primeiro caractere capturado ser mostrado no display. Devemos notar que na linha onde ser mostrado o campo, todo texto previamente existente ser apagado. O comando dever ser passado conforme o esquema abaixo: <GET NAME=CAMPO1 TYPE=VALUE SIZE=X COL=Y LIN=Z>

3.2.7 NUMERO DE SRIE Para capturar o nmero de srie do terminal, devemos passar para o parmetro TYPE o argumento SERIALNO. O parmetro NAME sempre obrigatrio. Assim, o parmetro NAME=xxx sempre retornado pelo POS. <GET TYPE=SERIALNO NAME=xxx>

3.3

PRINTER

<PRINTER> inicia texto para a impressora, </PRINTER > finaliza texto para a impressora, A mudana de linha realizada pelo comando <BR>.

3.4

CODEBAR

<CODEBAR XXXXXXXX>
Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

Onde XXXXXXXX, o texto a ser convertido para o cdigo de barras.

3.5

INIT

<INIT> define o ponto da transao que o POS retornar quando for acionada a tecla CANCELA (X).

3.6

POST

<POST> comando para que o POS envie as informaes ao Servidor.

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

4.0

Descrio da Mensagem do POS ao Servidor

Todos os campos capturados sero enviados para o Servidor quando for encontrado o comando POST, da seguinte forma: nome1=campo1&nome2=campo2&... Onde, nome o argumento coletado no parmetro NAME do campo em questo, e campo o valor capturado pelo POS. A ordem na qual os campos e seus respectivos valores aparecem na string de mensagem a ordem em que o comando de captura dos respectivos campos aparecem no corpo do XML.

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

Especificao de Interface

5.0

Exemplo de uso

Como exemplo, a sequncia da comunicao entre POS e Servidor poder ser: 1) POS inicia comunicao com Servidor baseado no arquivo XML previamente carregado no POS. 2) Servidor responde com os comandos para iniciar a transao no POS: <INIT> <CONSOLE>--------VENDA--------<BR> PASSE O CARTO<BR><\CONSOLE> <GET NAME=CARTAO TYPE=CARD TRACKS=3> <CONSOLE> DIGITE O VALOR<BR><\CONSOLE> <GET NAME=VALOR TYPE=FIELD SIZE=5 COL=8 LIN=2> <POST>

3) POS mostrar no display: --------VENDA-------- PASSE O CARTAO O POS, ento, aguardar a passagem do carto pelo usurio e ir para o prximo passo da transao: DIGITE O VALOR

Ao iniciar a digitao, teremos no display do POS: DIGITE QUANTIDADE 23 Aps apertar o Enter no teclado, o POS enviar ao Servidor o texto abaixo: CARTAO=trilhas 1 e 2&VALOR=23

4) Servidor poder responder ao POS: <CONSOLE>CARTAO ACEITO<BR><\CONSOLE> <CONSOLE>QUANTIDADE: 23<BR><\CONSOLE> <PRINTER>CARTAO: XXXXXXXXXXX</PRINTER > <INIT> <CONSOLE>--------VENDA--------<BR> PASSE O CARTO<BR><\CONSOLE> <GET NAME=CARTAO TYPE=CARD TRACKS=3> <CONSOLE> DIGITE O VALOR<BR><\CONSOLE> <GET NAME=VALOR TYPE=FIELD SIZE=5 COL=8 LIN=2> <POST>

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

10

Especificao de Interface

5) O POS mostrar no display: CARTAO ACEITO QUANTIDADE: 23

E, imprimir: CARTAO: XXXXXXXXXXX


6) O POS ficar pronto para a prxima transao, mostrando no display:

--------VENDA-------- PASSE O CARTAO


7) O POS sempre voltar para este ponto sempre que a tecla CANCELA for acionada:

--------VENDA-------- PASSE O CARTAO

Especificao: NAVS

Verso 1.0 25/05/2012

SKYTEF

11