Páginas filhas
  • Documentação API - Loja Click - Moodle

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Este documento tem por objetivo a documentar a API chamada “Moodle - Exportação de Matrículas de Alunos da Loja” que irá disparar automaticamente o processo do Moodle de Exportação de Matrículas e Docentes/Professores para o aluno que teve a matrícula e contrato efetivados com sucesso.

Orientações gerais, autenticação e exemplos de consumo das API's


Expandir
titleExportar para Moodle Matrículas de Alunos da Loja Click
HTML
<div class="post">POST</div>
<div class="endereco">/api/cst/v1/intmoodle/aluno/exportarMatricAluno</div>

Ao executar a chamada da API, serão realizadas as seguintes operações:

  • Inserir usuários no Moodle, caso não exista;
  • Inscrever usuário no Curso;
  • Inserir Grupo do usuário (Turma e Matriz Curricular - SESI);
  • Inserir Plano de Aprendizagem do Aluno;
  • Devolve para Loja/Ace o status do processamento (Response).
Informações
titleInformações Relevantes
  • A nova API irá registrar os dados no mesmo Monitor de log de exportação do Moodle, da mesma forma como acontece com o processo original de exportação do Moodle.
  • A API de importação de matrículas já existente foi atualizada para devolver um identificador único ao ACE, facilitando a chamada da nova API.
  • Não será possível reenviar esse registro com erro através do Monitor de log, já que dessa forma a Loja não será avisada da integração com sucesso.
Aviso

Será responsabilidade do ACE acionar a nova API para disparar o processo de exportação do Moodle, que enviará os dados do aluno e da matrícula efetuada para o Moodle.

Autenticação


Card
idBasic
labelBasic

Authorization - Basic Auth

Username <username>

Password <password>


Bloco de código
languagec#
titleRaw
{
    "codColigada": 3,
    "idUnico": 1
}


Content

  • codColigada: Código da Coligada no SGE (Campo Obrigatório);
  • idUnico: Identificador da Matrícula realizada no SGE pela Loja Click;

Retorno

Bloco de código
languagec#
titleConsole
{
    "Status": "Sucesso",
    "Mensagem": "Usuário do aluno Exportado com Sucesso! Matrícula do Aluno Exportada com Sucesso! Grupo Turma Exportado com Sucesso! Plano de Ensino Exportado para o Moodle com Sucesso!",
    "DadosCriados": {
        "CodColigada": 3,
        "Ra": "00878180",
		"IdPerlet": 3800,
		"IdHabilitacaoFilial": 71177,
		"IdSalaMoodle":[
			24054,
			23537,
			23538,
			23539,
			23540,
			23541,
			23542
		],
        "IdUsuarioMoodle": 110687
    },
    "DetalheErros": {
        "IdErro": null,
        "ExceptionType": null,
        "InnerException": null
    }
} 

Content

  • Status: Situação do processamento da requisição; Valores possíveis: "Sucesso" = Quando todas as etapas foram inseridas com sucesso; "Erro" = Quando ocorre um erro na integração com o SGE até a etapa de Criação de Matricula do Aluno; "Alerta" = Quando ocorre um erro na etapa de Efetivação do Contrato no ERP;
  • Mensagem: Mensagem de retorno do consumo da requisição;
  • Dados Criados
    • CodColigada: Código da Coligada utilizado no registro
    • Ra: Ra criado ou atualizado para o aluno enviado.
    • IdPerlet: Id do Período Letivo da matricula do aluno no SGE
    • IdSalaMoodle: Lista das salas em que o aluno está matriculado no Moodle.
    • IdUsuarioMoodle: Identificador do usuário do aluno no Moodle.
  • DetalheErros:
    • IdErro: Identificador da região da API que ocorreu o erro. Valores possíveis: 1 = Responsável Financeiro; 2 = Aluno; 3 = Matricula; 4 = Pré Contrato CRM; 5 = Efetivação Contrato ERP
    • ExceptionType: Tipo da exceção lançada pela API.
    • InnerException: Conteúdo extra da exceção lançada pela API.


HTML
<style>
	.expand-control {
    	cursor: pointer;
    	text-decoration: none;
	    margin-bottom: 10px;
	    background-color: #ededed;
	    height: 30px;
	    font-size: 20px;
	    padding: 5px;
	}
	.expand-control-text {
    	vertical-align: top;
	    font-weight: bold;
		color: #242424;
	}
	.post {
    	background-color: #378000;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.get {
    	background-color: #004fd6;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.put {
    	background-color: #ffa200;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.delete {
    	background-color: #cf0000;
	    color: #ffffff;
	    display: inline-block;
	    padding: 5px;
	    border-radius: 5px;
		font-weight: bold;
	}
	.endereco{
		display: inline-block;
		padding: 5px;
		font-weight: bold;
	}
</style>
<!-- 
EXEMPLO DE MARCAÇÃO PARA TIPO DE REQUEST:
<div class="post">POST</div>
<div class="get">GET</div>
<div class="put">PUT</div>
<div class="delete">DELETE</div>

O ENDEREÇO DEVE SER INSERIDO COM A SEGUINTE MARCAÇÃO:
<div class="endereco">/rm/api/TOTVSCustomizacao/CstIntegracaoProtheus/ItemContabil</div>
-->