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 Silva 29/07/2015 1.1 Inclusão dos serviços:

 Solicitação do token de impressão

 Impressão das carteiras profissionais

16/11/2015 1.2 Adaptação do WebService para integração à impressora modelo SR-300

(3)

1

Índice

1 OBJETIVO ... 2 2 ACESSO ... 2 3 SEGURANÇA ... 3 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 ... 7

4.2.1 Parâmetro ... 7

4.2.2 Resultado ... 7

5 INFORMAÇÕES ADICIONAIS ... 8

(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 impressão da carteira profissional, bem como demonstrar seu funcionamento e fornecer aos conselhos e inspetorias meios pelos quais seja possível realizar a impressão das novas carteiras profissionais.

Serviços:

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):

(5)

3

3 Segurança

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) Segue abaixo o fluxograma do processo de impressão da carteira profissional:

(6)

(7)

5

4.1 Solicitar o token de impressão.

Serviço 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.

4.1.1 Parâmetros

Parâmetros de requisição:

Nome Tipo Formato

carteiraProfissional CarteiraProfissionalEntity tokenAcesso Guid

00000000-0000-0000-0000-000000000000

Detalhamento dos parâmetros:

carteiraProfissionalEntity

Objeto que representa a carteira profissional a ser impressa, caso algum campo não obrigatório seja omitido, o sistema irá utilizar os dados armazenados no banco de dados do SIC.

Alguns campos serão utilizados para atualizar os dados do profissional, conforme descritos abaixo.

Campo Tipo Atualizável Obrigatório Observação

RegistroProfissional Texto Não Sim RNP do profissional

RegistroCrea Texto Não Sim Registro do

Profissional no CREA

UFCrea Texto Não Sim UF do CREA

Nome Texto Sim Não Nome do Profissional

CPF Texto Não Sim

DataRegistroCrea Data Não Sim

Titulo1 Texto Sim Sim Será atualizado caso

exista no BD do SIC

Titulo2 Texto Sim Não

NomeMae Texto Sim Sim

NomePai Texto Sim Sim

(8)

6

Nacionalidade Texto Não Sim

Naturalidade Texto Não Sim

NumeroDocumento (RG) Texto Não Sim

TituloEleitor Texto Sim Não

ZonaTituloEleitor Texto Sim Não

SecaoTituloEleitor Texto Sim Não MunicipioTiuloEleitor Texto Sim Não

UFTituloEleitor Texto Sim Não

PisPasep Texto Sim Não

UrlQrCode Texto Não Não

TipoSanguineo Texto Sim Não

Doador Booleano Sim Não

Indica se o

profissional é doador de órgãos

ImagemProfissional Texto Sim Não

Bytes da imagem convertida em Texto base 64

ImagemAssinaturaProfissional Texto Sim Não

Bytes da imagem convertida em Texto base 64

TipoCarteiraProfissional Texto Não Sim

tokenAcesso

Código de acesso informado pelo CONFEA.

4.1.2 Resultado

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

 Entidade

o Objetos que será utilizado 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.

(9)

7

4.2 Imprimir carteiras profissionais

Serviço responsável por realizar a impressão da carteira profissional.

4.2.1 Parâmetros

Parâmetros de requisição:

Nome Tipo Formato

tokenImpressao TokenImpressaoEntity tokenAcesso Guid

00000000-0000-0000-0000-000000000000

TokenImpressaoEntity

Campo Tipo Atualizável Obrigatório Observação

Token Texto Não Sim

Token que será utilizado para validar a impressão

RegistroNacional Texto Não Não

Validade Data Não Não

Imprimir Booleano Não Sim

Indica se impressão será feita pelo WebService

NomeImpressora Texto Não Não

Se a opção anterior for "True", o nome da impressora deve ser informado

Mensagens Texto Não Não

tokenAcesso

Código de acesso informado pelo CONFEA.

4.2.2 Resultado

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

o Registro que deve ser utilizado para imprimir a carteira profissional.  Erro

(10)

8 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 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