Explorar E-books
Categorias
Explorar Audiolivros
Categorias
Explorar Revistas
Categorias
Explorar Documentos
Categorias
MANUAL DO USUÁRIO
Introdução ...............................................................................................................................................1
Comunicação entre o Sistema ZEUS Frente de Loja e o Sistema Retaguarda ................................2
Exemplos: ..........................................................................................................................................2
O processo de comunicação é o seguinte: ....................................................................................3
Formatação das mensagens .................................................................................................................4
Cabeçalho de solicitação..................................................................................................................4
Cabeçalho de resposta .....................................................................................................................5
Formatação de cada serviço .................................................................................................................6
Consultas (serviços 01 e 02) ............................................................................................................6
Notificação de pagamento aceito (serviço 03) ...............................................................................9
Emissão de extrato (serviço 04).....................................................................................................10
Validação de senha (serviço 05) ....................................................................................................11
Algoritmo 01................................................................................................................................12
Validação de campo digitado (serviço 06)....................................................................................13
Consulta para recebimento de valores devidos (serviço 07) .....................................................14
Validação das parcelas calculadas em planos de pagamento (serviço 08) ..............................16
Informações de mercadoria (serviço 09) ......................................................................................18
Operações disponíveis no PDV ..........................................................................................................19
Instalação ..............................................................................................................................................20
No Concentrador .............................................................................................................................20
No PDV .............................................................................................................................................20
Parametrização .....................................................................................................................................21
Consulta para aceitar pagamento..................................................................................................21
Validação de senha de cliente para aceitar pagamento ..............................................................22
INTRODUÇÃO
Introdução
O Sistema ZEUS Frente de Loja contém opções para integração com sistemas de retaguarda
genéricos (do próprio usuário, tipicamente).
Essa integração permite que o PDV:
• Faça consultas ao cadastro de clientes da retaguarda no momento de validação dos
pagamentos;
• Notifique a retaguarda dos pagamentos aceitos para cada cliente;
• Faça consultas ao cadastro de clientes a qualquer momento;
• Valide senha de cliente;
• Emita extratos da conta do cliente a partir do número do cliente ou do número da fatura.
• Consulte informações ao sistema de controle de crédito para recebimento de valores devidos
pelo cliente, em créditos rotativos e parcelados.
A integração Sistema ZEUS Frente de Loja – Sistema Retaguarda se dá através da troca de dados
(mensagens) via arquivos.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 1
COMUNICAÇÃO SISTEMA ZEUS Frente de Loja - RETAGUARDA
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 2
COMUNICAÇÃO SISTEMA ZEUS Frente de Loja - RETAGUARDA
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 3
FORMATAÇÃO DAS MENSAGENS
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 4
FORMATAÇÃO DAS MENSAGENS
Cabeçalho de resposta
As mensagens de resposta também possuem um cabeçalho padrão, apresentado abaixo:
Cabeçalho de uma mensagem de resposta (Retaguarda ==> PDV) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
ASSINATURA Assinatura do protocolo Zanthus. Alfanumérico 1 1
Preenchimento fixo - “Z”.
NUMSEQ Número de seqüência da Numérico 2 6
mensagem (deve ser o mesmo
número usado na mensagem de
solicitação).
TIPOLAYOUT Tipo de layout da mensagem. Numérico 8 2
Preenchimento fixo – “01”.
CODRETORNO Código de retorno da transação Numérico 10 4
(zero indica sucesso).
CODRETAG Código de retorno da retaguarda Numérico 14 4
(não utilizado nas versões atuais)
Número de bytes do cabeçalho de uma mensagem de resposta 17
Em qualquer transação, o código de retorno (CODRETORNO) será lido pelo PDV, que interpretará um
valor diferente de zero como sendo um código de falha. Esse código de falha, adicionado de 7000,
será exibido ao operador do PDV. Se o sistema de retaguarda desejar que o PDV exiba uma
mensagem específica, basta concatenar o texto ao cabeçalho da resposta, de acordo com o seguinte
layout:
Mensagem de resposta com erro (Retaguarda ==> PDV) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum de resposta, 1 17
com CODRETORNO diferente
de zero
MSGPDV Mensagem para o PDV. Alfanumérico 18 20
MSGERRO Mensagem de erro. Alfanumérico 38 50
LINEFEED [LF] Avanço de linha. -- 88 1
Número total de bytes de uma mensagem de resposta com erro 105
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 5
FORMATAÇÃO DE CADA SERVIÇO
Quando a operação for bem sucedida, o programa do usuário deverá preencher o campo
CODRETORNO do cabeçalho de resposta com zero, e montar as informações de acordo com o
seguinte layout:
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 6
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 7
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 8
FORMATAÇÃO DE CADA SERVIÇO
Quando a operação for mal sucedida, o programa do usuário deverá retornar o campo
CODRETORNO com um valor diferente de zero, que represente o código da falha. Com exceção do
valor 3, o PDV tratará qualquer valor de CODRETORNO como falha na consulta. Se CODRETORNO
for igual a 3, o PDV assumirá que o cliente não está cadastrado. Este caso especial é importante,
porque a parametrização do PDV pode permitir o aceite de pagamento de cliente não cadastrado.
Valem as observações sobre a exibição de textos específicos nos retornos com falha, citadas na
descrição do cabeçalho de resposta, acima. (CodFon 56)
Exemplo de uma mensagem de resposta com erro:
• Conteúdo do arquivo RETAG.001
Z0000010100030003Falha na consulta Falha ao consultar retaguarda [LF]
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 9
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 10
FORMATAÇÃO DE CADA SERVIÇO
Para este serviço, a resposta deve ser apenas o cabeçalho comum de resposta. O PDV assumirá que
a senha está correta se o campo de resultado (CODRETORNO) retornar zerado.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 11
FORMATAÇÃO DE CADA SERVIÇO
Algoritmo 01
A senha digitada no teclado do PDV será transmitida de forma codificada, por questões de segurança,
da seguinte maneira: cada caracter deve ser traduzido pela tabela abaixo de acordo com sua posição
no campo SENHADIGIT, sendo que o primeiro caracter indica o número de dígitos da senha. A senha
propriamente dita começa no segundo caracter.
Significado de cada posição no campo SENHADIGIT (0 corresponde à primeira posição)
Caractere 0 1 2 3 4 5 6 7 8 9 10 11
B 0 0 8 5 2
P 1 1 9 6 3 0
H 2 2 7 4 1
I 3 3 0 8 5 2
J 4 4 1 9 6 3 0
R 5 5 2 7 4 1
K 6 6 3 0 8 5 2
Q 7 7 4 1 9 6 3 0
7 8 8 5 2 7 4 1
M 9 9 6 3 0 8 5 2
U 10 7 4 1 9 6 3 0
C 11 8 5 2 7 4 1
D 9 6 3 0 8 5 2
F 7 4 1 9 6 3
N 8 5 2 7 4
2 9 6 3 0 8 5
G 7 4 1 9 6
L 8 5 2 7
A 9 6 3 0 8
S 7 4 1 9
Exemplo de tradução quando o campo SENHADIGIT vier preenchido com “7PRMFLPRMMA2”:
Caractere Caractere
Posição Conteúdo Posição Conteúdo
convertido convertido
0 7 8 6 P 6
1 P 1 7 R 7
2 R 2 8 R 8
3 M 3 9 M
4 F 4 10 A
5 L 5 11 2
A senha digitada neste caso é “12345678”. Observe que os caracteres a partir da posição 9 devem
ser ignorados, uma vez que o tamanho informado na primeira posição foi 8.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 12
FORMATAÇÃO DE CADA SERVIÇO
Para este serviço, a resposta deve ser apenas o cabeçalho comum de resposta. O PDV assumirá que
o campo digitado é válido se o campo de resultado (CODRETORNO) retornar zerado.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 13
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 14
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 15
FORMATAÇÃO DE CADA SERVIÇO
Para este serviço, a resposta deve ser apenas o cabeçalho comum de resposta. O PDV assumirá que
o mapa de vencimentos é válido se o campo de resultado (CODRETORNO) retornar zerado.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 17
FORMATAÇÃO DE CADA SERVIÇO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 18
OPERAÇÕES DISPONÍVEIS NO PDV
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 19
INSTALAÇÃO
Instalação
No Concentrador
Para que a integração com a retaguarda funcione, é necessário definir as regiões, ou caminhos, onde
serão criados os arquivos de solicitação e onde serão lidos os arquivos de respostas às solicitações.
Estes parâmetros são definidos através do arquivo ZANTHUS.CFG que é utilizado pelo Sistema
ZEUS Frente de Loja, na figura do módulo Concentrador. Estes parâmetros são identificados
através das seguintes palavras: RETAG_MANDA e RETAG_RECEBE
Por exemplo:
Conteúdo do arquivo ZANTHUS.CFG
RETAG_MANDA=C:\ConsultaRetaguarda\PDVRetag
RETAG_RECEBE=C:\ConsultaRetaguarda\RetagPDV
Onde C:, como já mencionado, representa uma unidade local de um microcomputador, que poderá
ser substituída por uma região mapeada em rede.
O parâmetro RETAG_MANDA determina a região onde serão gerados, pelo Sistema ZEUS Frente
de Loja, os arquivos de solicitação dos PDV’s.
O parâmetro RETAG_RECEBE determina a região onde serão lidos, pelo Sistema ZEUS Frente de
Loja, os arquivos de resposta aos PDV’s.
O programa aplicativo do usuário deverá realizar a leitura dos arquivos de solicitação na região
determinada através do parâmetro RETAG_MANDA; e deverá escrever a resposta a solicitação na
região determinada através do parâmetro RETAG_RECEBE.
Além da configuração dos caminhos para comunicação, o Concentrador deve ser habilitado para
tratar as solicitações de acesso à retaguarda dos PDVs. Isso deve ser feito no menu
“Concentrador/Retaguarda...”, na opção “Ativar integração”.
No PDV
Para que o PDV passe a tentar o acesso à retaguarda, a integração deve ser ativada através da
função 6301 - Ativa integração com a retaguarda. Esta ativação é preservada pelo programa do
PDV (mesmo que haja mudança de data) até que seja desativada pela função 6302 - Desativa
integração com a retaguarda. Portanto, não é uma operação diária: basta uma ativação para que o
PDV permaneça preparado.
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 20
PARAMETRIZAÇÃO
Parametrização
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 21
PARAMETRIZAÇÃO
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 22