pef-v14-ver1.5.2 - layouts dos arquivos de importacao de usuarios e pedidos

90

Projeto Executivo

Volume 14

Layouts dos Arquivos de Importao: Usurios e Pedidos

Bilhetagem Eletrnica

RRIIOOCCAARRDD

PEF-V14 V.1.5.2

2005 Fetranspor Pgina 2 de 31

Origem FETRANSPOR Federao das Empresas de Transportes de Passageiros do Estado do Rio de Janeiro

Data 24/02/2005

Documento PEF-V14

Ttulo Projeto Executivo Riocard - Volume 14 - Layouts dos arquivos de importao: usurios e pedidos

Controle de verses Verso do documento

Data da atualizao

Tcnico Responsvel

1.0 14/01/2005 Everaldo Cartaxo Bastos 1.1 10/02/2005 Marcel Lapido Barbosa 1.2 24/02/2005 Marcel Lapido Barbosa 1.3 01/11/2005 Marcos Rodrigues da Silva 1.4 28/05/2010 Eliezer Ricardo e Danilo Leite 1.5 08/10/2010 Eliezer Ricardo 1.5.1 11/10/2010 Marcus Bignon 1.5.2 18/02/2014 Carol Carvalho

Bilhetagem Eletrnica

PEF-V14 V.1.5.2


ndice

1 Arquivo de Importao de Usurios ...................................................... 4 1.1 Regras de Gerao ................................................................................................... 4 1.2 Definies para o layout do arquivo com a verso 02.00 ..................................... 5 1.2.1 Registro "Header" .............................................................................................................................. 5 1.2.2 Registros de Detalhe ......................................................................................................................... 5 1.2.3 Registro "Trailler" .............................................................................................................................. 6 1.2.4 Modelo para a criao do arquivo de importao de usurios na verso 02.00 ......................... 6 1.3 Definies para o layout do arquivo com a verso 03.01 ..................................... 8 1.3.1 Registro "Header" .............................................................................................................................. 8 1.3.2 Registros de Detalhe ......................................................................................................................... 8 1.3.3 Registro "Trailler" .............................................................................................................................. 9 1.3.4 Modelo para a criao do arquivo de importao de usurios na verso 03.01 ....................... 10 1.4 Definies para o layout do arquivo com a verso 04.01 ................................... 12 1.4.1 Registro "Header" ............................................................................................................................ 12 1.4.2 Registros de Detalhe ....................................................................................................................... 12 1.4.3 Registro "Trailler" ............................................................................................................................ 14 1.4.4 Modelo para a criao do arquivo de importao de usurios na verso 04.01 ....................... 15 1.5 Definies para o layout do arquivo com a verso 04.02 ................................... 18 1.5.1 Registro "Header" ............................................................................................................................ 18 1.5.2 Registros de Detalhe ....................................................................................................................... 18 1.5.3 Registro "Trailler" ............................................................................................................................ 21 1.5.4 Modelo para a criao do arquivo de importao de usurios na verso 04.02 ....................... 22

2 Arquivo de Importao do Pedido ....................................................... 26 2.1 Regras de Gerao ................................................................................................. 26 2.2 Definies para o layout do arquivo com a verso 01.00 ................................... 27 2.2.1 Registro "Header" ............................................................................................................................ 27 2.2.2 Registros de Detalhe ....................................................................................................................... 27 2.2.3 Registro "Trailler" ............................................................................................................................ 28 2.2.4 Modelo para a criao do arquivo de importao de pedidos na verso 01.00 ........................ 28

3 Tabelas Auxiliares ................................................................................ 30 3.1 Tabela 01 - Cidades Integrantes do Sistema RioCard ......................................... 30 3.2 Tabela 02 - Redes de Recarga ............................................................................... 30 3.3 Tabela 03 - Disponibilidade das Redes de Recarga ............................................ 30 3.4 Tabela 04 - Tipos de Carto ................................................................................... 31 3.5 Tabela 05 Motivos de Cancelamento de Usurio .............................................. 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.

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

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 Tam. Comentrios Tp_registro Num 2 Tipo do Registro:

99 Fim de Arquivo. Qt_registros Num 6 Quantidade de registros do arquivo, incluindo o Header e o

Trailler.

1.2.4 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 = 01 Tipo do registro Nm_arquivo = CADUSU Nome do arquivo Nr_verso = 02.00 Nmero da verso do layout do arquivo Nr_doc_comprd = 22.333.444/0001-55 Nmero do CPF , CNPJ ou CEI do comprador Dt_gerao_arq = 12/01/2005 Data da gerao do arquivo Hr_gerao_arq = 15:25 Hora da gerao do arquivo

Modelo final do registro Header montado: 01CADUSU02.0022333444000155120120051525

Descrio dos dados que compem o registro de Detalhes

Tp_registro = 02 Tipo do registro Nr_matrcula = 55666 Matrcula do usurio Nm_usurio = JOS DA SILVA Nome do Usurio Nr_CPF = 001.006.607-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 2,80 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 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 = 99 Tipo do Registro Qt_registros = 7 Quantidade de registros

Modelo final do registro Trailler montado: 99000007

Exemplo de um arquivo completo:

PEF-V14 V.1.5.2


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

PEF-V14 V.1.5.2



Disponvel para utilizao em data a ser divulgada pela Fetranspor.



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:


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.



Registro Tipo 02 Incluso de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

02 Incluso de usurio Nr_matrcula Alfa 15 Nmero da matrcula do usurio. Nm_usurio Alfa 40 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 (em centavos).


Cd_cidade Num 2 Cdigo da Cidade onde ser feita a recarga Ver cdigos na tabela 01 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)

Dt_nascimento Num 8 Data de nascimento do usurio. Formato ddmmaaaa

Tp_sexo Alfa 1 Sexo do usurio: M Masculino F Feminino

PEF-V14 V.1.5.2


Tx_doc_ident Alfa 15 Nmero do documento de identidade. Sg_orgo_emissor Alfa 6 Sigla do rgo emissor do documento de identidade. Nr_ddd_tel Num 3 Nmero do DDD do telefone de contato Nr_tel_contato Alfa 10 Nmero do telefone de contato Tx_email (*) Alfa 60 Endereo de correio eletrnico



Registro Tipo 99 Fim de Arquivo Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

99 - Fim de Arquivo

Registro Tipo 03 Alterao de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

03 Alterao de usurio Nr_matrcula Alfa 15 Nmero da matrcula do usurio. Nm_usurio (*) Alfa 40 Nome do usurio. Nr_CPF (*) Num 11 Nmero do CPF do usurio.


Alinhado direita, completado com zeros esquerda. 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 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)

Dt_nascimento (*) Num 8 Data de nascimento do usurio. Formato ddmmaaaa.

Tp_sexo (*) Alfa 1 Sexo do usurio: M - Masculino F Feminino

Tx_doc_ident (*) Alfa 15 Nmero do documento de identidade. Sg_orgao_emissor (*) Alfa 6 Sigla do rgo emissor do documento de identidade. Nr_ddd_tel (*) Num 3 Nmero do DDD do telefone de contato Nr_tel_contato (*) Alfa 10 Nmero do telefone de contato Tx_email (*) Alfa 60 Endereo de correio eletrnico

PEF-V14 V.1.5.2





Nr_seq_reg = 1 Nmero de seqncia do registro Tp_registro = 01 Tipo do registro Nm_arquivo = CADUSU Nome do arquivo Nr_verso = 03.01 Nmero da verso do layout do arquivo Nr_doc_comprd = 32.333.444/0001-55 Nmero do CPF , CNPJ ou CEI do comprador



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 = 2 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 55666 Matrcula do usurio Nm_usurio = JOS DA SILVA Nome do usurio Nr_CPF = 001.006.607-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 2,80 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_impresso = 02 Cdigo de impresso que ser feita no carto solicitado Dt_nascimento = 8 espaos em branco Data de nascimento do usurio Tp_sexo = 1 espao em branco Sexo do usurio Tx_doc_ident = 15 espaos em branco Nmero do documento de identidade Sg_orgo_emissor = 6 espaos em branco Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 3 espaos em branco Nmero do DDD do telefone de contato Nr_tel_contato = 10 espaos em branco Nmero do telefone de contato Tx_email = 60 espaos em branco Endereo de correio eletrnico

Modelo final do registro Detalhe montado: 000020255666 JOS DA SILVA 001006607570002800201 02

PEF-V14 V.1.5.2


Tp_Registro = 02 (Incluso) ou 03 (Alterao) Cd_impresso = 04 (Carto individual)

Nr_seq_reg = 3 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 44555 Matrcula do usurio Nm_usurio = MARIA APARECIDA GOMES Nome do usurio Nr_CPF = 001.124.507-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 3,85 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_impresso = 04 Cdigo de impresso que ser feita no carto solicitado Dt_nascimento = 15/07/1970 Data de nascimento do usurio Tp_sexo = F Sexo do usurio Tx_doc_ident = 1971014 Nmero do documento de identidade Sg_orgo_emissor = IFP-RJ Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 021 Nmero do DDD do telefone de contato Nr_tel_contato = 2222-3333 Nmero do telefone de contato Tx_email = [email protected] Endereo de correio eletrnico

Modelo final do registro Detalhe montado: 000030244555 MARIA APARECIDA GOMES 001124507570003850201 0415071970F1971014 IFP-RJ0212222-3333 [email protected]


Nr_seq_reg = 7 Nmero de seqncia do registro Tp_registro = 99 Tipo do Registro



0000101CADUSU02.0022333444000155 000020255666 JOS DA SILVA 001006607570002800201 02 000030244555 MARIA APARECIDA GOMES 001124507570003850201 0415071970F1971014 IFP-RJ0212222-3333 [email protected] 000040233444 PEDRO ALVES DE OLIVEIRA 082184127450006400201 02 000050222333 CARLOS ANDRADE PEREIRA 024234717770003200201 0424051960M123321452/2VIA SSP-GO0224444-5555 [email protected] 000060211222 GISELE DE SOUZA 037345127610003000201 02 0000799

PEF-V14 V.1.5.2




















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 Bilhete nico individual) ou preencher ao menos um dado adicional.


PEF-V14 V.1.5.2












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 Bilhete nico individual) ou preencher ao menos um dado adicional.



Tx_doc_ident (*) Alfa 15 Nmero do documento de identidade. Sg_orgao_emissor (*) Alfa 6 Sigla do rgo emissor do documento de identidade. Nr_ddd_tel (*) Num 3 Nmero do DDD do telefone de contato Nr_tel_contato (*) Alfa 10 Nmero do telefone de contato Tx_email (*) Alfa 60 Endereo de correio eletrnico

PEF-V14 V.1.5.2


Registro Tipo 05 Excluso de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

05 Excluso de usurio Nr_matrcula Alfa 15 Nmero da matrcula do usurio.




99 - Fim de Arquivo

Registro Tipo 04 Inativao de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

04 Inativao de usurio Nr_matrcula Alfa 15 Nmero da matrcula do usurio. Cd_mt_cancel Num 2 Cdigo do motivo de cancelamento

Ver cdigos na tabela 05.

PEF-V14 V.1.5.2








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 = 2 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 55666 Matrcula do usurio Nm_usurio = JOS DA SILVA Nome do usurio Nr_CPF = 001.006.607-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 2,80 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_tp_carto = 02 Tipo de carto que ser solicitado Dt_nascimento = 8 espaos em branco Data de nascimento do usurio Tp_sexo = 1 espao em branco Sexo do usurio Tx_doc_ident = 15 espaos em branco Nmero do documento de identidade Sg_orgo_emissor = 6 espaos em branco Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 3 espaos em branco Nmero do DDD do telefone de contato Nr_tel_contato = 10 espaos em branco Nmero do telefone de contato Tx_email = 60 espaos em branco Endereo de correio eletrnico


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 = 3 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 44555 Matrcula do usurio Nm_usurio = MARIA APARECIDA GOMES Nome do usurio Nr_CPF = 001.124.507-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 3,85 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_tp_carto = 05 Tipo de carto que ser solicitado Dt_nascimento = 15/07/1970 Data de nascimento do usurio Tp_sexo = F Sexo do usurio Tx_doc_ident = 1971014 Nmero do documento de identidade Sg_orgo_emissor = IFP-RJ Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 021 Nmero do DDD do telefone de contato Nr_tel_contato = 2222-3333 Nmero do telefone de contato Tx_email = [email protected] Endereo de correio eletrnico


PEF-V14 V.1.5.2


Tp_Registro = 05 (Excluso)

Nr_seq_reg = 4 Nmero de seqncia do registro Tp_registro = 05 Tipo do registro Nr_matrcula = 77555 Matrcula do usurio

Modelo final do registro Detalhe montado: 000040577555

Tp_Registro = 04 (Inativao)

Nr_seq_reg = 5 Nmero de seqncia do registro Tp_registro = 04 Tipo do registro Nr_matrcula = 55777 Matrcula do usurio Cd_mt_cancel = 01 Motivo de cancelamento do usurio

Modelo final do registro Detalhe montado: 000050455777 01





0000101CADUSU02.0022333444000155 000020255666 JOS DA SILVA 001006607570002800201 02 000030244555 MARIA APARECIDA GOMES 001124507570003850201 0515071970F1971014 IFP-RJ0212222-3333 [email protected] 000040577555 000050455777 01 0000699

PEF-V14 V.1.5.2





















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.

PEF-V14 V.1.5.2













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.



Tx_doc_ident (*) Alfa 15 Nmero do documento de identidade. Sg_orgao_emissor (*) Alfa 6 Sigla do rgo emissor do documento de identidade. Nr_ddd_tel (*) Num 3 Nmero do DDD do telefone de contato

PEF-V14 V.1.5.2


Registro Tipo 05 Excluso de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

05 Excluso de usurio Nr_matrcula Alfa 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

Tp_reativacao Num 2

01 - Solicitar novo carto

02 - Reutilizar carto existente - Diferente de Personalizado

Usurio

03 - Reutilizar carto personalizado

CPF Num 11 Nmero do CPF (Obrigatrio para Tp_reativacao = 03)

Nr_cartao Num 13 Nmero do carto RioCard (Obrigatrio para Tp_reativacao = 02

ou 03)

Tx_dados_adicionais Estes dados sero obrigatrios caso tenha escolhido:

Tp_reativacao = 03


Tp_Sexo Alfa 1 Sexo do usurio: M Masculino F Feminino

Tx_doc_ident Alfa 15 Nmero do documento de identidade.

Sg_orgo_emissor Alfa 6 Sigla do rgo emissor do documento de identidade.

Nr_ddd_tel Num 3 Nmero do DDD do telefone de contato

Nr_tel_contato Alfa 10 Nmero do telefone de contato

Tx_email Alfa 60 Endereo de correio eletrnico

Registro Tipo 04 Inativao de Usurio Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo do Registro:

04 Inativao de usurio Nr_matrcula Alfa 15 Nmero da matrcula do usurio. Cd_mt_cancel Num 2 Cdigo do motivo de cancelamento

Ver cdigos na tabela 05.

PEF-V14 V.1.5.2





99 - Fim de Arquivo

PEF-V14 V.1.5.2








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 = 2 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 55666 Matrcula do usurio Nm_usurio = JOS DA SILVA Nome do usurio Nr_CPF = 001.006.607-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 2,80 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_tp_carto = 02 Tipo de carto que ser solicitado Dt_nascimento = 8 espaos em branco Data de nascimento do usurio Tp_sexo = 1 espao em branco Sexo do usurio Tx_doc_ident = 15 espaos em branco Nmero do documento de identidade Sg_orgo_emissor = 6 espaos em branco Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 3 espaos em branco Nmero do DDD do telefone de contato Nr_tel_contato = 10 espaos em branco Nmero do telefone de contato Tx_email = 60 espaos em branco Endereo de correio eletrnico


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 = 3 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 44555 Matrcula do usurio Nm_usurio = MARIA APARECIDA GOMES Nome do usurio Nr_CPF = 001.124.507-57 Nmero do CPF do usurio Vl_uso_dirio = R$ 3,85 Valor de uso dirio Cd_cidade = 02 Cdigo da cidade onde ser feita a recarga Cd_rede_recarga = 01 Cdigo da rede de recarga Nr_carto = 13 espaos em branco Nmero do carto de vale-transporte RioCard Cd_tp_carto = 05 Tipo de carto que ser solicitado Dt_nascimento = 15/07/1970 Data de nascimento do usurio Tp_sexo = F Sexo do usurio Tx_doc_ident = 1971014 Nmero do documento de identidade Sg_orgo_emissor = IFP-RJ Sigla do rgo emissor do documento de identidade Nr_ddd_tel = 021 Nmero do DDD do telefone de contato Nr_tel_contato = 2222-3333 Nmero do telefone de contato Tx_email = [email protected] Endereo de correio eletrnico


PEF-V14 V.1.5.2


Tp_Registro = 05 (Excluso)

Nr_seq_reg = 4 Nmero de seqncia do registro Tp_registro = 05 Tipo do registro Nr_matrcula = 77555 Matrcula do usurio

Modelo final do registro Detalhe montado: 000040577555

Tp_Registro = 04 (Inativao)

Nr_seq_reg = 5 Nmero de seqncia do registro Tp_registro = 04 Tipo do registro Nr_matrcula = 55777 Matrcula do usurio Cd_mt_cancel = 01 Motivo de cancelamento do usurio

Modelo final do registro Detalhe montado: 000050455777 01

Tp_Registro = 06 (Reativao)

Nr_seq_reg = 5 Nmero de seqncia do registro. Tp_registro = 2 Tipo do Registro: 06 - Reativao de usurio Nr_matrcula = 15 Nmero de matrcula do usurio Tp_reativacao = 2 01 - Solicitar novo carto 02 - Reutilizar carto existente - Diferente de Personalizado Usurio 03 - Reutilizar carto personalizado" CPF = 11 Nmero do CPF (Obrigatrio para Tp_reativacao = 03) Nr_cartao = 13 Nmero do carto RioCard (Obrigatrio para Tp_reativacao = 02 ou 03)

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 [email protected]





0000101CADUSU02.0022333444000155 000020255666 JOS DA SILVA 001006607570002800201 02 000030244555 MARIA APARECIDA GOMES 001124507570003850201 0615071970F1971014 IFP-RJ0212222-3333 [email protected] 000040577555 000050455777 01 0000699

PEF-V14 V.1.5.2


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.

PEF-V14 V.1.5.2



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





01 - Header do arquivo. Nm_arquivo Alfa 6 Nome do arquivo = "PEDIDO".





Registro Tipo 02 Item do Pedido Nome Formato Tam. Comentrios Nr_seq_reg Num 5 Nmero de seqncia do registro. Tp_registro Num 2 Tipo de Registro:

02 Item do Pedido Nr_matrcula Alfa 15 Nmero da matrcula do usurio. Vl_carga Num 8 Valor da carga, em centavos.


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.

PEF-V14 V.1.5.2





99 - Fim de Arquivo Vl_pedido Num 10 Valor total do pedido, em centavos.

Alinhado direita, completado com zeros esquerda. Exemplo: R$ 1.852,45 0000185245

2.2.4 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 = 1 Nmero de seqncia do registro Tp_registro = 01 Tipo do registro Nm_arquivo = PEDIDO Nome do arquivo Nr_verso = 01.00 Nmero da verso do layout do arquivo Nr_doc_comprd = 22.333.444/0001-55 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 = 2 Nmero de seqncia do registro Tp_registro = 02 Tipo do registro Nr_matrcula = 55666 Nmero da Matrcula do usurio Vl_carga = R$ 75,00 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 = 7 Nmero de seqncia do registro Tp_registro = 03 Tipo do registro Dt_liber_carga = 27/01/2005 Data da liberao da carga Tp_entrega = D Tipo da entrega dos cartes Nr_agncia = 4 espaos em branco Nmero da agncia para retirada dos cartes

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

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 = 7 Nmero de seqncia do registro Tp_registro = 03 Tipo do registro Dt_liber_carga = 27/01/2005 Data da liberao da carga Tp_entrega = A Tipo da entrega dos cartes Nr_agncia = 1122 Nmero da agncia para retirada dos cartes

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


Nr_seq_reg = 8 Nmero de seqncia do registro Tp_registro = 99 Tipo do registro Vl_pedido = R$ 430,00 Valor do pedido

Modelo final do Registro Trailler montado: 00008990000043000


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

PEF-V14 V.1.5.2


3 Tabelas Auxiliares

3.1 Tabela 01 - Cidades Integrantes do Sistema RioCard

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

Cidades Observao 46 Maric Disponvel em Agosto/2005 06 Niteri Disponvel em Agosto/2005 02 Rio de Janeiro Disponvel em Janeiro/2005 74 So Gonalo Disponvel em Agosto/2005 01 Terespolis Disponvel em Agosto/2005 04 Duque de Caxias Disponvel em Novembro/2005

3.2 Tabela 02 - Redes de Recarga

Relaciona as redes de recarga que sero utilizadas no sistema.

Redes de recarga Observao 01 nibus Disponvel em Janeiro/2005 02 Metr Disponvel em Fevereiro/2005 03 Trens No est disponvel 04 Barcas No est disponvel 05 Rede de POS da Fetranspor No est disponvel

3.3 Tabela 03 - Disponibilidade das Redes de Recarga

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

Cidades 01 - nibus 02 - Metr 03 - Trens 04 - Barcas 05 - POS 46 Marica - - - - - 06 Niteri - - - - - 02 Rio de Janeiro Sim Sim - - - 74 So Gonalo - - - - - 01 Terespolis - - - - - 04 Duque de Caxias Sim - - - -

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 Ttulo Impresso Comodato 01 Carto VT RioCard ao

Portador - Nmero do RioCard Com o Comprador

02 Carto VT RioCard do Comprador

- Nmero do RioCard - Nome do Comprador

Com o Comprador

03 Carto VT RioCard do Comprador/Usurio

- Nmero do RioCard - Nome do Comprador - Nome do Usurio

Com o Comprador

04 Carto VT RioCard Individual

- Nmero do RioCard - Nome do Usurio

Com o usurio

05 Carto VT BU Intermunicipal do Usurio


Com o usurio

06 Carto VT BU Carioca do Usurio


Com o usurio

07 Carto VT RioCard com Migrao do Tipo de Impresso p/ Personalizado Usurio

Este cdigo dever ser utilizado para migrar o tipo de impresso atual do carto para Personalizado Usurio, habilitando o mesmo para funcionar como BU Intermunicipal e Carioca, evitando a substituio do carto

Com o usurio, aps migrao

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 Motivo de Cancelamento 01 Demisso 02 bito 03 No optante 04 Transferncia

pef-v14-ver1.5.2 - layouts dos arquivos de importacao de usuarios e pedidos

Documents