90

RIOCARD
Projeto
Executivo
Volume 14
Layouts dos
Arquivos de
Importao:
Usurios e
Pedidos
Bilhetagem Eletrnica

PEF-V14 V.1.5.2

Origem
Data
FETRANSPOR Federao das Empresas de Transportes de
24/02/2005
Passageiros do Estado do Rio de Janeiro
Documento
Ttulo
PEF-V14
Projeto Executivo Riocard - Volume 14 - Layouts dos arquivos de
importao: usurios e pedidos
Controle de verses
Verso do
Data da
Tcnico Responsvel
documento
atualizao
1.0
14/01/2005
Everaldo Cartaxo Bastos
1.1
1.2
1.3
1.4
1.5
1.5.1
1.5.2

10/02/2005
24/02/2005
01/11/2005
28/05/2010
08/10/2010
11/10/2010
18/02/2014

Marcel Lapido Barbosa

Marcel Lapido Barbosa
Marcos Rodrigues da Silva
Eliezer Ricardo e Danilo Leite
Eliezer Ricardo
Marcus Bignon
Carol Carvalho

Bilhetagem Eletrnica

2005 Fetranspor

Pgina 2 de 31

PEF-V14 V.1.5.2

ndice
1 Arquivo de Importao de Usurios ...................................................... 4
1.1
1.2
1.2.1
1.2.2
1.2.3
1.2.4

1.3
1.3.1
1.3.2
1.3.3
1.3.4

1.4
1.4.1
1.4.2
1.4.3
1.4.4

1.5
1.5.1
1.5.2
1.5.3
1.5.4

Regras de Gerao ................................................................................................... 4

Definies para o layout do arquivo com a verso 02.00 ..................................... 5
Registro "Header" .............................................................................................................................. 5
Registros de Detalhe ......................................................................................................................... 5
Registro "Trailler" .............................................................................................................................. 6
Modelo para a criao do arquivo de importao de usurios na verso 02.00 ......................... 6

Definies para o layout do arquivo com a verso 03.01 ..................................... 8

Registro "Header" .............................................................................................................................. 8
Registros de Detalhe ......................................................................................................................... 8
Registro "Trailler" .............................................................................................................................. 9
Modelo para a criao do arquivo de importao de usurios na verso 03.01 ....................... 10

Definies para o layout do arquivo com a verso 04.01 ................................... 12

Registro "Header" ............................................................................................................................ 12
Registros de Detalhe ....................................................................................................................... 12
Registro "Trailler" ............................................................................................................................ 14
Modelo para a criao do arquivo de importao de usurios na verso 04.01 ....................... 15

Definies para o layout do arquivo com a verso 04.02 ................................... 18

Registro "Header" ............................................................................................................................ 18
Registros de Detalhe ....................................................................................................................... 18
Registro "Trailler" ............................................................................................................................ 21
Modelo para a criao do arquivo de importao de usurios na verso 04.02 ....................... 22

2 Arquivo de Importao do Pedido ....................................................... 26

2.1
2.2
2.2.1
2.2.2
2.2.3
2.2.4

Regras de Gerao ................................................................................................. 26

Definies para o layout do arquivo com a verso 01.00 ................................... 27
Registro "Header" ............................................................................................................................ 27
Registros de Detalhe ....................................................................................................................... 27
Registro "Trailler" ............................................................................................................................ 28
Modelo para a criao do arquivo de importao de pedidos na verso 01.00 ........................ 28

3 Tabelas Auxiliares ................................................................................ 30

3.1
3.2
3.3
3.4
3.5

Tabela 01 - Cidades Integrantes do Sistema RioCard ......................................... 30

Tabela 02 - Redes de Recarga ............................................................................... 30
Tabela 03 - Disponibilidade das Redes de Recarga ............................................ 30
Tabela 04 - Tipos de Carto ................................................................................... 31
Tabela 05 Motivos de Cancelamento de Usurio.............................................. 31

2005 Fetranspor

Pgina 3 de 31

PEF-V14 V.1.5.2

1 Arquivo de Importao de Usurios

Este arquivo dever ser gerado pelo cliente comprador, para a incluso dos dados dos usurios dos cartes.
O processamento feito acionando a opo de Incluso de Usurios por Importao de Arquivo no Painel
de Usurios. O arquivo s ser aceito se passar pela validao que efetuada no momento da execuo da
importao do arquivo.

1.1

Regras de Gerao

O nome externo do arquivo ser composto por:

Constante CADUSU;
Nmero da verso do arquivo, com 4 posies (sem o ponto);
CPF/CNPJ/CEI do cliente comprador, com 14 posies;
Data de gerao do arquivo, no formato aaaammdd;
Hora de gerao do arquivo, no formato hhmm;
Separados por underscore _.

Exemplo para um arquivo gerado para um cliente com o Cnpj de nr. 22.333.444/0001-55, em 12/01/2005,
s 15:25:
CADUSU_0200_223334440000155_20050112_1525.txt.

ATENO:

Todos os campos numricos devem ser alinhados direita e completados com zeros
esquerda.
Exemplo: O Campo Nr_doc_comprd numrico de 14 posies.
56597564152
00056597564152

Todos os campos com valores sero representados com 02 (duas) casas decimais, sem a
vrgula, devem ser alinhados direita e completados com zeros esquerda.
Exemplo: O Campo Vl_uso_dirio numrico de 6 posies.
R$ 3,85
000385

Todos os campos alfa devem ser alinhados esquerda e completados com espaos em
branco direita.

Todos os campos que apresentarem o asterisco ( * ) so opcionais, e devem sem

preenchidos com espaos em branco caso no tenham informaes.

2005 Fetranspor

Pgina 4 de 31

PEF-V14 V.1.5.2

1.2

Definies para o layout do arquivo com a verso 02.00

Disponvel para utilizao dos clientes a partir de Janeiro de 2005.

Esta verso ser descontinuada a partir de 01/05/2005, pois a mesma s permite a solicitao de cartes do
tipo 02 (Carto do Comprador) da tabela 04.

1.2.1

Registro "Header"

Registro usado para passar dados de gerao e de identificao do arquivo.

Registro Tipo 01 - Header do Arquivo
Nome
Formato
Tam. Comentrios
Tp_registro
Num
2 Tipo do Registro:
01 - Header do arquivo.
Nm_arquivo
Alfa
6 Nome do arquivo = "CADUSU".
Constante que identifica o arquivo.
Nr_verso
Alfa
5 Nmero da verso do layout do arquivo
Verso = 02.00
Nr_doc_comprd
Num
14 Nmero do CPF, CNPJ ou CEI do comprador.
Dt_gerao_arq
Num
8 Data de gerao do arquivo.
Formato ddmmaaaa.
Hr_gerao_arq
Num
4 Hora de gerao do arquivo.
Formato hhmm.

1.2.2

Registros de Detalhe

Registro gerado para identificar os detalhes do arquivo.

Registro Tipo 02 Incluso de Usurio
Nome
Formato
Tam. Comentrios
Tp_registro
Num
2 Tipo do Registro:
02 Dados do usurio.
Nr_matrcula
Alfa
15 Nmero da matrcula do usurio.
Nm_usurio
Alfa
60 Nome do usurio.
Nr_CPF
(*)
Num
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
Vl_uso_dirio
(*)
Num
6 Valor de uso dirio.
Valor de VT utilizado por dia, para ida e volta.
Exemplo: R$ 3,85
000385
Cd_cidade
Num
2 Cdigo da Cidade onde ser feita a recarga.
Ver cdigos na tabela 01 e disponibilidade na tabela 03.
Cd_rede_recarga
Num
2 Cdigo da rede de recarga:
Ver cdigos na tabela 02 e disponibilidade na tabela 03.
Nr_carto
(*)
Num
13 Nr do carto RioCard.
Dever ser informado no caso de reutilizao do carto

2005 Fetranspor

Pgina 5 de 31

PEF-V14 V.1.5.2

1.2.3

Registro "Trailler"

Registro gerado para identificar o fim do arquivo.

Registro Tipo 99 Fim de Arquivo
Nome
Formato
Tp_registro
Num
Qt_registros

1.2.4

Num

Tam. Comentrios
2 Tipo do Registro:
99 Fim de Arquivo.
6 Quantidade de registros do arquivo, incluindo o Header e o
Trailler.

Modelo para a criao do arquivo de importao de usurios na verso 02.00

Apresentamos abaixo um modelo de dados para esclarecer como deve ser feita a montagem do arquivo
texto de importao de usurios. Para a confeco de um arquivo texto um editor de texto simples como o
Bloco de Notas do Windows pode ser utilizado.
Descrio dos dados que compem o registro Header
Tp_registro
Nm_arquivo
Nr_verso
Nr_doc_comprd
Dt_gerao_arq
Hr_gerao_arq

= 01
= CADUSU
= 02.00
= 22.333.444/0001-55
= 12/01/2005
= 15:25

Tipo do registro
Nome do arquivo
Nmero da verso do layout do arquivo
Nmero do CPF , CNPJ ou CEI do comprador
Data da gerao do arquivo
Hora da gerao do arquivo

Modelo final do registro Header montado:

01CADUSU02.0022333444000155120120051525

Descrio dos dados que compem o registro de Detalhes

Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto

= 02
Tipo do registro
= 55666
Matrcula do usurio
= JOS DA SILVA
Nome do Usurio
= 001.006.607-57
Nmero do CPF do usurio
= R$ 2,80
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard

Modelo final do registro Detalhe montado:

0255666

JOS DA SILVA

001006607570002800201

Descrio dos dados que compem o registro de Trailler

Tp_registro
Qt_registros

= 99
=7

Tipo do Registro
Quantidade de registros

Modelo final do registro Trailler montado:

99000007

Exemplo de um arquivo completo:

2005 Fetranspor

Pgina 6 de 31

PEF-V14 V.1.5.2

01CADUSU02.0022333444000155120120051525
0255666
JOS DA SILVA
0244555
MARIA APARECIDA GOMES
0233444
PEDRO ALVES DE OLIVEIRA
0222333
CARLOS ANDRADE PEREIRA
0211222
GISELE DE SOUZA
99000007

2005 Fetranspor

001006607570002800201
001124507570003850201
082184127450006400201
024234717770003200201
037345127610003000201

Pgina 7 de 31

PEF-V14 V.1.5.2

1.3

Definies para o layout do arquivo com a verso 03.01

Disponvel para utilizao em data a ser divulgada pela Fetranspor.

1.3.1

Registro "Header"

Registro usado para passar dados de gerao e de identificao do arquivo.

Registro Tipo 01 - Header do Arquivo
Nome
Formato
Tam. Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Iniciado em 1, para cada arquivo.
Tp_registro
Num
2 Tipo do Registro:
01 - Header do arquivo.
Nm_arquivo
Alfa
6 Nome do arquivo = "CADUSU".
Constante que identifica o arquivo.
Nr_verso
Alfa
5 Nmero da verso do layout do arquivo.
Verso = 03.01
Nr_doc_comprd
Num
14 Nmero do CPF, CNPJ ou CEI do comprador.

1.3.2

Registros de Detalhe

Registro gerado para identificar os detalhes do arquivo.

Registro Tipo 02 Incluso de Usurio
Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula
Nm_usurio
Nr_CPF

(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

Num

Cd_rede_recarga

Num

Nr_carto

(*)

Cd_impresso

Num
Num

Tx_dados_adicionais
Dt_nascimento

Num

Tp_sexo

Alfa

2005 Fetranspor

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
02 Incluso de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Valor de VT utilizado por dia, para ida e volta.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.
2 Cdigo da rede de recarga:
Ver cdigos na tabela 02 e disponibilidade na tabela 03.
13 Nmero do carto RioCard.
Dever ser informado no caso de reutilizao do carto.
2 Cdigo de impresso que ser feita no carto solicitado.
Ver cdigos na tabela 04.
Estes dados s devero ser utilizados caso tenha escolhido
Cd_impresso = 04 (carto individual)
8 Data de nascimento do usurio.
Formato ddmmaaaa
1 Sexo do usurio:
M Masculino
F Feminino

Pgina 8 de 31

PEF-V14 V.1.5.2

Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email
(*)

Alfa
Alfa
Num
Alfa
Alfa

15
6
3
10
60

Nmero do documento de identidade.

Sigla do rgo emissor do documento de identidade.
Nmero do DDD do telefone de contato
Nmero do telefone de contato
Endereo de correio eletrnico

Registro Tipo 03 Alterao de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
03 Alterao de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Alinhado direita, completado com zeros esquerda.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.

Nr_matrcula
Nm_usurio
Nr_CPF

(*)
(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

(*)

Num

Cd_rede_recarga

(*)

Num

2 Cdigo da rede de recarga:

Ver cdigos na tabela 02 e disponibilidade na tabela 03.

Nr_carto

(*)

Num

13 Nmero do carto RioCard.

Dever ser informado no caso de reutilizao do carto

Cd_impresso

(*)

Num

2 Cdigo de impresso que ser feita no carto solicitado.

Ver cdigos na tabela 04.

Tx_dados_adicionais

Estes dados s devero ser utilizados caso tenha escolhido

Cd_impresso = 04 (carto individual)
Data de nascimento do usurio.
Formato ddmmaaaa.
Sexo do usurio:
M - Masculino
F Feminino
Nmero do documento de identidade.
Sigla do rgo emissor do documento de identidade.
Nmero do DDD do telefone de contato

Dt_nascimento

(*)

Num

Tp_sexo

(*)

Alfa

Tx_doc_ident
(*)
Sg_orgao_emissor (*)
Nr_ddd_tel
(*)

Alfa
Alfa
Num

15
6
3

Nr_tel_contato
Tx_email

Alfa
Alfa

10 Nmero do telefone de contato

60 Endereo de correio eletrnico

1.3.3

(*)
(*)

Registro "Trailler"

Registro gerado para identificar o fim do arquivo.

Registro Tipo 99 Fim de Arquivo
Nome
Formato
Nr_seq_reg
Num
Tp_registro
Num

2005 Fetranspor

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
99 - Fim de Arquivo

Pgina 9 de 31

PEF-V14 V.1.5.2

1.3.4

Modelo para a criao do arquivo de importao de usurios na verso 03.01

Apresentamos abaixo um modelo de dados para esclarecer como deve ser feita a montagem do arquivo
texto de importao de usurios. Para a confeco de um arquivo texto um editor de texto simples como o
Bloco de Notas do Windows pode ser utilizado.
Descrio dos dados que compem o registro Header
Nr_seq_reg
Tp_registro
Nm_arquivo
Nr_verso
Nr_doc_comprd

=1
= 01
= CADUSU
= 03.01
= 32.333.444/0001-55

Nmero de seqncia do registro

Tipo do registro
Nome do arquivo
Nmero da verso do layout do arquivo
Nmero do CPF , CNPJ ou CEI do comprador

Modelo final do registro Header montado:

0000101CADUSU03.0122333444000155

Descrio dos dados que compem o registro de Detalhes

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_impresso = 01 (Carto ao portador) ou
02 (Carto do comprador) ou
03 (Carto do Comprador/Usurio)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_impresso
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=2
Nmero de seqncia do registro
= 02
Tipo do registro
= 55666
Matrcula do usurio
= JOS DA SILVA
Nome do usurio
= 001.006.607-57
Nmero do CPF do usurio
= R$ 2,80
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 02
Cdigo de impresso que ser feita no carto solicitado
= 8 espaos em branco Data de nascimento do usurio
= 1 espao em branco Sexo do usurio
= 15 espaos em branco Nmero do documento de identidade
= 6 espaos em branco Sigla do rgo emissor do documento de identidade
= 3 espaos em branco Nmero do DDD do telefone de contato
= 10 espaos em branco Nmero do telefone de contato
= 60 espaos em branco Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000020255666

JOS DA SILVA

2005 Fetranspor

001006607570002800201

02

Pgina 10 de 31

PEF-V14 V.1.5.2

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_impresso = 04 (Carto individual)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_impresso
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=3
Nmero de seqncia do registro
= 02
Tipo do registro
= 44555
Matrcula do usurio
= MARIA APARECIDA GOMES Nome do usurio
= 001.124.507-57
Nmero do CPF do usurio
= R$ 3,85
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 04
Cdigo de impresso que ser feita no carto solicitado
= 15/07/1970
Data de nascimento do usurio
= F
Sexo do usurio
= 1971014
Nmero do documento de identidade
= IFP-RJ
Sigla do rgo emissor do documento de identidade
= 021
Nmero do DDD do telefone de contato
= 2222-3333
Nmero do telefone de contato
= riocard@fetranspor.com.br
Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000030244555

MARIA APARECIDA GOMES

001124507570003850201

0415071970F1971014

IFP-RJ0212222-3333 riocard@fetranspor.com.br

Descrio dos dados que compem o registro de Trailler

Nr_seq_reg
Tp_registro

=7
= 99

Nmero de seqncia do registro

Tipo do Registro

Modelo final do registro Trailler montado:

00000799

Exemplo de um arquivo completo:

0000101CADUSU02.0022333444000155
000020255666
JOS DA SILVA
000030244555
MARIA APARECIDA GOMES
000040233444
PEDRO ALVES DE OLIVEIRA
000050222333
CARLOS ANDRADE PEREIRA
000060211222
GISELE DE SOUZA
0000799

2005 Fetranspor

001006607570002800201
001124507570003850201
082184127450006400201
024234717770003200201
037345127610003000201

02
0415071970F1971014
IFP-RJ0212222-3333 riocard@fetranspor.com.br
02
0424051960M123321452/2VIA SSP-GO0224444-5555 deval@fetranspor.com.br
02

Pgina 11 de 31

PEF-V14 V.1.5.2

1.4

Definies para o layout do arquivo com a verso 04.01

Disponvel para utilizao em data a ser divulgada pela Fetranspor.

1.4.1

Registro "Header"

Registro usado para passar dados de gerao e de identificao do arquivo.

Registro Tipo 01 - Header do Arquivo
Nome
Formato
Tam. Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Iniciado em 1, para cada arquivo.
Tp_registro
Num
2 Tipo do Registro:
01 - Header do arquivo.
Nm_arquivo
Alfa
6 Nome do arquivo = "CADUSU".
Constante que identifica o arquivo.
Nr_verso
Alfa
5 Nmero da verso do layout do arquivo.
Verso = 04.01
Nr_doc_comprd
Num
14 Nmero do CPF, CNPJ ou CEI do comprador.

1.4.2

Registros de Detalhe

Registro gerado para identificar os detalhes do arquivo.

Registro Tipo 02 Incluso de Usurio
Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula
Nm_usurio
Nr_CPF

(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

Num

Cd_rede_recarga

Num

Nr_carto

(*)

Cd_tp_carto

Num
Num

Tx_dados_adicionais

Dt_nascimento

2005 Fetranspor

Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
02 Incluso de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Valor de VT utilizado por dia, para ida e volta.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.
2 Cdigo da rede de recarga:
Ver cdigos na tabela 02 e disponibilidade na tabela 03.
13 Nmero do carto RioCard.
Dever ser informado no caso de reutilizao do carto.
2 Cdigo do tipo de carto que ser solicitado.
Ver cdigos na tabela 04.
Estes dados sero obrigatrios caso tenha escolhido:
cd_tp_carto = 04 (carto VT RioCard individual) ou
cd_tp_carto = 05 (carto VT Bilhete nico individual) ou
preencher ao menos um dado adicional.
8 Data de nascimento do usurio.
Formato ddmmaaaa

Pgina 12 de 31

PEF-V14 V.1.5.2

Tp_sexo

Alfa

Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email
(*)

Alfa
Alfa
Num
Alfa
Alfa

1 Sexo do usurio:
M Masculino
F Feminino
15 Nmero do documento de identidade.
6 Sigla do rgo emissor do documento de identidade.
3 Nmero do DDD do telefone de contato
10 Nmero do telefone de contato
60 Endereo de correio eletrnico

Registro Tipo 03 Alterao de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
03 Alterao de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Alinhado direita, completado com zeros esquerda.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.

Nr_matrcula
Nm_usurio
Nr_CPF

(*)
(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

(*)

Num

Cd_rede_recarga

(*)

Num

2 Cdigo da rede de recarga:

Ver cdigos na tabela 02 e disponibilidade na tabela 03.

Nr_carto

(*)

Num

13 Nmero do carto RioCard.

Dever ser informado no caso de reutilizao do carto

Cd_tp_carto

Num

2 Cdigo do tipo de carto que ser solicitado.

Ver cdigos na tabela 04.
Estes dados sero obrigatrios caso tenha escolhido:
cd_tp_carto = 04 (carto VT RioCard individual) ou
cd_tp_carto = 05 (carto VT Bilhete nico individual) ou
preencher ao menos um dado adicional.

Tx_dados_adicionais

Dt_nascimento

(*)

Num

Tx_doc_ident
(*)
Sg_orgao_emissor (*)
Nr_ddd_tel
(*)

Alfa
Alfa
Num

8 Data de nascimento do usurio.

Formato ddmmaaaa.
1 Sexo do usurio:
M - Masculino
F Feminino
15 Nmero do documento de identidade.
6 Sigla do rgo emissor do documento de identidade.
3 Nmero do DDD do telefone de contato

Tp_sexo

(*)

Alfa

Nr_tel_contato
Tx_email

Alfa
Alfa

10 Nmero do telefone de contato

60 Endereo de correio eletrnico

2005 Fetranspor

(*)
(*)

Pgina 13 de 31

PEF-V14 V.1.5.2

Registro Tipo 04 Inativao de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula
Cd_mt_cancel

Alfa
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
04 Inativao de usurio
15 Nmero da matrcula do usurio.
2 Cdigo do motivo de cancelamento
Ver cdigos na tabela 05.

Registro Tipo 05 Excluso de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula

Alfa

1.4.3

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
05 Excluso de usurio
15 Nmero da matrcula do usurio.

Registro "Trailler"

Registro gerado para identificar o fim do arquivo.

Registro Tipo 99 Fim de Arquivo
Nome
Formato
Nr_seq_reg
Num
Tp_registro
Num

2005 Fetranspor

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
99 - Fim de Arquivo

Pgina 14 de 31

PEF-V14 V.1.5.2

1.4.4

Modelo para a criao do arquivo de importao de usurios na verso 04.01

Apresentamos abaixo um modelo de dados para esclarecer como deve ser feita a montagem do arquivo
texto de importao de usurios. Para a confeco de um arquivo texto um editor de texto simples como o
Bloco de Notas do Windows pode ser utilizado.
Descrio dos dados que compem o registro Header
Nr_seq_reg
Tp_registro
Nm_arquivo
Nr_verso
Nr_doc_comprd

=1
= 01
= CADUSU
= 04.01
= 32.333.444/0001-55

Nmero de seqncia do registro

Tipo do registro
Nome do arquivo
Nmero da verso do layout do arquivo
Nmero do CPF , CNPJ ou CEI do comprador

Modelo final do registro Header montado:

0000101CADUSU04.0122333444000155

Descrio dos dados que compem o registro de Detalhes

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_tp_carto = 01 (Carto VT RioCard ao portador) ou
02 (Carto VT RioCard do comprador) ou
03 (Carto VT RioCard do Comprador/Usurio)
04 (Carto VT RioCard do Usurio)
05 (Carto BU Estadual VT do Usurio)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_tp_carto
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=2
Nmero de seqncia do registro
= 02
Tipo do registro
= 55666
Matrcula do usurio
= JOS DA SILVA
Nome do usurio
= 001.006.607-57
Nmero do CPF do usurio
= R$ 2,80
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 02
Tipo de carto que ser solicitado
= 8 espaos em branco Data de nascimento do usurio
= 1 espao em branco Sexo do usurio
= 15 espaos em branco Nmero do documento de identidade
= 6 espaos em branco Sigla do rgo emissor do documento de identidade
= 3 espaos em branco Nmero do DDD do telefone de contato
= 10 espaos em branco Nmero do telefone de contato
= 60 espaos em branco Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000020255666

JOS DA SILVA

2005 Fetranspor

001006607570002800201

02

Pgina 15 de 31

PEF-V14 V.1.5.2

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_tp_carto = 05 (Carto VT Bilhete nico individual)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_tp_carto
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=3
Nmero de seqncia do registro
= 02
Tipo do registro
= 44555
Matrcula do usurio
= MARIA APARECIDA GOMES Nome do usurio
= 001.124.507-57
Nmero do CPF do usurio
= R$ 3,85
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 05
Tipo de carto que ser solicitado
= 15/07/1970
Data de nascimento do usurio
= F
Sexo do usurio
= 1971014
Nmero do documento de identidade
= IFP-RJ
Sigla do rgo emissor do documento de identidade
= 021
Nmero do DDD do telefone de contato
= 2222-3333
Nmero do telefone de contato
= riocard@fetranspor.com.br
Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000030244555

MARIA APARECIDA GOMES

2005 Fetranspor

001124507570003850201

0515071970F1971014

IFP-RJ0212222-3333 riocard@fetranspor.com.br

Pgina 16 de 31

PEF-V14 V.1.5.2

Tp_Registro

Nr_seq_reg
Tp_registro
Nr_matrcula

= 05 (Excluso)
=4
= 05
= 77555

Nmero de seqncia do registro

Tipo do registro
Matrcula do usurio

Modelo final do registro Detalhe montado:

000040577555

Tp_Registro

Nr_seq_reg
Tp_registro
Nr_matrcula
Cd_mt_cancel

= 04 (Inativao)
=5
= 04
= 55777
= 01

Nmero de seqncia do registro

Tipo do registro
Matrcula do usurio
Motivo de cancelamento do usurio

Modelo final do registro Detalhe montado:

000050455777

01

Descrio dos dados que compem o registro de Trailler

Nr_seq_reg
Tp_registro

=6
= 99

Nmero de seqncia do registro

Tipo do Registro

Modelo final do registro Trailler montado:

00000699

Exemplo de um arquivo completo:

0000101CADUSU02.0022333444000155
000020255666
JOS DA SILVA
000030244555
MARIA APARECIDA GOMES
000040577555
000050455777
01
0000699

2005 Fetranspor

001006607570002800201
001124507570003850201

02
0515071970F1971014

IFP-RJ0212222-3333 riocard@fetranspor.com.br

Pgina 17 de 31

PEF-V14 V.1.5.2

1.5

Definies para o layout do arquivo com a verso 04.02

Disponvel para utilizao em data a ser divulgada pela Fetranspor.

1.5.1

Registro "Header"

Registro usado para passar dados de gerao e de identificao do arquivo.

Registro Tipo 01 - Header do Arquivo
Nome
Formato
Tam. Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Iniciado em 1, para cada arquivo.
Tp_registro
Num
2 Tipo do Registro:
01 - Header do arquivo.
Nm_arquivo
Alfa
6 Nome do arquivo = "CADUSU".
Constante que identifica o arquivo.
Nr_verso
Alfa
5 Nmero da verso do layout do arquivo.
Verso = 04.02
Nr_doc_comprd
Num
14 Nmero do CPF, CNPJ ou CEI do comprador.

1.5.2

Registros de Detalhe

Registro gerado para identificar os detalhes do arquivo.

Registro Tipo 02 Incluso de Usurio
Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula
Nm_usurio
Nr_CPF

(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

Num

Cd_rede_recarga

Num

Nr_carto

(*)

Cd_tp_carto

Num
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
02 Incluso de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Valor de VT utilizado por dia, para ida e volta.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.
2 Cdigo da rede de recarga:
Ver cdigos na tabela 02 e disponibilidade na tabela 03.
13 Nmero do carto RioCard.
Dever ser informado no caso de reutilizao do carto.
2 Cdigo do tipo de carto que ser solicitado.
Ver cdigos na tabela 04.

Tx_dados_adicionais
Estes dados sero obrigatrios caso tenha escolhido:
cd_tp_carto = 04 (carto VT RioCard individual) ou
cd_tp_carto = 05 (carto VT BU Intermunicipal) ou
cd_tp_carto = 06 (carto VT Bilhete nico Carioca) ou
cd_tp_carto = 07 (carto VT RioCard com migrao do Tipo de
Impresso p/ Personalizado Usurio)
preencher ao menos um dado adicional.

2005 Fetranspor

Pgina 18 de 31

PEF-V14 V.1.5.2

Dt_nascimento

Num

Tp_sexo

Alfa

Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email
(*)

Alfa
Alfa
Num
Alfa
Alfa

8 Data de nascimento do usurio.

Formato ddmmaaaa
1 Sexo do usurio:
M Masculino
F Feminino
15 Nmero do documento de identidade.
6 Sigla do rgo emissor do documento de identidade.
3 Nmero do DDD do telefone de contato
10 Nmero do telefone de contato
60 Endereo de correio eletrnico

Registro Tipo 03 Alterao de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
03 Alterao de usurio
15 Nmero da matrcula do usurio.
40 Nome do usurio.
11 Nmero do CPF do usurio.
Se preencher, ser necessrio ser um CPF vlido.
6 Valor de uso dirio (em centavos).
Alinhado direita, completado com zeros esquerda.
Exemplo: R$ 3,85
000385
2 Cdigo da Cidade onde ser feita a recarga
Ver cdigos na tabela 01 e disponibilidade na tabela 03.

Nr_matrcula
Nm_usurio
Nr_CPF

(*)
(*)

Alfa
Alfa
Num

Vl_uso_dirio

(*)

Num

Cd_cidade

(*)

Num

Cd_rede_recarga

(*)

Num

2 Cdigo da rede de recarga:

Ver cdigos na tabela 02 e disponibilidade na tabela 03.

Nr_carto

(*)

Num

13 Nmero do carto RioCard.

Dever ser informado no caso de reutilizao do carto

Cd_tp_carto

Num

2 Cdigo do tipo de carto que ser solicitado.

Ver cdigos na tabela 04.

Tx_dados_adicionais
Estes dados sero obrigatrios caso tenha escolhido:
cd_tp_carto = 04 (carto VT RioCard individual) ou
cd_tp_carto = 05 (carto VT BU Intermunicipal) ou
cd_tp_carto = 06 (carto VT Bilhete nico Carioca) ou
cd_tp_carto = 07 (carto VT RioCard com migrao do Tipo de
Impresso p/ Personalizado Usurio)
preencher ao menos um dado adicional.

Dt_nascimento

(*)

Num

Tp_sexo

(*)

Alfa

Tx_doc_ident
(*)
Sg_orgao_emissor (*)
Nr_ddd_tel
(*)

2005 Fetranspor

Alfa
Alfa
Num

8 Data de nascimento do usurio.

Formato ddmmaaaa.
1 Sexo do usurio:
M - Masculino
F Feminino
15 Nmero do documento de identidade.
6 Sigla do rgo emissor do documento de identidade.
3 Nmero do DDD do telefone de contato

Pgina 19 de 31

PEF-V14 V.1.5.2

Registro Tipo 04 Inativao de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula
Cd_mt_cancel

Alfa
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
04 Inativao de usurio
15 Nmero da matrcula do usurio.
2 Cdigo do motivo de cancelamento
Ver cdigos na tabela 05.

Registro Tipo 05 Excluso de Usurio

Nome
Nr_seq_reg
Tp_registro

Formato
Num
Num

Nr_matrcula

Alfa

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
05 Excluso de usurio
15 Nmero da matrcula do usurio.

Registro Tipo 06 Reativao de Usurio

Nome
Formato Tam.
Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Tp_registro
Num
2 Tipo do Registro: 06 - Reativao de usurio
Nr_matrcula
Alfa
15 Nmero de matrcula do usurio
01 - Solicitar novo carto
02 - Reutilizar carto existente - Diferente de Personalizado
Tp_reativacao
Num
2
Usurio
03 - Reutilizar carto personalizado
CPF
Num
11 Nmero do CPF (Obrigatrio para Tp_reativacao = 03)
Nmero do carto RioCard (Obrigatrio para Tp_reativacao = 02
Nr_cartao
Num
13
ou 03)
Tx_dados_adicionais
Dt_nascimento
Tp_Sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

2005 Fetranspor

Num
Alfa
Alfa
Alfa
Num
Alfa
Alfa

8
1
15
6
3
10
60

Estes dados sero obrigatrios caso tenha escolhido:

Tp_reativacao = 03
Data de nascimento do usurio. Formato ddmmaaaa
Sexo do usurio: M Masculino F Feminino
Nmero do documento de identidade.
Sigla do rgo emissor do documento de identidade.
Nmero do DDD do telefone de contato
Nmero do telefone de contato
Endereo de correio eletrnico

Pgina 20 de 31

PEF-V14 V.1.5.2

1.5.3

Registro "Trailler"

Registro gerado para identificar o fim do arquivo.

Registro Tipo 99 Fim de Arquivo
Nome
Formato
Nr_seq_reg
Num
Tp_registro
Num

2005 Fetranspor

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
99 - Fim de Arquivo

Pgina 21 de 31

PEF-V14 V.1.5.2

1.5.4

Modelo para a criao do arquivo de importao de usurios na verso 04.02

Apresentamos abaixo um modelo de dados para esclarecer como deve ser feita a montagem do arquivo
texto de importao de usurios. Para a confeco de um arquivo texto um editor de texto simples como o
Bloco de Notas do Windows pode ser utilizado.
Descrio dos dados que compem o registro Header
Nr_seq_reg
Tp_registro
Nm_arquivo
Nr_verso
Nr_doc_comprd

=1
= 01
= CADUSU
= 04.02
= 32.333.444/0001-55

Nmero de seqncia do registro

Tipo do registro
Nome do arquivo
Nmero da verso do layout do arquivo
Nmero do CPF , CNPJ ou CEI do comprador

Modelo final do registro Header montado:

0000101CADUSU04.0222333444000155

Descrio dos dados que compem o registro de Detalhes

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_tp_carto = 01 (Carto VT RioCard ao portador) ou
02 (Carto VT RioCard do comprador) ou
03 (Carto VT RioCard do Comprador/Usurio)
04 (Carto VT RioCard do Usurio)
05 (Carto BU Intermunicipal VT do Usurio)
06 (Carto BU Carioca VT do Usurio)
07 (Carto VT RioCard com Migrao do Tipo de Impresso p/ Personalizado Usurio)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_tp_carto
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=2
Nmero de seqncia do registro
= 02
Tipo do registro
= 55666
Matrcula do usurio
= JOS DA SILVA
Nome do usurio
= 001.006.607-57
Nmero do CPF do usurio
= R$ 2,80
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 02
Tipo de carto que ser solicitado
= 8 espaos em branco Data de nascimento do usurio
= 1 espao em branco Sexo do usurio
= 15 espaos em branco Nmero do documento de identidade
= 6 espaos em branco Sigla do rgo emissor do documento de identidade
= 3 espaos em branco Nmero do DDD do telefone de contato
= 10 espaos em branco Nmero do telefone de contato
= 60 espaos em branco Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000020255666

JOS DA SILVA

2005 Fetranspor

001006607570002800201

02

Pgina 22 de 31

PEF-V14 V.1.5.2

Tp_Registro = 02 (Incluso) ou 03 (Alterao)

Cd_tp_carto = 06 (Carto BU Carioca VT Usurio)

Nr_seq_reg
Tp_registro
Nr_matrcula
Nm_usurio
Nr_CPF
Vl_uso_dirio
Cd_cidade
Cd_rede_recarga
Nr_carto
Cd_tp_carto
Dt_nascimento
Tp_sexo
Tx_doc_ident
Sg_orgo_emissor
Nr_ddd_tel
Nr_tel_contato
Tx_email

=3
Nmero de seqncia do registro
= 02
Tipo do registro
= 44555
Matrcula do usurio
= MARIA APARECIDA GOMES Nome do usurio
= 001.124.507-57
Nmero do CPF do usurio
= R$ 3,85
Valor de uso dirio
= 02
Cdigo da cidade onde ser feita a recarga
= 01
Cdigo da rede de recarga
= 13 espaos em branco Nmero do carto de vale-transporte RioCard
= 05
Tipo de carto que ser solicitado
= 15/07/1970
Data de nascimento do usurio
= F
Sexo do usurio
= 1971014
Nmero do documento de identidade
= IFP-RJ
Sigla do rgo emissor do documento de identidade
= 021
Nmero do DDD do telefone de contato
= 2222-3333
Nmero do telefone de contato
= riocard@fetranspor.com.br
Endereo de correio eletrnico

Modelo final do registro Detalhe montado:

000030244555

MARIA APARECIDA GOMES

2005 Fetranspor

001124507570003850201

0615071970F1971014

IFP-RJ0212222-3333 riocard@fetranspor.com.br

Pgina 23 de 31

PEF-V14 V.1.5.2

Tp_Registro

Nr_seq_reg
Tp_registro
Nr_matrcula

= 05 (Excluso)
=4
= 05
= 77555

Nmero de seqncia do registro

Tipo do registro
Matrcula do usurio

Modelo final do registro Detalhe montado:

000040577555

Tp_Registro

Nr_seq_reg
Tp_registro
Nr_matrcula
Cd_mt_cancel

= 04 (Inativao)
=5
= 04
= 55777
= 01

Nmero de seqncia do registro

Tipo do registro
Matrcula do usurio
Motivo de cancelamento do usurio

Modelo final do registro Detalhe montado:

000050455777

01

Tp_Registro

= 06 (Reativao)

Nr_seq_reg
Tp_registro
Nr_matrcula
Tp_reativacao

=5
=2
= 15
=2

Nmero de seqncia do registro.

Tipo do Registro: 06 - Reativao de usurio
Nmero de matrcula do usurio
01 - Solicitar novo carto
02 - Reutilizar carto existente - Diferente de Personalizado

Usurio
CPF
Nr_cartao
= 02 ou 03)

03 - Reutilizar carto personalizado"

Nmero do CPF (Obrigatrio para Tp_reativacao = 03)
Nmero do carto RioCard (Obrigatrio para Tp_reativacao

= 11
= 13

Tx_dados_adicionais - Estes dados sero obrigatrios caso tenha escolhido: Tp_reativacao = 03

Dt_nascimento
=8
Data de nascimento do usurio. Formato ddmmaaaa
Tp_Sexo
=1
Sexo do usurio: M Masculino F Feminino
Tx_doc_ident
= 15
Nmero do documento de identidade.
Sg_orgo_emissor
=6
Sigla do rgo emissor do documento de identidade.
Nr_ddd_tel
=3
Nmero do DDD do telefone de contato
Nr_tel_contato
= 10
Nmero do telefone de contato
Tx_email
= 60
Endereo de correio eletrnico
Modelo final do registro Detalhe montado:
0000206M51681877490

0351681877490011702267888510101988M1234567

detran21 99878888

carol.carvalho@riocard.com

Descrio dos dados que compem o registro de Trailler

Nr_seq_reg
Tp_registro

=6
= 99

Nmero de seqncia do registro

Tipo do Registro

Modelo final do registro Trailler montado:

00000699

Exemplo de um arquivo completo:

0000101CADUSU02.0022333444000155
000020255666
JOS DA SILVA
000030244555
MARIA APARECIDA GOMES
000040577555
000050455777
01
0000699

2005 Fetranspor

001006607570002800201
001124507570003850201

02
0615071970F1971014

IFP-RJ0212222-3333 riocard@fetranspor.com.br

Pgina 24 de 31

PEF-V14 V.1.5.2

2005 Fetranspor

Pgina 25 de 31

PEF-V14 V.1.5.2

2 Arquivo de Importao do Pedido

Este arquivo dever ser gerado pelo cliente comprador de acordo com suas necessidades de compra,
permitindo as informaes dos valores dos crditos e sua distribuio para os cartes de cada usurio. O
processamento feito acionando a opo de Incluso de Pedidos por Importao de Arquivo no Painel de
Gerenciamento de Pedidos. O arquivo s ser aceito se passar pela validao que efetuada no momento
da execuo da importao do arquivo.

2.1

Regras de Gerao

O nome externo do arquivo ser composto por:

Constante PEDIDO;
Nmero da verso do arquivo, com 4 posies (sem o ponto);
CPF/CNPJ/CEI do cliente comprador, com 14 posies;
Data de gerao do arquivo, no formato aaaammdd;
Hora de gerao do arquivo, no formato hhmm;
Separados por underscore _.

Exemplo para um arquivo gerado para um cliente com o Cnpj de nr. 22.333.444/0001-55, em 12/01/2005,
s 15:25:
PEDIDO_0100_223334440000155_20050112_1525.txt.

ATENO:
-

Todos os campos numricos devem ser alinhados direita e completados com zeros
esquerda.
Exemplo: O Campo Nr_doc_comprd numrico de 14 posies.
56597564152
00056597564152

Todos os campos com valores sero representados com 02 (duas) casas decimais, sem a
vrgula, devem ser alinhados direita e completados com zeros esquerda.
Exemplo: O Campo Vl_carga numrico de 8 posies.
R$ 65,30
00006530

Todos os campos alfa devem ser alinhados esquerda e completados com espaos em
branco direita.

Todos os campos que apresentarem o asterisco ( * ) so opcionais, e devem sem

preenchidos com espaos em branco caso no tenham informaes.

2005 Fetranspor

Pgina 26 de 31

PEF-V14 V.1.5.2

2.2

Definies para o layout do arquivo com a verso 01.00

Disponvel para utilizao dos clientes a partir de Janeiro de 2005.

2.2.1

Registro "Header"

Registro usado para passar dados de gerao e de identificao do arquivo.

Registro Tipo 01 - Header do Arquivo
Nome
Formato
Tam. Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Iniciado em 1, para cada arquivo.
Tp_registro
Num
2 Tipo do Registro:
01 - Header do arquivo.
Nm_arquivo
Alfa
6 Nome do arquivo = "PEDIDO".
Constante que identifica o arquivo.
Nr_verso
Alfa
5 Nmero da verso do layout do arquivo.
Verso = 01.00
Nr_doc_comprd
Num
14 Nmero do CPF, CNPJ ou CEI do comprador.

2.2.2

Registros de Detalhe

Registro gerado para identificar os detalhes do arquivo.

Registro Tipo 02 Item do Pedido
Nome
Formato
Nr_seq_reg
Num
Tp_registro
Num
Nr_matrcula
Vl_carga

Alfa
Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo de Registro:
02 Item do Pedido
15 Nmero da matrcula do usurio.
8 Valor da carga, em centavos.
Alinhado direita, completado com zeros esquerda.
Exemplo: R$ 65,30
00006530

Registro Tipo 03 Dados da Entrega/Retirada dos Cartes

Este registro opcional, devendo ser informado caso no utilize o site para a finalizao do pedido.
Nome
Formato
Tam. Comentrios
Nr_seq_reg
Num
5 Nmero de seqncia do registro.
Tp_registro
Num
2 Tipo de Registro:
03 Dados da Entrega/Retirada dos cartes
Dt_liber_carga
(*)
Num
8 Data da liberao da carga.
Informar caso se queira fixar uma data de liberao maior do
que os 5 ou 7 dias teis aps o pagamento.
Formato ddmmaaaa.
Tp_entrega
(*)
Alfa
1 Tipo da entrega do carto.
Informar caso o pedido tenha solicitaes de cartes novos.
"D" - Entrega domiciliar (ser calculada uma tarifa de entrega
baseada na quantidade de cartes).
"A" - Retirada na agncia do Unibanco informada abaixo.
Nr_agncia
(*)
Num
4 Nmero da agncia para retirada dos cartes produzidos
junto com o pedido.
Dever constar na relao de agncias do Unibanco que
fazem a entrega de cartes.

2005 Fetranspor

Pgina 27 de 31

PEF-V14 V.1.5.2

2.2.3

Registro "Trailler"

Registro gerado para identificar o fim do arquivo.

Registro Tipo 99 Fim de Arquivo
Nome
Formato
Nr_seq_reg
Num
Tp_registro
Num
Vl_pedido

2.2.4

Num

Tam. Comentrios
5 Nmero de seqncia do registro.
2 Tipo do Registro:
99 - Fim de Arquivo
10 Valor total do pedido, em centavos.
Alinhado direita, completado com zeros esquerda.
Exemplo: R$ 1.852,45
0000185245

Modelo para a criao do arquivo de importao de pedidos na verso 01.00

Apresentamos abaixo um modelo de dados para esclarecer como deve ser feita a montagem do arquivo
texto de importao de pedidos. Para a confeco de um arquivo texto um editor de texto simples como o
Bloco de Notas do Windows pode ser utilizado.

Descrio dos dados que compem o registro header

Nr_seq_reg
Tp_registro
Nm_arquivo
Nr_verso
Nr_doc_comprd

=1
= 01
= PEDIDO
= 01.00
= 22.333.444/0001-55

Nmero de seqncia do registro

Tipo do registro
Nome do arquivo
Nmero da verso do layout do arquivo
Nmero do CPF, CNPJ ou CEI do comprador.

Modelo final do Registro Header montado:

0000101PEDIDO01.0022333444000155

Descrio dos dados que compem o registro de detalhes tipo 02 Valor da carga
Nr_seq_reg
Tp_registro
Nr_matrcula
Vl_carga

=2
= 02
= 55666
= R$ 75,00

Nmero de seqncia do registro

Tipo do registro
Nmero da Matrcula do usurio
Valor da carga em centavos de R$

Modelo final do Registro Detalhe tipo 02 montado:

000020255666

00007500

Descrio dos dados que compem o registro de detalhes tipo 03 Dados da entrega a domicilio
Nr_seq_reg
Tp_registro
Dt_liber_carga
Tp_entrega
Nr_agncia

=7
= 03
= 27/01/2005
=D
= 4 espaos em branco

Nmero de seqncia do registro

Tipo do registro
Data da liberao da carga
Tipo da entrega dos cartes
Nmero da agncia para retirada dos cartes

Modelo final do Registro Detalhe tipo 03 (entrega domiciliar) montado:

000070327012005D

2005 Fetranspor

Pgina 28 de 31

PEF-V14 V.1.5.2

Descrio dos dados que compem o registro de detalhes tipo 03 Dados da entrega na agncia
Nr_seq_reg
Tp_registro
Dt_liber_carga
Tp_entrega
Nr_agncia

=7
= 03
= 27/01/2005
=A
= 1122

Nmero de seqncia do registro

Tipo do registro
Data da liberao da carga
Tipo da entrega dos cartes
Nmero da agncia para retirada dos cartes

Modelo final do Registro Detalhe tipo 03 (entrega na agncia) montado:

000070327012005A1122

Descrio dos dados que compem o registro de Trailler

Nr_seq_reg
Tp_registro
Vl_pedido

=8
= 99
= R$ 430,00

Nmero de seqncia do registro

Tipo do registro
Valor do pedido

Modelo final do Registro Trailler montado:

00008990000043000

Exemplo de um arquivo completo:

0000101PEDIDO01.0022333444000155
000020255666
00007500
000030244555
00008500
000040233444
00009500
000050222333
00011000
000060211222
00006500
000070327012005D
00008990000043000

2005 Fetranspor

Pgina 29 de 31

PEF-V14 V.1.5.2

Tabelas Auxiliares

3.1

Tabela 01 - Cidades Integrantes do Sistema RioCard

Relaciona as cidades que tm sistemas de bilhetagem eletrnica integrados ao RioCard.

Cidades
46 Maric
06 Niteri
02 Rio de Janeiro
74 So Gonalo
01 Terespolis
04 Duque de Caxias

3.2

Observao
Disponvel em
Disponvel em
Disponvel em
Disponvel em
Disponvel em
Disponvel em

Agosto/2005
Agosto/2005
Janeiro/2005
Agosto/2005
Agosto/2005
Novembro/2005

Tabela 02 - Redes de Recarga

Relaciona as redes de recarga que sero utilizadas no sistema.

Redes de recarga
01 nibus
02 Metr
03 Trens
04 Barcas
05 Rede de POS da Fetranspor

3.3

Observao
Disponvel em Janeiro/2005
Disponvel em Fevereiro/2005
No est disponvel
No est disponvel
No est disponvel

Tabela 03 - Disponibilidade das Redes de Recarga

Mostra as redes de recarga disponveis em cada cidade integrante do sistema.

Cidades
46 Marica
06 Niteri
02 Rio de Janeiro
74 So Gonalo
01 Terespolis
04 Duque de Caxias

2005 Fetranspor

01 - nibus
Sim
Sim

02 - Metr
Sim
-

03 - Trens
-

04 - Barcas
-

05 - POS
-

Pgina 30 de 31

PEF-V14 V.1.5.2

3.4

Tabela 04 - Tipos de Carto

Relaciona os tipos de carto que podero ser solicitados na personalizao dos cartes e com quem ser
feito o comodato da posse do carto.
Cdigo
01
02
03

04
05
06

07

Ttulo
Carto VT RioCard ao
Portador
Carto VT RioCard do
Comprador
Carto VT RioCard do
Comprador/Usurio

Impresso
- Nmero do RioCard

- Nmero do RioCard
- Nome do Comprador
- Nmero do RioCard
- Nome do Comprador
- Nome do Usurio
Carto VT RioCard
- Nmero do RioCard
Individual
- Nome do Usurio
Carto VT BU Intermunicipal - Nmero do RioCard
do Usurio
- Nome do Usurio
Carto VT BU Carioca do
- Nmero do RioCard
Usurio
- Nome do Usurio
Este cdigo dever ser
Carto VT RioCard com
utilizado para migrar o tipo de
Migrao do Tipo de
Impresso p/ Personalizado impresso atual do carto para
Personalizado Usurio,
Usurio

Comodato
Com o Comprador
Com o Comprador
Com o Comprador

Com o usurio
Com o usurio
Com o usurio

Com o usurio, aps

migrao

habilitando o mesmo para

funcionar como BU
Intermunicipal e Carioca,
evitando a substituio do
carto

3.5

Tabela 05 Motivos de Cancelamento de Usurio

Relaciona os cdigos de motivo de cancelamento de usurios que podero ser utilizados na inativao de
usurios.
Cdigo
01
02
03
04

2005 Fetranspor

Motivo de Cancelamento
Demisso
bito
No optante
Transferncia

Pgina 31 de 31