Web Service Plataforma Arouca Documento de uso 1
Histórico de Revisões Data Seção Afetada Histórico 01/11/13 recuperarcertificadoconcluinte() recuperarhistoricoporcpf() recuperarpessoa() 1 - Exceção 2074 criada para não permitir recuperar certificado de tipo desligamento <> 3. 2 - Incluído os atributos o tipo de item 10 e 11, respectivamente C redenciamento com Operadora de Plano de Saúde e Vínculo com Consultório(Atuação) devido à importação dos dados da ANS no método recuperarhistoricoporcpf(). 3 Incluído o atributo <Fonte> no CBO do método recuperarpessoa(). 22/05/13 cadastrarconcluintes() recuperarhistoricocpf() cadastrardesligamento() cadastraringressante() recuperarpessoa() 1- Nova exceção foi adicionada para não permitir mais cadastrar concluinte em curso onde o CPF tem ao menos um registro de ingressante. (exceção 2066: cadastrarconcluinte_registro_invalido ) 2- O método cadastrarconcluite() agora está como deprecated, em substituição ao novo método cadastrardesligamento() 3- Novo método criado: recuperarhistoricocpf() 4- Incluído no método recuperarpessoa() o objeto registroconselhoclasse[]. 5- Controle de concorrência nos métodos de cadastros. 23/07/13 cadastrardesligamento() recuperarcertificadoconcluinte() recuperarpessoa() cadastaringressante() 1- Removido obrigatoriedade atributo <nomeconcluinteparacertificado > e removido o atributo <idcurso> do método cadastrardesligamento(). 2- Inclusão autorização de acesso através da DN do certificado também em curso e oferta. 3- Criado nova exceção para não retornar certificados revogados. 4- Retorno lista de Registro Conselho de Classe e CBOxxx método recuperarpessoa() 5- Remoção da data de ingresso da Chave de duplicidade do método cadastraringressante() 6- Envio automático de email de notificação de certificado para o concluinte. 7- Não permitir cadastro de desligamento em curso de <Nível> = Pós-gradução e <Modalidade> = Especialização em Residência Médica Inserido atributo <Data de Trancamento> no cadastraringressante() 2
Sumário Informações gerais sobre o serviço... 5 Contexto... 5 Objetivo... 5 Nome... 5 Endereço do arquivo WSDL... 5 Gestor do serviço... 5 Responsável técnico... 5 Requisitos e orientações para acesso... 5 Objetos de retorno... 6 WSCbo... 6 WSCurso... 6 WSOrgao... 6 WSPessoa... 7 WSLocalOferta... 7 WSOferta... 8 wsequipe... 8 wsespecialidaderesidenciamedica... 8 wsfonte... 8 WSPrograma... 8 WSExperienciaDocente... 8 wsitemhistorico... 9 wsregistroconselhoclasse... 11 wsatuacao... 11 wscredenciamento... 11 Informações detalhadas do serviço... 11 Nome do Serviço na interface... 11 Tabela de classificação das Exceções do Web Service... 12 Exceções de Certificação Digital... 13 Considerações gerais sobre parâmetros de entrada e/ou saída 19 Métodos do Web Service... 19 Verificar Pessoa... 19 Recuperar Pessoa... 20 Cadastrar Pessoa... 20 3
Recuperar Cursos... 21 Cadastrar Ingressante... 23 Cadastrar Concluinte (Deprecated)... 24 Recuperar Certificado Concluinte... 24 Recuperar Local de Oferta... 25 Recuperar Oferta... 26 Recuperar Historico por CPF... 28 Cadastar Desligamento... 33 Referências... 33 4
Informações gerais sobre o serviço Contexto Objetivo Nome O Web Service da Plataforma Arouca foi criado, inicialmente, para atender às demandas da UNA-SUS de consulta e inserção de informações relacionadas a cursos. Web Service para disponibilizar informações da Plataforma Arouca. Permitir a inclusão de dados referente a cursos, ingressantes e concluintes. AroucaWebService Endereço do arquivo WSDL Ambiente de Homologação: https://aroucad.unasus.gov.br:8443/plataformaarouca/services/aroucawebservice?wsdl Ambiente de Produção: https://arouca.unasus.gov.br:8443/plataformaarouca/services/aroucawebservice?wsdl Responsável técnico Nome: Equipe Técnica Plataforma Arouca Contato: http://sistemas.unasus.gov.br/suporte/ Telefone: 31-34095844 Requisitos e orientações para acesso Todos os métodos do Web Service da Plataforma Arouca são cobertos por certificado digital. Portanto, para ter acesso a este serviço é necessário que faça uma solicitação de assinatura de certificado conforme orientações contidas no documento Solicitação de Certificado Digital Arouca usando OpenSSL ou Solicitação de Certificado Digital Arouca usando Java. Entre em contato com nosso suporte para tirar dúvidas técnicas ou de instalação através do canal: https://sistemas.unasus.gov.br/suporte/ 5
Objetos de retorno WSCbo Classe utilizada para retornar dados do CBO (Código Brasileiro de Ocupações). Caracteriza a atividade desempenhada pela pessoa. O CBO é obtido pelo cadastro do CNES com informação de código e nome da ocupação. Ex: Código: 225120 Nome: Médico Cardiologista Atributos: Código ( String): Código do CBO Fonte (String): Nome da Fonte Nome (String): Nome do CBO Status (Integer) : Situação do CBO // 0- Ativo 1 - Inativo WSCurso Classe utilizada para retornar dados do curso. Um curso é vinculado a um órgão ofertante. Atributos: Id (Long): Id do Curso no banco de dados da Plataforma Arouca. Nome (String): Nome do Curso WSOrgao Classe utilizada para retornar dados do órgão. Atributos: Id (Long): Id do órgão Nome (String): Nome do órgão Município (String): Município do órgão WSCurso []: Array de cursos vinculados ao órgão. 6
WSExperienciaDocente Classe utilizada para retornar as experiências docentes da pessoa Atributos: WSPessoa Código (Long): Código Descrição (String): Descrição da experiência docente Classe utilizada para retornar dados da pessoa. Ela pode conter uma lista de especialidades (obtidas a partir dos programas de residência), lista de perfis (na Plataforma Arouca. ), CBOs (Código Brasileiro de Ocupações) e experiências como docente. Os perfis da Plataforma Arouca estão estruturados da seguinte forma: Profissional de Saúde: pode ver ofertas de vagas dos cursos disponíveis na Plataforma Arouca, registrar interesse em cursos/ofertas, visualizar e adicionar itens a seu histórico Gestores de órgãos ofertantes de cursos: Podem cadastrar cursos, ofertas e registrar ingressantes, concluintes e matriculados em seus cursos/ofertas Gestores de órgãos integralizadores: Podem conceder títulos baseados em objetivos de aprendizado na Plataforma Arouca. Gestores de órgãos de saúde: Podem ser gestores estaduais ou municipais de saúde, gestores de estabelecimentos de saúde (como hospitais). Podem registrar demandas de treinamento ou aperfeiçoamento de seu pessoal ou usar a plataforma para selecionar profissionais de saúde para trabalho através de seus históricos educacional e profissional. Atributos: Id (Long): Id da pessoa no banco de dados. Nome (String): Nome da pessoa wsespecialidaderesidenciamedica[] : Especialidades da pessoa Ex: Obstetrícia e Ginecologia Perfis (String[]) : Perfil da pessoa ( Atributo exibido apenas se o usuário fez ao menos uma autenticação na Plataforma Arouca ). wscbo[] : Lista das ocupações da pessoa. Ex: Enfermeiro, agente de saúde pública. wsexperienciadocente[] : Lista das experiências como docente da pessoa. Ex: Professor de Enfermagem. wsconselhoregistroclasse[]: Lista de registro do conselho de classe do profissional da saúde. WSLocalOferta Classe utilizada para retornar dados do local da oferta de um curso. Um órgão ofertante pode 7
WSOferta wsequipe oferecer cursos em pólos de educação à distância ou em outras unidades com endereço diferente de sua sede. O local da oferta é onde o curso será realizado. Atributos: Id (Long): Id do Local da Oferta no banco de dados. Nome (String): Nome do local da oferta que ofereceu o curso. WSOrgao : Informações do órgão que ofertou o curso. Ex: UFMG Logradouro (String): Logradouro do local de oferta do curso Numero(String): Número do endereço Complemento (String): Dados complementares do endereço Bairro (String): Bairro do local da oferta CEP (String): CEP do local da oferta Município (String): Município do local da oferta UF (String): UF do local da oferta Classe utilizada para retornar dados da oferta de um curso oferecido por um órgão cadastrado. Atributos: ID(Long): Id da oferta no banco de dados WSCurso: Informação do curso ofertado WSLocalOferta: Informação do local de oferta NumeroVagas(Long): Número de vagas oferecidas na oferta do curso DataInicioInscricao (String): Data de início da inscrição da oferta DataTerminoInscricao (String): Data de término da inscrição da oferta DataInicioSelecao (String): Data de início do processo de seleção DataTerminoSelecao (String): Data de término do processo de seleção DataInicioMatricula (String): Data de início da matrícula no curso DataTerminoMatricula (String): Data de termino da matrícula no curso DataInicioRealizacao (String): Data de início da realização do curso DataTerminoRealizacao (String): Data de término da realização do curso Informações sobre equipe de saúde. Atributos: id (long) - Id da equipe de saúde no banco de dados. nome (string) Nome da equipe de saúde. 8
wsespecialidaderesidenciamedica wsfonte Informações da especialidade de residência médica. Atributos: id (long)- Id cadastrado no banco de dados da especialidade de residência médica nome (string)- Nome da especialidade. Os dados do Arouca são de diversas fontes. Se o item do histórico unificado foi cadastrado pelo próprio usuário então o sistema define o padrão id =0 e Nome= USUÁRIO, se foi por uma fonte oficial de dados do Arouca, o sistema envia consecutivamente o ID e nome da fonte. Atributos: id (long) Id da fonte do dados do Arouca. nome (string) Nome da fonte. wsprograma Programas de governo que financiam cursos. Atributos: id (long) - Id do programa cadastrado no banco de dados. nome (string) - Nome do programa. wsitemhistorico Item do histórico unificado do profissional de saúde. Atributos: cpf (string): CPF do profissional de saúde. nome (string): Nome do Profissional de saúde. tipoitem (int): 1 = Conclusão de curso ou Curso em andamento, 2 = Conclusão de módulo educacional ou Módulo em andamento, 3 = Participação em outras Atividades Educacionais, 4 = Publicações de trabalhos, 5 = Certificado/Título concedido por orgão integralizador, 6 = Residência medica, 7 = Vínculo com estabelecimento de saúde, 8 = Experiência docente, 9 = 9
Vínculo com equipes de saúde. orgao (WSOrgao): Informações do órgão referente. codibgemuncipio (string): Código IBGE do município referente. uf (string): UF referente fonte (wsfonte): Origem da fonte de dados do item do histórico. datafim (string): Texto no formato dd/mm/yyyy datainicio (string): Texto no formato dd/mm/yyyy Curso (wscurso): Informações do curso. nível (string): Nível do curso referente. modalidade (string): Modalidade do curso referente. situacaocurso (string): C = Concluído ou A = Em Andamento modulo (string): Um módulo educacional ou módulo de ensino. E uma unidade de ensino e de avaliação somativa. situacaomodulo (string): C = Concluído ou A = Em Andamento programa (wsprograma): Programa de governo. temas (string): Id e nomes dos temas separados por ;. Ex (<id>-saúde da Família; <id>- Medicina preventiva e social; etc) numeropublicacoes (string): Número de publicações de trabalhos na área de saúde. urllattes (string): url Lates tipoatividadeeducacional (string): P-Palestras e Eventos, G-Grupos de Estudo, A-Apoio Educacional, V-Visitas de Supervisão, T-Apoio por telessaúde, H-Treinamento de habilidades, O- Outra tipoexperienciadocente (string): 1- Professor, 2- Orientador, 3- Tutor a distância, 4- Tutor presencial, 5- Preceptor, 6- Monitor, 7- Outro, 8 - Formadores, 9- Teleconsultores, 10- Matriciadores, 11- Apoiadores especialidaderesidenciamedica (wsespecialidaderesidenciamedica): situacaoresidencia (string): C = Concluído ou A = Em Andamento nomecertificado (string): Nome do certificado emitido por órgão integralizador. datacertificado ( string): Data certificado emitido por órgão integralizador. cbo ( wscbo): As ocupações obtidas a partir dos vínculos profissionais cadastrados. Vínculos ativos e inativos. cargahoraria (int): Carga horária referente informado. naturezaorgaocontratante (string): 0=Não definido - 1=Administração Direta da Saúde - 2=Administração Direta de Outros Órgãos - 3=Administração Indireta (Autarquias) - 4=Administração Indireta (Fundação) - 5=Administração Indireta (Empresa Pública) - 6=Administração Indireta (Organização Social) - 7=Empresa - 8=Fundação Privada - 9=Cooperativa - 10=Serviço Social Autônomo- 11=Entidade Beneficente sem fins lucrativos - 12=Economia Mista - 13=Sindicato existeplanocarreira (string): S-Sim, N-Não, I-Não sei progressaoporantiguidade (string): S-Sim, N-Não, I-Não sei progressaopordesempenho (string): S-Sim, N-Não, I-Não sei progressaoporformacao (string): S-Sim, N-Não, I-Não sei incentivopordesempenho (string): - S-Sim, N-Não, I-Não sei mecanismoingresso ( string): S-Sim, N-Não, I-Não sei equipe (wsequipe): Informações de equipe de saúde atuação (wsatuacao): Vínculo com consultório (ANS) credenciamento (wscredenciamento): Credenciamento com Operadora de Plano de Saúde 10
wsregistroconselhoclasse wsatuacao Registro do conselho de classe do profissional da saúde. Atributos: numeroregistro (string): Número registro siglaconselhoprofissional (string): Sigla do conselho profissional UF (string): UF do conselho Vínculo com Consultório. Atributos: id (long) - Id da Atuação cadastrado no banco de dados. nome (string) - Nome da Atuação wscredenciamento Credenciamento com Operadora de Planos de Saúde Atributos: id (long) - Id do credenciamento cadastrado no banco de dados. nome (string) - Nome do credenciamento. Informações detalhadas do serviço Nome do Serviço na interface AroucaWebService Tabela de classificação das Exceções do Web Service Código Descrição da Exceção 1050 EXC_CADASTRAR_INGRESSANTE_PESSOA_NAO_ENCONTRADA: O Cliente do serviço aciona o método cadastroingressante() do webservice e informa um CPF de uma pessoa não cadastrada no banco de dados: Mensagem retorno: Pessoa não encontrada. 1060 EXC_CADASTRARCONCLUINTE_PESSOA_NAO_ENCONTRADA: O Cliente do serviço aciona o método cadastroconcluinte() ou cadastrodesligamento() do webservice e informa um CPF de uma 11
pessoa não cadastrada no banco de dados: Mensagem retorno: Pessoa não encontrada. 1070 EXC_RECUPERARCERTIFICADOCONCLUITE_CONCLUINTE_NAO_ENCONTRADO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do webservice e informa um CPF de uma pessoa não cadastrado como concluinte no banco de dados: Mensagem retorno: Concluinte não cadastrado. 1071 EXC_RECUPERARCERTIFICADOCONCLUITE_MODELO_CERTIFICADO_NAO_ENCON TRADO: Cliente do serviço aciona método recuperarcertificadoconcluinte() do webservice e tenta obter o certificado de uma pessoa, no entanto, o curso não tem um modelo de certificado vinculado. Mensagem retorno: Não há modelo de certificado associado ao curso informado. 1072 EXC_RECUPERARCERTIFICADOCONCLUINTE_PESSOA_NAO_ENCONTRADO: O Cliente do serviço aciona o método recuperarcertificadopessoa() do webservice e informa um CPF de uma pessoa não cadastrada no banco de dados: Mensagem retorno: Pessoa não encontrada. 1073 EXC_RECUPERARCERTIFICADOCONCLUITE_MODELO_CERTIFICADO_NAO_ENCON TRADO_OFERTA: Cliente do serviço aciona método recuperarcertificadoconcluinte() do webservice e tenta obter o certificado de uma pessoa, no entanto, o curso não tem um modelo de certificado vinculado. Mensagem retorno: Não há modelo de certificado associado na oferta informado. 2010 EXC_VERIFICAR_PESSOA_CPF_INVALIDO: O Cliente do serviço aciona o método verificarpessoa() do webservice e informa um CPF inválido. Mensagem retorno: O CPF informado é inválido. 2020 EXC_RECUPERARPESSOA_CPF_INVALIDO: O Cliente do serviço aciona o método recuperarpessoa() do webservice e informa um CPF inválido. Mensagem retorno: O CPF informado é inválido. 2030 EXC_RECUPERARCURSO_UF_INVALIDO: O Cliente do serviço aciona o método recuperarcurso() do webservice e informa uma UF inválida. Mensagem retorno: O Estado informado é inválido. 2040 EXC_ CADASTRARPESSOA_ATRIBUTOS_INVALIDOS: O Cliente do serviço aciona o método cadastrarpessoa() do webservice e informa algum atributo fora do padrão. Mensagem retorno: Atributos fora do padrão: [CPF], [data de nascimento],[email],[sexo] 12
2041 EXC_ CADASTRARPESSOA_MUNICIPIO_INVALIDO: O Cliente do serviço aciona o método cadastrarpessoa() do webservice e informa código do município do IBGE não válido. EX: 4546546 Mensagem retorno: Município informado inválido. 2050 EXC_CADASTRARINGRESSANTE_ATRIBUTOS_INVALIDOS: O Cliente do serviço aciona o método cadastraringressante() do webservice e informa algum atributo fora do padrão para o cadastro. Mensagem retorno: Atributos fora do padrão: [CPF], [DataIngresso] [DataTrancamento] 2051 EXC_ CADASTRARINGRESSANTE _OFERTA_INVALIDO: O Cliente do serviço aciona o método cadastraringressante() do webservice e informa um ID de oferta inválido, ou seja, não cadastrado no banco de dados. Mensagem retorno: Id de oferta inválido. 2052 EXC_ CADASTRARINGRESSANTE_OFERTA_EXIGE_ASSINATURA: O Cliente do serviço aciona o método cadastraringressante() do webservice e informa um ID de oferta que exige assinatura digital. Mensagem retorno: Este cadastro não pode ser realizado, pois a oferta selecionada exige assinatura digital 2053 EXC_ CADASTRARINGRESSANTE_CURSO_ESPECIALIZACAO_RESIDENCIA: O Cliente do serviço aciona o método cadastraringressante() do webservice e informa um ID de oferta onde o curso é especialização de residência médica. Mensagem retorno: Não é permitido cadastrar ingressante em curso de especialização em residência médica. 2060 EXC_ CADASTRARCONCLUINTE _ATRIBUTOS_INVALIDOS: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do webservice e informa algum atributo fora do padrão para o cadastro. Mensagem retorno: Atributos fora do padrão: [CPF], [DataConclusao] 2061 EXC_ CADASTRARCONCLUINTE_CURSO_ INVALIDO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do webservice e informa um ID do Curso inválido, ou seja, não cadastrado no banco de dados. Mensagem retorno: Id do curso inválido 2064 CADASTRARCONCLUINTE_OFERTA_EXIGE_ASSINATURA: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do webservice e informa um ID de oferta que exige assinatura digital. Mensagem retorno: Este cadastro não pode ser realizado, pois a oferta selecionada exige assinatura digital. 2065 CADASTRARCONCLUINTE_CURSO_ESPECIALIZACAO_RESIDENCIA: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do webservice e informa um ID de curso que é de especialização de residência médica. Mensagem retorno: Não é permitido desligamento em curso de especialização em residência 13
médica. 2066 CADASTRARCONCLUINTE_REGISTRO_INVALIDO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do webservice e informa um ID de curso e CPF que já tem registro de ingressante. Mensagem retorno: Este desligamento não pode ser cadastrado com Referência = Curso, pois existem registros de ingressante para este profissional para ofertas do curso indicado. Para cadastrar este desligamento, mude a referência para Oferta e escolha uma oferta específica do curso em questão.. 2070 EXC_RECUPERARCERTIFICADOCONCLUITE_ATRIBUTOS_INVALIDOS: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do webservice e informa algum atributo fora do padrão para a pesquisa. Mensagem retorno: Atributos fora do padrão: [CPF], [DataConclusao]. 2071 EXC_ RECUPERARCERTIFICADOCONCLUITE_CURSO_OFERTA_INVÁLIDO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do webservice e informa um ID de curso ou ID de oferta inválido para a pesquisa, ou seja, um ID não cadastrado no banco de dados. Mensagem retorno: Id curso/oferta inválido. 2072 EXC_ RECUPERARCERTIFICADOCONCLUITE_REVOGADO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do webservice e pesquisa por um desligamento revogado no banco de dados. Mensagem retorno: O certificado de conclusão foi revogado no dia <data_revogacao>. 2074 EXC_ RECUPERARCERTIFICADOCONCLUITE_TIPONAOCONCLUINTE: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do webservice e pesquisa por um desligamento com tipo de desligamento <> 3. Mensagem retorno: Tipo de desligamento diferente de 3 (Conclusão de curso). 20840 EXC_ RECUPERARLOCALOFERTA_LOCAL_OFERTA_INVALIDO: O Cliente do serviço aciona o método recuperarlocaloferta() do webservice e informa um ID de oferta inválido para a pesquisa, ou seja, um ID de Oferta não cadastrado no banco de dados. Mensagem retorno: Id do Local de oferta inválido 2081 EXC_ RECUPERARLOCALOFERTA_MUNICIPIO_INVALIDO: O Cliente do serviço aciona o método recuperarlocaloferta() do webservice e informa código do município do IBGE não válido para a pesquisa. Mensagem retorno: Município informado inválido. 2082 EXC_ RECUPERARLOCALOFERTA_UF_INVALIDO: O Cliente do serviço aciona o método recuperarlocaloferta() do webservice e informa uma UF inexistente. Mensagem retorno: O Estado informado é inválido. 14
2083 EXC_ RECUPERARLOCALOFERTA_ORGAO_INVALIDO: O Cliente do serviço aciona o método recuperarlocaloferta() do webservice e informa código do órgão não válido para a pesquisa. Mensagem retorno: Id órgão inválido. 2090 EXC_ RECUPERAROFERTA_CURSO_INVALIDO: O Cliente do serviço aciona o método recuperaroferta() do webservice e informa um ID de curso inválido para a pesquisa, ou seja, um ID de curso não cadastrado no banco de dados. Mensagem retorno: Id do curso inválido 2091 EXC_RECUPERAROFERTA_OFERTA_INVALIDO: O Cliente do serviço aciona o método recuperaroferta() do webservice e informa um ID de oferta inválido para a pesquisa, ou seja, um ID de oferta não cadastrado no banco de dados. Mensagem retorno: Id da oferta inválido. 2092 EXC_RECUPERAROFERTA_LOCAL_OFERTA_INVALIDO: O Cliente do serviço aciona o método recuperaroferta() do webservice e informa um id local oferta inválido para a pesquisa, ou seja, um id local oferta não cadastrado no banco de dados. Mensagem retorno: Id do local de oferta inválido 20100 EXC_RECUPERARHISTORICOPORCPF_CPF_INVALIDO: O Cliente do serviço aciona o método recuperarhistoricoporcpf() do webservice e informa um CPF inválido. Mensagem retorno: O CPF informado é inválido. 20101 EXC_RECUPERARHISTORICOPORCPF_ATRIBUTOS_INVALIDO: O Cliente do serviço aciona o método recuperarhistoricoporcpf() do webservice e informa um CPF inválido. Mensagem retorno: Atributos fora do padrão: dataultimopedido 3010 EXC_VERIFICAR_PESSOA_DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método verificarpessoa() do webservice sem informar o CPF para a consulta. Mensagem retorno: Atributos obrigatórios não informados: cpf. 3020 EXC_RECUPERAR_PESSOA_DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método recuperarpessoa() do WebService sem informar o CPF para a consulta. Mensagem retorno: Atributos obrigatórios não informados: cpf. 3040 EXC_ CADASTRARPESSOA_DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método cadastrarpessoa() do WebService não informando os atributos obrigatórios. Mensagem retorno: Atributos obrigatórios não informados: [CPF], [Nome], [Nome da mãe], [Email],[Código do Município] 3050 EXC_ CADASTRARINGRESSANTE _DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método cadastraringressante() do WebService não informando os atributos obrigatórios. Mensagem retorno: Atributos obrigatórios não informados: CPF, idoferta, dataingresso. 15
3060 EXC_CADASTRARCONCLUINTE_CAMPO_OBRIGATORIO_NAO_INFORMADO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastardesligamento() do WebService não informando os atributos obrigatórios. Mensagem retorno: Atributos obrigatórios não informados: CPF, idoferta, DataConclusão 3070 EXC_ RECUPERARCERTIFICADOCONCLUITE_DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do WebService não informando os atributos obrigatórios. Mensagem retorno: Atributos obrigatórios não informados: cpf, id do Curso, Data de Conclusão 30100 EXC_RECUPERARHISTORICOPORCPF_DADOS_OBRIGATORIOS: O Cliente do serviço aciona o método recuperarhistoricoporcpf () do WebService não informando os atributos obrigatórios. Mensagem retorno: Atributos obrigatórios não informados: CPF.. 4040 EXC_CADASTRARPESSOA_PESSOA_DUPLICADA: O Cliente do serviço aciona o método cadastrarpessoa() do WebService e tenta cadastrar uma pessoa com CPF já cadastrado no banco de dados. Mensagem retorno: Pessoa já cadastrada 4050 EXC_CADASTRARINGRESSANTE_INGRESSO_DUPLICADO: O Cliente do serviço aciona o método cadastraringressante() do WebService e tenta cadastrar um ingressante já cadastrado no banco de dados. Um ingressante é considerado duplicado quando há um registro com o mesmo CPF e IdOferta. Mensagem retorno: Ingressante já cadastrado 4060 EXC_CADASTRARCONCLUINTE_DUPLICADO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do WebService e tenta cadastrar um desligamento já cadastrado no banco de dados. Um concluinte é considerado duplicado quando há um registro com o mesmo CPF, DataConcluinte, IdOferta e TipoDesligamento. Mensagem retorno: Concluinte já cadastrado 5080 EXC_RECUPERARLOCALOFERTA_ARGUMENTO_NAO_INFORMADO: O Cliente do serviço aciona o método recuperarlocaloferta() do WebService e tenta recuperar um local de oferta sem informar nenhum argumento. Mensagem retorno: Argumentos não informado 5090 EXC_ RECUPERAROFERTA_ARGUMENTO_NAO_INFORMADO: O Cliente do serviço aciona o método recuperaroferta() do WebService e tenta recuperar uma oferta sem informar nenhum argumento. Mensagem retorno: Argumentos não informado 16
Exceções de Certificação Digital Atualmente há três exceções que estão relacionadas ao certificado digital: Certificado não encontrado: Ocorre quando não há um certificado instalado no servidor de aplicação da Plataforma Arouca. Certificado Inválido: Ocorre quando o certificado instalado no servidor de aplicação da Plataforma Arouca está expirado ou inválido. Acesso não Autorizado: Ocorre quando se tenta recuperar ou cadastrar dados de um órgão via Web Service. Para dar autorização de acesso ao método, é necessário que o administrador da Plataforma Arouca cadastre manualmente as informações da DN (Distinct Name) do certificado digital no sistema. A DN de Autorizados poderá estar associada a um órgão, curso, ou oferta. O cliente que possuir a DN no cadastro de um órgão terá permissão sobre todos os cursos e ofertas do órgão. Em um curso terá permissão sobre o curso e todas as suas ofertas. E em uma oferta terá permissão apenas sobre a oferta. Código Descrição 9031 RECUPERARCURSOS_ERRO_CERTIFICADO: O Cliente do serviço aciona o método recuperarcursos() do WebService, no entanto, ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 9041 CADASTRARPESSOA_ERRO_CERTIFICADO: O Cliente do serviço aciona o método cadastrarpessoa() do WebService, no entanto, ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 9040 CADASTRARPESSOA_USUARIO_NAO_AUTORIZADO: O Cliente do serviço aciona o método cadastrarpessoa() do WebService e tenta cadastrar uma pessoa em um órgão, curso ou oferta a qual não tenha permissão de acesso. Mensagem retorno: Acesso não autorizado 9050 CADASTRARINGRESSANTE_USUARIO_NAO_AUTORIZADO: O Cliente do serviço aciona o método cadastraringressante() do WebService e tenta cadastrar um ingressante em um órgão a qual não tenha permissão de acesso. Mensagem retorno: Acesso não autorizado 9051 CADASTRARINGRESSANTE_ERRO_CERTIFICADO: O Cliente do serviço aciona o método cadastraringressante() do WebService, no entanto, ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 17
9060 CADASTRARCONCLUINTE_USUARIO_NAO_AUTORIZADO O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do WebService e tenta cadastrar um concluinte em um órgão a qual não tenha permissão de acesso. Mensagem retorno: Acesso não autorizado 9061 CADASTRARCONCLUINTE_ERRO_CERTIFICADO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do WebService ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 9071 RECUPERARCERTIFICADOCONCLUINTE_ERRO_CERTIFICADO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do WebService ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 9070 RECUPERARCERTIFICADOCONCLUINTE_USUARIO_NAO_AUTORIZADO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do WebService e tenta recuperar certificado de um usuário vinculado a um órgão a qual ele não tenha permissão de acesso. Mensagem retorno: Acesso não autorizado 9080 RECUPERARLOCALOFERTA_USUARIO_NAO_AUTORIZADO: O Cliente do serviço aciona o método recuperarlocaloferta() do WebService pelo IdOrgão ou pelo IDLocalOferta e tenta recuperar dados de um local de oferta de curso a qual não tem permissão de acesso. Mensagem retorno: Acesso não autorizado 9081 RECUPERARLOCALOFERTA_ERRO_CERTIFICADO: O Cliente do serviço aciona o método recuperarlocaloferta() do WebService ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 9090 RECUPERAROFERTA_USUARIO_NAO_AUTORIZADO: O Cliente do serviço aciona o método recuperarloferta() do WebService e tenta recuperar dados de uma oferta de curso a qual não tem permissão de acesso. Mensagem retorno: Acesso não autorizado 9091 RECUPERAROFERTA_ERRO_CERTIFICADO: O Cliente do serviço aciona o método recuperarlocaloferta() do WebService ocorre algum problema relacionado ao certificado digital do cliente do serviço. Mensagem retorno: Erro Certificado. 99011 VERIFICARPESSOA_ERRO_INESPERADO: O Cliente do serviço aciona o método verificarpessoa() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99021 RECUPERARPESSOA_ERRO_INESPERADO: O Cliente do serviço aciona o método 18
recuperarpessoa() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99031 RECUPERARCURSOS_ERRO_INESPERADO: O Cliente do serviço aciona o método recuperarcursos() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99041 CADASTRARPESSOA_ERRO_INESPERADO: O Cliente do serviço aciona o método cadastrarpessoa() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99051 CADASTRARINGRESSANTE_ERRO_INESPERADO: O Cliente do serviço aciona o método cadastraringressante() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99061 CADASTRARCONCLUINTE_ERRO_INESPERADO: O Cliente do serviço aciona o método cadastrarconcluinte() ou cadastrardesligamento() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99071 RECUPERARCERTIFICADOCONCLUINTE_ERRO_INESPERADO: O Cliente do serviço aciona o método recuperarcertificadoconcluinte() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99081 RECUPERARLOCALOFERTA_ERRO_INESPERADO: O Cliente do serviço aciona o método recuperarlocaloferta() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99091 RECUPERAROFERTA_ERRO_INESPERADO: O Cliente do serviço aciona o método recuperaroferta() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. 99101 RECUPERARHISTORICOUNIFICADO_ERRO_INESPERADO: O Cliente do serviço aciona o método recuperarhistoricoporcpf() do WebService e ocorre algum erro inesperado. Mensagem retorno: Erro inesperado. Contate o suporte técnico. Considerações gerais sobre parâmetros de entrada e/ou saída Os retornos dos métodos de recuperar dados do Web Service estão em formato de array[] de uma classe ou um único item de uma classe. Caso uma pesquisa não encontre informação, o sistema retorna o array ou o item como vazio. 19
Métodos do Web Service 1 Verificar Pessoa Verifica se uma pessoa está cadastrada na Plataforma Arouca através de um CPF. Método: boolean verificarpessoa( String CPF ) Parâmetro de entrada: CPF String CPF da pessoa (campo obrigatório) ex: 52553472137 Parâmetro de saída: Return Boolean Se não existir, Web Service retorna false (Não cadastrado) Se existir, Web Service retorna true (Cadastrado) 2 - Recuperar Pessoa Recupera uma pessoa cadastrada na Plataforma Arouca com sua lista de especialidades, perfis, CBOs e registro conselho de classe, caso possua. Os CBOs exibidos estão relacionados a todos os estabelecimentos de saúde onde o profissional obteve alguma experiência profissional. Inclusive estabelecimentos de saúde onde já trabalhou. Um CBO é considerado como ativo quando não há uma data de Término definido no histórico unificado da pessoa. Método: WSPessoa recuperarpessoa( String cpf) Parâmetro de entrada: CPF String CPF da pessoa (campo obrigatório) ex: 52553472137 Parâmetro de saída: 20
WSPessoa Objeto Retorna tipo WSPessoa (Ver objetos de retorno) < WSPessoa> // Objeto de retorno WSPessoa <Long Id>1</ Long Id > // ID da Pessoa <String Nome> Maria de Paula</ String Nome > // Nome Pessoa < wsespecialidaderesidenciamedica[]> <string>medicina Geral </string> // Nome Especialidade <string>pediatria </string> </ wsespecialidaderesidenciamedica[] > < String[] Perfis> <string> Profissional de Saúde</string> //Perfis da Pessoa </ String[] Perfis > < WSCBO[]> <String codigo>25</string codigo> <fonte>cfm</fonte> <String Nome> Médico Pediatra</String Nome> //CBO <String status> 0</String status > //0 Ativo 1 - Inativo </ WSCBOS[]> < wsexperienciadocente []> <String codigo>25</string codigo> <String Descrição> Orientador curso tal </String Descrição> </ wsexperienciadocente []> < wsregistroconselhoclasse []> <numeroregistro>608714</numeroregistro> <siglaconselhoprofissional>crm</siglaconselhoprofissional> <uf>rj</uf> </ wsregistroconselhoclasse []> 3 - Recuperar Cursos </ WSPessoa > Recupera os cursos vinculados aos órgãos cadastrados. Se o cliente do serviço não informar os parâmetros de entrada, o Web Service retorna todos os 21
cursos dos órgãos aos quais o cliente tem permissão para acesso. Se não houver nenhum curso cadastrado para os órgãos autorizados, o sistema retorna o array do órgão com array de cursos vazio. Se as informações do certificado digital do cliente não estiverem associadas a um determinado órgão pesquisado por ele, o Web Service também retorna array de cursos vazios. Este procedimento serve como requisito de segurança, já que não expõe informações indevidas a quem não tem acesso. Método: WSOrgao[] recuperarcursos( String nomeorgao, String sigla, String uf) Parâmetro(s) de Entrada: nomeorgao String Nome do órgão (campo opcional) Sigla String Sigla do órgão (campo opcional) UF String UF do órgão (campo opcional) Ex: MG Uma pesquisa feita somente com este parâmetro, retorna uma lista vazia caso não haja órgão com autorização para acesso vinculado. Também ocorre caso a UF não tenha um órgão cadastrado. Parâmetro de Saída: WSOrgão Objeto[ ] Retorna tipo WSOrgão (Ver objetos de retorno) <Array WSOrgao> // Lista de órgãos <Array WSCursos> //Lista de cursos <long_id>1</int_id> //ID do curso <string_nome> Médico urologista</string_nome> //Nome curso </Array WSCursos> <long_id>1</long_id> //Id do órgão <string_municipio> Cuiaba-MT</string_municipio> //Município <string_nome> Univ. Fed. Cuiabá</string_nome> //Nome do Órgão </Array_WSOrgão> 22
4 - Cadastrar Pessoa Cadastra uma pessoa na Plataforma Arouca. Método: void cadastrarpessoa( String cpf, String nome,string nomepai, String nomemae, String sexo, String datanasc, String email, String municipio) Parâmetro(s) de Entrada: CPF String CPF da pessoa (campo obrigatório) ex: 52553472137 Nome String Nome da pessoa (campo obrigatório) nomepai String Nome do pai da pessoa (campo opcional) nomemae String Nome da mãe da pessoa (campo obrigatório) Sexo String Sexo da Pessoa ( F, M ) - (campo opcional) F Feminino M Masculino datanascimento String Data de nascimento da pessoa (campo opcional) Informada no padrão: dd/mm/yyyy Email String E-mail da pessoa. Sistema pode usá-lo para notificação de certificados - (campo obrigatório) ex: xxxxxxx@xxx.xx codmunicipio String Código IBGE do Município (campo obrigatório) ex: 3106200 5 - Cadastrar Ingressante Cadastra uma pessoa como ingressante de um curso. Método: void cadastraringressante( String cpf, Long idoferta, String dataingresso, String datatrancamento ) 23
Parâmetro(s) de Entrada: CPF String CPF da pessoa (campo obrigatório). ex: 52553472137 idoferta Long ID da Oferta (campo obrigatório). dataingresso String Data ingresso na oferta (campo obrigatório). Formato dd/mm/aaaa datatrancamento String Data trancamento no curso (campo obrigatório). Formato dd/mm/aaaa 6 - Cadastrar Concluinte (Deprecated) Este método realiza uma chamada ao método Cadastrar Desligamento passando o tipo de desligamento igual a "Conclusão dos requisitos acadêmicos ou titulação". Após inserir um registro o sistema envia email automático para o usuário notificando que o certificado dele já pode ser emitido na Plataforma Arouca. Isto quando o curso ou oferta estiver associado a um modelo de certificado e o mesmo for configurado, na respectiva tela de cadastro da Plataforma Arouca, para notificar ao usuário. Método: void cadastrarconcluinte(string cpf, Long idoferta, String dataconclusao, String nomeconcluinteparacertificado) Parâmetros de Entrada: CPF String CPF da pessoa (campo obrigatório). ex: 52553472137 idoferta Long ID da Oferta (campo obrigatório ). dataconclusao String Data de conclusão no curso (campo obrigatório). Formato dd/mm/aaaa nomeconcluinte ParaCertificado String Nome do Concluinte Para Certificado Esse é o nome que irá aparecer no certificado impresso. Se esse nome não for informado, o sistema usará o nome contido no cadastro de pessoa. 24
7 - Recuperar Certificado Concluinte Recupera URL para download do certificado no formato PDF de um concluinte de um curso. Método: String recuperarcertificadoconcluinte ( String cpf, Long idcurso, Long idoferta, String dataconclusao ) Parâmetros de Entrada: cpf String CPF da pessoa (campo obrigatório). ex: 52553472137 idcurso Long ID do curso (campo obrigatório). idoferta Long ID do Oferta (campo obrigatório). dataconclusao String Data da conclusão no curso (campo obrigatório). Formato dd/mm/aaaa Parâmetro de Saída: return String URL para download do certificado do curso de uma pessoa. Ex: http://<servidor>/plataformaarouca/certificado/recuperacertificado? hash=wjdktura-dslvbaaa 8 - Recuperar Local de Oferta Recupera lista de locais de oferta de um órgão. A exceção acesso não autorizado é disparada somente através dos argumentos idlocaloferta e idorgao. Se o cliente for recuperar local de oferta informando apenas os argumentos: Nome,UF ou Município, caso ele não tenha permissão de acesso, o retorno é uma array vazio. Este procedimento serve como requisito de segurança, já que não expõe informações indevidas a quem não tem acesso. 25
Método: WSLocalOferta[] recuperarlocaloferta ( Long idlocaloferta, Long idorgao, String nome,string municipio, String uf ) Parâmetro(s) de Entrada: idlocaloferta Long Id do local da Oferta (campo opcional). idorgão Long ID do órgão (campo opcional). nome String Nome do local da oferta (campo opcional) codmunicipio String Código IBGE do Município (campo opcional) ex: 305124 Uma pesquisa feita somente com este parâmetro, retorna uma lista vazia caso não haja órgão com autorização de acesso vinculado ao município. Também ocorre caso o município não tenha órgão cadastrado. UF String UF do local da oferta (campo opcional) ex: MG Parâmetro(s) de Saída: Uma pesquisa feita somente com este parâmetro, retorna uma lista vazia caso não haja órgão com autorização para acesso vinculado. Também ocorre caso a UF não tenha um órgão cadastrado. WSLocalOferta Objeto[ ] Retorna tipo WSLocalOferta (Ver objetos de retorno) <Array WSLocalOferta> <string_bairro>jardinopolis</string_bairro> <string_cep>35201230</string_cep> <long_id>1</long_id> <string_logradouro> Rua 7</string_logradouro> <string_municipio>belo Horizonte</string_municipio> <string_nome> Faculdade de Medicina</string_nome> <string_numero>150</string_numero> < WSOrgao> <long_id>1</long_id> <string_nome> Apec - Potiguar </string_nome> </ WSOrgao> <string_complemento> Bl02</string_complemento> <string_uf>mg</string_uf> 26
</Array_ WSLocalOferta > 9 - Recuperar Oferta Recupera ofertas de cursos cadastrados por um órgão na Plataforma Arouca. Método: WSOferta[] recuperaroferta ( Long idoferta, Long idcurso, Long idlocaloferta) Parâmetro(s) de Entrada: idoferta Long Id da Oferta (campo opcional) idlocaloferta Long Id do Local da Oferta (campo opcional). idcurso Long ID do curso (campo opcional). Parâmetro de Saída: WSOferta Objeto[ ] Retorna tipo WSOferta (Ver objetos de retorno) <Array WSOferta> <WSCurso> <long_id>2031</long_id> <string_nome>curso Online</string_nome> </WSCurso> <string_datainicioincricao>05/10/2011</string_datainicioincricao> <string_datainicioselecao>05/10/2011</string_datainicioselecao> <string_datainiciomatricula>05/10/2011</string_datainiciomatricula> <string_datainiciorealizacao>05/10/2011</string_datainiciorealizacao> <string_dataterminoinscricao>05/10/2011</string_taterminoinscricao> <string_dataterminoselecao>05/10/2011</string_dataterminoselecao> <string_dataterminomatricula>05/10/2011</string_taterminomatricula> <string_dataterminorealizacao>05/10/2011</string_terminorealizacao> <long_id>2009</long_id> <WSLocalOferta> <long_id>2004</long_id> 27
9 - Recuperar Histórico por CPF <string_nome>local do Curso Online</string_nome> </WSLocalOferta> <long_numerovagas>50</long_numerovagas> </Array WSOferta > Recupera histórico unificado cadastrados por um órgão na Plataforma Arouca. Método: WSOferta[]recuperarHistoricoPorCpf ( String CPF, String dataultimopedido) Parâmetro(s) de Entrada: CPF String CPF do profissional de saude (campo obrigatório) dataultimopedido String Data da ultima atualização (campo opcional). Parâmetro de Saída: wsitemhistorico Objeto[ ] Retorna tipo wsitemhistorico (Ver objetos de retorno) Tipo Item Histórico = 1 <ItemHistoricoList> <codibgemuncipio>xxxxx</codibgemuncipio> <cpf>xxxxxxxx</cpf> <curso> <id>xxx</id> <nome>curso tal</nome> </curso> <datafim>dd/mm/aaaa</datafim> <datainicio> dd/mm/aaaa </datainicio> <fonte> <id>881</id> <nome>fonte tal</nome> </fonte> <modalidade>xxxx</modalidade> 28
<nivel>x</nivel> <nome>pessoa tal</nome> <orgao> <id>xxxx</id> <nome>orgao tal</nome> </orgao> <situacaocurso>x</situacaocurso> <tipoitem>1</tipoitem> <uf>xx</uf> </ItemHistoricoList> Tipo Item Histórico = 2 <ItemHistoricoList> <codibgemuncipio>xxxxx</codibgemuncipio> <cpf>xxxxxxxxxx</cpf> <curso> <id>xxx</id> <nome>curso tal</nome> </curso> <fonte> <id>xxx</id> <nome>fonte tal</nome> </fonte> <modalidade>xxx</modalidade> <nivel>x</nivel> <nome>pessoa tal </nome> <orgao> <id>xxxx</id> <nome>orgao tal</nome> </orgao> <situacaocurso>c</situacaocurso> <temas>2 Alimentação e Nutrição;3 Atenção Primária / Saúde da Família;</temas> <tipoitem>1</tipoitem> <uf>xx</uf> </ItemHistoricoList> Tipo Item Histórico = 3 <ItemHistoricoList> <cargahoraria>xx</cargahoraria> <codibgemuncipio>xxxxx</codibgemuncipio> <cpf>xxxxxxxx</cpf> <datafim> dd/mm/aaaa </datafim> <datainicio> dd/mm/aaaa </datainicio> <fonte> <id>0</id> <nome>usuario</nome> 29
</fonte> <nome>pessoa tal</nome> <orgao> <id>xxx</id> <nome>orgao tal </nome> </orgao> <temas>1 Acidentes e Violência;2 Alimentação e Nutrição;3 </temas> <tipoatividadeeducacional>x</tipoatividadeeducacional> <tipoitem>3</tipoitem> <uf>xx</uf> </ItemHistoricoList> Tipo Item Histórico = 4 <ItemHistoricoList> <cpf>xxxxxxxxxx</cpf> <datafim> dd/mm/aaaa </datafim> <datainicio> dd/mm/aaaa </datainicio> <fonte> <id>0</id> <nome>usuario</nome> </fonte> <nome>pessoa tal</nome> <numeropublicacoes>xx</numeropublicacoes> <temas>1 Acidentes e Violência</temas> <tipoitem>4</tipoitem> <urllattes>urllattes.com.br</urllattes> </ItemHistoricoList> Tipo Item Histórico = 5 <ItemHistoricoList> <codibgemuncipio>xxxx</codibgemuncipio> <cpf>xxxxxxxxxxx</cpf> <datacertificado> dd/mm/aaaa </datacertificado> <fonte> <id>0</id> <nome>usuario</nome> </fonte> <nome>pessoa tal</nome> <nomecertificado>minha Integralização</nomeCertificado> <orgao> <id>505021</id> <nome>órgao tal</nome> </orgao> 30
<tipoitem>5</tipoitem> <uf>xx</uf> </ItemHistoricoList> Tipo Item Histórico = 6 <ItemHistoricoList> <codibgemuncipio>xxxxx</codibgemuncipio> <cpf>xxxxxxxx</cpf> <datafim> dd/mm/aaaa </datafim> <datainicio> dd/mm/aaaa </datainicio> <especialidaderesidenciamedica> <id>xx</id> <nome>cirurgia tal</nome> </especialidaderesidenciamedica> <fonte> <id>x</id> <nome>fonte tal </nome> </fonte> <nome>pessoa tal </nome> <orgao> <id>xxx</id> <nome>orgao tal </nome> </orgao> <programa> <id>xx</id> <nome>programa tal</nome> </programa> <situacaoresidencia>x</situacaoresidencia> <tipoitem>6</tipoitem> <uf>xx</uf> </ItemHistoricoList> Tipo Item Histórico = 7 <ItemHistoricoList> <cargahoraria>44</cargahoraria> <cbo> <codigo>322205</codigo> <nome>técnico de enfermagem</nome> </cbo> <codibgemuncipio>420430</codibgemuncipio> <cpf>03286206962</cpf> <datafim> dd/mm/aaaa </datafim> <datainicio> dd/mm/aaaa </datainicio> <fonte> <id>1</id> <nome>cadastro Nacional de Estabelecimentos de Saúde</nome> 31
</fonte> <naturezaorgaocontratante>11</naturezaorgaocontratante> <nome>julcelei Chiapetti Vargas</nome> <orgao> <id>137549</id> <nome>beneficencia CAMILIANA DO SUL - HOSPITAL SAO FRANCISCO (CNES: 2303892)</nome> </orgao> <tipoitem>7</tipoitem> <uf>sc</uf> </ItemHistoricoList> item = 8 <ItemHistoricoList> <codibgemuncipio>420540</codibgemuncipio> <cpf>37065386287</cpf> <fonte> <id>7</id> <nome>universidade Federal de Santa Catarina</nome> </fonte> <naturezaorgaocontratante>10</naturezaorgaocontratante> <nome>hassan Tajeddini</nome> <orgao> <id>5</id> <nome>universidade Federal de Santa Catarina</nome> </orgao> <tipoexperienciadocente>1</tipoexperienciadocente> <tipoitem>8</tipoitem> <uf>sc</uf> </ItemHistoricoList> item= 9 <ItemHistoricoList> <cbo> <codigo>223116</codigo> <nome>médico de família e comunidade</nome> </cbo> <codibgemuncipio>250490</codibgemuncipio> <cpf>79807887453</cpf> <datafim> dd/mm/aaaa </datafim> <datainicio> dd/mm/aaaa </datainicio> <equipe> <id>23091</id> <nome>massangana III</nome> </equipe> 32
<fonte> <id>1</id> <nome>cadastro Nacional de Estabelecimentos de Saúde</nome> </fonte> <naturezaorgaocontratante>01</naturezaorgaocontratante> <nome>michelyne de Carvalho Correia Moreira</nome> <orgao> <id>87005</id> <nome>prefeitura MUNICIPAL DE CRUZ DO ESPIRITO SANTO - UNIDADE DE SAUDE DA FAMILIA DE MASSANGANA III (CNES: 2592614)</nome> </orgao> <tipoitem>9</tipoitem> <uf>pb</uf> </ItemHistoricoList> Item = 10 <ItemHistoricoList> <cpf>xxxxxxxxxxx</cpf> <credenciamento> <id>xx</id> <nome>citopatologia</nome> </credenciamento> <datainicio>23/06/2005</datainicio> <fonte> <id>2484</id> <nome>agência Nacional de Saúde</nome> </fonte> <nome>xxxxxxxxxxxxxxx </nome> <orgao> <id>xxxxx</id> <nome>equipe ESF: PSF02 CS SANTO ANTONIO</nome> </orgao> <tipoitem>10</tipoitem> </ItemHistoricoList> Item = 11 <ItemHistoricoList> <atuacao> <id>xx</id> <nome>ginecologia e Obstetricia</nome> </atuacao> <cpf>xxxxxxxxxxxx</cpf> <datainicio>23/06/2005</datainicio> 33
<fonte> <id>xxxx</id> < nome>agência Nacional de Saúde</nome> </fonte> <nome>therezinha de Jesus Motta Figueira</nome> <orgao> <id>xxxxx</id> <nome>xxxxxxxxxxxx</nome> </orgao> <tipoitem>11</tipoitem> </ItemHistoricoList> 10 - Cadastrar Desligamento Cadastra o desligamento de uma pessoa do curso ou oferta do curso. Após inserir um registro o sistema envia email automático para o usuário notificando que o certificado dele já pode ser emitido na Plataforma Arouca. Isto acontece quando o curso ou oferta estiver associado a um modelo de certificado, o tipo for "Conclusão dos requisitos acadêmicos ou titulação" e o mesmo for configurado, na respectiva tela de cadastro da Plataforma Arouca, para notificar ao usuário. Método: void cadastrardesligamento(string cpf, Long idoferta, String dataconclusao, String nomeconcluinte, String tipodesligamento) Parâmetros de Entrada: CPF String CPF da pessoa (campo obrigatório). ex: 52553472137 idoferta Long Id Oferta (campo obrigatório ) dataconclusao String Data de conclusão no curso (campo obrigatório). Formato dd/mm/aaaa nomeconcluintepar acertificado String tipodesligamento String Valores aceitos. Nome do Concluinte para certificado Esse é o nome que irá aparecer no certificado impresso. Se esse nome não for informado, o sistema usará o nome contido no cadastro de pessoa. 1. Abandono do curso 34
2. Cancelamento geral do curso 3. Conclusão dos requisitos acadêmicos ou titulação 4. Falecimento do discente 5. Mudança de nível com titulação (pós-graduação) 6. Mudança de nível sem titulação (pós-graduação) 7. Processo administrativo Referências http://cxf.apache.org/ 35