1. Integrações Consulta de Dados
Developers Valorizza
  • Valorizza
    • Autenticação
    • Integrações Financeiras
      • RetornaFaturamentos
      • RetornaDadosFaturamento
      • ValoresRecebidos
      • RecebeDocumentos
      • ValoresRecebidosGeral
      • RetornaFaturamentosAPagar
      • RetornaDadosFaturamentoAPagar
      • RecebeFaturamentoExterno
      • RetornaDadosRemessaBanco
    • Integrações do Módulo Acadêmico
      • RecebeAlunos
      • RecebeCursos
      • RecebeProfessores
      • RecebeAlunosCursos
      • RecebeDisciplinas
      • RecebeAlunoDisciplinas - deprecated
      • RecebeAlunoDisciplinaProfessor - deprecated
      • RecebeCursoDisciplinas
      • RecebeDisciplinaTurma
      • RecebeCursoProfessores
      • RecebeTurmas
      • RecebeTurmaAlunos
      • RecebeTurmaProfessores
      • RecebeUsuarios
      • RetornaDiplomaDigital
    • Integrações Consulta de Dados
      • RetornaDadosArquivos
        POST
      • RetornaDadosAuditorias
        POST
      • RetornaDadosContratos
        POST
      • RetornaDadosContratacoes
        POST
      • RetornaDadosContratosMonitoria
        POST
      • RetornaDadosConvenios
        POST
      • RetornaDadosCurriculo
        POST
      • RetornaDadosEquivalencia
        POST
      • RetornaDadosIntegracaoCursos
        POST
      • RetornaDadosIntegracaoCursoDisciplina
        POST
      • RetornaDadosIntegracaoCursoProfessor
        POST
      • RetornaDadosIntegracaoDisciplinas
        POST
      • RetornaDadosIntegracaoProfessores
        POST
      • RetornaDadosIntegracaoDisciplinaTurma
        POST
      • RetornaDadosIntegracaoAlunos
        POST
      • RetornaDadosIntegracaoAlunoCurso
        POST
      • RetornaDadosIntegracaoAlunoDisciplina
        POST
      • RetornaDadosIntegracaoAlunoDisciplinaProfessor
        POST
      • RetornaDadosIntegracaoAlunoCursoHorario
        POST
      • RetornaDadosNotasAtividades
        POST
      • RetornaDadosOcorrencias
        POST
      • RetornaDadosPendenciasContratos
        POST
      • RetornaDadosPessoas
        POST
      • RetornaDadosProjetos
        POST
      • RetornaDadosSolicitacoes
        POST
      • RetornaDadosVaga
        POST
    • Integrações de Serviços
      • CadastraPessoa
    • Integrações de Recrutamentos
      • RecebeCurriculos
      • RecebeVagas
      • EncerraVagas
    • Schemas
      • RequestBodies
        • RetornaDadosPessoasBody
        • RetornaDadosSolicitacoesBody
        • RetornaUnidadesBody
        • RetornaVagasCidadesBody
      • Integracoes_Financeiras
      • Integracoes_do_Modulo_Academico
      • Integracoes_Consulta_de_Dados
      • Integracoes_de_Servicos
      • Integracoes_de_Recrutamentos
  • Kretos
    • Autenticação
    • Gerenciamento de Colaboradores
      • Adicionar ou Atualizar Colaborador
      • Obter Prazo Médio de Contratações
    • Acessos
      • Gerar Link de Acesso
      • Registrar Saída de Colaborador
      • Obter Lista de Colaboradores
      • Obter Dados do Colaborador
    • Gerenciamento de Horários
      • Adicionar ou Atualizar Horário
      • Obter Lista de Horários
    • Gerenciamento de Vagas
      • Criar Nova Vaga
      • Obter Lista de Vagas Incluídas
    • Relatórios
      • Obter Histórico de Contratações
    • Schemas
      • RequestBodies
        • Obter_Prazo_M_dio_de_Contrata_esBody
      • Inclus_o_de_Novo_Colaborador
      • Prazo_M_dio_de_Contrata_es
      • Solicitar_Link_de_Acesso
      • Informar_Sa_da_de_Colaborador
      • Listar_Colaboradores
      • Dados_do_Colaborador
      • Manuten_o_de_Hor_rio
      • Listar_Hor_rios
      • Abertura_de_Vaga
      • Listar_Vagas_Inclu_das
      • Hist_rico_de_Contrata_es
  1. Integrações Consulta de Dados

RetornaDadosConvenios

POST
/apiconsultadadosvalorizza/RetornaDadosConvenios
Permite retornar os registros do cadastro de convênios incluídos e/ou alterados no período especificado.
Detalhamento dos campos do serviço - dados de entrada:
CampoTipoDescrição
tokenVarcharCódigo/Token fornecido pela Valorizza para a integração
dataInicioDataData inicial para retornar os elementos cadastrados no período informado
dataFimDataData final para retornar os elementos cadastrados no período informado
identificacaoNuméricoIdentificação do convênio. Retorna somente dados relativos ao convênio solicitado
quantidadeNuméricoQuantidade de elementos por página, quando não informado, não irá existir paginação
paginaNuméricoPágina a ser visualizada quando for utilizado a paginação
Detalhamento dos campos do serviço - dados de saída:
CampoTipoDescrição
totalElementosVarcharTotal de elementos encontrados
totalPaginasVarcharTotal de páginas de acordo com a quantidade informada nos dados de entrada
paginaAtualVarcharPágina que está sendo visualizada, visível quando quantidade for informada nos dados de entrada
elementos[].identificadorConvenioNuméricoIdentificador do convênio
elementos[].descricaoVarcharDescrição
elementos[].tipoConvenioVarcharTipo do convênio
Agente de integração
Instituição de ensino
Concedente
Agente concedente
Convênio de colaboração
Jurídica
elementos[].processoVarcharProcesso
Estágio obrigatório (requer disciplina)
Estágio (requer matrícula)
Monitoria (requer matrícula)
Outros (não requer matrícula)
elementos[].conveniadoVarcharConveniado
elementos[].unidadeVarcharUnidade
elementos[].situacaoVarcharSituação
Em elaboração
Em aprovação
Aprovado
Cancelado
Suspenso
elementos[].tipoFaturamentoVarcharTipo do faturamento
Não gera cobrança
Percentual valor da parcela
Percentual valor da bolsa
Valor fixo mensal
Valor fixo proporcional
elementos[].pagarBolsaVarcharConvênio paga bolsa
Sim
Não
elementos[].percentualReceberNuméricoPercentual a receber
elementos[].valorReceberVarcharValor a receber
elementos[].valorMinimoReceberVarcharValor mínimo a receber
elementos[].cobrarValorMinimoVarcharCobrar valor mínimo
Parcela com mês inteiro
Parcela com mês parcial
Ambos
elementos[].dadosBancariosVarcharDados bancários
Opcional
Obrigatório
elementos[].efetividadeObrigatoriaVarcharEfetividade obrigatória
Sim
Não
elementos[].pagaRecessoRescisaoSeparadoVarcharPaga recesso de rescisão separado
Sim
Não
elementos[].pagaRecessoDiasUteisVarcharPaga recesso por dias úteis
Sim
Não
elementos[].incluiBeneficioVarcharInclui benefício
Sim
Não
elementos[].agregaBeneficioAdministracaoEstagioVarcharAgrega benefício na administração de estágio
Sim
Não
elementos[].agregaRecessoAdministracaoEstagioVarcharAgrega recesso na administração de estágio
Sim
Não
elementos[].recebeDiasUteisVarcharRecebe por dias úteis
Sim
Não
elementos[].percentualPagarNuméricoPercentual a pagar
elementos[].valorPagarVarcharValor a pagar
elementos[].diaCalculoParcelaNuméricoDia de cálculo da parcela
elementos[].tipoMonitoriaVarcharTipo de monitoria
Não remunerado
Remunerado
elementos[].quantidadeMaximaAlunosNuméricoQuantidade máxima de alunos
elementos[].preceptorVarcharPreceptor
Do conveniado
Da instituição de ensino
elementos[].calculoFinanceiroVarcharCálculo financeiro
Dia mês
Trinta dias
elementos[].autoatendimentoVarcharAutoatendimento
Sim
Não
elementos[].inicioDataData de início
elementos[].validadeDataData de validade
elementos[].seguroVarcharSeguro
Próprio
Concedente
elementos[].seguradoraVarcharSeguradora
elementos[].apoliceSeguroVarcharApólice do seguro
elementos[].observacaoVarcharObservação do cadastro
elementos[].inclusaoDataHoraData de Inclusão
elementos[].usuarioVarcharUsuário do cadastro
elementos[].atualizacaoDataHoraData de atualização
elementos[].estimativaEstagiariosNuméricoValor da estimativa de estagiários
elementos[].cursos[].cursoVarcharNome do curso
elementos[].cursos[].cursoDisciplinaVarcharNome da disciplina do curso
elementos[].cursos[].cursoAgrupadorVarcharNome do agrupador do curso
elementos[].cursos[].cursoQuantidadeMaximaAlunosNuméricoQuantidade máxima de alunos do curso
elementos[].cursos[].cursoCepVarcharCEP
elementos[].cursos[].cursoEnderecoVarcharEndereço
elementos[].cursos[].cursoNumeroVarcharNúmero
elementos[].cursos[].cursoUfVarcharEstado
elementos[].cursos[].cursoCidadeVarcharCidade
elementos[].cursos[].inclusaoDataHoraData de Inclusão
elementos[].cursos[].usuarioVarcharUsuário do cadastro
elementos[].descontos[].descontoDeNuméricoDesconto de
elementos[].descontos[].descontoAteNuméricoDesconto até
elementos[].descontos[].descontoValorVarcharValor do desconto
elementos[].descontos[].inclusaoDataHoraData de Inclusão
elementos[].descontos[].usuarioVarcharUsuário do cadastro
elementos[].beneficios[].beneficioVarcharBenefício
elementos[].beneficios[].beneficioValorVarcharValor do benefício
elementos[].beneficios[].beneficioPercentualNuméricoPercentual do benefício
elementos[].beneficios[].beneficioTipoVarcharTipo do benefício
Diário
Mensal
elementos[].beneficios[].beneficioDiasUteisVarcharBenefício dias úteis
Sim
Não
elementos[].beneficios[].inclusaoDataHoraData de Inclusão
elementos[].beneficios[].usuarioVarcharUsuário do cadastro
elementos[].percentuais[].percentualTipoVagaVarcharTipo da vaga
elementos[].percentuais[].percentualReceberVarcharPercentual a receber
elementos[].percentuais[].beneficioPercentualVarcharValor a receber
elementos[].percentuais[].inclusaoDataHoraData de Inclusão
elementos[].percentuais[].usuarioVarcharUsuário do cadastro
elementos[].arquivos[].identificadorVarcharIdentificador do arquivo
elementos[].arquivos[].nomeArquivoVarcharNome do arquivo
elementos[].arquivos[].nomeArquivoFisicoVarcharNome do arquivo físico
elementos[].arquivos[].atualizacaoDataHoraData de atualização
elementos[].arquivos[].situacaoVarcharSituação do arquivo
Aprovado
Recusado
Em Aprovação

Request

Authorization
API Key
Add parameter in body
cliente
Example:
cliente: ********************
or
Body Params application/json

Examples

Responses

🟢200
application/json
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/apiconsultadadosvalorizza/RetornaDadosConvenios' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "Token",
    "dataInicio": "2012-01-20",
    "dataFim": "2012-06-20",
    "identificacao": "1234",
    "quantidade": 0,
    "pagina": 0
}'
Response Response Example
{
    "convenios": {
        "totalElementos": "",
        "totalPaginas": "",
        "paginaAtual": "",
        "elementos": [
            {
                "identificadorConvenio": "",
                "descricao": "",
                "tipoConvenio": "",
                "processo": "",
                "conveniado": "",
                "unidade": "",
                "situacao": "",
                "tipoFaturamento": "",
                "pagarBolsa": "",
                "percentualReceber": 0,
                "valorReceber": 0,
                "valorMinimoReceber": 0,
                "cobrarValorMinimo": "",
                "dadosBancarios": "",
                "efetividadeObrigatoria": "",
                "pagaRecessoRescisaoSeparado": "",
                "pagaRecessoDiasUteis": "",
                "incluiBeneficio": "",
                "agregaBeneficioAdministracaoEstagio": "",
                "agregaRecessoAdministracaoEstagio": "",
                "recebeDiasUteis": "",
                "percentualPagar": 0,
                "valorPagar": "",
                "diaCalculoParcela": 0,
                "tipoMonitoria": "",
                "quantidadeMaximaAlunos": 0,
                "preceptor": "",
                "calculoFinanceiro": "",
                "autoatendimento": "",
                "inicio": "",
                "validade": "",
                "seguro": "",
                "seguradora": "",
                "apoliceSeguro": "",
                "observacao": "",
                "inclusao": "",
                "usuario": "",
                "atualizacao": "",
                "estimativaEstagiarios": "",
                "cursos": [
                    {
                        "curso": "",
                        "cursoDisciplina": "",
                        "cursoAgrupador": "",
                        "cursoQuantidadeMaximaAlunos": "",
                        "cursoCep": "",
                        "cursoEndereco": "",
                        "cursoNumero": "",
                        "cursoUf": "",
                        "cursoCidade": "",
                        "inclusao": "",
                        "usuario": ""
                    }
                ],
                "descontos": [
                    {
                        "descontoDe": 0,
                        "descontoAte": 0,
                        "descontoValor": 0,
                        "inclusao": "",
                        "usuario": ""
                    }
                ],
                "beneficios": [
                    {
                        "beneficio": "",
                        "beneficioValor": 0,
                        "beneficioPercentual": 0,
                        "beneficioTipo": "",
                        "beneficioDiasUteis": "",
                        "inclusao": "",
                        "usuario": ""
                    }
                ],
                "percentuais": [
                    {
                        "percentualTipoVaga": "",
                        "percentualReceber": 0,
                        "percentualValorReceber": 0,
                        "inclusao": "",
                        "usuario": ""
                    }
                ],
                "arquivos": [
                    {
                        "identificador": "",
                        "nomeArquivo": "",
                        "nomeArquivoFisico": "",
                        "atualizacao": "",
                        "situacao": ""
                    }
                ]
            }
        ]
    },
    "MsgRetorno": ""
}
Modified at 2026-03-26 13:52:32
Previous
RetornaDadosContratosMonitoria
Next
RetornaDadosCurriculo
Built with