> ## 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 notas masivas (Excel/CSV)

> Importación masiva de notas desde Excel/CSV.

**Flujo:** 1) Subir archivo con upload_file, 2) Llamar a este método con el file_url devuelto.

**Columnas del Excel:** ID, SEMESTER, COURSE, FINAL GRADE. SEMESTER = 6 dígitos (202601 = Spring A, …, 202606 = Fall B).



## OpenAPI

````yaml /openapi-mintlify.json post /method/edtools_core.api.upload_grades_file
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.upload_grades_file:
    post:
      tags:
        - Grade Import
      summary: Importar notas masivas (Excel/CSV)
      description: >-
        Importación masiva de notas desde Excel/CSV.


        **Flujo:** 1) Subir archivo con upload_file, 2) Llamar a este método con
        el file_url devuelto.


        **Columnas del Excel:** ID, SEMESTER, COURSE, FINAL GRADE. SEMESTER = 6
        dígitos (202601 = Spring A, …, 202606 = Fall B).
      operationId: ImportarNotasMasivas
      parameters: []
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                file_url:
                  type: string
                  description: URL devuelta por upload_file (ej. /files/notas.xlsx)
                grading_scale:
                  type: string
                  description: Opcional. Nombre de la escala de calificaciones
      responses:
        '200':
          description: Respuesta con success, validation_errors, summary, errors
      deprecated: false
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: Authorization
      in: header

````