Carteiras Profissionais

(1)

SERVIÇO PÚBLICO FEDERAL

CONSELHO FEDERAL DE ENGENHARIA E AGRONOMIA – CONFEA

Carteiras Profissionais

(2)

Histórico de Revisão

Data Versão Descrição Autor

16/06/2015 1.0 Demonstração do serviço fornecido pelo CONFEA para manipular a carteira profissional

Fernando Batista da Silva

29/07/2015 1.1 Inclusão dos serviços:

 Solicitação do token de impressão

 Impressão das carteiras profissionais

(3)

1

Índice

1 OBJETIVO ... 2 2 ACESSO ... 2 3 SEGURANÇA ... 2 4 DETALHAMENTO DO SERVIÇO. ... 3

4.1 SOLICITAR O TOKEN DE IMPRESSÃO. ... 5

4.1.1 Parâmetros ... 5

4.1.2 Resultado ... 6

4.2 IMPRIMIR CARTEIRAS PROFISSIONAIS ... 6

4.2.1 Parâmetro ... 6

4.2.2 Resultado ... 6

5 INFORMAÇÕES ADICIONAIS ... 7

(4)

2

Documento de Visão

1 Objetivo

Este documento tem por objetivo demonstrar as funcionalidades disponibilizadas no serviço responsável por gerenciar a carteira profissional, bem como demonstrar seu funcionamento e fornecer aos conselhos e inspetorias meios pelos quais seja possível gerenciar a impressão de carteiras profissionais, para isto serão fornecidas operações para:

a) Solicitar o Token de impressão b) Imprimir carteiras profissionais

2 Acesso

O acesso ao serviço será fornecido pelo CONFEA mediante solicitação pelo e-mail

gti@confea.org.br, no qual deverão ser informados os seguintes dados:

 Nome da inspetoria e respectivo regional.

 I.P. da aplicação que irá consumir o serviço (deve ser fornecido o I.P. externo).

 Período no qual o serviço ficará ativo (data inicial e data final).

Mediante solicitação o CONFEA fornecerá um código de acesso ao conselho que deverá ser informado como parâmetro em todas as requisições feitas ao serviço.

O serviço estará acessível no seguinte endereço, onde poderão ser consultados os métodos expostos e a descrição do serviço.

Endereço do serviço: (Ambiente de teste)

http://wcfsci.teste.confea.org.br:8081/services/CarteiraProfissionalService.svc Descrição do serviço (wsdl):

http://wcfsci.teste.confea.org.br:8081/services/CarteiraProfissionalService.svc?wsdl

(5)

3 O acesso é restrito ao endereço I.P. informado pelo CREA. Caso o cliente altere o I.P. de seus servidores, deverá informar com antecedência para que seu acesso não seja bloqueado. Todas as informações recebidas e enviadas pelos métodos destes serviços, são armazenadas em log na base de dados do CONFEA e o mesmo deve ser feito no ambiente do CREA. Os dados são trafegados utilizando protocolo SSL.

4 Detalhamento do serviço.

Os serviços disponibilizados pelo CONFEA são:

 Solicitar o Token de impressão (SolicitarTokenImpressao)

 Imprimir carteiras profissionais (ImprimirCarteirasProfissionais)

(6)

(7)

5

4.1 Solicitar o token de impressão.

Este método é responsável por fornecer um token para impressão da carteira profissional.

O token deverá ser utilizado como parâmetro obrigatório para impressão da carteira profissional, terá validade de sete dias a partir da solicitação.

4.1.1 Parâmetros

Para realizar a requisição o sistema deverá informar obrigatoriamente uma lista do objeto CarteiraProfissionalEntity como parâmetro, onde o sistema irá gerar um token para cada carteira profissional.

CarteiraProfissionalEntity:

Propriedade Tipo Tamanho Obrigatório Observação

Codigo Inteiro Não

RegistroProfissional Texto 10 Sim RegistroCrea Texto 15 Sim

Nome Texto 60 Sim

CPF Texto 11 Sim

DataRegistroCrea Data Sim Titulo1 Texto 70 Sim Titulo2 Texto 70 Não Titulo3 Texto 70 Não Titulo4 Texto 70 Não NomeMae Texto 53 Sim NomePai Texto 53 Sim DataNascimento Data Sim Nacionalidade Texto 12 Sim Naturalidade Texto 24 Sim NumeroDocumento (RG) Texto 15 Sim NumeroTituloEleitor Texto 12 Sim ZonaTituloEleitor Texto 4 Sim SecaoTituloEleitor Texto 4 Sim MunicipioTiuloEleitor Texto 30 Sim UFTituloEleitor Texto 2 Sim PisPasep Texto 11 Sim UrlQrCode Texto Não

Situacao Texto Não

Justificativa Texto Não TokenAcesso Texto 36 Sim

(8)

6

4.1.2 Resultado

A requisição irá retornar o objeto ActionReturn<List<TokenImpressaoEntity>>, com as seguintes propriedades.

 Entidade

o Lista com os objetos que serão utilizados para realizar a impressão da carteira profissional.

 Erro

o Variável booleana que indica se houve erro na requisição.

 Mensagens

o Lista de mensagens, em caso de erro o sistema obrigatoriamente irá informar todos os erros encontrados no processo.

4.2 Imprimir carteiras profissionais

Serviço responsável por realizar a impressão da carteira profissional, para isto a requisição deve ser realizada pelo CREA no qual o usuário está registrado, o

profissional deve estar devidamente registrado no SIC (sistema de informações confea /

crea).

4.2.1 Parâmetro

Para realizar a requisição o sistema deverá informar o seguinte objeto como parâmetro da pesquisa:

List<TokenImpressaoEntity>

O sistema deverá gerar obrigatoriamente uma carteira profissional por token.

Propriedade Tipo Tamanho Obrigatório Observação

Token Texto 36 Sim

Validade Data Não

4.2.2 Resultado

A pesquisa irá retornar o objeto ActionReturn<List<CarteiraProfissionalEntity>>:

 Entidade

o Lista de objetos que representam as carteiras profissionais impressas, cada registro na lista deve ser utilizado para imprimir uma carteira profissional.

 Erro

o Variável booleana que indica se houve erro na requisição.

(9)

7 o Lista de mensagens, em caso de erro o sistema obrigatoriamente irá

informar todos os erros encontrados no processamento.

5 Informações Adicionais

Informações adicionais serão fornecidas mediante solicitação.

6 Contato técnico

E-mail: fernando.silva@confea.org.br