TRANSAÇÕES PDV – LISTENER
CRM MÚLTIPLOS CONVÊNIOS
RMS Software S.A. - Uma Empresa TOTVS
Todos os direitos reservados.
A RMS Software é a maior fornecedora nacional de software de
gestão corporativa para o mercado de comércio e varejo.
Este documento contém informações conceituais, técnicas e telas
do produto que são confidenciais, podendo ser utilizadas somente
pelos clientes RMS no projeto de utilização do RMS/Retail.
A reprodução deste material, por qualquer meio, em todo ou em
parte, sem a autorização prévia e por escrito da RMS Software
S.A., ou envio do mesmo a outras empresas terceirizadas não
pertencentes ao grupo da RMS, sujeita o infrator aos termos da
Lei número 6895 de 17/10/80 e as penalidades previstas nos
artigos 184 e 185 do Código Penal.
Para solicitar a autorização de reprodução parcial ou total desde
documento, ou ainda necessitar enviá-lo à outra empresa, é
necessário enviar uma solicitação assinada e com firma
reconhecida para o departamento de controle de manuais da
RMS, que fica situado à Al. Rio Negro, 1084 – 16º andar,
Alphaville, Barueri, São Paulo, ou se necessário o cliente poderá
entrar em contato pelo Telefone (0xx11) 2699-0008.
A RMS Software S.A. reserva-se o direito de alterar o conteúdo
deste manual, no todo ou em parte, sem prévio aviso.
O nome RMS e os logotipos RMS, RMS/Retail são marcas
registradas da RMS Software e suas empresas afiliadas no Brasil.
Todos os demais nomes mencionados podem ser marcas
registradas e comercializadas pelos seus proprietários.
RMS Software S.A. - Uma empresa TOTVS.
11 2699-0008 – www.rms.com.br
2
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
ÍNDICE
Transações PDV – Listener – CRM Múltiplos Convênios .................................................................................................................. 4
Objetivo .............................................................................................................................................................................................. 4
Descrição do processo ....................................................................................................................................................................... 4
Padrões e Considerações ................................................................................................................................................................. 4
Layout da Chamada ( PDV  Retaguarda ) ..................................................................................................................................... 6
......................................................................................................................... 7
Layout do Retorno de Aprovação ( Retaguarda  PDV ) ................................................................................................................. 7
3
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
Transações PDV – Listener – CRM Múltiplos Convênios
Objetivo
Permitir a comunicação entre PDV x retaguarda RMS para consultar o cadastro de clientes
Descrição do processo
Padrões e Considerações
1. Todos os delimitadores devem ser o caracter “pipe” - |
2. Os comandos possíveis a serem enviados são:
“CC” – Consulta de cheques (autorização de venda)
“CS” – Consulta de saldos disponíveis (consulta de clientes)
“NV” – Notificação de Venda
“CL/CA” – Cadastro do Cliente
“CV” – Convênio (autorização de venda)
“CT” – Carnê (autorização de venda)
“FD” – Crédito Rotativo (Caderneta Eletrônica) (autorização de venda)
“FI” – Consulta Clientes Fidelidade
“PL” – Private Label (autorização de venda)
“VT” – Vale (autorização de venda)
“ES” – Esporádico (autorização de venda)
“SA” – Sazonal (autorização de venda)
“PT” – Pontos Fidelidade (autorização de venda)
“NT” – Notificação de Terceiros
“AC” – Autorização de Cancelamento de CUPOM
“HC” – Cancelamento de CUPOM
“CP” – Consulta parcela pagamento CREDIÁRIO
“PG” – Notificação do Pagamento
“EO” – Estoque OnLine
“AS” – Troca de Senha
“CB” – Consulta Total de Dívida Private Label
“BX” – Pagamento de Private Label (Total / Parcial)
“XP” - Consulta CUPONS em aberto de PRIVATE LABEL/CADERNETA (Frente de Caixa)
“PX” - Pagamento de CUPONS em aberto de PRIVATE LABEL/CADERNETA (Frente de Caixa)
3.
O número de autorização criado em uma consulta de Autorização de
Venda deve ser o mesmo número para a operação “NV” correspondente e o mesmo para o
cancelamento.
4.
O código de retorno “00” significa que a solicitação foi processada
com sucesso. Qualquer outro código indica retorno com erro.
5.
Cada transação é equivalente a uma parcela. Por exemplo em uma
compra em três parcelas o PDV deverá enviar uma transação “CC” com o valor total da compra e
três transações “NV” com os dados de cada parcela.
4
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
6.
A transação “NV” respeita a transação anterior a ela. Por exemplo
uma transação “CC” seguida de “NV” significa uma finalização em cheque. Uma transação “FD”
seguida de “NV” significa uma finalização em crédito rotativo.
7.
Para as finalizações que não sejam em cheque, deverá ser enviado
no campo “CH-CHEQUE” o conteúdo do campo “CH-CUPOM” na transação “NV”.
8.
Para incluir um cliente através do PDV deverá ser enviada uma
transação “CL / CA” e aguardar um retorno “00” para a confirmação da transação. Após isso podese utilizar o sistema normal de autorização enviando uma transação “CC” seguida de “NV”.
9.
Para as consultas de fidelidade e private label, o código enviado de
identificação do cliente deverá ser o “número do cartão”. A mensagem terá como código de
identificação “FI” (fidelidade) ou “PL” (private label) e o PDV deverá enviar à retaguarda:
 Código de identificação da mensagem
 Código da Transação = “FI” ou “PL”
 Tipo do código = 2
 Código informado no PDV = número do cartão
 Código da Loja
 Número do PDV
10.
A transação de pagamento “PG” deverá conter os campos código do
cliente (Código, CPF ou Cartão), Loja, PDV, Fiscal, Usuário e Valor. Ela possui um retorno como
todas as outras, porém não gera número de autorização e nem requer uma transação “NV” para
sua confirmação.
11.
Para a modalidade “Carnê”, antes de enviar uma transação “PG”,
deverá ser enviada uma “CP”. Esta informação “CP” será a solicitação da informação a ser paga
pelo cliente. Deverá ser enviado os campos código do cliente (Código, CPF ou Cartão), Loja, PDV,
Fiscal e Usuário.
12.
Para emissão do carnê pelo PDV, ao ser enviada uma mensagem
“CC”, será retornado o número do carnê a ser gerado. No entanto, a confirmação só será mesmo
quando recebida a transação “NV” com as parcelas.
13.
Para a transação do tipo “XP” é necessário enviar para retaguarda:
Código de identificação da mensagem
Código da Transação = “XP”
Tipo do código = 0, 1 ou 2.
Código informado no PDV = Código do cliente ou CPF do cliente ou número do cartão.
Código da Loja
Número do PDV
14.
Para a transação do tipo “PX” o PDV deve enviar no campo definido
no LAYOUT quais os CUPONS que devem ser baixados (pagos).
CAMPO DE ENTRADA: CH-CUPOM-DTA-VALOR para cada cupom separa-los com #
Exemplo: |1234;25112014;1700#56789;26112014;1500|  2 CUPONS
OBS: O Valor é o valor pago do Cupom
15.
Para a transação do tipo “XP” a Retaguarda enviará no campo
definido no LAYOUT quais os CUPONS que devem ser baixados (pagos).
CAMPO DE SAIDA: RT-CUPOM-DTA-VALOR para cada cupom separa-los com #
Exemplo: |1234;25112014;1700#567;26112014;1500#90;27112014;1600|  3 CUPONS
5
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
Layout da Chamada ( PDV  Retaguarda )
Campo
CH-FILLER
PIPE-00
CH-TRANSACAO
PIPE-00
CH-TIPCOD
PIPE-01
CH-CODIGO
PIPE-02
CH-LOJA
PIPE-03
CH-PDV
PIPE-04
CH-CUPOM
PIPE-05
CH-FINAL
PIPE-06
CH-DATA-VENC
PIPE-07
CH-DIAS-VENC
PIPE-08
CH-VALOR
PIPE-09
CH-BANCO
PIPE-10
CH-AGENCIA
PIPE-11
CH-CONTA
PIPE-12
CH-CHEQUE
PIPE-13
CH-CPF
PIPE-14
CH-USUARIO
PIPE-15
CH-FISCAL
PIPE-16
CH-AUTORIZACAO
Descrição
Código de identificação da mensagem
Delimitador
Código da Transação: CS,CC,NV,FI...
Delimitador
Tipo do código: 0 – Código de Cliente
1 – C.P.F. / C.G.C.
2 – Número Cartão
Delimitador
Código informado no PDV
Delimitador
Código da Loja
Delimitador
Número do PDV
Delimitador
Número do cupom
Delimitador
Número da finalizadora
Delimitador
Data para vencimento
Delimitador
Número de dias para vencimento
Delimitador
Valor do cheque
Delimitador
Número do banco do cheque
Delimitador
Código da agência do cheque
Delimitador
Número da conta corrente do cheque
Delimitador
Número do cheque
Delimitador
C.P.F. do cheque
Delimitador
Identificação do caixa
Delimitador
Identificação do fiscal
Delimitador
Número de autorização da venda
Início
1
5
6
8
9
Final
4
5
7
8
9
Tipo
Num
Alfa
Alfa
Alfa
Num
Tam.
4
1
2
1
1
10
11
27
28
31
32
35
36
42
43
46
47
55
56
60
61
78
79
82
83
88
89
100
101
108
109
123
124
132
133
141
142
10
26
27
30
31
34
35
41
42
45
46
54
55
59
60
77
78
81
82
87
88
99
100
107
108
122
123
131
132
140
141
150
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Num
1
16
1
3
1
3
1
6
1
3
1
8
1
4
1
17
1
3
1
5
1
11
1
7
1
14
1
8
1
8
1
9
PIPE-17
CH-SEQUENCIA
PIPE-18
CH-CMC7
PIPE-19
CH-CMC7-LIDA
PIPE-20
CH-PEDIDO
PIPE-21
CH-SENHA
PIPE-22
CH-DT-LANC
PIPE-22
CH-SEQ-VALE
PIPE-22
CH-NOME
PIPE-23
CH-N-CARTAO
PIPE-24
CH-N-ENDERECO
PIPE-25
CH-NUM
PIPE-26
CH-BAIRRO
PIPE-27
CH-CIDADE
Delimitador
Número de sequência do PDV
Delimitador
CMC7 DO CHEQUE
Delimitador
CMC7 DO CHEQUE - LIDA (S) OU DIGITADA (N)
Delimitador
Nrº do Pedido do Vendas Assistidas
Delimitador
Nova senha
Delimitador
Data de lançamento vale
Delimitador
Nrº Sequencia vale
Delimitador
Nome do Cliente
Delimitador
Número do Cartão
Delimitador
Endereço Cliente
Delimitador
Número do endereço do cliente
Delimitador
Bairro
Delimitador
Cidade
151
152
157
158
193
194
195
196
103
104
110
111
119
120
128
129
170
171
188
171
230
231
237
238
259
260
151
156
157
192
193
194
195
102
103
109
110
118
119
127
128
169
129
187
188
187
230
236
237
258
259
280
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Alfa
1
5
1
35
1
1
1
7
1
6
1
8
1
7
1
40
1
16
1
40
1
5
1
20
1
20
PIPE-28
Delimitador
281
281
Alfa
1
PIPE-28
CH-ESTADO
Delimitador
Complemento do endereço do cliente
281
282
281
283
Alfa
Alfa
1
2
Dec.
2
6
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
PIPE-29
CH-CEP
PIPE-30
CH-EMAIL
PIPE-23
CH-DATA-NASC
PIPE-23
CH-FONE
PIPE-23
CH-CUPOM-DTA-VALOR
PIPE-23
Delimitador
CEP do Endereço do Cliente
Delimitador
E-mail Cliente
Delimitador
Data de Nascimento
Delimitador
Telefone Cliente
Delimitador
Cupom; Data Vencimento; Valor
Delimitador
285
286
295
296
317
318
327
328
340
341
401
285
294
295
316
317
326
327
339
340
400
401
Alfa
Num
Alfa
Alfa
Alfa
Num
Alfa
Num
Alfa
Alfa
Alfa
1
8
1
20
1
8
1
11
1
59
1
Início
1
3
4
24
25
75
76
116
117
122
123
Final
2
3
23
24
74
75
115
116
121
122
123
Tipo
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Tam.
2
1
20
1
50
1
40
1
5
1
1
Dec.
Início
1
3
4
13
14
31
32
33
34
74
75
89
90
105
106
117
118
158
159
164
165
185
186
191
192
194
195
197
198
205
206
Final
2
3
12
13
30
31
32
33
73
74
88
89
104
105
116
117
157
158
163
164
184
185
190
191
193
194
196
197
204
205
207
Tipo
Num
Alfa
Num
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Alfa
Num
Alfa
Alfa
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Tam.
2
1
9
1
17
1
1
1
40
1
14
1
15
1
11
1
40
1
5
1
20
1
5
1
2
1
2
1
7
1
2
Dec.
208
209
208
210
Alfa
Num
1
2
211
212
214
211
213
214
Alfa
Num
Alfa
1
2
1
Layout do Retorno com Erro ( Retaguarda
Campo
RE-CODIGO
PIPE-E01
RE-MENS
PIPE-E02
RE-MENS-ERRO
PIPE-E03
RE-NOME
PIPE-E04
RE-SEQUENCIA
PIPE-E05
PIPE-E06
Descrição
Código do Erro
Delimitador
Mensagem para PDV
Delimitador
Mensagem de Erro
Delimitador
Nome do Cliente
Delimitador
Número da Sequência
Delimitador
Delimitador
Layout do Retorno de Aprovação ( Retaguarda  PDV )
Campo
RT-CODIGO
PIPE-R01
RT-AUTORIZ
PIPE-R02
RT-SALDO
PIPE-R03
RT-SINAL
PIPE-R04
RT-NOME
PIPE-R05
RT-CPF
PIPE-R06
RT-RG
PIPE-R07
RT-FONE
PIPE-R08
RT-ENDERECO
PIPE-R09
RT-NUM
PIPE-R10
RT-COMPLE
PIPE-R11
RT-SEQUENCIA
PIPE-R12
RT-SITU-CLIE
PIPE-R13
RT-TIPO-CLIE
PIPE-R14
RT-PONTOS-DISP
PIPE-R15
RT-EVENTO-01
PIPE-R16
RT-EVENTO-02
PIPE-R17
RT-EVENTO-03
PIPE-R18
Descrição
Código de retorno
Delimitador
Número da autorização
Delimitador
Saldo disponível
Delimitador
Sinal do saldo disponível
Delimitador
Nome do cliente
Delimitador
C.P.F. do cliente
Delimitador
R.G. do cliente
Delimitador
Telefone do cliente
Delimitador
Endereço do cliente
Delimitador
Número do endereço do cliente
Delimitador
Complemento do endereço do cliente
Delimitador
Número de sequência do PDV
Delimitador
Situação do Cliente
Delimitador
Tipo de Cliente
Delimitador
Pontos disponíveis dos clientes
Delimitador
Se a data de nascimento do cliente estiver na
semana gravar 01 se não gravar 00
Delimitador
Se a data de nascimento do cônjuge do cliente
estiver na semana gravar 01, se a data de
nascimento de qualquer dependente do cliente
estiver na semana gravar 02 se não gravar 00
Delimitador
Premiação
Delimitador
2
7
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
RT-PONTO-EXTRA-1
PIPE-R19
RT-PONTO-EXTRA-2
PIPE-R20
RT-MENSAGEM
PIPE-R21
RT-CATEGORIA
PIPE-R22
RT-DIAS-CHEQUE
PIPE-R23
RT-NOME-EMPR
PIPE-R24
RT-SENHA
PIPE-R25
RT-CARNET
PIPE-R26
RT-PARCELA
PIPE-R27
RT-VALOR
PIPE-R28
RT-VENCIMENTO
PIPE-R29
RT-CH-DEVOL
PIPE-R30
RT-CH-QT-COMP
Ponto Extra – Por período de compra
Delimitador
Ponto Extra – Por estabelecimento de compra
Delimitador
Espaço para qualquer tipo de mensagem que a
retaguarda deseje enviar para PDV sobre o cliente
Delimitador
Categoria do Cliente – Informa o tipo de cliente. Se
for funcionário será = 1.
Delimitador
Número Dias Cheque Pré
Delimitador
Nome Empresa Conveniada
Delimitador
Senha
Delimitador
Número do carnê
Delimitador
Número da parcela do carnê
Delimitador
Valor parcela
Delimitador
Data vencimento parcela
Delimitador
Ocorrência de Cheques Devolvidos
Delimitador
Quantidade de Cheques Compensados
RT-CUPOM-DTA-VALOR Cupom; Data Vencimento; Valor
PIPE-R31
Delimitador
PIPE-R32
Delimitador
215
222
223
230
231
221
222
229
230
260
Num
Alfa
Num
Alfa
Alfa
7
1
7
1
30
261
262
261
263
Alfa
Num
1
2
264
265
268
269
299
300
310
311
318
319
321
322
339
340
348
349
350
351
264
267
268
298
299
309
310
317
318
320
321
338
339
347
348
349
350
356
Alfa
Num
Alfa
Alfa
Alfa
Alfa
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Num
Alfa
Alfa
Alfa
Num
1
3
1
30
1
10
1
7
1
2
1
17
1
8
1
1
1
6
351
401
402
400
401
402
Alfa
Alfa
Alfa
59
1
1
2
S/N
8
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.
9
TRANSAÇÕES PDV – LISTENER – CRM MÚLTIPLOS CONVÊNIOS VERSÃO 1.2 - RMS Software S.A. - Uma empresa TOTVS. – Todos Direitos Reservados.