Obtener Certificados Emitidos

Importante: este Webservice será liberado próximamente. Cualquier duda consulte con soporte@educativa.com


obtener_certificados_emitidos ( 1{  id_usuario as Integer,  id_grupo as Integer,  }n )


El método permite obtener el último certificado emitido para los alumnos en las diversas aulas.

Devuelve: 1{id_usuario + id_grupo + url_certificado}n


Funcionamiento

  • Lo que se devolverá, específicamente, son urls que permitirán la descarga de cada certificado.
  • Se deben especificar ambos parámetros obligatorio para obtener el certificado para un alumno en un aula dada.
  • Se puede consultar por múltiples bloques alumno-aula en una misma llamada.


Ejemplo de Respuesta

Ejemplo de respuesta de la llamada obtener_certificados_emitidos, que indica obtener el certificado de un alumno para tres aulas, y el certificado de otro alumno para un aula específica.


  • Llamada:


     <aula:obtener_certificados_emitidos>
        <aula:usuario_grupo>
           <aula:id_usuario>manu</aula:id_usuario>
           <aula:id_grupo>32</aula:id_grupo>
        </aula:usuario_grupo>
        <aula:usuario_grupo>
           <aula:id_usuario>manu</aula:id_usuario>
           <aula:id_grupo>33</aula:id_grupo>
        </aula:usuario_grupo>
        <aula:usuario_grupo>
           <aula:id_usuario>manu</aula:id_usuario>
           <aula:id_grupo>34</aula:id_grupo>
        </aula:usuario_grupo>
        <aula:usuario_grupo>
           <aula:id_usuario>john</aula:id_usuario>
           <aula:id_grupo>8</aula:id_grupo>
        </aula:usuario_grupo>
     </aula:obtener_certificados_emitidos>


En esta llamada, podemos observar que:

+ se solicitan los certificados para el 'id_usuario' = "manu" en las aulas con 'id_grupo' = "32", 'id_grupo' = "33" y 'id_grupo' = "34".

+ se solicita el certificado del 'id_usuario' = "john" en el aula con 'id_grupo' = "8".


  • Respuesta:


 <obtener_certificados_emitidos_response xmlns="urn:Educativa/Aula/">
        <usuario_grupo_certificado>
           <id_usuario>manu</id_usuario>
           <id_grupo>32</id_grupo>
           <url_certificado>https://campus.com/aula/validacion_certificado.cgi=id37h4ia8nzi3gU9inetd&wAccion=download</url_certificado>
        </usuario_grupo_certificado>
        <usuario_grupo_certificado>
           <id_usuario>manu</id_usuario>
           <id_grupo>33</id_grupo>
           <url_certificado>https://campus.com/aula/validacion_certificado.cgi=id37h4ia8nzi3gU9asde1&wAccion=download</url_certificado>
        </usuario_grupo_certificado>
        <usuario_grupo_certificado>
           <id_usuario>manu</id_usuario>
           <id_grupo>34</id_grupo>
           <url_certificado>https://campus.com/aula/validacion_certificado.cgi=id31d3fa8nzi3gU9inetd&wAccion=download</url_certificado>
        </usuario_grupo_certificado>
        <usuario_grupo_certificado>
           <id_usuario>john</id_usuario>
           <id_grupo>8</id_grupo>
           <url_certificado>https://campus.com/aula/validacion_certificado.cgi=iasdasdasd8nzi3gU9inetd&wAccion=download</url_certificado>
        </usuario_grupo_certificado>
     </obtener_certificados_emitidos_response>


Errores de validación


  • Educativa::Aula::Error::UsuarioInexistente: ocurre cuando el usuario no se encuentra registrado en la plataforma.
  • Educativa::Aula::Error::IdGrupoInvalido: El 'id_grupo' ingresado no es integer.
  • Educativa::Aula::Error::GrupoInexistente: ocurre cuando el id_grupo del aula ingresado no existe en la base de datos.
  • Educativa::Aula::Error::UsuarioInexistenteEnGrupo: ocurre cuando se intenta solicitar el certificado de un usuario en un aula en el que no existe.