Você está na página 1de 24

A SOLUÇÃO EM AUTOMAÇÃO COMERCIAL

MANUAL DO USUÁRIO

Sistema ZEUS Frente de Loja


Integração com Retaguarda

M009 – Revisão 16 – 14/01/2003

ZANTHUS INDÚSTRIA E COMÉRCIO DE EQUIPAMENTOS ELETRÔNICOS S.A.


Fone (11) 3365 – 1300 www.zanthus.com.br
ÍNDICE

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

Comunicação entre o Sistema ZEUS Frente de Loja e o Sistema Retaguarda


A implementação da integração com a retaguarda exige que o usuário escreva um programa de
acesso às suas bases de dados, com seus próprios métodos de acesso.
A troca de dados ocorre através de arquivos gerados em determinados diretórios, ou subdiretórios,
que são configurados e utilizados pelo Sistema ZEUS Frente de Loja e o programa do usuário.
Exemplos:
X:\Consulta\PDVRetag Representa o diretório em que são escritos os arquivos de
solicitação do PDV ao Sistema Retaguarda
X:\Consulta\RetagPDV Representa o diretório em que são escritos os arquivos de
resposta do Sistema Retaguarda ao PDV
X:\Consulta\PDVRetag\RETAG.001 Representa o arquivo de solicitação do PDV ao Sistema
Retaguarda. A extensão do arquivo (“.001”) representa o
número do PDV que está fazendo a solicitação. Exemplo: ao
PDV de número 17 criará o arquivo RETAG.017
X:\Consulta\RetagPDV\RETAG.001 Representa o arquivo de resposta do Sistema Retaguarda ao
PDV. Como no caso acima, a extensão do arquivo (“.001”)
representa o número do PDV para o qual a resposta está
destinada.
Nos exemplos acima, “X:” representa uma unidade de disco do computador que pode ser uma
unidade da rede do usuário.

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

O processo de comunicação é o seguinte:


Sistema ZEUS Frente de Loja Sistema Retaguarda
1 REPOUSO: Espera o aparecimento de algum
arquivo de nome RETAG.nnn no diretório
combinado para comunicação PDV-Retaguarda
(definido por RETAG_MANDA=).
2 PDV nnn precisa fazer um acesso à
retaguarda
3 Grava a solicitação em arquivo temporário,
de nome TEMP.nnn (nnn é o número do
PDV) no diretório combinado para
comunicação PDV-Retaguarda (definido por
RETAG_MANDA=).
4 Renomeia o arquivo temporário criado
(TEMP.nnn) para RETAG.nnn.
5 Reconhece a existência do arquivo RETAG.nnn.
6 Renomeia o arquivo detectado (RETAG.nnn)
para PDVTMP.nnn, para sinalizar ao Sistema
ZEUS Frente de Loja que está tratando a
solicitação.
7 Percebe que o arquivo RETAG.nnn não Interpreta o conteúdo do arquivo PDVTMP.nnn,
existe mais (“a solicitação está sendo tratada apagando-o a seguir, e executa a solicitação.
pela retaguarda”). Passa a esperar o
aparecimento do arquivo RETAG.nnn no
diretório combinado para comunicação
Retaguarda-PDV (definido por
RETAG_RECEBE=)
8 Conclui o tratamento e grava o resultado em
arquivo temporário, de nome RETTMP.nnn, no
diretório combinado para comunicação
Retaguarda-PDV (definido por
RETAG_RECEBE=)
9 Renomeia o arquivo temporário criado
(RETTMP.nnn) para RETAG.nnn.
10 Reconhece a existência do arquivo
RETAG.nnn no diretório comum.
11 Trata o conteúdo do arquivo RETAG.nnn,
apagando-o a seguir.
12 Percebe que o arquivo RETAG.nnn não existe
mais (“a resposta foi recebida pelo Sistema
ZEUS Frente de Loja”). Volta ao repouso
(esperar o aparecimento de algum arquivo
RETAG.nnn).
É importante ressaltar a importância da criação dos arquivos temporários, que depois são
renomeados para os nomes esperados: essa precaução evita que o outro sistema assuma que o
arquivo está pronto quando ele ainda está sendo gravado.

SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 3
FORMATAÇÃO DAS MENSAGENS

Formatação das mensagens


As mensagens trocadas pelos aplicativos devem obedecer a formatos pré-determinados.
O layout de solicitação é formatado pelo PDV e o layout de resposta deve ser formatado pelo
aplicativo do usuário com base nos dados do Sistema de Retaguarda.
Observe as regras gerais para o preenchimento dos campos (as exceções serão destacadas em cada
caso):
Tipo do campo Justificação Preenchimento
Numérico Direita As posições não utilizadas deverão ser preenchidas com
“0” (zero).
Valor monetário Direita As posições não utilizadas deverão ser preenchidas com
“0” (zero). No tamanho do campo já estão incluídas as
duas casas para os centavos.
Alfanumérico Esquerda As posições não utilizadas deverão ser preenchidas com “
“ (branco).
As mensagens, tanto de solicitação como de resposta, possuem cabeçalhos padronizados. Em outras
palavras, toda mensagem de solicitação será enviada pelo PDV com o cabeçalho de solicitação, e
toda resposta deverá ser formatada com o cabeçalho de resposta.
Cabeçalho de solicitação
Abaixo apresentamos o cabeçalho para mensagens de solicitação.
Cabeçalho de uma mensagem de solicitação (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
Assinatura do protocolo Zanthus.
ASSINATURA Preenchimento fixo - “Z”. Alfanumérico 1 1
NUMSEQ Número de seqüência da mensagem. Numérico 2 6
Tipo de layout da mensagem.
TIPOLAYOUT Preenchimento fixo - “01”. Numérico 8 2
TIPOSERVIÇO Tipo de serviço (ver tabela abaixo). Numérico 10 2
Número de bytes do cabeçalho de uma mensagem de solicitação 11
O campo NUMSEQ representa o número de seqüência da mensagem que é gerado e controlado pelo
Sistema ZEUS Frente de Loja. O aplicativo de retaguarda deverá repetir o mesmo conteúdo na
resposta, para que o PDV compare com o número enviado.
O campo TIPOSERVIÇO representa o tipo de serviço que está sendo solicitado. As opções são:
TIPOSERVIÇO Serviço
01 Consulta ao cadastro de clientes
02 Consulta ao cadastro de clientes para validar pagamento
03 Notificação à retaguarda de pagamento aceito
04 Emissão de extratos da conta do cliente
05 Validação de senha
06 Validação de campo digitado
07 Consulta para recebimento de valores devidos
08 Validação das parcelas calculadas em planos de pagamento.
09 Informações de mercadoria
Veja, adiante, a definição do layout de cada serviço.

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

Formatação de cada serviço

Consultas (serviços 01 e 02)


Abaixo apresentamos o layout de uma mensagem de consulta.
Mensagem de solicitação (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com 1 11
TIPOSERVIÇO 01, 02 ou 03)
TIPOCODIGO Tipo do código: Numérico 12 1
0 – Código do cliente.
1 – C.P.F./CNPJ
CODIGOCLIENT Código do cliente informado no Numérico 13 19
PDV.
CODIGOLOJA Código da loja. Numérico 32 4
NUMPDV Número do PDV. Numérico 36 3
NUMCUPOM Número do cupom. Numérico 39 6
NUMFINALIZA Número da finalizadora. Numérico 45 3
DATAVENC Data para vencimento Numérico 48 8
(DDMMAAAA)
NUMDIASVENC Número de dias para vencimento. Numérico 56 4
VALORCHEQ Valor do cheque. Numérico 60 12
NUMBANCO Número do banco do cheque. Numérico 72 4
CODAGENCIA Código da agência do cheque. Numérico 76 5
NUMCONTA Número da conta corrente do Numérico 81 16
cheque.
NUMCHEQ Número do cheque. Numérico 97 16
NUMCPFCHEQ Número do C.P.F. do cheque. Numérico 113 15
IDENTCAIXA Identificação do caixa. Numérico 128 9
IDENTFISCAL Identificação do fiscal. Numérico 137 16
NUMAUTORVE Número de autorização da venda. Alfanumérico 153 16
ND
PLANO Código do plano de pagamento Numérico 169 3
(CodFon 63)
FINALIZ1PLAN Primeira finalizadora do plano Numérico 172 3
(CodFon 63)
FINALIZ2PLAN Segunda finalizadora do plano Numérico 175 3
(CodFon 63)
FINALIZ3PLAN Terceira finalizadora do plano Numérico 178 3
(CodFon 63)
CODOPER Código de operação do plano Numérico 181 3
(CodFon 63)
NROFUNCAO Código da função sendo Numérico 184 5
executada
(CodFon 70)
LINEFEED [LF] Avanço de linha. -- 189 1
Número total de bytes de uma mensagem de solicitação 189
Exemplo de uma mensagem de consulta:
• Conteúdo do arquivo RETAG.001
Z000001010110000000000000012345000201900017100123101999000000000000124503410006200000000004392
290000000000008848000015017978937idencaixaIdentificafiscal000000000000000000100200000000001110[LF]

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

Mensagem de resposta (Retaguarda ==> PDV) Tipo de layout: 01


Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum de resposta, com 1 17
CODRETORNO igual a zero
CODIGOCLIENT Código do cliente informado no PDV. Numérico 18 19
STATUSCLIENT Status do cliente. Numérico 37 3
DESCRSTATUS Descrição do status do cliente. Alfanumérico 40 30
SALDODISP Valor do saldo disponível. Numérico 70 12(2)*
CODAUTORVEND Código de autorização da venda. Alfanumérico 82 16
NUMCPFCLIENT Número do C.P.F./CNPJ do cliente. Numérico 98 15
NUMRGCLIENT Número do R.G./IE do cliente. Numérico 113 16
NUMTELCLIENT Número do telefone do cliente. Alfanumérico 129 16
NOMECLIENTE Nome do cliente. Alfanumérico 145 48
ENDCLIENTE Endereço do cliente. Alfanumérico 193 40
NUMENDCLIENT Número do endereço do cliente. Alfanumérico 233 8
COMPENDCLIENT Complemento do endereço do cliente. Alfanumérico 241 20
BAIRROCLIENTE Nome do bairro do endereço do Alfanumérico 261 20
cliente.
MUNICICLIENTE Nome do município do endereço do Alfanumérico 281 20
cliente.
UFCLIENTE Nome da unidade federal do endereço Alfanumérico 301 2
do cliente.
CEPCLIENTE Número do C.E.P. do endereço do Alfanumérico 303 8
cliente.
NASCIMENTO Data de nascimento (DDMMAAAA) Numérico 311 8
DIAVENCIMENTO Dia do mês do vencimento do cliente Numérico 319 2
DIACORTE Dia de corte do vencimento Numérico 321 2
INIBEPONTOS Calcula pontos para cliente: Numérico 323 1
0 – sim, usando fator de acréscimo
definido no arquivo de textos, chave
922-000-003
1 – não
2 – sim, usando FATORCLIENTE
FATORCLIENTE Fator de acréscimo de pontos para Numérico 324 9(4)
cliente
PONTOSACUM Número de pontos atuais do cliente Numérico 333 9(2)
DATAPONTOS Data dos pontos atuais (DDMMAA) Numérico 342 6
HORAPONTOS Hora dos pontos atuais (HHMM) Numérico 348 4
TRATASTATUS Tratamento se conteúdo do campo Numérico 352 5
STATUSCLIENT diferente de zero
(considerar a soma das opções
abaixo, conforme desejado):
0 – O cliente é bloqueado,
exibindo a mensagem existente
em DESCRSTATUS e não é
permitido o recebimento.
1 – Será exibida a mensagem e a
transação é aceita.
2 – Será exibida a mensagem e a
transação só será aceita com
liberação do supervisor
4 – Será sempre exibida,
independentemente do Status.
8 – O complemento do nome será
exibido, independentemente do
Status.
(CodFon 56)

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

Mensagem de resposta (Retaguarda ==> PDV) Tipo de layout: 01


Campo Descrição Tipo Início Tamanho
COMPLNOME Complemento do nome do cliente, a Alfanumérico 357 20
ser usado na quando houver opção
de impressão (por exemplo,
comprovante de compra)
(CodFon 56)
PROIBETIPO1 Proíbe cliente na venda do tipo 1: Numérico 377 1
0 – não proíbe
1 – proíbe
(CodFon 57)
PROIBETIPO2 Proíbe cliente na venda do tipo 2: Numérico 378 1
0 – não proíbe
1 – proíbe
(CodFon 57)
PROIBETIPO3 Proíbe cliente na venda do tipo 3: Numérico 379 1
0 – não proíbe
1 – proíbe
(CodFon 57)
PROIBETIPO4 Proíbe cliente na venda do tipo 4: Numérico 380 1
0 – não proíbe
1 – proíbe
(CodFon 57)
PROIBETIPO5 Proíbe cliente na venda do tipo 5: Numérico 381 1
0 – não proíbe
1 – proíbe
(CodFon 57)
REFENDER Ponto de referência do endereço do Alfanumérico 382 72
cliente
(CodFon 63)
LINEFEED [LF] Avanço de linha. -- 454 1
Número total de bytes de uma resposta com sucesso 454
(*) Se o campo saldo for negativo, o primeiro caracter deve ser o sinal de menos (“-”), e os dígitos
ocuparão os onze caracteres restantes.
Se a mensagem de resposta for menor do que o tamanho especificado, o PDV assumirá que os
campos correspondentes às posições faltantes estão zerados, o que, dependendo da operação em
andamento, poderá provocar a recusa do cliente.

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

Exemplo de uma mensagem de resposta com sucesso:


• Conteúdo do arquivo RETAG.001
Z00000101000000000000000000000012345000 0000001000000000000000001234000
015013557836 193203050000001151822484ZANTHUS Industria e Comercio de Equip. Ltda. Rua Enxovia
420/424 Prox. Shop. Morumbi Chac. Sto. Antonio Sao Paulo SP[LF]

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]

Notificação de pagamento aceito (serviço 03)


A notificação de pagamento aceito segue o mesmo layout descrito para os serviços 01 e 02.
Naturalmente, o cabeçalho da solicitação deve conter 03 no campo TIPOSERVIÇO.
A resposta também segue o layout descrito para os serviços 01 e 02.
O serviço 03 está relacionado a uma execução anterior do serviço 01. A seqüência seria a seguinte:
1. O PDV envia uma mensagem solicitando o serviço “01” (solicitação de aprovação);
2. O Sistema Retaguarda envia uma resposta positiva;
3. O PDV efetiva o pagamento e termina a transação;
4. O PDV envia uma mensagem com o serviço “03” (notificação de pagamento);
5. O Sistema Retaguarda envia uma resposta positiva.

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

Emissão de extrato (serviço 04)


Para este serviço o layout da mensagem de solicitação é o seguinte:
Mensagem de solicitação de extrato (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com 1 11
TIPOSERVIÇO igual a 04)
CODIGOCLIENT Código do cliente informado no Numérico 12 19
PDV
TIPOCONSULTA Tipo de consulta a ser efetuada Numérico 31 1
(Ver Operações Disponíveis no
PDV)
LINEFEED [LF] Avanço de linha. -- 32 1
Número total de bytes de uma mensagem de solicitação de extrato 32

Exemplo de uma mensagem de solicitação de serviço de emissão de extrato.


• Conteúdo do arquivo RETAG.001
Z000001010400000000000000123450[LF]

Para este serviço temos a seguinte resposta:


Mensagem de resposta à solicitação de extrato (Retaguarda ==> PDV) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum de resposta 1 17
STATUSCLIENT Status do cliente. Numérico 18 3
DESCRSTATUS Descrição do status do cliente. Alfanumérico 21 30
NOMECLIENTE Nome do cliente. Alfanumérico 51 até 48
LINEFEED [LF] Avanço de linha. -- Variável 1
TEXTO Texto do extrato, com linhas Alfanumérico Variável Variável
separadas por LINEFEED [LF].
O tamanho total dessa mensagem de resposta é variável e depende do tamanho do extrato
formatado.
A resposta ao extrato é tratada da seguinte forma pelo PDV: a primeira linha (até o primeiro
LINEFEED, aquele que vem após o campo NOMECLIENTE) é lida e interpretada (verificando-se o
resultado no cabeçalho). Se o retorno indicar sucesso, o texto a partir do caracter seguinte a esse
primeiro [LF] será impresso.
O campo TEXTO representa uma série de linhas que poderão ser adicionadas a essa mensagem de
resposta. Essas linhas de texto representam o extrato que é formatado e fornecido, pelo aplicativo do
usuário, com base nos dados contidos em seu sistema de retaguarda. Cada linha a ser impressa
deverá possuir um [LF] no final da linha.
Alguns caracteres especiais poderão ser adicionados, no início da linha de texto.
Caracter Função
“#” Linha de marcação.
“@” Tracejado especial.
A linha de marcação representa uma linha a ser impressa contendo a expressão: “NÃO É
DOCUMENTO FISCAL”. A linha de marcação é impressa pelo ECF automaticamente, a cada dez
linhas; o aplicativo do usuário poderá, se quiser, antecipar a impressão dessa linha a fim de evitar
impressões em locais, ou trechos, indesejáveis. Por exemplo, se o sistema de retaguarda desejar que
um trecho de cinco linhas seja impresso continuamente sem a linha de marcação automática, basta
preceder a primeira linha do trecho pelo caracter #.

Exemplo de uma mensagem de resposta ao serviço de emissão de extrato.


• Conteúdo do arquivo RETAG.001

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

Z0000010100000000000Cliente apto a fazer compras ZANTHUS Ind. e Com. Ltda[LF]@Extrato da


fatura.....[LF]#Nome do cliente: ZANTHUS Ind. e Com. Ltda.[LF]...

Validação de senha (serviço 05)


Para este serviço, o layout da mensagem de solicitação é o seguinte:
Mensagem de validação de senha (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com TIPOSERVIÇO 1 11
igual a 05)
TIPOCOD Indicador do tipo de identificação: Numérico 12 2
01 código de cliente
02 código de funcionário
IDENTIFICAÇÃO Código do cliente ou do funcionário Numérico 14 19
informado no PDV
NIVELFUNC Nível de autorização pedida (este campo Numérico 33 4
não é usado nas versões atuais, e será
sempre enviado zerado)
CODIFICAÇÃO Indicador do algoritmo de codificação da Numérico 37 2
senha no campo seguinte
SENHADIGIT Senha digitada. Este campo é enviado Alfanumérico 39 12
pelo PDV de forma codificada.
LINEFEED [LF] Avanço de linha. -- 51 1
Número total de bytes de uma mensagem de validação de senha 51
Exemplo de uma mensagem de solicitação de serviço de validação de senha de cliente.
• Conteúdo do arquivo RETAG.001
Z00000101050212345678901234567890000007PRMFLPRMMA2[LF]

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

Validação de campo digitado (serviço 06)


Para este serviço, o layout da mensagem de solicitação é o seguinte:
Mensagem de validação de senha (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com TIPOSERVIÇO 1 11
igual a 06)
TIPO Tipo de validação (00 a 03, de acordo Numérico 12 2
com o algoritmo utilizado – de 96 a 99
respectivamente)
IDENTIFICAÇÃO Conteúdo para validação (campo Numérico 14 19
digitado)
LINEFEED [LF] Avanço de linha. -- 33 1
Total de bytes de uma mensagem de validação de campo digitado 33
Exemplo de uma mensagem de solicitação de serviço de validação de campo digitado.
• Conteúdo do arquivo RETAG.001
Z0000010105021234567890123456789[LF]

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

Consulta para recebimento de valores devidos (serviço 07)


Para este serviço, o layout da mensagem de solicitação é o seguinte:
Mensagem de consulta dívida (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com TIPOSERVIÇO 1 11
igual a 07)
TIPO Tipo de consulta: Numérico 12 2
1 – só consulta (somente o nome do
cliente é aproveitado);
2 – consulta dívida parcelada (tipo 1)
3 – consulta dívida parcelada (tipo 2)
4 – consulta dívida rotativa
5 – consulta dívida rotativa no arquivo de
clientes local.
É considerada OK a mensagem com
CODRETORNO = 0.
CLIENTE Informação digitada no campo CLIENTE Numérico 14 19
DOCTO1 Informação digitada como primeiro Numérico 33 16
documento.
DOCTO2 Informação digitada como segundo Numérico 49 16
documento.
DOCTO3 Informação digitada como terceiro Numérico 65 16
documento.
LINEFEED [LF] Avanço de linha. -- 81 1
Total de bytes de uma mensagem de consulta de dívida 81
Exemplo de uma mensagem de solicitação de serviço de consulta de dívida.
• Conteúdo do arquivo RETAG.001
Z0000010105021234567890123456789111111111111111122222222222222223333333333333333[LF]

Para este serviço temos a seguinte resposta:


Mensagem de resposta à solicitação de extrato (Retaguarda ==> PDV) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum de resposta 1 17
CLIENTE Código do cliente (o mesmo da Numérico 18 19
mensagem de consulta)
NOMECLIENTE Nome do cliente (impresso no Alfanumérico 37 48
comprovante de recebimento)
DATAVENCTO Data de vencimento (formato 85 8
Numérico
DDMMAAA)
ALTERADATA Permissão para alterar data: 93 1
Numérico
0 – sempre
1 – não permite;não exibe
2 – não permite; exibe
3 – permitido ao supervisor
4 – permitido ao gerente
VLRMINIMO Valor mínimo para aceitar pagamento 94 12(2)
Numérico
(somente para TIPO =4 – rotativo)
VALOR1 Primeiro valor (valor do saldo devedor 106 12(2)
Numérico
quando TIPO =4 – rotativo)
ALTERAVALOR1 Permissão para altera valor 1 (idem 118 1
Numérico
ALTERADATA)
VALOR2 Segundo valor 119 12(2)
Numérico
ALTERAVALOR2 Permissão para altera valor 2 (idem 131 1
Numérico
ALTERADATA)
VALOR3 Terceiro valor 132 12(2)
Numérico

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

Mensagem de resposta à solicitação de extrato (Retaguarda ==> PDV) Tipo de layout: 01


Campo Descrição Tipo Início Tamanho
ALTERAVALOR3 Permissão para altera valor 3 (idem 144 1
Numérico
ALTERADATA)
VALOR4 Quarto valor 145 12(2)
Numérico
ALTERAVALOR4 Permissão para altera valor 4 (idem 157 1
Numérico
ALTERADATA)
VALOR5 Quinto valor 158 12(2)
Numérico
ALTERAVALOR5 Permissão para altera valor 5 (idem 170 1
Numérico
ALTERADATA)
VALOR6 Sexto valor 171 12(2)
Numérico
ALTERAVALOR6 Permissão para altera valor 6 (idem 183 1
Numérico
ALTERADATA)
VALOR7 Sétimo valor 184 12(2)
Numérico
ALTERAVALOR7 Permissão para altera valor 7 (idem 196 1
Numérico
ALTERADATA)
VALOR8 Oitavo valor 197 12(2)
Numérico
ALTERAVALOR8 Permissão para altera valor 8 (idem 209 1
Numérico
ALTERADATA)
VALOR9 Nono valor 210 12(2)
Numérico
ALTERAVALOR9 Permissão para altera valor 9 (idem 222 1
Numérico
ALTERADATA)
VALOR10 Décimo valor 223 12(2)
Numérico
ALTERAVALOR10 Permissão para altera valor 10 (idem 235 1
Numérico
ALTERADATA)
LIBERAMULTA Cobrar multa conforme parametrizado: 236 2
0 – sim
1 – não (isentar multa)
LIBERAJUROS Cobrar multa conforme parametrizado: 238 2
0 – sim
1 – não (isentar multa)
LINEFEED [LF] Avanço de linha. -- 240 1

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

Validação das parcelas calculadas em planos de pagamento (serviço 08)


(CodFon 64)

Para este serviço, o layout da mensagem de solicitação é o seguinte:


Mensagem de validação de senha (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com TIPOSERVIÇO 1 11
igual a 08)
CODCLIENTE Código do cliente Numérico 12 19
DATA_01 Data de vencimento da parcela 01 Numérico 31 6
CODOPER_01 Código de operação da parcela 01 Numérico 37 3
VALPARC_01 Valor da parcela 01 Numérico 40 12(2)
DATA_02 Data de vencimento da parcela 02 Numérico 52 6
CODOPER_02 Código de operação da parcela 02 Numérico 58 3
VALPARC_02 Valor da parcela 02 Numérico 61 12(2)
DATA_03 Data de vencimento da parcela 03 Numérico 73 6
CODOPER_03 Código de operação da parcela 03 Numérico 79 3
VALPARC_03 Valor da parcela 03 Numérico 82 12(2)
DATA_04 Data de vencimento da parcela 04 Numérico 94 6
CODOPER_04 Código de operação da parcela 04 Numérico 100 3
VALPARC_04 Valor da parcela 04 Numérico 103 12(2)
DATA_05 Data de vencimento da parcela 05 Numérico 115 6
CODOPER_05 Código de operação da parcela 05 Numérico 121 3
VALPARC_05 Valor da parcela 05 Numérico 124 12(2)
DATA_06 Data de vencimento da parcela 06 Numérico 136 6
CODOPER_06 Código de operação da parcela 06 Numérico 142 3
VALPARC_06 Valor da parcela 06 Numérico 145 12(2)
DATA_07 Data de vencimento da parcela 07 Numérico 157 6
CODOPER_07 Código de operação da parcela 07 Numérico 163 3
VALPARC_07 Valor da parcela 07 Numérico 166 12(2)
DATA_08 Data de vencimento da parcela 08 Numérico 178 6
CODOPER_08 Código de operação da parcela 08 Numérico 184 3
VALPARC_08 Valor da parcela 08 Numérico 187 12(2)
DATA_09 Data de vencimento da parcela 09 Numérico 199 6
CODOPER_09 Código de operação da parcela 09 Numérico 205 3
VALPARC_09 Valor da parcela 09 Numérico 208 12(2)
DATA_10 Data de vencimento da parcela 10 Numérico 220 6
CODOPER_10 Código de operação da parcela 10 Numérico 226 3
VALPARC_10 Valor da parcela 10 Numérico 229 12(2)
DATA_11 Data de vencimento da parcela 11 Numérico 241 6
CODOPER_11 Código de operação da parcela 11 Numérico 247 3
VALPARC_11 Valor da parcela 11 Numérico 250 12(2)
DATA_12 Data de vencimento da parcela 12 Numérico 262 6
CODOPER_12 Código de operação da parcela 12 Numérico 268 3
VALPARC_12 Valor da parcela 12 Numérico 271 12(2)
DATA_13 Data de vencimento da parcela 13 Numérico 283 6
CODOPER_13 Código de operação da parcela 13 Numérico 289 3
VALPARC_13 Valor da parcela 13 Numérico 292 12(2)
DATA_14 Data de vencimento da parcela 14 Numérico 304 6
CODOPER_14 Código de operação da parcela 14 Numérico 310 3
VALPARC_14 Valor da parcela 14 Numérico 313 12(2)
DATA_15 Data de vencimento da parcela 15 Numérico 325 6
CODOPER_15 Código de operação da parcela 15 Numérico 331 3
VALPARC_15 Valor da parcela 15 Numérico 334 12(2)
DATA_16 Data de vencimento da parcela 16 Numérico 346 6
CODOPER_16 Código de operação da parcela 16 Numérico 352 3
VALPARC_16 Valor da parcela 16 Numérico 355 12(2)
DATA_17 Data de vencimento da parcela 17 Numérico 367 6
SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 16
FORMATAÇÃO DE CADA SERVIÇO

Mensagem de validação de senha (PDV => Retaguarda) Tipo de layout: 01


Campo Descrição Tipo Início Tamanho
CODOPER_17 Código de operação da parcela 17 Numérico 373 3
VALPARC_17 Valor da parcela 17 Numérico 376 12(2)
DATA_18 Data de vencimento da parcela 18 Numérico 388 6
CODOPER_18 Código de operação da parcela 18 Numérico 394 3
VALPARC_18 Valor da parcela 18 Numérico 397 12(2)
DATA_19 Data de vencimento da parcela 19 Numérico 409 6
CODOPER_19 Código de operação da parcela 19 Numérico 415 3
VALPARC_19 Valor da parcela 19 Numérico 418 12(2)
DATA_20 Data de vencimento da parcela 20 Numérico 430 6
CODOPER_20 Código de operação da parcela 20 Numérico 436 3
VALPARC_20 Valor da parcela 20 Numérico 439 12(2)
DATA_21 Data de vencimento da parcela 21 Numérico 451 6
CODOPER_21 Código de operação da parcela 21 Numérico 457 3
VALPARC_21 Valor da parcela 21 Numérico 460 12(2)
DATA_22 Data de vencimento da parcela 22 Numérico 472 6
CODOPER_22 Código de operação da parcela 22 Numérico 478 3
VALPARC_22 Valor da parcela 22 Numérico 481 12(2)
DATA_23 Data de vencimento da parcela 23 Numérico 493 6
CODOPER_23 Código de operação da parcela 23 Numérico 499 3
VALPARC_23 Valor da parcela 23 Numérico 502 12(2)
DATA_24 Data de vencimento da parcela 24 Numérico 514 6
CODOPER_24 Código de operação da parcela 24 Numérico 520 3
VALPARC_24 Valor da parcela 24 Numérico 523 12(2)
DATA_25 Data de vencimento da parcela 25 Numérico 535 6
CODOPER_25 Código de operação da parcela 25 Numérico 541 3
VALPARC_25 Valor da parcela 25 Numérico 544 12(2)
DATA_26 Data de vencimento da parcela 26 Numérico 556 6
CODOPER_26 Código de operação da parcela 26 Numérico 562 3
VALPARC_26 Valor da parcela 26 Numérico 565 12(2)
DATA_27 Data de vencimento da parcela 27 Numérico 577 6
CODOPER_27 Código de operação da parcela 27 Numérico 583 3
VALPARC_27 Valor da parcela 27 Numérico 586 12(2)
DATA_28 Data de vencimento da parcela 28 Numérico 598 6
CODOPER_28 Código de operação da parcela 28 Numérico 604 3
VALPARC_28 Valor da parcela 28 Numérico 607 12(2)
DATA_29 Data de vencimento da parcela 29 Numérico 619 6
CODOPER_29 Código de operação da parcela 29 Numérico 625 3
VALPARC_29 Valor da parcela 29 Numérico 628 12(2)
DATA_30 Data de vencimento da parcela 30 Numérico 640 6
CODOPER_30 Código de operação da parcela 30 Numérico 646 3
VALPARC_30 Valor da parcela 30 Numérico 649 12(2)
LINEFEED [LF] Avanço de linha. -- 661 1
Total de bytes de uma mensagem de validação de campo digitado 661

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

Informações de mercadoria (serviço 09)


(CodFon 70)

Para este serviço o layout da mensagem de solicitação é o seguinte:


Mensagem de solicitação de extrato (PDV => Retaguarda) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum (com 1 11
TIPOSERVIÇO igual a 09)
CODIGOMERC Código da mercadoria informada Numérico 12 17
no PDV
TIPOCONSULTA Tipo de consulta a ser efetuada Numérico 29 1
(Ver Operações Disponíveis no
PDV)
LINEFEED [LF] Avanço de linha. -- 30 1
Número total de bytes de uma mensagem de solicitação 30
Exemplo de uma mensagem de solicitação de serviço de emissão de extrato.
• Conteúdo do arquivo RETAG.001
Z000001010400000000000000123450[LF]

Para este serviço temos a seguinte resposta:


Mensagem de resposta à solicitação (Retaguarda ==> PDV) Tipo de layout: 01
Campo Descrição Tipo Início Tamanho
CABEÇALHO Cabeçalho comum de resposta 1 17
STATUSMERC Status da mercadoria. Numérico 18 3
DESCRSTATUS Descrição do status da Alfanumérico 21 30
mercadoria. (Será impresso
junto com o código da função
no cabeçalho do relatório).
DESCRMERC Descritivo do produto. Alfanumérico 51 até 48
LINEFEED [LF] Avanço de linha. -- Variável 1
TEXTO Texto do extrato, com linhas Alfanumérico Variável Variável
separadas por LINEFEED [LF].
O tamanho total dessa mensagem de resposta é variável e depende do tamanho do texto formatado.
A impressão é feita na seguinte forma pelo PDV: a primeira linha (até o primeiro LINEFEED, aquele
que vem após o campo DESCRMERC) é lida e interpretada (verificando-se o resultado no cabeçalho).
Se o retorno indicar sucesso, o texto a partir do caracter seguinte a esse primeiro [LF] será impresso.
O campo TEXTO representa uma série de linhas que poderão ser adicionadas a essa mensagem de
resposta. Essas linhas de texto representam o extrato que é formatado e fornecido, pelo aplicativo do
usuário, com base nos dados contidos em seu sistema de retaguarda. Cada linha a ser impressa
deverá possuir um [LF] no final da linha.
Alguns caracteres especiais poderão ser adicionados, no início da linha de texto.
Caracter Função
“#” Linha de marcação.
“@” Tracejado especial.
A linha de marcação representa uma linha a ser impressa contendo a expressão: “NÃO É
DOCUMENTO FISCAL”. A linha de marcação é impressa pelo ECF automaticamente, a cada dez
linhas; o aplicativo do usuário poderá, se quiser, antecipar a impressão dessa linha a fim de evitar
impressões em locais, ou trechos, indesejáveis. Por exemplo, se o sistema de retaguarda desejar que
um trecho de cinco linhas seja impresso continuamente sem a linha de marcação automática, basta
preceder a primeira linha do trecho pelo caracter #.
Exemplo de uma mensagem de resposta ao serviço de informações de mercadoria.
• Conteúdo do arquivo RETAG.001
Z0000010100000000000INFORMAÇOES NUTRICIONAIS QUEIJO PRATO FATIADO[LF]@VALOR
CALORICO[LF]#Valores diários de referência[LF]...

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

Operações disponíveis no PDV


A integração genérica viabiliza as seguintes funções no PDV:
Função no Código do Tipo de
Serviço
PDV Serviço consulta
Consultas ao cadastro de clientes da retaguarda no momento da Venda 02
validação dos pagamentos
Notificação a retaguarda dos pagamentos aceitos para cada cliente. Venda 03
Validação de senha de cliente no momento do aceite de pagamento Venda 05
Validação de campo digitado Diversas 06
Consultas ao cadastro de clientes a qualquer momento. 6391 01
Informações de cliente (Visor padrão CLIENTE) 6381 04 0
Informações de cliente (Visor padrão NUM. FATURA) 6382 04 1
Recebimento de clientes com consulta de valores devidos 500/509 07
Informações de mercadoria (CodFon 70) 6371 09 0
Informações de mercadoria (CodFon 70) 6372 09 1
As três primeiras opções, que se referem à integração com a retaguarda inserida nas operações do
PDV, dependem de opções de parametrização no Arquivo 9, de finalizadoras (ver item 5 -
Parametrização, adiante).
O campo TIPOSERVIÇO será preenchido pelo Sistema ZEUS Frente de Loja com os valores
apresentados no campo Código do serviço da tabela.

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

Consulta para aceitar pagamento


O cadastro de finalizadoras (arquivo 9) contém um campo que define o modo de integração com a
retaguarda. Esse campo aparece na tela de finalizadoras com a legenda “Retag” (ver campo A09CK
no documento M001- Formatação).
Pode-se usar modos de integração diferentes com finalizadoras diferentes.
As opções possíveis para cada finalizadora são:
• Consultar e validar saldo disponível para o cliente. Se o pagamento exceder o saldo
disponível, pode-se abrir a possibilidade de liberação por supervisor;
• Consultar dados do cheque do cliente (pré-datado ou não);
• Notificar a retaguarda do pagamento aceito pelo PDV. Cada pagamento aceito gerará
uma notificação;
• Exibir o nome do cliente no visor para confirmação. O operador deve pressionar a tecla
ENTRA para ir adiante na transação.
O parâmetro (“Retag”) deve ser o resultado da soma de vários indicadores, conforme as opções
desejadas. A tabela a seguir descreve o valor dos indicadores para cada caso:
Para... Somar...
Consultar saldo 1
Permitir liberação por supervisor 2
Consultar cheque 4
Consulta de cheque pede data (pré-datado) 8
Notificar a retaguarda sobre os pagamentos aceitos 16
Exibir o nome do cliente para confirmação 32
Enviar a consulta sempre como sendo CPF/CGC 64
Permitir a liberação pelo supervisor se o cliente não for cadastrado 128
Usar o código do cliente digitado no começo do cupom (para evitar redigitação) 256
Solicitar a digitação do número da conta corrente 512
Por exemplo: uma finalizadora que irá consultar o cheque pré-datado (4+8) e notificar a retaguarda
(16) deve ser parametrizada com 28 (o resultado de 4+8+16).
Os dados solicitados durante a consulta são armazenados no registro do movimento, sub-registro 2
(ou 4, dependendo da operação) conforme segue:
Informação solicitada Gravada no campo
Cliente M02AM/M04AL - Código do cliente envolvido
Data M02AS/M04AR - Data digitada
Banco M02AP/M04AO - Número do documento digitado
Agencia M02AT/M04AS - Segundo número de documento digitado
Cheque M02AU/M04AT - Terceiro número de documento digitado
Conta M02AV/M04AU - Quarto número de documento digitado

SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 21
PARAMETRIZAÇÃO

Validação de senha de cliente para aceitar pagamento


O cadastro de finalizadoras (arquivo 9) contém um campo que indica se o PDV deve pedir a digitação
da senha do cliente para aceitar um pagamento. Esse campo aparece na tela de finalizadoras com a
legenda “Senha” (ver campo A09CF no documento M001- Formatação).
Se a finalizadora estiver parametrizada com esse campo contendo um valor diferente de zero, o PDV
fará a validação da senha do cliente através do serviço 05, descrito anteriormente.

SISTEMA ZEUS Frente de Loja M009 - INTEGRAÇÃO COM RETAGUARDA - Revisão 16 – 14/01/2003 Pág 22

Você também pode gostar