> ## Documentation Index
> Fetch the complete documentation index at: https://docs.edtools.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar nota individual

> Importa una sola nota por petición. Pensado para que el Monitor de Moodle (u otro integrador) itere y envíe un registro por estudiante con feedback inmediato.

**Campos obligatorios:** student_id, semester, course, final_grade

**Course** acepta con o sin espacios: STA 530 o STA530.

**Semester** debe ser 6 dígitos: 202601 (Spring A), 202602 (Spring B), ..., 202606 (Fall B).

**Errores de validación** indican qué campo falta o tiene formato incorrecto.



## OpenAPI

````yaml /openapi-mintlify.json post /method/edtools_core.api.import_grade_single
openapi: 3.0.0
info:
  title: Edtools - CUCUSA
  description: |-
    Colección completa de endpoints para EdTools SIS - CUC University.

    ## Autenticación
    Usa el header `Authorization: token API_KEY:API_SECRET`

    ## Base URL
    - Producción: https://cucuniversity.edtools.co
    - Local: http://localhost:8080
  contact: {}
  version: '1.0'
servers:
  - url: https://cucuniversity.edtools.co/api
    variables: {}
security:
  - apiKey: []
tags:
  - name: CRUD Operations
    description: Operaciones básicas de Crear, Leer, Actualizar y Eliminar estudiantes
  - name: Métodos Personalizados
    description: Endpoints /api/method/ específicos para operaciones de estudiantes
  - name: Búsquedas Avanzadas
    description: Consultas avanzadas con filtros complejos
  - name: Utilidades
    description: Endpoints de utilidad general
  - name: Student Applicant
    description: Solicitudes de admisión de candidatos
  - name: Student Admission
    description: Configuración de procesos de admisión
  - name: Academic Year
    description: Años académicos
  - name: Academic Term
    description: Períodos académicos (semestres, trimestres)
  - name: Room
    description: Aulas y salones
  - name: Student Group
    description: Grupos de estudiantes por curso, lote o actividad
  - name: Grading Scale
    description: Escalas de calificación (A, B, C, etc.) - Submittable
  - name: Assessment Criteria
    description: Criterios de evaluación (Participación, Tareas, Exámenes)
  - name: Guardian
    description: Tutores y acudientes de estudiantes
  - name: Student Category
    description: Categorías de estudiantes (Regular, Beca, etc.)
  - name: Student Batch Name
    description: Nombres de lotes/cohortes
  - name: Fee Category
    description: Categorías de cuotas (Matrícula, Biblioteca, etc.)
  - name: Operaciones
    description: Operaciones de configuración (Single DocType)
  - name: Métodos
    description: Métodos de la herramienta de asistencia
  - name: Portal del Estudiante
    description: Endpoints para el portal de estudiantes - información consolidada
  - name: Enrollment y Programas
    description: Endpoints para inscripciones y programas combinados
  - name: Grupos de Estudiantes
    description: Endpoints para gestión de grupos
  - name: Horarios y Calendario
    description: Endpoints para horarios de clases y calendario
  - name: Asistencia Combinada
    description: Endpoints de asistencia que combinan múltiples DocTypes
  - name: Evaluaciones Combinadas
    description: Endpoints de evaluación que combinan Assessment Plan, Result y Criteria
  - name: Cuotas y Facturación
    description: Endpoints que combinan Fees, Fee Structure y Facturación
  - name: LMS - Quiz Avanzado
    description: Endpoints avanzados de quizzes con evaluación automática
  - name: Admisiones
    description: Endpoints de proceso de admisión
  - name: Grade Import
    description: Importación de notas (individual y masiva desde Excel/CSV)
paths:
  /method/edtools_core.api.import_grade_single:
    post:
      tags:
        - Grade Import
      summary: Importar nota individual
      description: >-
        Importa una sola nota por petición. Pensado para que el Monitor de
        Moodle (u otro integrador) itere y envíe un registro por estudiante con
        feedback inmediato.


        **Campos obligatorios:** student_id, semester, course, final_grade


        **Course** acepta con o sin espacios: STA 530 o STA530.


        **Semester** debe ser 6 dígitos: 202601 (Spring A), 202602 (Spring B),
        ..., 202606 (Fall B).


        **Errores de validación** indican qué campo falta o tiene formato
        incorrecto.
      operationId: ImportarNotaIndividual
      parameters: []
      requestBody:
        description: Datos de la nota a importar
        content:
          application/json:
            schema:
              type: object
              required:
                - student_id
                - semester
                - course
                - final_grade
              properties:
                student_id:
                  type: string
                  description: ID del estudiante (ej. EDU-STU-2025-02806)
                semester:
                  type: string
                  description: >-
                    6 dígitos: 202601=Spring A, 202602=Spring B, ...,
                    202606=Fall B
                course:
                  type: string
                  description: >-
                    Short name del curso. Acepta STA 530 o STA530 (con o sin
                    espacios)
                final_grade:
                  type: string
                  description: Número (0-100) o letra de la escala (A, B+, etc.)
                full_name:
                  type: string
                  description: Opcional, solo visual
                course_title:
                  type: string
                  description: Opcional, solo visual
                grading_scale:
                  type: string
                  description: >-
                    Opcional. Nombre de la escala; si no, usa la de Education
                    Settings
            example:
              student_id: EDU-STU-2025-02806
              semester: '202601'
              course: STA530
              final_grade: '85'
        required: true
      responses:
        '200':
          description: >-
            Respuesta con success, message, validation_errors,
            assessment_result, created, error_detail
      deprecated: false
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header

````