Especificações Técnicas
Integração Operações cartão pré-pago MoneyCard
Versão 01.05
Pagina 1 de 7
Histórico de Revisões
Histórico das alterações no documento de especificação técnica.
Data
Descrição
20/08/2012 Elaboração da documentação
03/09/2012 Adequação final do Layout
14/09/2012 Inclusão tipo de transação “00” Carga Inicial e campo para
número do passaporte quando cliente estrangeiro.
19/09/2012 Controle de Versão do arquivo de integração
Campo RG alterado para Texto.
25/09/2012 Alteração do Registro 30 – Inclusão dos campos End. Número,
Bairro, Fax e Celular.
17/10/2012 Alteração de obrigatoriedade dos campos complemento,
telefone, fax, celular, e-mail e RG.
21/11/2012 Ajustes campos complementos – brancos
Versão
Autor
01.00
01.00
Elias S. Coelho
Elias S. Coelho
01.01
Elias S. Coelho
01.02
Elias S. Coelho
01.03
Elias S. Coelho
01.04
Elias S. Coelho
01.05
Elias S. Coelho
Objetivo
Este documento tem como objetivo definir os requerimentos para automação de ativação de cartões cargas, recargas e recompra de saldos de cartões Money Card.
Informações Técnicas
Estrutura do arquivo
Ilustração da estrutura do arquivo, a operação é composta pelos registros 30, 31, 32 e 60:
10
Cabeçalho do arquivo
20
Cabeçalho do lote
30
Dados do Cliente
31
Dados Adicionais do Cliente
32
Dados de segurança
60
Valores
Padrão de nomes dos arquivos .txt.
Pagina 2 de 7
Complemento nome do arquivo (compl):


Arquivo de Vendas = Load
Arquivo de Recargas e Recompras = RLCH
Nome completo = (complemento_Data_Sequencia.txt)
Compl_DDMMYYYY_Seq.txt
Seq = Sequencial quantidade de arquivos enviados por dia.
1. Arquivo de Operações - ( Carga inicial, Recarga e Recompra )
Registro Cabeçalho do arquivo - 10
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Req
Tipo de Registro
Identificação do registro Header
Numero
1
2
“10”
S
Data
Data de Geração do arquivo
Numero
3
10
YYYYMMDD
S
Hora
Hora de Geração do arquivo
Numero
11
16
HHMMSS
S
Identificação
CNPJ da Empresa.
Numero
17
25
9 Primeiros dígitos do CNPJ
S
Ambiente
Produção (P) Homologação (H)
AlfaNum
26
26
“P” ou “H”
S
Versão
Controle de versão de integração
AlfaNum
27
27
Fixo “1”
S
Registro – Cabeçalho do lote 20
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Req
Tipo de Registro
Identificação do registro
Numero
1
2
“20”
S
Sequencial
Numero sequencial do registro
iniciando em “1”
Numero
3
8
Formato “000001”
S
Identificação
ID Empresa
Numero
9
14
6 primeiros dígitos do CNPJ
N
Brancos
Complemento do registro.
AlfaNum
15
400
S
Pagina 3 de 7
Registro – Dados do Cliente 30
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Re
q
Tipo de Registro
Identificação do registro
Numero
1
2
Brancos
Complemento do registro
AlfaNum
3
4
S
Nome
Primeiro Nome
AlfaNum
5
54
S
Brancos
Complemento do registro.
AlfaNum
55
55
S
Sobrenome
Sobrenome
AlfaNum
56
105
S
“30”
S
Quando cliente estrangeiro
preencher com “99999999999”
(11-caracteres) informar o
passaporte no registro 32 valido
somente para cartão moeda R$.
CPF
CPF
AlfaNum
106
116
Brancos
Complemento do registro.
AlfaNum
117
117
S
Endereço
Endereço
AlfaNum
118
177
S
Número
End. Número
AlfNum
178
187
S
Complemento
Complemento do endereço.
AlfaNum
188
207
N
Bairro
Bairro
AlfaNum
208
232
S
Cidade
Cidade
AlfaNum
233
257
S
Estado
Estado
AlfaNum
258
259
S
CEP
CEP
Numero
260
268
S
Pais
Pais
AlfaNum
269
278
S
Telefone
Telefone
AlfaNum
279
308
DDD + Número telefone
Obrigatório para pessoa física
C
Fax
Fax
AlfaNum
309
338
DDD + Número Fax
N
Celular
Celular
AlfaNum
339
368
Proxy
Número do Proxy MoneyCard
AlfaNum
369
387
DDD + Número Celular
Obrigatório para pessoa física
Preencher com (0) Zero à
esquerda.
Ex: 0002089999999999999
S
C
S
Pagina 4 de 7
Registro – Dados Adicionais do Cliente - 31
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Req
Tipo de Registro
Identificação do registro
Numero
1
2
“31”
S
Brancos
Complemento do registro
AlfaNum
3
63
Nascimento
Data de Nascimento
Numero
64
71
Mãe
Nome da Mãe
AlfaNum
72
92
S
Brancos
Complemento do registro
AlfaNum
93
94
S
E-mail
E-mail do cliente
AlfaNum
95
174
N
S
YYYYMMDD
S
Registro – Dados de Segurança - 32
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Req
Tipo de Registro
Identificação do registro
Numero
1
2
Brancos
Complemento do registro
AlfaNum
3
4
S
Sobrenome
Sobrenome
AlfaNum
5
54
S
RG
Registro Geral
AlfaNum
55
63
Proxy
Número do Proxy MoneyCard
AlfaNum
64
82
Frase
Frase de Segurança
AlfaNum
83
88
Resposta
Resposta Frase de Segurança
AlfaNum
89
138
Passaporte
Número do Passaporte
AlfaNum
139
150
“32”
S
Obrigatório para Pessoa Física.
C
Preencher com (0) Zero a esquerda.
S
Ex: 0002089999999999999
"000200" = "NOME DO PRIMEIRO
ANIMAL DE ESTIMAÇÃO"
"000202" = "JOGO DE BARALHO
FAVORITO"
"000203" = "TIME FAVORITO DE
ESPORTE PROFISSIONAL"
S
"000204" = "JOGO FAVORITO DE
COMPUTADOR"
"000205" = "DESTINO DE VIAGEM
FAVORITO"
"000206" = "LOCAL / NATURAL DE"
S
Cliente Estrangeiro permitido somente
cartão moeda R$ – Preencher campo
CPF do registro “30” com
“99999999999”
Pagina 5 de 7
C
Registro – Valores - 60
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Req
Tipo de Registro
Identificação do registro
Numero
1
2
“60”
S
Transação
Tipo Transação
AlfaNum
3
4
“00” Carga Inicial
“01” Recarga
“02” Recompra de saldo
S
Brancos
Complemento do registro
AlfaNum
5
102
Valor
Valor Moeda Estrangeira
Numero (10,2)
103
112
Brancos
Complemento do registro
AlfaNum
113
137
Proxy
Número do Proxy MoneyCard
AlfaNum
138
156
S
Ex: 0000000.00
S
S
Preencher com (0) Zero à
esquerda.
Ex: 0002089999999999999
S
Cabeçalho - Retorno de processamento / Validação
Nome do Campo
Descrição
Tipo
Início Fim
Conteúdo / Formato
Tipo de Registro
Identificação do registro
Numero
1
2
“90”
Arquivo
Nome do Arquivo TXT
AlfaNum
3
102
Nome do arquivo TXT enviado para processamento.
Data
Data de processamento retorno
Numero
103
110
YYYYMMDD
Detalhes - Retorno
Nome do Campo
Descrição
Tipo
Início
Fim
Conteúdo / Formato
Linha
Linha do Arquivo TXT
importado
Numero
1
4
“0000”
Proxy
Número do Proxy MoneyCard
AlfaNum
5
23
(0) Zero a esquerda. Ex: 0002089999999999999
Codigo
Código da Mensagem
Numero
24
27
“0000”
Pagina 6 de 7
Nome do Campo
Descricao
Descrição
Mensagem simplificada
Tipo
AlfaNum
Início
Fim
28
177
Conteúdo / Formato
Campo Descrição da tabela de mensagens.
Pagina 7 de 7