Merge pull request 'feature/rbac y perfiles implementados' (#26) from feature/rbac-users into main

Reviewed-on: #26

src/App.jsx

@@ -15,6 +15,8 @@ import Expedientes from './pages/Expedientes';
 import Organization from './pages/Organization';
 import Users from './pages/Users';
 import UserForm from './pages/UserForm';
+import Profiles from './pages/Profiles';
+import ProfileForm from './pages/ProfileForm';
 import Reports from './pages/Reports';
 import Settings from './pages/Settings';
 import Importers from './pages/Importers';
@@ -87,6 +89,21 @@ function AppContent() {
             <UserForm />
           </RequireAuth>
         } />
+        <Route path="/profiles" element={
+          <RequireAuth>
+            <Profiles />
+          </RequireAuth>
+        } />
+        <Route path="/profiles/new" element={
+          <RequireAuth>
+            <ProfileForm />
+          </RequireAuth>
+        } />
+        <Route path="/profiles/:id/edit" element={
+          <RequireAuth>
+            <ProfileForm />
+          </RequireAuth>
+        } />
         <Route path="/reports" element={
           <RequireAuth>
             <Reports />

src/api/apiError.js

@@ -0,0 +1,19 @@
+/**
+ * Extrae el mensaje de error de una respuesta HTTP fallida.
+ * Lee el JSON del body y devuelve `detail`, `message` o `error` del backend.
+ * Si no hay JSON, devuelve el texto o un fallback genérico con el status.
+ */
+export async function extractApiError(response) {
+  const status = response.status;
+  try {
+    const contentType = response.headers.get('content-type') || '';
+    if (contentType.includes('application/json')) {
+      const body = await response.json();
+      return body.detail || body.message || body.error || `Error ${status}`;
+    }
+    const text = await response.text();
+    return text || `Error ${status}`;
+  } catch {
+    return `Error ${status}`;
+  }
+}

src/api/coves.js

@@ -1,95 +1,56 @@
 import { fetchWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
 const API_BASE_URL = import.meta.env.VITE_EFC_API_URL;
 
 export const fetchPedimentoCoves = async (pedimentoId, page = 1, pageSize = 10, filters = {}) => {
-  try {
+  const params = new URLSearchParams({
-    const params = new URLSearchParams({
+    pedimento: pedimentoId,
-      pedimento: pedimentoId,
+    page: page.toString(),
-      page: page.toString(),
+    page_size: pageSize.toString(),
-      page_size: pageSize.toString(),
+  });
-    });
 
-    // Agregar filtros si existen
+  if (filters.numero_cove) params.append('numero_cove__icontains', filters.numero_cove);
-    if (filters.numero_cove) {
+  if (filters.cove_descargado !== undefined && filters.cove_descargado !== '') params.append('cove_descargado', filters.cove_descargado);
-      params.append('numero_cove__icontains', filters.numero_cove);
+  if (filters.acuse_cove_descargado !== undefined && filters.acuse_cove_descargado !== '') params.append('acuse_cove_descargado', filters.acuse_cove_descargado);
-    }
+  if (filters.date_from) params.append('created_at__gte', filters.date_from);
-    if (filters.cove_descargado !== undefined && filters.cove_descargado !== '') {
+  if (filters.date_to) params.append('created_at__lte', filters.date_to);
-      params.append('cove_descargado', filters.cove_descargado);
-    }
-    if (filters.acuse_cove_descargado !== undefined && filters.acuse_cove_descargado !== '') {
-      params.append('acuse_cove_descargado', filters.acuse_cove_descargado);
-    }
-    if (filters.date_from) {
-      params.append('created_at__gte', filters.date_from);
-    }
-    if (filters.date_to) {
-      params.append('created_at__lte', filters.date_to);
-    }
 
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/?${params}`);
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/?${params}`);
-    
+  if (!response.ok) throw new Error(await extractApiError(response));
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const data = await response.json();
+  const data = await response.json();
-    return {
+  return { results: data.results, count: data.count, next: data.next, previous: data.previous };
-      results: data.results,
-      count: data.count,
-      next: data.next,
-      previous: data.previous
-    };
-  } catch (error) {
-    console.error('Error fetching COVEs:', error);
-    throw error;
-  }
 };
 
 export const downloadCove = async (coveId) => {
-  try {
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/${coveId}/download/`);
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/${coveId}/download/`);
+  if (!response.ok) throw new Error(await extractApiError(response));
-    
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const blob = await response.blob();
+  const blob = await response.blob();
-    const url = window.URL.createObjectURL(blob);
+  const url = window.URL.createObjectURL(blob);
-    const a = document.createElement('a');
+  const a = document.createElement('a');
-    a.style.display = 'none';
+  a.style.display = 'none';
-    a.href = url;
+  a.href = url;
-    a.download = `COVE_${coveId}.pdf`;
+  a.download = `COVE_${coveId}.pdf`;
-    document.body.appendChild(a);
+  document.body.appendChild(a);
-    a.click();
+  a.click();
-    window.URL.revokeObjectURL(url);
+  window.URL.revokeObjectURL(url);
-    document.body.removeChild(a);
+  document.body.removeChild(a);
-  } catch (error) {
-    console.error('Error downloading COVE:', error);
-    throw error;
-  }
 };
 
 export const downloadAcuseCove = async (coveId) => {
-  try {
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/${coveId}/download-acuse/`);
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/coves/${coveId}/download-acuse/`);
+  if (!response.ok) throw new Error(await extractApiError(response));
-    
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const blob = await response.blob();
+  const blob = await response.blob();
-    const url = window.URL.createObjectURL(blob);
+  const url = window.URL.createObjectURL(blob);
-    const a = document.createElement('a');
+  const a = document.createElement('a');
-    a.style.display = 'none';
+  a.style.display = 'none';
-    a.href = url;
+  a.href = url;
-    a.download = `ACUSE_COVE_${coveId}.pdf`;
+  a.download = `ACUSE_COVE_${coveId}.pdf`;
-    document.body.appendChild(a);
+  document.body.appendChild(a);
-    a.click();
+  a.click();
-    window.URL.revokeObjectURL(url);
+  window.URL.revokeObjectURL(url);
-    document.body.removeChild(a);
+  document.body.removeChild(a);
-  } catch (error) {
+};
-    console.error('Error downloading COVE acuse:', error);
-    throw error;
-  }
-};

src/api/datastage.js

@@ -1,44 +1,42 @@
-// Consultar el estado de un task por task_id
+import { getWithAuth, postWithAuth, patchWithAuth, deleteWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
+
+const API_BASE = `${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/`;
+
 export async function fetchTaskStatus(task_id) {
   const url = `${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/task-status/?task_id=${encodeURIComponent(task_id)}`;
   const res = await getWithAuth(url);
-  if (!res.ok) throw new Error('Error al consultar el estado del task');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }
 
-import.meta.env;
-import { getWithAuth, postWithAuth, patchWithAuth, deleteWithAuth } from '../fetchWithAuth';
-const API_BASE = `${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/`;
-
 export async function fetchDatastages(page = 1, page_size = 10) {
   const url = `${API_BASE}?page=${page}&page_size=${page_size}`;
   const res = await getWithAuth(url);
-  if (!res.ok) throw new Error('Error al obtener datastages');
+  if (!res.ok) throw new Error(await extractApiError(res));
-  const data = await res.json();
+  return res.json();
-  // Si la respuesta es paginada, devolver el objeto completo
-  return data;
 }
 
 export async function fetchDatastageDetail(id) {
   const res = await getWithAuth(`${API_BASE}${id}/`);
-  if (!res.ok) throw new Error('Error al obtener detalle');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }
 
 export async function createDatastage(data) {
   const res = await postWithAuth(API_BASE, data);
-  if (!res.ok) throw new Error('Error al crear datastage');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }
 
 export async function updateDatastage(id, data) {
   const res = await patchWithAuth(`${API_BASE}${id}/`, data);
-  if (!res.ok) throw new Error('Error al actualizar datastage');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }
 
 export async function deleteDatastage(id) {
   const res = await deleteWithAuth(`${API_BASE}${id}/`);
-  if (!res.ok) throw new Error('Error al eliminar datastage');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return true;
 }

src/api/documentos.ts

@@ -1,5 +1,6 @@
 // src/api/pedimentoDocuments.ts
 import { fetchWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
 export interface PedimentoDocument {
   id: string;
@@ -47,6 +48,6 @@ export async function fetchPedimentoDocuments(
     `${API_URL}/record/documents/?${params.toString()}`
   );
   
-  if (!res.ok) throw new Error('No autorizado o error en la petición');
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }

src/api/documents.js

@@ -1,74 +1,43 @@
-
-/**
- * @typedef {Object} Document
- * @property {string} id
- * @property {string} organizacion
- * @property {string} pedimento
- * @property {string} archivo
- * @property {number} document_type
- * @property {number} size
- * @property {string} extension
- * @property {string} created_at
- * @property {string} updated_at
- */
-
-/**
- * @typedef {Object} DocumentsResponse
- * @property {number} count
- * @property {string|null} next
- * @property {string|null} previous
- * @property {Document[]} results
- */
-
 import { refreshToken } from './auth';
+import { extractApiError } from './apiError';
 
 const API_URL = import.meta.env.VITE_EFC_API_URL;
-/**
+
- * Obtiene la lista de documentos (pedimentos)
- * @param {string} token
- * @returns {Promise<DocumentsResponse>}
- */
 export async function fetchDocuments(token, queryString = '') {
   let url = `${API_URL}/customs/pedimentos/`;
-  if (queryString) {
+  if (queryString) url += `?${queryString}`;
-    url += `?${queryString}`;
+
-  }
   let res = await fetch(url, {
     headers: {
       'Authorization': `Bearer ${token}`,
       'Content-Type': 'application/json',
     },
   });
+
   if (res.status === 401) {
-    // Intentar refrescar el token
     const refresh = localStorage.getItem('refresh');
     if (refresh) {
       try {
         const data = await refreshToken(refresh);
         localStorage.setItem('access', data.access);
-        // Reintenta la petición con el nuevo access token
         res = await fetch(`${API_URL}/customs/pedimentos/`, {
           headers: {
             'Authorization': `Bearer ${data.access}`,
             'Content-Type': 'application/json',
           },
         });
-      } catch (err) {
+      } catch {
         throw new Error('SESSION_EXPIRED');
       }
     } else {
       throw new Error('SESSION_EXPIRED');
     }
   }
-  if (!res.ok) throw new Error('No autorizado o error en la petición');
+
-  return res.json(); // Tipado por JSDoc: Promise<DocumentsResponse>
+  if (!res.ok) throw new Error(await extractApiError(res));
+  return res.json();
 }
-/**
+
- * Obtiene los documentos por id de pedimento
- * @param {string} token
- * @param {string} id
- * @returns {Promise<DocumentsResponse>}
- */
 export async function fetchDocumentById(token, id) {
   let res = await fetch(`${API_URL}/record/documents/?page=1&page_size=10&pedimento=${id}/`, {
     headers: {
@@ -76,27 +45,27 @@ export async function fetchDocumentById(token, id) {
       'Content-Type': 'application/json',
     },
   });
+
   if (res.status === 401) {
-    // Intentar refrescar el token
     const refresh = localStorage.getItem('refresh');
     if (refresh) {
       try {
         const data = await refreshToken(refresh);
         localStorage.setItem('access', data.access);
-        // Reintenta la petición con el nuevo access token
         res = await fetch(`${API_URL}/record/documents/?page=1&page_size=10&pedimento=${id}/`, {
           headers: {
             'Authorization': `Bearer ${data.access}`,
             'Content-Type': 'application/json',
           },
         });
-      } catch (err) {
+      } catch {
         throw new Error('SESSION_EXPIRED');
       }
     } else {
       throw new Error('SESSION_EXPIRED');
     }
   }
-  if (!res.ok) throw new Error('No autorizado o error en la petición');
+
-  return res.json(); // Tipado por JSDoc: Promise<DocumentsResponse>
+  if (!res.ok) throw new Error(await extractApiError(res));
+  return res.json();
 }

src/api/edocuments.js

@@ -1,101 +1,58 @@
 import { fetchWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
 const API_BASE_URL = import.meta.env.VITE_EFC_API_URL;
 
 export const fetchPedimentoEdocuments = async (pedimentoId, page = 1, pageSize = 10, filters = {}) => {
-  try {
+  const params = new URLSearchParams({
-    const params = new URLSearchParams({
+    pedimento: pedimentoId,
-      pedimento: pedimentoId,
+    page: page.toString(),
-      page: page.toString(),
+    page_size: pageSize.toString(),
-      page_size: pageSize.toString(),
+  });
-    });
 
-    // Agregar filtros si existen
+  if (filters.numero_edocument) params.append('numero_edocument__icontains', filters.numero_edocument);
-    if (filters.numero_edocument) {
+  if (filters.clave) params.append('clave__icontains', filters.clave);
-      params.append('numero_edocument__icontains', filters.numero_edocument);
+  if (filters.descripcion) params.append('descripcion__icontains', filters.descripcion);
-    }
+  if (filters.edocument_descargado !== undefined && filters.edocument_descargado !== '') params.append('edocument_descargado', filters.edocument_descargado);
-    if (filters.clave) {
+  if (filters.acuse_descargado !== undefined && filters.acuse_descargado !== '') params.append('acuse_descargado', filters.acuse_descargado);
-      params.append('clave__icontains', filters.clave);
+  if (filters.date_from) params.append('created_at__gte', filters.date_from);
-    }
+  if (filters.date_to) params.append('created_at__lte', filters.date_to);
-    if (filters.descripcion) {
-      params.append('descripcion__icontains', filters.descripcion);
-    }
-    if (filters.edocument_descargado !== undefined && filters.edocument_descargado !== '') {
-      params.append('edocument_descargado', filters.edocument_descargado);
-    }
-    if (filters.acuse_descargado !== undefined && filters.acuse_descargado !== '') {
-      params.append('acuse_descargado', filters.acuse_descargado);
-    }
-    if (filters.date_from) {
-      params.append('created_at__gte', filters.date_from);
-    }
-    if (filters.date_to) {
-      params.append('created_at__lte', filters.date_to);
-    }
 
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/?${params}`);
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/?${params}`);
-    
+  if (!response.ok) throw new Error(await extractApiError(response));
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const data = await response.json();
+  const data = await response.json();
-    return {
+  return { results: data.results, count: data.count, next: data.next, previous: data.previous };
-      results: data.results,
-      count: data.count,
-      next: data.next,
-      previous: data.previous
-    };
-  } catch (error) {
-    console.error('Error fetching EDocs:', error);
-    throw error;
-  }
 };
 
 export const downloadEdocument = async (edocId) => {
-  try {
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/${edocId}/download/`);
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/${edocId}/download/`);
+  if (!response.ok) throw new Error(await extractApiError(response));
-    
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const blob = await response.blob();
+  const blob = await response.blob();
-    const url = window.URL.createObjectURL(blob);
+  const url = window.URL.createObjectURL(blob);
-    const a = document.createElement('a');
+  const a = document.createElement('a');
-    a.style.display = 'none';
+  a.style.display = 'none';
-    a.href = url;
+  a.href = url;
-    a.download = `EDOC_${edocId}.pdf`;
+  a.download = `EDOC_${edocId}.pdf`;
-    document.body.appendChild(a);
+  document.body.appendChild(a);
-    a.click();
+  a.click();
-    window.URL.revokeObjectURL(url);
+  window.URL.revokeObjectURL(url);
-    document.body.removeChild(a);
+  document.body.removeChild(a);
-  } catch (error) {
-    console.error('Error downloading EDocs:', error);
-    throw error;
-  }
 };
 
 export const downloadAcuseEdocument = async (edocId) => {
-  try {
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/${edocId}/download-acuse/`);
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/edocuments/${edocId}/download-acuse/`);
+  if (!response.ok) throw new Error(await extractApiError(response));
-    
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const blob = await response.blob();
+  const blob = await response.blob();
-    const url = window.URL.createObjectURL(blob);
+  const url = window.URL.createObjectURL(blob);
-    const a = document.createElement('a');
+  const a = document.createElement('a');
-    a.style.display = 'none';
+  a.style.display = 'none';
-    a.href = url;
+  a.href = url;
-    a.download = `ACUSE_EDOC_${edocId}.pdf`;
+  a.download = `ACUSE_EDOC_${edocId}.pdf`;
-    document.body.appendChild(a);
+  document.body.appendChild(a);
-    a.click();
+  a.click();
-    window.URL.revokeObjectURL(url);
+  window.URL.revokeObjectURL(url);
-    document.body.removeChild(a);
+  document.body.removeChild(a);
-  } catch (error) {
+};
-    console.error('Error downloading EDocs acuse:', error);
-    throw error;
-  }
-};

src/api/expedientes.ts

@@ -33,9 +33,9 @@ export interface PedimentosFilters {
   aduana?: string;
   regimen?: string;
   clave_pedimento?: string;
-  fecha_inicio?: string;
-  fecha_fin?: string;
   fecha_pago?: string;
+  fecha_pago_desde?: string;
+  fecha_pago_hasta?: string;
   alerta?: string | boolean;
   agente_aduanal?: string;
   curp_apoderado?: string;
@@ -53,6 +53,7 @@ export interface PedimentosFilters {
   contribuyente?: string;
   numero_edocs?: number;
   numero_coves?: number;
+  ordering?: string;
 }
 
 export async function fetchDocuments(

src/api/organizacion.js

@@ -1,4 +1,5 @@
 import { refreshToken } from './auth';
+import { extractApiError } from './apiError';
 
 const API_URL = import.meta.env.VITE_EFC_API_URL;
 
@@ -9,14 +10,13 @@ export async function fetchOrganizationUsage(token) {
       'Content-Type': 'application/json',
     },
   });
+
   if (res.status === 401) {
-    // Intentar refrescar el token
     const refresh = localStorage.getItem('refresh');
     if (refresh) {
       try {
         const data = await refreshToken(refresh);
         localStorage.setItem('access', data.access);
-        // Reintenta la petición con el nuevo access token
         res = await fetch(`${API_URL}/organization/uso-almacenamiento/mi_organizacion/`, {
           headers: {
             'Authorization': `Bearer ${data.access}`,
@@ -24,13 +24,14 @@ export async function fetchOrganizationUsage(token) {
           },
         });
         if (res.status === 401) throw new Error('SESSION_EXPIRED');
-      } catch (err) {
+      } catch {
         throw new Error('SESSION_EXPIRED');
       }
     } else {
       throw new Error('SESSION_EXPIRED');
     }
   }
-  if (!res.ok) throw new Error('No autorizado o error en la petición');
+
+  if (!res.ok) throw new Error(await extractApiError(res));
   return res.json();
 }

src/api/procesos.js

@@ -1,66 +1,32 @@
 import { fetchWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
 const API_BASE_URL = import.meta.env.VITE_EFC_API_URL;
 
 export const fetchPedimentoProcesos = async (pedimentoId, page = 1, pageSize = 10, filters = {}) => {
-  try {
+  const params = new URLSearchParams({
-    const params = new URLSearchParams({
+    pedimento: pedimentoId,
-      pedimento: pedimentoId,
+    page: page.toString(),
-      page: page.toString(),
+    page_size: pageSize.toString(),
-      page_size: pageSize.toString(),
+  });
-    });
 
-    // Agregar filtros si existen
+  if (filters.estado !== undefined && filters.estado !== '') params.append('estado', filters.estado);
-    if (filters.estado !== undefined && filters.estado !== '') {
+  if (filters.servicio !== undefined && filters.servicio !== '') params.append('servicio', filters.servicio);
-      params.append('estado', filters.estado);
+  if (filters.organizacion_name) params.append('organizacion_name__icontains', filters.organizacion_name);
-    }
+  if (filters.date_from) params.append('created_at__gte', filters.date_from);
-    if (filters.servicio !== undefined && filters.servicio !== '') {
+  if (filters.date_to) params.append('created_at__lte', filters.date_to);
-      params.append('servicio', filters.servicio);
+  if (filters.updated_from) params.append('updated_at__gte', filters.updated_from);
-    }
+  if (filters.updated_to) params.append('updated_at__lte', filters.updated_to);
-    if (filters.organizacion_name) {
-      params.append('organizacion_name__icontains', filters.organizacion_name);
-    }
-    if (filters.date_from) {
-      params.append('created_at__gte', filters.date_from);
-    }
-    if (filters.date_to) {
-      params.append('created_at__lte', filters.date_to);
-    }
-    if (filters.updated_from) {
-      params.append('updated_at__gte', filters.updated_from);
-    }
-    if (filters.updated_to) {
-      params.append('updated_at__lte', filters.updated_to);
-    }
 
-    const response = await fetchWithAuth(`${API_BASE_URL}/customs/procesamientopedimentos/?${params}`);
+  const response = await fetchWithAuth(`${API_BASE_URL}/customs/procesamientopedimentos/?${params}`);
-    
+  if (!response.ok) throw new Error(await extractApiError(response));
-    if (!response.ok) {
-      throw new Error(`Error ${response.status}: ${response.statusText}`);
-    }
 
-    const data = await response.json();
+  const data = await response.json();
-    return {
+  return { results: data.results, count: data.count, next: data.next, previous: data.previous };
-      results: data.results,
-      count: data.count,
-      next: data.next,
-      previous: data.previous
-    };
-  } catch (error) {
-    console.error('Error fetching Procesos:', error);
-    throw error;
-  }
 };
 
-// Mapeo de estados
 export const getEstadoLabel = (estado) => {
-  const estados = {
+  const estados = { 1: 'Pendiente', 2: 'En Proceso', 3: 'Completado', 4: 'Error', 5: 'Cancelado' };
-    1: 'Pendiente',
-    2: 'En Proceso',
-    3: 'Completado',
-    4: 'Error',
-    5: 'Cancelado'
-  };
   return estados[estado] || `Estado ${estado}`;
 };
 
@@ -70,38 +36,27 @@ export const getEstadoColor = (estado) => {
     2: 'bg-blue-100 text-blue-800',
     3: 'bg-green-100 text-green-800',
     4: 'bg-red-100 text-red-800',
-    5: 'bg-gray-100 text-gray-800'
+    5: 'bg-gray-100 text-gray-800',
   };
   return colores[estado] || 'bg-gray-100 text-gray-800';
 };
 
-// Mapeo de servicios
 export const getServicioLabel = (servicio) => {
   const servicios = {
-    1: 'Digitalización',
+    1: 'Digitalización', 2: 'Validación', 3: 'Procesamiento SAT',
-    2: 'Validación',
+    4: 'Generación COVEs', 5: 'Generación EDocs', 6: 'Envío VUCEM',
-    3: 'Procesamiento SAT',
+    7: 'Clasificación', 8: 'Archivo Digital', 9: 'Notificaciones',
-    4: 'Generación COVEs',
-    5: 'Generación EDocs',
-    6: 'Envío VUCEM',
-    7: 'Clasificación',
-    8: 'Archivo Digital',
-    9: 'Notificaciones'
   };
   return servicios[servicio] || `Servicio ${servicio}`;
 };
 
 export const getServicioColor = (servicio) => {
   const colores = {
-    1: 'bg-purple-100 text-purple-800',
+    1: 'bg-purple-100 text-purple-800', 2: 'bg-indigo-100 text-indigo-800',
-    2: 'bg-indigo-100 text-indigo-800',
+    3: 'bg-blue-100 text-blue-800',     4: 'bg-cyan-100 text-cyan-800',
-    3: 'bg-blue-100 text-blue-800',
+    5: 'bg-teal-100 text-teal-800',     6: 'bg-green-100 text-green-800',
-    4: 'bg-cyan-100 text-cyan-800',
+    7: 'bg-yellow-100 text-yellow-800', 8: 'bg-orange-100 text-orange-800',
-    5: 'bg-teal-100 text-teal-800',
+    9: 'bg-pink-100 text-pink-800',
-    6: 'bg-green-100 text-green-800',
-    7: 'bg-yellow-100 text-yellow-800',
-    8: 'bg-orange-100 text-orange-800',
-    9: 'bg-pink-100 text-pink-800'
   };
   return colores[servicio] || 'bg-gray-100 text-gray-800';
-};
+};

src/api/rbac.js

@@ -0,0 +1,153 @@
+const API_URL = import.meta.env.VITE_EFC_API_URL || 'http://localhost:8000';
+import { fetchWithAuth, postWithAuth, patchWithAuth, deleteWithAuth } from '../fetchWithAuth';
+
+async function handleResponse(response, operation = 'operación') {
+  if (response.status === 401) throw new Error('SESSION_EXPIRED');
+  if (!response.ok) {
+    let detail = `Error ${response.status}`;
+    try {
+      const body = await response.json();
+      detail = body.detail || body.message || JSON.stringify(body);
+    } catch {
+      detail = await response.text().catch(() => detail);
+    }
+    throw new Error(detail);
+  }
+  const contentType = response.headers.get('content-type');
+  if (!contentType?.includes('application/json')) return null;
+  return response.json();
+}
+
+// ── Catálogo de permisos ─────────────────────────────────────────────────────
+
+/** Array plano: [{ id, codename, descripcion, modulo }] */
+export async function fetchPermissions() {
+  const res = await fetchWithAuth(`${API_URL}/rbac/permissions/`);
+  return handleResponse(res, 'Fetch Permissions');
+}
+
+/** Agrupado por módulo: { cards: [...], coves: [...], ... } */
+export async function fetchPermissionsByModule() {
+  const res = await fetchWithAuth(`${API_URL}/rbac/permissions/by-module/`);
+  return handleResponse(res, 'Fetch Permissions By Module');
+}
+
+// ── Permisos efectivos del usuario actual ────────────────────────────────────
+
+/** { permissions: ["cards.view", ...], roles: ["admin"] } */
+export async function fetchMyPermissions() {
+  const res = await fetchWithAuth(`${API_URL}/rbac/my-permissions/`);
+  return handleResponse(res, 'Fetch My Permissions');
+}
+
+// ── Roles (OrganizationRole) ─────────────────────────────────────────────────
+
+export async function fetchRoles() {
+  const res = await fetchWithAuth(`${API_URL}/rbac/roles/`);
+  return handleResponse(res, 'Fetch Roles');
+}
+
+/**
+ * data: { nombre, descripcion?, permission_ids: number[] }
+ * permission_ids son IDs numéricos de RolePermission.
+ */
+export async function createRole(data) {
+  const res = await postWithAuth(`${API_URL}/rbac/roles/`, data);
+  return handleResponse(res, 'Create Role');
+}
+
+export async function getRole(id) {
+  const res = await fetchWithAuth(`${API_URL}/rbac/roles/${id}/`);
+  return handleResponse(res, 'Get Role');
+}
+
+/**
+ * PATCH — reemplaza el rol completo.
+ * data: { nombre?, descripcion?, permission_ids?: number[] }
+ */
+export async function updateRole(id, data) {
+  const res = await patchWithAuth(`${API_URL}/rbac/roles/${id}/`, data);
+  return handleResponse(res, 'Update Role');
+}
+
+export async function deleteRole(id) {
+  const res = await deleteWithAuth(`${API_URL}/rbac/roles/${id}/`);
+  if (res.status === 401) throw new Error('SESSION_EXPIRED');
+  if (!res.ok) {
+    let detail = `Error ${res.status}`;
+    try { detail = (await res.json()).detail || detail; } catch {}
+    throw new Error(detail);
+  }
+  return true;
+}
+
+// ── Asignación de roles a usuarios (UserRole) ────────────────────────────────
+
+/**
+ * userId: filtra por usuario. Usa ?user_id= según spec.
+ * Respuesta: [{ id, user: {...}, role: {...}, created_at }]
+ */
+export async function fetchUserRoles(userId) {
+  const url = userId
+    ? `${API_URL}/rbac/user-roles/?user_id=${userId}`
+    : `${API_URL}/rbac/user-roles/`;
+  const res = await fetchWithAuth(url);
+  return handleResponse(res, 'Fetch User Roles');
+}
+
+/**
+ * body: { user_id, role_id } — UUIDs según spec del backend.
+ */
+export async function assignUserRole(userId, roleId) {
+  const res = await postWithAuth(`${API_URL}/rbac/user-roles/`, {
+    user_id: userId,
+    role_id: roleId,
+  });
+  return handleResponse(res, 'Assign Role');
+}
+
+export async function revokeUserRole(userRoleId) {
+  const res = await deleteWithAuth(`${API_URL}/rbac/user-roles/${userRoleId}/`);
+  if (res.status === 401) throw new Error('SESSION_EXPIRED');
+  if (!res.ok) {
+    let detail = `Error ${res.status}`;
+    try { detail = (await res.json()).detail || detail; } catch {}
+    throw new Error(detail);
+  }
+  return true;
+}
+
+// ── Switch de organización (solo SuperUser) ───────────────────────────────────
+
+/**
+ * Establece la organización activa del superuser.
+ * body: { organization_id: "uuid" }
+ */
+export async function switchOrganization(organizationId) {
+  const res = await postWithAuth(`${API_URL}/rbac/switch-organization/`, {
+    organization_id: organizationId,
+  });
+  return handleResponse(res, 'Switch Organization');
+}
+
+/** Limpia la organización activa del superuser. */
+export async function clearOrganization() {
+  const res = await deleteWithAuth(`${API_URL}/rbac/switch-organization/`);
+  if (res.status === 401) throw new Error('SESSION_EXPIRED');
+  if (!res.ok) {
+    let detail = `Error ${res.status}`;
+    try { detail = (await res.json()).detail || detail; } catch {}
+    throw new Error(detail);
+  }
+  return true;
+}
+
+// ── Permisos singulares por usuario (UserPermission) ─────────────────────────
+
+export async function fetchUserPermissions(userId) {
+  const url = userId
+    ? `${API_URL}/rbac/user-permissions/?user_id=${userId}`
+    : `${API_URL}/rbac/user-permissions/`;
+  const res = await fetchWithAuth(url);
+  return handleResponse(res, 'Fetch User Permissions');
+}

src/api/users.js

@@ -1,56 +1,42 @@
 const API_URL = import.meta.env.VITE_EFC_API_URL || 'http://localhost:8000';
 import { fetchWithAuth, postWithAuth, putWithAuth, deleteWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
-// Función helper para manejar respuestas
+async function handleResponse(response) {
-
+  if (response.status === 401) throw new Error('SESSION_EXPIRED');
-async function handleResponse(response, operation = 'operación') {
+  if (!response.ok) throw new Error(await extractApiError(response));
-  if (response.status === 401) {
-    throw new Error('SESSION_EXPIRED');
-  }
-  if (!response.ok) {
-    const errorText = await response.text();
-    throw new Error(`Error ${response.status}: ${response.statusText}`);
-  }
   const contentType = response.headers.get('content-type');
-  if (!contentType || !contentType.includes('application/json')) {
+  if (!contentType || !contentType.includes('application/json')) return null;
-    throw new Error('El servidor no devolvió JSON válido');
-  }
   return response.json();
 }
 
 export async function fetchUsers() {
-  const url = `${API_URL}/user/users/`;
+  const res = await fetchWithAuth(`${API_URL}/user/users/`);
-  const res = await fetchWithAuth(url);
+  return handleResponse(res);
-  return handleResponse(res, 'Fetch Users');
 }
 
 export async function createUser(userData) {
-  const url = `${API_URL}/user/users/`;
+  const res = await postWithAuth(`${API_URL}/user/users/`, userData);
-  const res = await postWithAuth(url, userData);
+  return handleResponse(res);
-  return handleResponse(res, 'Create User');
 }
 
 export async function updateUser(id, userData) {
-  const url = `${API_URL}/user/users/${id}/`;
+  const res = await putWithAuth(`${API_URL}/user/users/${id}/`, userData);
-  const res = await putWithAuth(url, userData);
+  return handleResponse(res);
-  return handleResponse(res, 'Update User');
 }
 
 export async function deleteUser(id) {
-  const url = `${API_URL}/user/users/${id}/`;
+  const res = await deleteWithAuth(`${API_URL}/user/users/${id}/`);
-  const res = await deleteWithAuth(url);
+  return handleResponse(res);
-  if (!res.ok) throw new Error(`Error ${res.status}: ${res.statusText}`);
-  return true;
 }
 
 export async function getCurrentUser(token) {
-  const url = `${API_URL}/user/users/me/`;
+  const res = await fetch(`${API_URL}/user/users/me/`, {
-  const res = await fetch(url, {
     headers: {
       'Authorization': `Bearer ${token}`,
       'Content-Type': 'application/json',
       'Accept': 'application/json',
     },
   });
-  return handleResponse(res, 'Get Current User');
+  return handleResponse(res);
 }

src/api/users.ts

@@ -1,138 +1,39 @@
+/// <reference types="vite/client" />
 const API_URL = import.meta.env.VITE_EFC_API_URL || 'http://localhost:8000';
 import { fetchWithAuth, postWithAuth, putWithAuth, deleteWithAuth } from '../fetchWithAuth';
+import { extractApiError } from './apiError';
 
-// Función helper para manejar respuestas
+async function handleResponse(response: Response) {
-async function handleResponse(response, operation = 'operación') {
+  if (response.status === 401) throw new Error('SESSION_EXPIRED');
-  console.log(`📡 ${operation} response:`, response.status, response.statusText);
+  if (!response.ok) throw new Error(await extractApiError(response));
-  
-  if (response.status === 401) {
-    console.error('❌ Unauthorized - session expired');
-    throw new Error('SESSION_EXPIRED');
-  }
-  
-  if (!response.ok) {
-    const errorText = await response.text();
-    console.error(`❌ ${operation} error:`, response.status, errorText);
-    throw new Error(`Error ${response.status}: ${response.statusText}`);
-  }
-  
-  // Verificar que la respuesta es JSON
   const contentType = response.headers.get('content-type');
-  if (!contentType || !contentType.includes('application/json')) {
+  if (!contentType?.includes('application/json')) return null;
-    const text = await response.text();
-    console.error('❌ Response is not JSON:', text.substring(0, 200));
-    throw new Error('El servidor no devolvió JSON válido');
-  }
-  
   return response.json();
 }
 
 export async function fetchUsers() {
-  try {
+  const res = await fetchWithAuth(`${API_URL}/user/users/`);
-    const url = `${API_URL}/user/users/`;
+  return handleResponse(res);
-    console.log('👥 Fetching users from:', url);
-    
-    const res = await fetchWithAuth(url);
-    
-    const data = await handleResponse(res, 'Fetch Users');
-    console.log('✅ Users data received');
-    return data;
-    
-  } catch (error) {
-    console.error('❌ Error in fetchUsers:', error);
-    if (error.name === 'TypeError' && error.message.includes('fetch')) {
-      throw new Error('Error de conexión al servidor');
-    }
-    throw error;
-  }
 }
 
-export async function createUser(userData) {
+export async function createUser(userData: object) {
-  try {
+  const res = await postWithAuth(`${API_URL}/user/users/`, userData);
-    const url = `${API_URL}/user/users/`;
+  return handleResponse(res);
-    console.log('➕ Creating user at:', url);
-    
-    const res = await postWithAuth(url, userData);
-    
-    const data = await handleResponse(res, 'Create User');
-    console.log('✅ User created successfully');
-    return data;
-    
-  } catch (error) {
-    console.error('❌ Error in createUser:', error);
-    if (error.name === 'TypeError' && error.message.includes('fetch')) {
-      throw new Error('Error de conexión al servidor');
-    }
-    throw error;
-  }
 }
 
-export async function updateUser(id, userData) {
+export async function updateUser(id: string | number, userData: object) {
-  try {
+  const res = await putWithAuth(`${API_URL}/user/users/${id}/`, userData);
-    const url = `${API_URL}/user/users/${id}/`;
+  return handleResponse(res);
-    console.log('✏️ Updating user at:', url);
-    
-    const res = await putWithAuth(url, userData);
-    
-    const data = await handleResponse(res, 'Update User');
-    console.log('✅ User updated successfully');
-    return data;
-    
-  } catch (error) {
-    console.error('❌ Error in updateUser:', error);
-    if (error.name === 'TypeError' && error.message.includes('fetch')) {
-      throw new Error('Error de conexión al servidor');
-    }
-    throw error;
-  }
 }
 
-export async function deleteUser(id) {
+export async function deleteUser(id: string | number) {
-  try {
+  const res = await deleteWithAuth(`${API_URL}/user/users/${id}/`);
-    const url = `${API_URL}/user/users/${id}/`;
+  if (res.status === 401) throw new Error('SESSION_EXPIRED');
-    console.log('🗑️ Deleting user at:', url);
+  if (!res.ok) throw new Error(await extractApiError(res));
-    
+  return true;
-    const res = await deleteWithAuth(url);
-    
-    if (res.status === 401) {
-      console.error('❌ Unauthorized - session expired');
-      throw new Error('SESSION_EXPIRED');
-    }
-    
-    if (!res.ok) {
-      const errorText = await res.text();
-      console.error('❌ Delete User error:', res.status, errorText);
-      throw new Error(`Error ${res.status}: ${res.statusText}`);
-    }
-    
-    console.log('✅ User deleted successfully');
-    return true; // DELETE suele no devolver contenido
-    
-  } catch (error) {
-    console.error('❌ Error in deleteUser:', error);
-    if (error.name === 'TypeError' && error.message.includes('fetch')) {
-      throw new Error('Error de conexión al servidor');
-    }
-    throw error;
-  }
 }
 
 export async function getCurrentUser() {
-  try {
+  const res = await fetchWithAuth(`${API_URL}/user/users/me/`);
-    const url = `${API_URL}/user/users/me/`;
+  return handleResponse(res);
-    console.log('👤 Fetching current user from:', url);
-    
-    const res = await fetchWithAuth(url);
-    
-    const data = await handleResponse(res, 'Get Current User');
-    console.log('✅ Current user data received:', data);
-    return data;
-    
-  } catch (error) {
-    console.error('❌ Error in getCurrentUser:', error);
-    if (error.name === 'TypeError' && error.message.includes('fetch')) {
-      throw new Error('Error de conexión al servidor');
-    }
-    throw error;
-  }
 }

src/components/Sidebar.jsx

@@ -1,23 +1,21 @@
 import React, { useState, useEffect } from 'react';
 import { Link, useLocation, useNavigate } from 'react-router-dom';
 import { useUser } from '../context/UserContext';
+import { fetchWithAuth } from '../fetchWithAuth';
 
 export default function Sidebar({ isMobileOpen, onMobileClose }) {
-  // Leer si el usuario es importador desde localStorage
-  const isImportador = typeof window !== 'undefined' && localStorage.getItem('user_is_importador') === 'true';
-  // Leer grupos del usuario desde localStorage
-  let userGroups = [];
-  if (typeof window !== 'undefined') {
-    try {
-      userGroups = JSON.parse(localStorage.getItem('user_groups') || '[]');
-    } catch {
-      userGroups = [];
-    }
-  }
-  // Si los grupos son exactamente [3,5]
-  const isGroup35 = Array.isArray(userGroups) && userGroups.length === 2 && userGroups.includes(3) && userGroups.includes(5);
-  // Leer DEBUG_MODE desde variables de entorno
   const isDebugMode = import.meta.env.VITE_DEBUG_MODE === 'true';
+
+  // Permisos RBAC — cargados desde /rbac/my-permissions/ al hacer login
+  const [userPermissions, setUserPermissions] = useState(() => {
+    try {
+      return JSON.parse(localStorage.getItem('user_permissions') || '[]');
+    } catch {
+      return [];
+    }
+  });
+
+  const hasPermission = (codename) => userPermissions.includes(codename);
   
   // Estados para responsividad
   const [isCollapsed, setIsCollapsed] = useState(false);
@@ -34,6 +32,14 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
   const handleLogout = () => {
     localStorage.removeItem('access');
     localStorage.removeItem('refresh');
+    localStorage.removeItem('user_id');
+    localStorage.removeItem('user_is_importador');
+    localStorage.removeItem('user_groups');
+    localStorage.removeItem('user_permissions');
+    localStorage.removeItem('username');
+    localStorage.removeItem('user_email');
+    localStorage.removeItem('user_first_name');
+    localStorage.removeItem('user_last_name');
     window.dispatchEvent(new CustomEvent('authStateChanged'));
     navigate('/login');
   };
@@ -55,6 +61,22 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
     handleMobileClose();
   }, [location.pathname]);
 
+  // Si no hay permisos en localStorage (sesión previa al RBAC), los carga del servidor
+  useEffect(() => {
+    if (userPermissions.length === 0 && localStorage.getItem('access')) {
+      const apiUrl = import.meta.env.VITE_EFC_API_URL || '';
+      fetchWithAuth(`${apiUrl}/rbac/my-permissions/`)
+        .then(res => res.ok ? res.json() : null)
+        .then(data => {
+          if (data && Array.isArray(data.permissions)) {
+            localStorage.setItem('user_permissions', JSON.stringify(data.permissions));
+            setUserPermissions(data.permissions);
+          }
+        })
+        .catch(() => {});
+    }
+  }, []);
+
   // El usuario y loading ahora vienen del contexto global
 
   // Definir todas las secciones
@@ -71,9 +93,8 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
             </svg>
           )
         },
-        // Ocultar 'Mi Organización' si es importador o si esGroup35
         ...(
-          (!isImportador && !isGroup35)
+          hasPermission('organizacion.view')
             ? [
                 {
                   name: 'Mi Organización',
@@ -101,15 +122,19 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
             </svg>
           )
         },
-        {
+        ...(
-          name: 'Auditor',
+          hasPermission('auditoria.view')
-          path: '/auditor',
+            ? [{
-          icon: (
+                name: 'Auditor',
-            <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                path: '/auditor',
-              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
+                icon: (
-            </svg>
+                  <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-          )
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-3 7h3m-3 4h3m-6-4h.01M9 16h.01" />
-        }
+                  </svg>
+                )
+              }]
+            : []
+        )
       ]
     },
     {
@@ -158,9 +183,9 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
         }
       ]
     },
-    // Nueva sección Tableros - Solo mostrar si DEBUG_MODE es true
+    // Nueva sección Tableros - Solo mostrar si DEBUG_MODE es true y tiene cards.view
     ...(
-      (isDebugMode && !isGroup35)
+      (isDebugMode && hasPermission('cards.view'))
         ? [
             {
               title: 'Tableros',
@@ -179,71 +204,70 @@ export default function Sidebar({ isMobileOpen, onMobileClose }) {
           ]
         : []
     ),
-    ...(
+    {
-      isGroup35
+      title: 'Acceso a Usuarios',
-        ? []
+      items: [
-        : [
+        ...(
-            {
+          hasPermission('importadores.view')
-              title: 'Acceso a Usuarios',
+            ? [{
-              items: [
+                name: 'Importadores',
-                // Botón Importadores como primer elemento
+                path: '/importers',
-                {
+                icon: (
-                  name: 'Importadores',
+                  <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                  path: '/importers',
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M16 7a4 4 0 01-8 0M12 11v10m-6 0h12a2 2 0 002-2v-5a2 2 0 00-2-2H6a2 2 0 00-2 2v5a2 2 0 002 2z" />
-                  icon: (
+                  </svg>
-                    <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                )
-                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M16 7a4 4 0 01-8 0M12 11v10m-6 0h12a2 2 0 002-2v-5a2 2 0 00-2-2H6a2 2 0 00-2 2v5a2 2 0 002 2z" />
+              }]
-                    </svg>
+            : []
-                  )
+        ),
-                },
+        ...(
-                ...(
+          hasPermission('usuarios.view')
-                  isImportador
+            ? [{
-                    ? []
+                name: 'Usuarios',
-                    : [
+                path: '/users',
-                        {
+                icon: (
-                          name: 'Usuarios',
+                  <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                          path: '/users',
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197m13.5-9a2.5 2.5 0 11-5 0 2.5 2.5 0 015 0z" />
-                          icon: (
+                  </svg>
-                            <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                )
-                              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M12 4.354a4 4 0 110 5.292M15 21H3v-1a6 6 0 0112 0v1zm0 0h6v-1a6 6 0 00-9-5.197m13.5-9a2.5 2.5 0 11-5 0 2.5 2.5 0 015 0z" />
+              }]
-                            </svg>
+            : []
-                          )
+        ),
-                        }
+        ...(
-                      ]
+          hasPermission('usuarios.manage_roles')
-                ),
+            ? [{
-                {
+                name: 'Perfiles',
-                  name: 'Ventanilla Única',
+                path: '/profiles',
-                  path: '/vucem',
+                icon: (
-                  icon: (
+                  <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
-                      <circle cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="2" fill="none" />
+                  </svg>
-                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M8 12h8M12 8v8" />
+                )
-                    </svg>
+              }]
-                  )
+            : []
-                }
+        ),
-              ]
+        ...(
-            }
+          hasPermission('vucem.view')
-          ]
+            ? [{
-    )
+                name: 'Ventanilla Única',
+                path: '/vucem',
+                icon: (
+                  <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <circle cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="2" fill="none" />
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M8 12h8M12 8v8" />
+                  </svg>
+                )
+              }]
+            : []
+        ),
+      ]
+    }
   ];
 
-  // Filtrar secciones según si es importador y modo debug
+  // Ocultar secciones que no tienen ningún item visible
-  // Modificar items según si es importador
+  const menuSections = allMenuSections.filter(
-  const menuSections = allMenuSections
+    section => section && section.items && section.items.length > 0
-    .map(section => {
+  );
-      if (section.title === 'Organización') {
-        return {
-          ...section,
-          items: section.items.filter(item => !(isImportador && item.name === 'Mi Organización'))
-        };
-      }
-      // Para Tableros, filtrar la sección si es importador o si no está en modo debug
-      if (section.title === 'Tableros' && (isImportador || !isDebugMode)) {
-        return null;
-      }
-      return section;
-    })
-    .filter(Boolean);
 
   return (
     <>

src/fetchWithAuth.js

@@ -74,6 +74,7 @@ const refreshToken = async () => {
     localStorage.removeItem('refresh');
     localStorage.removeItem('user_id');
     localStorage.removeItem('user_is_importador');
+    localStorage.removeItem('user_permissions');
     
     // Redirigir al login después de un pequeño delay
     setTimeout(() => {

src/hooks/usePollTaskStatus.js

@@ -0,0 +1,99 @@
+import { useState, useRef, useCallback } from 'react';
+import { fetchWithAuth } from '../fetchWithAuth';
+
+const API_BASE_URL = import.meta.env.VITE_EFC_API_URL;
+
+// Estados que indican que la tarea ya terminó (no hay más que esperar)
+const FINAL_STATES = new Set(['SUCCESS', 'FAILURE', 'completed', 'failed', 'cancelled']);
+
+/**
+ * Polling acotado de estado de tarea.
+ *
+ * Uso:
+ *   const { taskState, polling, poll, reset } = usePollTaskStatus({ maxAttempts: 3, intervalMs: 2500 });
+ *
+ *   // Después de enviar la tarea al microservicio:
+ *   poll(taskId);
+ *
+ *   // taskState: null | { status, message, error, attempts }
+ *   // polling: true mientras hay intentos pendientes
+ */
+export function usePollTaskStatus({ maxAttempts = 3, intervalMs = 2500 } = {}) {
+  const [taskState, setTaskState] = useState(null);
+  const [polling, setPolling]     = useState(false);
+
+  const timeoutRef  = useRef(null);
+  const abortedRef  = useRef(false);
+  const attemptsRef = useRef(0);
+
+  const stop = useCallback(() => {
+    abortedRef.current = true;
+    if (timeoutRef.current) {
+      clearTimeout(timeoutRef.current);
+      timeoutRef.current = null;
+    }
+    setPolling(false);
+  }, []);
+
+  const reset = useCallback(() => {
+    stop();
+    setTaskState(null);
+    attemptsRef.current = 0;
+  }, [stop]);
+
+  const poll = useCallback((taskId) => {
+    if (!taskId) return;
+
+    // Reiniciar estado previo
+    abortedRef.current  = false;
+    attemptsRef.current = 0;
+    setPolling(true);
+    setTaskState({ status: 'PENDING', message: null, error: null, attempts: 0 });
+
+    const attempt = async () => {
+      if (abortedRef.current) return;
+
+      attemptsRef.current += 1;
+      const n = attemptsRef.current;
+
+      try {
+        const res = await fetchWithAuth(`${API_BASE_URL}/tasks/status/${taskId}/`);
+        if (abortedRef.current) return;
+
+        if (!res.ok) {
+          setTaskState({ status: 'FAILURE', message: `Error HTTP ${res.status}`, error: true, attempts: n });
+          setPolling(false);
+          return;
+        }
+
+        const data = await res.json();
+        if (abortedRef.current) return;
+
+        const newState = {
+          status:   data.status,
+          message:  data.message || data.error || null,
+          error:    data.error   || null,
+          result:   data.result  || null,
+          attempts: n,
+        };
+        setTaskState(newState);
+
+        if (FINAL_STATES.has(data.status) || n >= maxAttempts) {
+          setPolling(false);
+          return;
+        }
+
+        timeoutRef.current = setTimeout(attempt, intervalMs);
+
+      } catch (err) {
+        if (abortedRef.current) return;
+        setTaskState({ status: 'FAILURE', message: err.message, error: true, attempts: n });
+        setPolling(false);
+      }
+    };
+
+    attempt();
+  }, [maxAttempts, intervalMs]);
+
+  return { taskState, polling, poll, stop, reset };
+}

src/pages/Auditor.jsx

@@ -8,6 +8,7 @@ import xml from 'highlight.js/lib/languages/xml';
 import 'highlight.js/styles/github.css';
 hljs.registerLanguage('xml', xml);
 import { downloadFile } from '../utils/downloadUtils';
+import { extractApiError } from '../api/apiError';
 
 const API_URL = import.meta.env.VITE_EFC_API_URL;
 
@@ -342,10 +343,10 @@ function GlobalAuditModal({ modal, onClose, onConsultar, consultando, onIniciarP
               </div>
 
               {/* Tabla de pedimentos con pendientes */}
-              {resultado.detalle_pendientes && resultado.detalle_pendientes.length > 0 && (
+              {resultado.result?.detalle_pendientes && resultado.result.detalle_pendientes.length > 0 && (
                 <details className="rounded-xl border border-amber-100 overflow-hidden" open>
                   <summary className="flex items-center justify-between px-4 py-2.5 bg-amber-50 text-sm font-semibold text-amber-800 cursor-pointer list-none select-none">
-                    <span>Pedimentos con pendientes ({resultado.detalle_pendientes.length})</span>
+                    <span>Pedimentos con pendientes ({resultado.result.detalle_pendientes.length})</span>
                     <svg className="w-4 h-4 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                       <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 9l-7 7-7-7" />
                     </svg>
@@ -355,14 +356,16 @@ function GlobalAuditModal({ modal, onClose, onConsultar, consultando, onIniciarP
                       <thead className="bg-amber-50/60">
                         <tr>
                           <th className="px-4 py-2 text-left font-semibold text-amber-900">Pedimento</th>
-                          <th className="px-4 py-2 text-left font-semibold text-amber-900">Documentos faltantes</th>
+                          <th className="px-4 py-2 text-left font-semibold text-amber-900">Faltantes</th>
                           <th className="px-4 py-2 text-center font-semibold text-amber-900">Progreso</th>
                         </tr>
                       </thead>
-                      <tbody className="divide-y divide-amber-50 bg-white max-h-52 overflow-y-auto">
+                      <tbody className="divide-y divide-amber-50 bg-white">
-                        {resultado.detalle_pendientes.map((item, i) => {
+                        {resultado.result.detalle_pendientes.map((item, i) => {
-                          const faltantesEntries = Object.entries(item).filter(([k]) => k.startsWith('faltantes_'));
+                          const faltantesEntries = Object.entries(item).filter(([k]) => k.startsWith('faltantes_') || k === 'no_descargadas');
                           const todosLosIds = faltantesEntries.flatMap(([, v]) => Array.isArray(v) ? v : []);
+                          const descargados = item.descargados ?? item.descargadas ?? '?';
+                          const total = item.total ?? item.total_partidas ?? '?';
                           return (
                             <tr key={i} className="hover:bg-amber-50/40">
                               <td className="px-4 py-2 font-mono font-semibold text-gray-800 whitespace-nowrap">
@@ -381,7 +384,7 @@ function GlobalAuditModal({ modal, onClose, onConsultar, consultando, onIniciarP
                                 </div>
                               </td>
                               <td className="px-4 py-2 text-center whitespace-nowrap text-gray-600">
-                                {item.descargados ?? '?'}<span className="text-gray-400">/{item.total ?? '?'}</span>
+                                {descargados}<span className="text-gray-400">/{total}</span>
                               </td>
                             </tr>
                           );
@@ -393,10 +396,10 @@ function GlobalAuditModal({ modal, onClose, onConsultar, consultando, onIniciarP
               )}
 
               {/* Tabla de errores */}
-              {resultado.detalle_errores && resultado.detalle_errores.length > 0 && (
+              {resultado.result?.detalle_errores && resultado.result.detalle_errores.length > 0 && (
                 <details className="rounded-xl border border-red-200 overflow-hidden">
                   <summary className="flex items-center justify-between px-4 py-2.5 bg-red-50 text-sm font-semibold text-red-800 cursor-pointer list-none select-none">
-                    <span>Errores ({resultado.detalle_errores.length})</span>
+                    <span>Errores ({resultado.result.detalle_errores.length})</span>
                     <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                       <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 9l-7 7-7-7" />
                     </svg>
@@ -410,7 +413,7 @@ function GlobalAuditModal({ modal, onClose, onConsultar, consultando, onIniciarP
                         </tr>
                       </thead>
                       <tbody className="divide-y divide-red-50 bg-white">
-                        {resultado.detalle_errores.map((item, i) => (
+                        {resultado.result.detalle_errores.map((item, i) => (
                           <tr key={i} className="hover:bg-red-50/40">
                             <td className="px-4 py-2 font-mono font-semibold text-gray-800 whitespace-nowrap">{item.pedimento}</td>
                             <td className="px-4 py-2 text-red-700">{item.error || '—'}</td>
@@ -560,8 +563,7 @@ function Auditor() {
         organizacionid: globalAuditModal.organizacion_id,
       });
       if (!response.ok) {
-        const errorData = await response.json().catch(() => ({}));
+        throw new Error(await extractApiError(response));
-        throw new Error(errorData.message || errorData.error || `Error ${response.status}`);
       }
       const data = await response.json();
       showMessage(data.message || 'Proceso iniciado correctamente', 'success');
@@ -585,8 +587,7 @@ function Auditor() {
       setIniciandoProcesamiento(true);
       const response = await postWithAuth(`${API_URL}/customs/pedimentos/${pedimento_id}/${urlPath}/`);
       if (!response.ok) {
-        const errorData = await response.json().catch(() => ({}));
+        throw new Error(await extractApiError(response));
-        throw new Error(errorData.message || errorData.error || `Error ${response.status}`);
       }
       const data = await response.json();
       showMessage(data.status || 'Procesamiento iniciado correctamente', 'success');
@@ -603,7 +604,7 @@ function Auditor() {
     try {
       setConsultandoTask(true);
       const response = await getWithAuth(`${API_URL}/tasks/status/${globalAuditModal.task_id}/`);
-      if (!response.ok) throw new Error('Error al consultar el estado de la tarea');
+      if (!response.ok) throw new Error(await extractApiError(response));
       const data = await response.json();
       if (data.ready) {
         setGlobalAuditModal(prev => ({ ...prev, resultado: data }));
@@ -630,7 +631,7 @@ function Auditor() {
         organizacion_id: organizacionId
       });
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría de acuses');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setGlobalAuditModal({ label: 'Acuses', procesamiento: 'acuses', organizacion_id: organizacionId, task_id: data.task_id, resultado: null });
@@ -654,7 +655,7 @@ function Auditor() {
         organizacion_id: organizacionId
       });
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría de EDocuments');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setGlobalAuditModal({ label: 'EDocuments', procesamiento: 'edocs', organizacion_id: organizacionId, task_id: data.task_id, resultado: null });
@@ -678,7 +679,7 @@ function Auditor() {
         organizacion_id: organizacionId
       });
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría de acuses cove');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setGlobalAuditModal({ label: 'Acuses de COVE', procesamiento: 'acuse_coves', organizacion_id: organizacionId, task_id: data.task_id, resultado: null });
@@ -699,7 +700,7 @@ function Auditor() {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        throw new Error('Error al auditar el pedimento');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setAuditResultModal({ tipo: 'pc', pedimento_id: pedimentoId, pedimento_app: pedimento?.pedimento_app, data });
@@ -722,7 +723,7 @@ function Auditor() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al procesar las remesas del pedimento');
+        throw new Error(await extractApiError(response));
       }
 
       const data = await response.json();
@@ -750,7 +751,7 @@ function Auditor() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría de remesas');
+        throw new Error(await extractApiError(response));
       }
 
       const data = await response.json();
@@ -774,7 +775,7 @@ function Auditor() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al procesar las partidas del pedimento');
+        throw new Error(await extractApiError(response));
       }
 
       const data = await response.json();
@@ -802,7 +803,7 @@ function Auditor() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría de partidas');
+        throw new Error(await extractApiError(response));
       }
 
       const data = await response.json();
@@ -831,7 +832,7 @@ function Auditor() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al iniciar la auditoría');
+        throw new Error(await extractApiError(response));
       }
 
       const data = await response.json();
@@ -853,7 +854,7 @@ function Auditor() {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        throw new Error('Error al auditar acuse del pedimento');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setAuditResultModal({ tipo: 'ac', pedimento_id: pedimentoId, pedimento_app: pedimento?.pedimento_app, data });
@@ -873,7 +874,7 @@ function Auditor() {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        throw new Error('Error al auditar acuse cove del pedimento');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setAuditResultModal({ tipo: 'ac_cove', pedimento_id: pedimentoId, pedimento_app: pedimento?.pedimento_app, data });
@@ -894,7 +895,7 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        throw new Error('Error al auditar eDocument del pedimento');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setAuditResultModal({ tipo: 'edoc', pedimento_id: pedimentoId, pedimento_app: pedimento?.pedimento_app, data });
@@ -914,7 +915,7 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        throw new Error('Error al auditar COVE del pedimento');
+        throw new Error(await extractApiError(response));
       }
       const data = await response.json();
       setAuditResultModal({ tipo: 'cove', pedimento_id: pedimentoId, pedimento_app: pedimento?.pedimento_app, data });
@@ -935,7 +936,7 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         pedimento_id: pedimentoId
       });
       if (!response.ok) {
-        showMessage('Error al intentar realizar la peticion de pedimento VU', 'warning');
+        showMessage(await extractApiError(response), 'error');
         return;
       }
 
@@ -1054,14 +1055,7 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
       });
 
       if (!response.ok) {
-        // Obtener el JSON de error que devuelve Django
+        showMessage(`No se encontró datos para auditoría: ${getVistaNombre(vista_auditar)}. Detalle: ${await extractApiError(response)}`, 'warning');
-        const errorData = await response.json();
-        const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-        
-        showMessage(`No se encontró datos para auditoría: ${getVistaNombre(vista_auditar)}. Detalle: ${errorMessage}`, 'warning');
-                    
-        // showMessage(`Error al obtener datos para vista ${vista_auditar}`, 'error');
         setDetalleModalXml(null);
         return;
       }
@@ -1125,7 +1119,7 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         const res = await fetchWithAuth(`${API_URL}/record/documents/descargar/${doc.id}/`);
         
         if (!res.ok) {
-          setPreviewError('Error al obtener el archivo');
+          setPreviewError(await extractApiError(res));
           setPreviewLoading(false);
           return;
         }
@@ -1169,11 +1163,10 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
           setPreviewLoading(false);
         }
       } catch (err) {
-        console.error('Error en vista previa:', err);
         if (err.message === 'SESSION_EXPIRED') {
           setPreviewError('Tu sesión ha expirado, por favor inicia sesión de nuevo.');
         } else {
-          setPreviewError('Error al obtener el archivo');
+          setPreviewError(err.message || 'Error al obtener el archivo');
         }
         setPreviewLoading(false);
       }
@@ -1262,24 +1255,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      console.error('Error al obtener petición VU:', error);
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
-      showMessage('Error al cargar la petición VU', 'error');
     }
   };
 
@@ -1292,24 +1277,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      console.error('Error al obtener petición VU:', error);
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage('Error al cargar la petición VU', 'error');
     }
   };
 
@@ -1323,24 +1300,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      console.error('Error al obtener petición VU:', error);
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
-      showMessage('Error al cargar la petición VU', 'error');
     }
   };
 
@@ -1353,24 +1322,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1384,23 +1345,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      showMessage(`Error al cargar la petición VU: ${error.message|| 'Error desconocido'}`, 'error');
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
     }
   };
 
@@ -1413,24 +1367,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1443,24 +1389,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
-      showMessage(`Error al cargar la petición VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1473,24 +1411,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1503,24 +1433,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
-      showMessage(`Error al cargar la petición VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1533,24 +1455,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1564,26 +1478,19 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      showMessage(`Error al cargar la petición VU: ${error.message|| 'Error desconocido'}`, 'error');
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
     }
   };
-    
+
   // Vista previa de respuesta Acuse COVE VU
   const handlePreviewRespuestaAcuseCoveVU = async (pedimentoId) => {
     try {
@@ -1593,24 +1500,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1624,23 +1523,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de petición VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de petición VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-      showMessage(`Error al cargar la petición VU: ${error.message|| 'Error desconocido'}`, 'error');
+      showMessage(error.message || 'Error al cargar la petición VU', 'error');
     }
   };
 
@@ -1653,24 +1545,16 @@ const handleAuditarEDocumentPedimento = async (pedimentoId) => {
         });
 
         if (!response.ok) {
-           // Obtener el JSON de error que devuelve Django
+          showMessage(`No se encontró archivo de respuesta VU: ${await extractApiError(response)}`, 'warning');
-          const errorData = await response.json();
-
-          const errorMessage = errorData.error || 
-                          `Error ${response.status}: ${response.statusText}`;
-
-          showMessage(`No se encontró archivo de respuesta VU: ${errorMessage}`, 'warning');
           return;
         }
 
         const documento = await response.json();
 
-        // Llamar a la función de vista previa existente
         await previewDocument(documento);
 
     }catch(error) {
-
+      showMessage(error.message || 'Error al cargar la respuesta VU', 'error');
-      showMessage(`Error al cargar la respuesta VU: ${error.message|| 'Error desconocido'}`, 'error');
     }
   };
 
@@ -1726,7 +1610,7 @@ function formatXml(xml) {
           ...(pedimentoFilter && { search: pedimentoFilter })
         });
         const response = await getWithAuth(`${API_URL}/customs/pedimentos/?${queryParams}`);
-        if (!response.ok) throw new Error('Error al cargar los pedimentos');
+        if (!response.ok) throw new Error(await extractApiError(response));
         const data = await response.json();
         setPedimentos(data.results);
         setCount(data.count);

src/pages/Datastage.jsx

@@ -22,6 +22,8 @@ async function patchProcesadoTrue(item) {
     });
 }
 import { fetchWithAuth } from '../fetchWithAuth';
+import { useNotification } from '../context/NotificationContext';
+import { extractApiError } from '../api/apiError';
 
 // Modal para mostrar registros cargados
 function RegistrosCargadosModal({ open, onClose, registros }) {
@@ -59,7 +61,7 @@ function RegistrosCargadosModal({ open, onClose, registros }) {
 }
 
 // Procesar datastage (adaptado para mostrar registros cargados)
-async function procesarDatastage(item, setDatastages, setSuccess, setError, setRegistrosCargados, setShowRegistrosModal) {
+async function procesarDatastage(item, setDatastages, setSuccess, showMessage, setRegistrosCargados, setShowRegistrosModal) {
     try {
         const url = `${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/${item.id}/procesar/`;
         const body = {
@@ -72,53 +74,54 @@ async function procesarDatastage(item, setDatastages, setSuccess, setError, setR
             headers: { 'Content-Type': 'application/json' },
             body: JSON.stringify(body)
         });
+        if (!res.ok) {
+            showMessage(await extractApiError(res), 'error');
+            return;
+        }
         const data = await res.json();
-        if (res.status === 200) {
+        await patchProcesadoTrue(item);
-            // PATCH para marcar como procesado en backend
+        setDatastages(prev => ({
-            await patchProcesadoTrue(item);
+            ...prev,
-            setDatastages(prev => ({
+            results: Array.isArray(prev.results)
-                ...prev,
+                ? prev.results.map(d => d.id === item.id ? { ...d, procesado: true } : d)
-                results: Array.isArray(prev.results)
+                : []
-                    ? prev.results.map(d => d.id === item.id ? { ...d, procesado: true } : d)
+        }));
-                    : []
+        if (data && data.task_id && data.detail) {
-            }));
+            setSuccess(`Procesamiento iniciado.\nTask ID: ${data.task_id}\n${data.detail}`);
-            // Mostrar el mensaje con task_id y detail si existen
-            if (data && data.task_id && data.detail) {
-                setSuccess(`Procesamiento iniciado.\nTask ID: ${data.task_id}\n${data.detail}`);
-            } else {
-                setSuccess('Procesado correctamente');
-            }
-            // El modal de éxito se debe mostrar en el componente principal después de setSuccess
-            // No se llama aquí
-            if (data && data.registros_cargados) {
-                setRegistrosCargados(data.registros_cargados);
-                setShowRegistrosModal(true);
-            }
         } else {
-            setError(data && data.detail ? data.detail : 'No se pudo procesar el datastage');
+            setSuccess('Procesado correctamente');
+        }
+        if (data && data.registros_cargados) {
+            setRegistrosCargados(data.registros_cargados);
+            setShowRegistrosModal(true);
         }
     } catch (e) {
-        setError('No se pudo procesar el datastage');
+        showMessage(e.message || 'No se pudo procesar el datastage', 'error');
     }
 }
 // Descarga autenticada de archivos datastage
-function downloadDatastageFile(id, filename) {
+async function downloadDatastageFile(id, filename, showMessage) {
     const url = `${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/${id}/download-datastage/`;
-    fetchWithAuth(url, { method: 'GET' })
+    try {
-        .then(async res => {
+        const res = await fetchWithAuth(url, { method: 'GET' });
-            if (!res.ok) throw new Error('Error al descargar archivo');
+        if (!res.ok) {
-            const blob = await res.blob();
+            const errMsg = await extractApiError(res);
-            const link = document.createElement('a');
+            throw new Error(errMsg);
-            link.href = window.URL.createObjectURL(blob);
+        }
-            link.download = filename || `datastage_${id}.zip`;
+        const blob = await res.blob();
-            document.body.appendChild(link);
+        const link = document.createElement('a');
-            link.click();
+        link.href = window.URL.createObjectURL(blob);
-            link.remove();
+        link.download = filename || `datastage_${id}.zip`;
-        })
+        document.body.appendChild(link);
-        .catch(() => alert('No se pudo descargar el archivo.'));
+        link.click();
+        link.remove();
+    } catch (err) {
+        showMessage(err.message || 'No se pudo descargar el archivo', 'error');
+    }
 }
 
 export default function Datastage() {
+    const { showMessage } = useNotification();
     const focusKeeperRef = useRef(null);
     // datastages will hold the full API response object (with .results and .count)
     const [datastages, setDatastages] = useState({ results: [], count: 0 });
@@ -165,6 +168,7 @@ export default function Datastage() {
             }
         } catch (e) {
             setError(e.message);
+            showMessage(e.message, 'error');
             setDatastages({ results: [], count: 0 });
         }
         setLoading(false);
@@ -183,7 +187,7 @@ export default function Datastage() {
             setSelected(detail);
             setShowDetailModal(true);
         } catch (e) {
-            setError(e.message);
+            showMessage(e.message, 'error');
         }
         setLoading(false);
     };
@@ -197,14 +201,16 @@ export default function Datastage() {
             const fd = new FormData();
             fd.append('contribuyente', form.contribuyente);
             if (form.archivo) fd.append('archivo', form.archivo);
-            await postFormDataWithAuth(`${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/`, fd);
+            const res = await postFormDataWithAuth(`${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/`, fd);
+            if (!res.ok) throw new Error(await extractApiError(res));
             setForm({ archivo: null, contribuyente: '' });
             setShowCreateModal(false);
             setSuccess('Datastage creado exitosamente');
             setShowSuccessModal(true);
             load();
         } catch (e) {
-            setError(e.message);
+            setShowCreateModal(false);
+            showMessage(e.message || 'Error al crear el datastage', 'error');
         }
         setLoading(false);
     };
@@ -218,7 +224,8 @@ export default function Datastage() {
             const fd = new FormData();
             fd.append('contribuyente', form.contribuyente);
             if (form.archivo) fd.append('archivo', form.archivo);
-            await patchFormDataWithAuth(`${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/${editingId}/`, fd);
+            const res = await patchFormDataWithAuth(`${import.meta.env.VITE_EFC_API_URL}/datastage/datastages/${editingId}/`, fd);
+            if (!res.ok) throw new Error(await extractApiError(res));
             setForm({ archivo: null, contribuyente: '' });
             setEditingId(null);
             setShowEditModal(false);
@@ -226,7 +233,8 @@ export default function Datastage() {
             setShowSuccessModal(true);
             load();
         } catch (e) {
-            setError(e.message);
+            setShowEditModal(false);
+            showMessage(e.message || 'Error al actualizar el datastage', 'error');
         }
         setLoading(false);
     };
@@ -244,7 +252,8 @@ export default function Datastage() {
             setShowSuccessModal(true);
             load();
         } catch (e) {
-            setError(e.message);
+            setShowDeleteModal(false);
+            showMessage(e.message || 'Error al eliminar el datastage', 'error');
         }
         setLoading(false);
     };
@@ -269,8 +278,9 @@ export default function Datastage() {
             } else {
                 setImportadores([]);
             }
-        } catch {
+        } catch (e) {
             setImportadores([]);
+            showMessage(e.message || 'Error al cargar importadores', 'error');
         }
         setShowCreateModal(true);
     };
@@ -404,7 +414,8 @@ export default function Datastage() {
                                                                 } catch {
                                                                     return '';
                                                                 }
-                                                            })()
+                                                            })(),
+                                                            showMessage
                                                         )}
                                                     >
                                                         <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -444,7 +455,7 @@ export default function Datastage() {
                                                 <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M6 18L18 6M6 6l12 12" /></svg>
                                             </button>
                                             <button
-                                                onClick={() => procesarDatastage(item, setDatastages, setSuccess, setError, setRegistrosCargados, setShowRegistrosModal)}
+                                                onClick={() => procesarDatastage(item, setDatastages, setSuccess, showMessage, setRegistrosCargados, setShowRegistrosModal)}
                                                 className={`inline-flex items-center justify-center w-9 h-9 rounded-lg border transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-offset-1 ${item.procesado ? 'bg-gray-100 border-gray-200 cursor-not-allowed opacity-50' : 'bg-green-50 border-green-200 hover:bg-green-100 hover:border-green-300 focus:ring-green-500 cursor-pointer'}`}
                                                 title={item.procesado ? 'Ya procesado' : 'Procesar'}
                                                 disabled={item.procesado}
@@ -516,7 +527,8 @@ export default function Datastage() {
                                                     title="Descargar archivo"
                                                     onClick={() => downloadDatastageFile(
                                                         item.id,
-                                                        (() => { try { const url = new URL(item.download_url); return decodeURIComponent(url.pathname.split('/').pop() || ''); } catch { return ''; } })()
+                                                        (() => { try { const url = new URL(item.download_url); return decodeURIComponent(url.pathname.split('/').pop() || ''); } catch { return ''; } })(),
+                                                        showMessage
                                                     )}
                                                 >
                                                     <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
@@ -555,7 +567,7 @@ export default function Datastage() {
                                             <svg className="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M6 18L18 6M6 6l12 12" /></svg>
                                         </button>
                                         <button
-                                            onClick={() => procesarDatastage(item, setDatastages, setSuccess, setError, setRegistrosCargados, setShowRegistrosModal)}
+                                            onClick={() => procesarDatastage(item, setDatastages, setSuccess, showMessage, setRegistrosCargados, setShowRegistrosModal)}
                                             className={`inline-flex items-center justify-center w-9 h-9 rounded-lg border transition-all duration-200 focus:outline-none focus:ring-2 focus:ring-offset-1 ${item.procesado ? 'bg-gray-100 border-gray-200 cursor-not-allowed opacity-50' : 'bg-green-50 border-green-200 hover:bg-green-100 hover:border-green-300 focus:ring-green-500 cursor-pointer'}`}
                                             title={item.procesado ? 'Ya procesado' : 'Procesar'}
                                             disabled={item.procesado}

src/pages/Expedientes.jsx

@@ -55,7 +55,8 @@ export default function Documents() {
   const [expedienteFilter, setExpedienteFilter] = useState('all'); // all, true, false
   const [contribuyenteFilter, setContribuyenteFilter] = useState('');
   const [contribuyenteInput, setContribuyenteInput] = useState('');
-  const [fechaPagoFilter, setFechaPagoFilter] = useState('');
+  const [fechaInicioFilter, setFechaInicioFilter] = useState('');
+  const [fechaFinFilter, setFechaFinFilter] = useState('');
   const [pedimentoFilter, setPedimentoFilter] = useState('');
   const [searchFilter, setSearchFilter] = useState('');
   const [curpApoderadoFilter, setCurpApoderadoFilter] = useState('');
@@ -63,6 +64,8 @@ export default function Documents() {
   const [aduanaFilter, setAduanaFilter] = useState('');
   const [tipoOperacionFilter, setTipoOperacionFilter] = useState('');
   const [clavePedimentoFilter, setClavePedimentoFilter] = useState('');
+  const [sortField, setSortField] = useState('created_at');
+  const [sortDir, setSortDir] = useState('desc');
   const { showMessage } = useNotification();
   
   // Estados para selección múltiple
@@ -105,18 +108,20 @@ export default function Documents() {
 
   // Fetching usando la función tipada de TypeScript
   const fetchPedimentosData = async (page = currentPage, pageSize = itemsPerPage) => {
-    // Construir objeto de filtros
+    const ordering = sortDir === 'desc' ? `-${sortField}` : sortField;
     const filters = {
       search: searchFilter || undefined,
-      pedimento_app: pedimentoFilter || undefined, 
+      pedimento_app: pedimentoFilter || undefined,
       existe_expediente: expedienteFilter === 'all' ? undefined : expedienteFilter,
       contribuyente: contribuyenteFilter || undefined,
       curp_apoderado: curpApoderadoFilter || undefined,
-      fecha_pago: fechaPagoFilter || undefined,
+      fecha_pago_desde: fechaInicioFilter || undefined,
+      fecha_pago_hasta: fechaFinFilter || undefined,
       patente: patenteFilter || undefined,
       aduana: aduanaFilter || undefined,
       tipo_operacion: tipoOperacionFilter || undefined,
       clave_pedimento: clavePedimentoFilter || undefined,
+      ordering,
     };
     return await fetchDocuments(page, pageSize, filters);
   };
@@ -125,7 +130,7 @@ export default function Documents() {
   const { data: pedimentos, loading, error, refetch } = usePolling(
     () => fetchPedimentosData(currentPage, itemsPerPage),
     30000, // 30 segundos
-    [currentPage, itemsPerPage, searchFilter, pedimentoFilter, expedienteFilter, alertaFilter, contribuyenteFilter, curpApoderadoFilter, fechaPagoFilter, patenteFilter, aduanaFilter, tipoOperacionFilter, clavePedimentoFilter]
+    [currentPage, itemsPerPage, searchFilter, pedimentoFilter, expedienteFilter, alertaFilter, contribuyenteFilter, curpApoderadoFilter, fechaInicioFilter, fechaFinFilter, patenteFilter, aduanaFilter, tipoOperacionFilter, clavePedimentoFilter, sortField, sortDir]
   );
 
   // Manejo de errores de sesión
@@ -810,13 +815,80 @@ const downloadExpediente = async (pedimentoId, pedimentoName, setSuccess, showMe
   expedienteFilter !== 'all',
   contribuyenteFilter,
   curpApoderadoFilter,
-  fechaPagoFilter,
+  fechaInicioFilter,
+  fechaFinFilter,
   patenteFilter,
   aduanaFilter,
   tipoOperacionFilter,
   clavePedimentoFilter,
 ].some(Boolean);
 
+  const handleDescargarFiltroExcel = async () => {
+    const params = new URLSearchParams();
+    if (searchFilter)         params.append('search',          searchFilter);
+    if (pedimentoFilter)      params.append('pedimento_app',   pedimentoFilter);
+    if (expedienteFilter !== 'all') params.append('existe_expediente', expedienteFilter);
+    if (contribuyenteFilter)  params.append('contribuyente',   contribuyenteFilter);
+    if (curpApoderadoFilter)  params.append('curp_apoderado',  curpApoderadoFilter);
+    if (fechaInicioFilter)    params.append('fecha_pago_desde', fechaInicioFilter);
+    if (fechaFinFilter)       params.append('fecha_pago_hasta', fechaFinFilter);
+    if (patenteFilter)        params.append('patente',         patenteFilter);
+    if (aduanaFilter)         params.append('aduana',          aduanaFilter);
+    if (tipoOperacionFilter)  params.append('tipo_operacion',  tipoOperacionFilter);
+    if (clavePedimentoFilter) params.append('clave_pedimento', clavePedimentoFilter);
+
+    try {
+      showMessage('Generando Excel, por favor espera...', 'info');
+      const res = await fetchWithAuth(`${API_URL}/customs/pedimentos/export-excel/?${params.toString()}`);
+      if (!res.ok) {
+        showMessage('Error al generar el archivo Excel', 'error');
+        return;
+      }
+      const blob = await res.blob();
+      const url = window.URL.createObjectURL(blob);
+      const a = document.createElement('a');
+      a.href = url;
+      const hdr = res.headers.get('Content-Disposition') || '';
+      const match = hdr.match(/filename="([^"]+)"/);
+      a.download = match ? match[1] : 'pedimentos.xlsx';
+      a.click();
+      a.remove();
+      window.URL.revokeObjectURL(url);
+      showMessage('Excel descargado correctamente', 'success');
+    } catch (err) {
+      showMessage(err.message || 'Error al descargar el Excel', 'error');
+    }
+  };
+
+  const handleSort = (field) => {
+    if (sortField === field) {
+      setSortDir(prev => prev === 'asc' ? 'desc' : 'asc');
+    } else {
+      setSortField(field);
+      setSortDir('asc');
+    }
+    setCurrentPage(1);
+  };
+
+  const SortIcon = ({ field }) => {
+    if (sortField !== field) {
+      return (
+        <svg className="inline ml-1 w-3 h-3 text-gray-400 opacity-50" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M7 16V4m0 0L3 8m4-4l4 4M17 8v12m0 0l4-4m-4 4l-4-4" />
+        </svg>
+      );
+    }
+    return sortDir === 'asc' ? (
+      <svg className="inline ml-1 w-3 h-3 text-blue-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M5 15l7-7 7 7" />
+      </svg>
+    ) : (
+      <svg className="inline ml-1 w-3 h-3 text-blue-500" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 9l-7 7-7-7" />
+      </svg>
+    );
+  };
+
   // El layout principal y la tabla siempre se renderizan, loader/error/empty solo dentro del área de la tabla
 
   return (
@@ -975,11 +1047,33 @@ const downloadExpediente = async (pedimentoId, pedimentoName, setSuccess, showMe
                     className="w-full border border-gray-300 rounded-xl px-3 py-2.5 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 bg-white shadow-sm transition-all duration-200 hover:shadow-md"
                   />
                 </div>
-                {/* Fecha de pago */}
+                {/* Fecha de inicio */}
                 <div className="flex flex-col">
-                  <label className="text-xs font-semibold text-gray-700 mb-1.5">Fecha de pago</label>
+                  <label className="text-xs font-semibold text-gray-700 mb-1.5">Fecha de inicio</label>
-                  <input type="date" value={fechaPagoFilter} onChange={e => setFechaPagoFilter(e.target.value)}
+                  <input
-                    className="w-full border border-gray-300 rounded-xl px-3 py-2.5 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 bg-white shadow-sm transition-all duration-200 hover:shadow-md" />
+                    type="date"
+                    value={fechaInicioFilter}
+                    onChange={e => {
+                      setFechaInicioFilter(e.target.value);
+                      setCurrentPage(1);
+                    }}
+                    max={fechaFinFilter || undefined}
+                    className="w-full border border-gray-300 rounded-xl px-3 py-2.5 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 bg-white shadow-sm transition-all duration-200 hover:shadow-md"
+                  />
+                </div>
+                {/* Fecha de fin */}
+                <div className="flex flex-col">
+                  <label className="text-xs font-semibold text-gray-700 mb-1.5">Fecha de fin</label>
+                  <input
+                    type="date"
+                    value={fechaFinFilter}
+                    onChange={e => {
+                      setFechaFinFilter(e.target.value);
+                      setCurrentPage(1);
+                    }}
+                    min={fechaInicioFilter || undefined}
+                    className="w-full border border-gray-300 rounded-xl px-3 py-2.5 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500 focus:border-blue-500 bg-white shadow-sm transition-all duration-200 hover:shadow-md"
+                  />
                 </div>
                 {/* Patente */}
                 <div className="flex flex-col">
@@ -1134,14 +1228,23 @@ const downloadExpediente = async (pedimentoId, pedimentoName, setSuccess, showMe
                   </svg>
                   Actualizar Ahora
                 </button>
-                <button 
+                <button
-                  onClick={() => {handleDownloadSelected()}}
+                  onClick={() => handleDownloadSelected()}
                   className="inline-flex items-center px-4 py-2.5 border border-transparent text-sm font-medium rounded-xl text-white bg-gradient-to-r from-purple-600 to-purple-700 hover:from-purple-700 hover:to-purple-800 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-purple-500 transition-all duration-200 transform hover:scale-105 shadow-lg"
                 >
                   <svg className="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                     <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-4l-4 4m0 0l-4-4m4 4V4" />
                   </svg>
-                  {hasActiveFilters ? 'Descargar por Filtro' : 'Descargar Todos'}
+                  Descargar Expedientes
+                </button>
+                <button
+                  onClick={handleDescargarFiltroExcel}
+                  className="inline-flex items-center px-4 py-2.5 border border-transparent text-sm font-medium rounded-xl text-white bg-gradient-to-r from-green-600 to-green-700 hover:from-green-700 hover:to-green-800 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500 transition-all duration-200 transform hover:scale-105 shadow-lg"
+                >
+                  <svg className="w-4 h-4 mr-2" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 17v-2m3 2v-4m3 4v-6m2 10H7a2 2 0 01-2-2V5a2 2 0 012-2h5.586a1 1 0 01.707.293l5.414 5.414a1 1 0 01.293.707V19a2 2 0 01-2 2z" />
+                  </svg>
+                  {hasActiveFilters ? 'Descargar por Filtro' : 'Descargar Todos (Excel)'}
                 </button>
               </div>
             </div>
@@ -1176,12 +1279,49 @@ const downloadExpediente = async (pedimentoId, pedimentoName, setSuccess, showMe
                           className="w-4 h-4 text-blue-600 border-gray-300 rounded focus:ring-blue-500"
                         />
                       </th>
-                      <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Pedimento</th>
+                      <th
-                      <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Fecha Pago</th>
+                        scope="col"
+                        className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase cursor-pointer select-none hover:bg-gray-100 transition-colors"
+                        onClick={() => handleSort('pedimento')}
+                        title="Ordenar por pedimento"
+                      >
+                        Pedimento<SortIcon field="pedimento" />
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase cursor-pointer select-none hover:bg-gray-100 transition-colors"
+                        onClick={() => handleSort('fecha_pago')}
+                        title="Ordenar por fecha de pago"
+                      >
+                        Fecha Pago<SortIcon field="fecha_pago" />
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase cursor-pointer select-none hover:bg-gray-100 transition-colors"
+                        onClick={() => handleSort('aduana')}
+                        title="Ordenar por aduana"
+                      >
+                        Aduana<SortIcon field="aduana" />
+                      </th>
+                      <th
+                        scope="col"
+                        className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase cursor-pointer select-none hover:bg-gray-100 transition-colors"
+                        onClick={() => handleSort('patente')}
+                        title="Ordenar por patente"
+                      >
+                        Patente<SortIcon field="patente" />
+                      </th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Contribuyente</th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">CURP Apod.</th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Partidas</th>
-                      <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">F. Carga</th>
+                      <th
+                        scope="col"
+                        className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase cursor-pointer select-none hover:bg-gray-100 transition-colors"
+                        onClick={() => handleSort('created_at')}
+                        title="Ordenar por fecha de carga"
+                      >
+                        F. Carga<SortIcon field="created_at" />
+                      </th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Tipo Op.</th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Clave</th>
                       <th scope="col" className="px-4 py-2 text-xs font-medium tracking-wider text-left text-gray-500 uppercase">Archivos</th>
@@ -1233,6 +1373,8 @@ const downloadExpediente = async (pedimentoId, pedimentoName, setSuccess, showMe
                             </Link>
                           </td>
                           <td className="px-4 py-3 text-xs text-gray-900 whitespace-nowrap">{ped.fecha_pago}</td>
+                          <td className="px-4 py-3 text-xs text-gray-900 whitespace-nowrap">{ped.aduana ?? '—'}</td>
+                          <td className="px-4 py-3 text-xs text-gray-900 whitespace-nowrap">{ped.patente ?? '—'}</td>
                           <td className="max-w-xs px-4 py-3 text-xs text-gray-900 truncate" title={ped.contribuyente}>{ped.contribuyente}</td>
                           <td className="px-4 py-3 text-xs text-gray-900 whitespace-nowrap">{ped.curp_apoderado}</td>
                           <td className="px-4 py-3 text-xs text-gray-900 whitespace-nowrap">{ped.numero_partidas}</td>

src/pages/Login.jsx

@@ -23,11 +23,12 @@ export default function Login() {
       const apiUrl = import.meta.env.VITE_EFC_API_URL || '';
       const token = data.access;
       try {
-        const res = await fetch(`${apiUrl}/user/users/me/`, {
+        const [resUser, resPerms] = await Promise.all([
-          headers: { 'Authorization': `Bearer ${token}` }
+          fetch(`${apiUrl}/user/users/me/`, { headers: { 'Authorization': `Bearer ${token}` } }),
-        });
+          fetch(`${apiUrl}/rbac/my-permissions/`, { headers: { 'Authorization': `Bearer ${token}` } }),
-        if (res.ok) {
+        ]);
-          const user = await res.json();
+        if (resUser.ok) {
+          const user = await resUser.json();
           if (user && user.username) {
             localStorage.setItem('username', user.username);
             if (user.email) localStorage.setItem('user_email', user.email);
@@ -38,6 +39,12 @@ export default function Login() {
             if (typeof user.is_importador !== 'undefined') localStorage.setItem('user_is_importador', String(user.is_importador));
           }
         }
+        if (resPerms.ok) {
+          const permsData = await resPerms.json();
+          if (permsData && permsData.permissions) {
+            localStorage.setItem('user_permissions', JSON.stringify(permsData.permissions));
+          }
+        }
       } catch (e) {
         // Si falla, continuar igual
         console.error('No se pudo guardar info de usuario en localStorage', e);

src/pages/PedimentoDetail.jsx

@@ -136,7 +136,9 @@ export default function PedimentoDetail() {
   const [isSelectAllDocs, setIsSelectAllDocs] = useState(false);
   const [showDeleteModal, setShowDeleteModal] = useState(false);
   const [showUploadModal, setShowUploadModal] = useState(false);
-  
+  const [headerUploadTypeId, setHeaderUploadTypeId] = useState(null);
+  const [headerUploadNumero, setHeaderUploadNumero] = useState('');
+
   // Estados para subir documentos
   const [selectedFiles, setSelectedFiles] = useState([]);
   const [uploadingDocuments, setUploadingDocuments] = useState(false);
@@ -983,7 +985,12 @@ const handleDeleteSelectedPedimentoDocuments = async () => {
       
       // Agregar el ID del pedimento
       formData.append('pedimento_id', id);
-      
+
+      // Tipo de documento específico si la subida viene del header de una sección
+      if (headerUploadTypeId) {
+        formData.append('document_type_id', headerUploadTypeId);
+      }
+
       // Agregar archivos al FormData
       selectedFiles.forEach((file) => {
         formData.append('files', file);
@@ -1001,6 +1008,7 @@ const handleDeleteSelectedPedimentoDocuments = async () => {
       // Limpiar archivos seleccionados y cerrar modal
       setSelectedFiles([]);
       setShowUploadModal(false);
+      setHeaderUploadTypeId(null);
 
       // Forzar recarga de documentos
       const currentPage = page;
@@ -2815,7 +2823,7 @@ const handleDeleteSelectedPedimentoDocuments = async () => {
         return;
       }
      
-      const result = await postFormDataWithAuth(`${API_URL}/record/documents/bulk-upload-vu/`, formData);
+      const result = await postFormDataWithAuth(`${API_URL}/record/documents/bulk-upload/`, formData);
 
       if(!result.ok){
         const errorData = await result.json();
@@ -2840,7 +2848,7 @@ const handleDeleteSelectedPedimentoDocuments = async () => {
     }catch (error){
       showMessage(`Error durante la subida: ${error.message}`, 'error');
     } finally {
-      
+
       // Limpiar y cerrar
       setSelectedDocumentForUpload(null);
       setUploadFiles([]);
@@ -2855,6 +2863,62 @@ const isPartida = selectedDocumentForUpload?.tab === 'partida';
 const isCove = selectedDocumentForUpload?.tab === 'cove';
 const isEdoc = selectedDocumentForUpload?.tab === 'edoc';
 
+  // Función para crear un registro VU nuevo (partida/cove/edoc) y subir sus archivos
+  const handleCreateVuRecord = async () => {
+    const tab = selectedDocumentForUpload?.tab;
+    if (!tab || !headerUploadNumero.trim() || uploadFiles.length === 0) {
+      showMessage('Por favor completa el número y selecciona al menos un archivo', 'warning');
+      return;
+    }
+
+    setUploadingToDocumento('header-upload');
+
+    try {
+      const formData = new FormData();
+      formData.append('pedimento_id', id);
+      formData.append('tab_seccion', tab);
+      formData.append('numero', headerUploadNumero.trim());
+
+      uploadFiles.forEach((fileObj, index) => {
+        formData.append('files', fileObj.file);
+        formData.append(`secciones[${index}]`, fileObj.seccion);
+      });
+
+      const result = await postFormDataWithAuth(`${API_URL}/record/documents/create-vu-record/`, formData);
+
+      if (!result.ok) {
+        const errorData = await result.json();
+        throw new Error(errorData.error || 'Error desconocido');
+      }
+
+      const data = await result.json();
+      showMessage(data.message || 'Registro creado exitosamente', 'success');
+
+      // Recargar la tabla correspondiente
+      if (tab === 'partida') {
+        fetchPedimentoPartidas(partidasPage, partidasPageSize, partidasFilters)
+          .then((d) => { setPartidas(d.results || []); setPartidasCount(d.count || 0); })
+          .catch(err => console.error('Error recargando partidas:', err));
+      } else if (tab === 'cove') {
+        fetchPedimentoCoves && fetchPedimentoCoves(covesPage, covesPageSize, covesFilters)
+          .then((d) => { setCoves(d.results || []); setCovesCount(d.count || 0); })
+          .catch(err => console.error('Error recargando coves:', err));
+      } else if (tab === 'edoc') {
+        fetchPedimentoEdocs && fetchPedimentoEdocs(edocsPage, edocsPageSize, edocsFilters)
+          .then((d) => { setEdocs(d.results || []); setEdocsCount(d.count || 0); })
+          .catch(err => console.error('Error recargando edocs:', err));
+      }
+    } catch (error) {
+      showMessage(`Error: ${error.message}`, 'error');
+    } finally {
+      setSelectedDocumentForUpload(null);
+      setUploadFiles([]);
+      setUploadModalOpen(false);
+      setHeaderUploadNumero('');
+      setUploadingToDocumento(null);
+    }
+  };
+
  // Estados para documentos de errores VU
 const [errorDocuments, setErrorDocuments] = useState([]);
 const [errorDocsCount, setErrorDocsCount] = useState(0);
@@ -4324,7 +4388,24 @@ useEffect(() => {
                       {partidasCount} partidas
                     </span>
                   </div>
-                  
+
+                  <div className="flex items-center gap-2">
+                    <button
+                      onClick={() => {
+                        setSelectedDocumentForUpload({ tab: 'partida', numero: '', pedimento: id, id: 'header-upload', isHeaderUpload: true });
+                        setUploadFiles([]);
+                        setHeaderUploadNumero('');
+                        setUploadModalOpen(true);
+                      }}
+                      className="inline-flex items-center justify-center px-3 py-2 text-sm font-medium leading-4 text-white bg-green-600 border border-transparent rounded-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500"
+                    >
+                      <svg className="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-8l-4-4m0 0L8 8m4-4v12" />
+                      </svg>
+                      Subir Documentos
+                    </button>
+                  </div>
+
                   {/* Botones de acción masiva */}
                   {/* <div className="flex items-center space-x-3">
                     {selectedPartidas.length > 0 && (
@@ -4811,6 +4892,23 @@ useEffect(() => {
                       {covesCount} COVEs
                     </span>
                   </div>
+
+                  <div className="flex items-center gap-2">
+                    <button
+                      onClick={() => {
+                        setSelectedDocumentForUpload({ tab: 'cove', numero: '', pedimento: id, id: 'header-upload', isHeaderUpload: true });
+                        setUploadFiles([]);
+                        setHeaderUploadNumero('');
+                        setUploadModalOpen(true);
+                      }}
+                      className="inline-flex items-center justify-center px-3 py-2 text-sm font-medium leading-4 text-white bg-green-600 border border-transparent rounded-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500"
+                    >
+                      <svg className="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-8l-4-4m0 0L8 8m4-4v12" />
+                      </svg>
+                      Subir Documentos
+                    </button>
+                  </div>
                 </div>
 
                 {/* Botones para descargar todos los AcuseCoves y COVEs */}
@@ -5265,6 +5363,21 @@ useEffect(() => {
                       {edocsCount} EDocs
                     </span>
                   </div>
+
+                  <button
+                    onClick={() => {
+                      setSelectedDocumentForUpload({ tab: 'edoc', numero: '', pedimento: id, id: 'header-upload', isHeaderUpload: true });
+                      setUploadFiles([]);
+                      setHeaderUploadNumero('');
+                      setUploadModalOpen(true);
+                    }}
+                    className="inline-flex items-center justify-center px-3 py-2 text-sm font-medium leading-4 text-white bg-green-600 border border-transparent rounded-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500"
+                  >
+                    <svg className="w-4 h-4 mr-1.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                      <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M4 16v1a3 3 0 003 3h10a3 3 0 003-3v-1m-4-8l-4-4m0 0L8 8m4-4v12" />
+                    </svg>
+                    Subir Documentos
+                  </button>
                 </div>
 
                 {/* Filtros */}
@@ -6947,6 +7060,7 @@ useEffect(() => {
                 onClick={() => {
                   setShowUploadModal(false);
                   setSelectedFiles([]);
+                  setHeaderUploadTypeId(null);
                 }}
                 className="px-4 py-2 text-sm font-medium text-gray-700 transition-colors duration-200 bg-white border border-gray-300 rounded-lg hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500"
               >
@@ -7158,15 +7272,34 @@ useEffect(() => {
             <div className="relative w-full max-w-md p-6 bg-white rounded-lg shadow-xl">
               <div className="mb-4">
                 <h3 className="text-lg font-medium leading-6 text-gray-900">
-                  Subir documentos a {selectedDocumentForUpload.tab}: {selectedDocumentForUpload.numero}
+                  {selectedDocumentForUpload.isHeaderUpload
+                    ? `Nuevo ${selectedDocumentForUpload.tab === 'partida' ? 'Partida' : selectedDocumentForUpload.tab === 'cove' ? 'COVE' : 'EDoc'}`
+                    : `Subir documentos a ${selectedDocumentForUpload.tab}: ${selectedDocumentForUpload.numero}`}
                 </h3>
                 <p className="mt-1 text-sm text-gray-500">
-                  Selecciona los archivos que deseas subir
+                  {selectedDocumentForUpload.isHeaderUpload
+                    ? 'Se creará el registro y se subirán los archivos'
+                    : 'Selecciona los archivos que deseas subir'}
                 </p>
               </div>
 
               {/* Selectores específicos por tipo de archivo */}
               <div className="space-y-4">
+                {/* Input de número para header upload */}
+                {selectedDocumentForUpload.isHeaderUpload && (
+                  <div>
+                    <label className="block mb-2 text-sm font-medium text-gray-700">
+                      {isPartida ? 'Número de partida' : isCove ? 'Número de COVE' : 'Número de EDoc'}
+                    </label>
+                    <input
+                      type="text"
+                      value={headerUploadNumero}
+                      onChange={(e) => setHeaderUploadNumero(e.target.value)}
+                      placeholder={isPartida ? 'Ej. 1' : isCove ? 'Ej. CV-2024-001' : 'Ej. ED-2024-001'}
+                      className="block w-full px-3 py-2 text-sm text-gray-700 bg-white border border-gray-300 rounded-md shadow-sm focus:outline-none focus:ring-blue-500 focus:border-blue-500"
+                    />
+                  </div>
+                )}
                 {/* Primer selector para COVE (XML solo para partida y cove) */}
                 {(isPartida || isCove) && (
                 <div>
@@ -7256,14 +7389,23 @@ useEffect(() => {
                     setUploadModalOpen(false);
                     setShowUploadModal(false);
                     setSelectedFiles([]);
+                    setHeaderUploadNumero('');
                   }}
                   className="px-4 py-2 text-sm font-medium text-gray-700 bg-white border border-gray-300 rounded-md shadow-sm hover:bg-gray-50 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500"
                 >
                   Cancelar
                 </button>
                 <button
-                  onClick={() => {handleUploadFilesToDocumento(selectedDocumentForUpload.tab)}}
+                  onClick={() => {
-                  disabled={uploadFiles.length === 0 || uploadingToDocumento === selectedDocumentForUpload.id}
+                    selectedDocumentForUpload.isHeaderUpload
+                      ? handleCreateVuRecord()
+                      : handleUploadFilesToDocumento(selectedDocumentForUpload.tab);
+                  }}
+                  disabled={
+                    uploadFiles.length === 0 ||
+                    uploadingToDocumento === selectedDocumentForUpload.id ||
+                    (selectedDocumentForUpload.isHeaderUpload && !headerUploadNumero.trim())
+                  }
                   className="inline-flex justify-center px-4 py-2 text-sm font-medium text-white bg-blue-600 border border-transparent rounded-md shadow-sm hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500 disabled:opacity-50 disabled:cursor-not-allowed"
                 >
                   {uploadingToDocumento === selectedDocumentForUpload.id ? (

src/pages/ProfileForm.jsx

@@ -0,0 +1,416 @@
+import React, { useEffect, useState } from 'react';
+import { useNavigate, useParams } from 'react-router-dom';
+import {
+  getRole,
+  createRole,
+  updateRole,
+  fetchPermissionsByModule,
+} from '../api/rbac';
+import { useNotification } from '../context/NotificationContext';
+
+// Nombres legibles de módulos para la UI
+const MODULE_LABELS = {
+  usuarios:       'Usuarios',
+  pedimentos:     'Pedimentos',
+  partidas:       'Partidas',
+  remesas:        'Remesas',
+  coves:          'COVEs',
+  edocuments:     'E-Documents',
+  acuses:         'Acuses',
+  documentos:     'Documentos',
+  vucem:          'Ventanilla Única (VUCEM)',
+  reportes:       'Reportes',
+  datastage:      'DataStage',
+  organizacion:   'Organización',
+  notificaciones: 'Notificaciones',
+  cards:          'Dashboard / Cards',
+};
+
+export default function ProfileForm() {
+  const { id } = useParams();
+  const isEditing = Boolean(id);
+  const navigate = useNavigate();
+  const { showMessage } = useNotification();
+
+  const [name, setName] = useState('');
+  const [description, setDescription] = useState('');
+  const [isAdminRole, setIsAdminRole] = useState(false);
+
+  // Permisos de la API: { modulo: [{ id, codename, descripcion, modulo }] }
+  const [permsByModule, setPermsByModule] = useState({});
+  const [loadingPerms, setLoadingPerms] = useState(true);
+
+  // IDs numéricos de permisos seleccionados
+  const [selectedPermIds, setSelectedPermIds] = useState(new Set());
+
+  const [loadingRole, setLoadingRole] = useState(isEditing);
+  const [submitting, setSubmitting] = useState(false);
+
+  useEffect(() => {
+    if (typeof window !== 'undefined' && !document.getElementById('profiles-animations')) {
+      const style = document.createElement('style');
+      style.id = 'profiles-animations';
+      style.innerHTML = `
+        @keyframes fadeInUpProfiles {
+          0% { opacity: 0; transform: translateY(24px); }
+          100% { opacity: 1; transform: translateY(0); }
+        }
+        .fade-in-up-profiles { animation: fadeInUpProfiles 0.6s cubic-bezier(0.22, 1, 0.36, 1) both; }
+        @keyframes bounce-slow {
+          0%, 100% { transform: translateY(0); }
+          50% { transform: translateY(-8px); }
+        }
+        .animate-bounce-slow { animation: bounce-slow 2.2s infinite; }
+      `;
+      document.head.appendChild(style);
+    }
+  }, []);
+
+  // Cargar catálogo de permisos desde API
+  useEffect(() => {
+    fetchPermissionsByModule()
+      .then(data => {
+        setPermsByModule(data && typeof data === 'object' ? data : {});
+      })
+      .catch(() => showMessage('Error al cargar catálogo de permisos', 'error'))
+      .finally(() => setLoadingPerms(false));
+  }, []);
+
+  // Cargar datos del rol si es edición
+  useEffect(() => {
+    if (!isEditing) return;
+    getRole(id)
+      .then(role => {
+        setName(role.nombre || '');
+        setDescription(role.descripcion || '');
+        setIsAdminRole(role.is_admin_role || false);
+
+        // Permisos vienen como [{ id, codename, descripcion, modulo }]
+        const permList = Array.isArray(role.permissions) ? role.permissions : [];
+        setSelectedPermIds(new Set(permList.map(p => p.id)));
+        setLoadingRole(false);
+      })
+      .catch(err => {
+        showMessage(err.message || 'Error al cargar perfil', 'error');
+        setLoadingRole(false);
+      });
+  }, [id, isEditing]);
+
+  // Módulos en el orden en que llegan de la API
+  const modules = Object.keys(permsByModule);
+
+  const togglePerm = (permId) => {
+    setSelectedPermIds(prev => {
+      const next = new Set(prev);
+      if (next.has(permId)) next.delete(permId);
+      else next.add(permId);
+      return next;
+    });
+  };
+
+  const toggleModule = (module) => {
+    const moduleIds = (permsByModule[module] || []).map(p => p.id);
+    const allSelected = moduleIds.every(id => selectedPermIds.has(id));
+    setSelectedPermIds(prev => {
+      const next = new Set(prev);
+      if (allSelected) {
+        moduleIds.forEach(id => next.delete(id));
+      } else {
+        moduleIds.forEach(id => next.add(id));
+      }
+      return next;
+    });
+  };
+
+  const totalPerms = modules.reduce((acc, m) => acc + (permsByModule[m]?.length ?? 0), 0);
+
+  const selectAll = () => {
+    const all = modules.flatMap(m => (permsByModule[m] || []).map(p => p.id));
+    setSelectedPermIds(new Set(all));
+  };
+
+  const clearAll = () => setSelectedPermIds(new Set());
+
+  const handleSubmit = async (e) => {
+    e.preventDefault();
+    if (!name.trim()) {
+      showMessage('El nombre del perfil es obligatorio', 'error');
+      return;
+    }
+    setSubmitting(true);
+    try {
+      const payload = {
+        nombre: name.trim(),
+        descripcion: description.trim(),
+        permission_ids: [...selectedPermIds],
+      };
+
+      if (isEditing) {
+        await updateRole(id, payload);
+        showMessage('Perfil actualizado correctamente', 'success');
+      } else {
+        await createRole(payload);
+        showMessage('Perfil creado correctamente', 'success');
+      }
+      navigate('/profiles');
+    } catch (err) {
+      showMessage(err.message || 'Error al guardar perfil', 'error');
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  if (loadingRole) {
+    return (
+      <div className="min-h-screen p-4 sm:p-6 bg-gradient-to-br from-gray-50 to-blue-50 flex items-center justify-center">
+        <div className="animate-spin rounded-full h-12 w-12 border-b-2 border-indigo-600" />
+      </div>
+    );
+  }
+
+  return (
+    <div className="min-h-screen p-4 sm:p-6 bg-gradient-to-br from-gray-50 to-blue-50">
+      <div className="max-w-4xl mx-auto">
+
+        {/* Header */}
+        <div className="mb-8 relative overflow-hidden rounded-2xl shadow bg-gradient-to-r from-indigo-600 via-indigo-700 to-indigo-800 border border-indigo-200 p-6 sm:p-8 flex flex-col sm:flex-row items-start sm:items-center gap-4 sm:gap-6 fade-in-up-profiles">
+          <div className="flex-shrink-0 bg-white/20 backdrop-blur-sm rounded-full p-3 sm:p-4 shadow-lg animate-bounce-slow">
+            <svg className="h-8 w-8 sm:h-10 sm:w-10 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
+            </svg>
+          </div>
+          <div className="flex-1">
+            <h1 className="text-2xl sm:text-3xl font-extrabold text-white tracking-tight mb-1">
+              {isEditing ? 'Editar Perfil' : 'Nuevo Perfil'}
+            </h1>
+            <p className="text-sm sm:text-base text-white/80 font-medium">
+              {isEditing ? `Editando: ${name}` : 'Define nombre y permisos del nuevo perfil'}
+            </p>
+          </div>
+          <button
+            type="button"
+            onClick={() => navigate('/profiles')}
+            className="flex-shrink-0 inline-flex items-center gap-2 px-4 py-2 bg-white/20 hover:bg-white/30 text-white text-sm font-medium rounded-lg border border-white/30 transition-all duration-200"
+          >
+            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M10 19l-7-7m0 0l7-7m-7 7h18" />
+            </svg>
+            Regresar
+          </button>
+          <div className="absolute -top-10 -right-10 opacity-20 pointer-events-none select-none">
+            <svg width="120" height="120" viewBox="0 0 120 120" fill="none">
+              <circle cx="60" cy="60" r="50" fill="white" fillOpacity="0.15" />
+            </svg>
+          </div>
+        </div>
+
+        <form onSubmit={handleSubmit} className="space-y-6">
+
+          {/* Datos del perfil */}
+          <div className="bg-white rounded-2xl shadow-lg border border-gray-100 p-6 fade-in-up-profiles" style={{ animationDelay: '0.05s' }}>
+            <div className="flex items-center mb-4 pb-3 border-b border-gray-200">
+              <div className="bg-indigo-600 rounded-lg p-2 mr-3 shadow-sm">
+                <svg className="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M7 7h.01M7 3h5c.512 0 1.024.195 1.414.586l7 7a2 2 0 010 2.828l-7 7a2 2 0 01-2.828 0l-7-7A1.994 1.994 0 013 12V7a4 4 0 014-4z" />
+                </svg>
+              </div>
+              <div>
+                <h4 className="text-sm font-semibold text-slate-800">Datos del perfil</h4>
+                <p className="text-xs text-slate-500">Identifica el perfil dentro de la organización</p>
+              </div>
+            </div>
+            <div className="grid grid-cols-1 sm:grid-cols-2 gap-4 max-w-2xl">
+              <div className="space-y-1">
+                <label className="block text-xs font-semibold text-slate-700">
+                  Nombre <span className="text-red-600">*</span>
+                </label>
+                <input
+                  type="text"
+                  value={name}
+                  onChange={e => setName(e.target.value)}
+                  required
+                  disabled={isAdminRole}
+                  placeholder="Ej. Operador de VUCEM"
+                  className="w-full px-3 py-2 border border-slate-300 rounded-md shadow-sm focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-all bg-white text-slate-900 placeholder-slate-400 text-sm disabled:bg-slate-100 disabled:text-slate-500"
+                />
+                {isAdminRole && (
+                  <p className="text-xs text-amber-600 flex items-center gap-1 mt-1">
+                    <svg className="w-3 h-3" fill="currentColor" viewBox="0 0 24 24">
+                      <path d="M12 2l2.09 6.26L20 10l-5 4.87L16.18 22 12 18.77 7.82 22 9 14.87 4 10l5.91-1.74z" />
+                    </svg>
+                    Perfil de administrador — el nombre es fijo
+                  </p>
+                )}
+              </div>
+              <div className="space-y-1">
+                <label className="block text-xs font-semibold text-slate-700">Descripción</label>
+                <input
+                  type="text"
+                  value={description}
+                  onChange={e => setDescription(e.target.value)}
+                  placeholder="Descripción opcional del perfil"
+                  className="w-full px-3 py-2 border border-slate-300 rounded-md shadow-sm focus:ring-2 focus:ring-indigo-500 focus:border-indigo-500 transition-all bg-white text-slate-900 placeholder-slate-400 text-sm"
+                />
+              </div>
+            </div>
+          </div>
+
+          {/* Permisos */}
+          <div className="bg-white rounded-2xl shadow-lg border border-gray-100 p-6 fade-in-up-profiles" style={{ animationDelay: '0.1s' }}>
+            <div className="flex items-center justify-between mb-4 pb-3 border-b border-gray-200">
+              <div className="flex items-center">
+                <div className="bg-indigo-600 rounded-lg p-2 mr-3 shadow-sm">
+                  <svg className="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                  </svg>
+                </div>
+                <div>
+                  <h4 className="text-sm font-semibold text-slate-800">Permisos</h4>
+                  <p className="text-xs text-slate-500">
+                    {loadingPerms
+                      ? 'Cargando catálogo…'
+                      : `${selectedPermIds.size} de ${totalPerms} permisos seleccionados`}
+                  </p>
+                </div>
+              </div>
+              {!loadingPerms && (
+                <div className="flex gap-2">
+                  <button
+                    type="button"
+                    onClick={selectAll}
+                    className="px-2.5 py-1 text-xs font-medium text-indigo-700 bg-indigo-50 hover:bg-indigo-100 rounded-md border border-indigo-200 transition-colors"
+                  >
+                    Todos
+                  </button>
+                  <button
+                    type="button"
+                    onClick={clearAll}
+                    className="px-2.5 py-1 text-xs font-medium text-slate-600 bg-slate-50 hover:bg-slate-100 rounded-md border border-slate-200 transition-colors"
+                  >
+                    Ninguno
+                  </button>
+                </div>
+              )}
+            </div>
+
+            {loadingPerms ? (
+              <div className="flex items-center justify-center py-10">
+                <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-indigo-600" />
+              </div>
+            ) : modules.length === 0 ? (
+              <div className="text-center py-10 text-slate-400 text-sm">
+                No se pudo cargar el catálogo de permisos
+              </div>
+            ) : (
+              <div className="space-y-5">
+                {modules.map(module => {
+                  const modulePerms = permsByModule[module] || [];
+                  const selectedCount = modulePerms.filter(p => selectedPermIds.has(p.id)).length;
+                  const allSelected = selectedCount === modulePerms.length && modulePerms.length > 0;
+                  const someSelected = selectedCount > 0 && !allSelected;
+
+                  return (
+                    <div key={module} className="border border-slate-100 rounded-xl overflow-hidden">
+                      {/* Cabecera módulo */}
+                      <div
+                        className={`flex items-center justify-between px-4 py-2.5 cursor-pointer select-none transition-colors ${
+                          allSelected ? 'bg-indigo-50' : someSelected ? 'bg-slate-50' : 'bg-slate-50/50'
+                        }`}
+                        onClick={() => toggleModule(module)}
+                      >
+                        <div className="flex items-center gap-2">
+                          <div className={`w-4 h-4 rounded border-2 flex items-center justify-center flex-shrink-0 transition-colors ${
+                            allSelected
+                              ? 'bg-indigo-600 border-indigo-600'
+                              : someSelected
+                                ? 'bg-indigo-200 border-indigo-400'
+                                : 'bg-white border-slate-300'
+                          }`}>
+                            {allSelected && (
+                              <svg className="w-2.5 h-2.5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="3" d="M5 13l4 4L19 7" />
+                              </svg>
+                            )}
+                            {someSelected && (
+                              <div className="w-1.5 h-0.5 bg-indigo-600 rounded" />
+                            )}
+                          </div>
+                          <span className="text-sm font-semibold text-slate-700">
+                            {MODULE_LABELS[module] ?? module}
+                          </span>
+                        </div>
+                        <span className="text-xs text-slate-400 font-mono">
+                          {selectedCount}/{modulePerms.length}
+                        </span>
+                      </div>
+
+                      {/* Permisos del módulo */}
+                      <div className="grid grid-cols-2 sm:grid-cols-3 gap-px bg-slate-100">
+                        {modulePerms.map(perm => {
+                          const active = selectedPermIds.has(perm.id);
+                          return (
+                            <button
+                              key={perm.id}
+                              type="button"
+                              onClick={() => togglePerm(perm.id)}
+                              className={`flex items-center gap-2 px-3 py-2 text-left transition-colors duration-100 ${
+                                active ? 'bg-indigo-50' : 'bg-white hover:bg-slate-50'
+                              }`}
+                            >
+                              <div className={`w-3.5 h-3.5 rounded border flex items-center justify-center flex-shrink-0 transition-colors ${
+                                active ? 'bg-indigo-600 border-indigo-600' : 'bg-white border-slate-300'
+                              }`}>
+                                {active && (
+                                  <svg className="w-2 h-2 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="3" d="M5 13l4 4L19 7" />
+                                  </svg>
+                                )}
+                              </div>
+                              <span
+                                className={`text-xs truncate ${active ? 'text-indigo-800 font-medium' : 'text-slate-600'}`}
+                                title={perm.descripcion}
+                              >
+                                {perm.descripcion}
+                              </span>
+                            </button>
+                          );
+                        })}
+                      </div>
+                    </div>
+                  );
+                })}
+              </div>
+            )}
+          </div>
+
+          {/* Botones */}
+          <div className="flex flex-col sm:flex-row justify-end gap-3 pb-8 fade-in-up-profiles" style={{ animationDelay: '0.15s' }}>
+            <button
+              type="button"
+              onClick={() => navigate('/profiles')}
+              disabled={submitting}
+              className="w-full sm:w-auto px-6 py-2.5 border border-slate-300 rounded-lg shadow-sm text-sm font-semibold text-slate-700 bg-white hover:bg-slate-50 transition-all duration-200 disabled:opacity-50"
+            >
+              Cancelar
+            </button>
+            <button
+              type="submit"
+              disabled={submitting || loadingPerms}
+              className="w-full sm:w-auto px-6 py-2.5 rounded-lg shadow-lg text-sm font-semibold text-white bg-gradient-to-r from-indigo-600 to-indigo-800 hover:from-indigo-700 hover:to-indigo-900 transition-all duration-200 flex items-center justify-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
+            >
+              {submitting && <div className="animate-spin rounded-full h-4 w-4 border-b-2 border-white" />}
+              <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d={isEditing ? 'M5 13l4 4L19 7' : 'M12 6v6m0 0v6m0-6h6m-6 0H6'} />
+              </svg>
+              <span>
+                {submitting
+                  ? (isEditing ? 'Guardando...' : 'Creando...')
+                  : (isEditing ? 'Guardar cambios' : 'Crear perfil')}
+              </span>
+            </button>
+          </div>
+        </form>
+      </div>
+    </div>
+  );
+}

src/pages/Profiles.jsx

@@ -0,0 +1,275 @@
+import React, { useEffect, useState } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { fetchRoles, deleteRole } from '../api/rbac';
+import { useNotification } from '../context/NotificationContext';
+
+export default function Profiles() {
+  const [roles, setRoles] = useState([]);
+  const [loading, setLoading] = useState(true);
+  const [searchTerm, setSearchTerm] = useState('');
+  const [showDeleteModal, setShowDeleteModal] = useState(false);
+  const [roleToDelete, setRoleToDelete] = useState(null);
+  const [deleting, setDeleting] = useState(false);
+  const navigate = useNavigate();
+  const { showMessage } = useNotification();
+
+  useEffect(() => {
+    if (typeof window !== 'undefined' && !document.getElementById('profiles-animations')) {
+      const style = document.createElement('style');
+      style.id = 'profiles-animations';
+      style.innerHTML = `
+        @keyframes fadeInUpProfiles {
+          0% { opacity: 0; transform: translateY(24px); }
+          100% { opacity: 1; transform: translateY(0); }
+        }
+        .fade-in-up-profiles { animation: fadeInUpProfiles 0.6s cubic-bezier(0.22, 1, 0.36, 1) both; }
+      `;
+      document.head.appendChild(style);
+    }
+  }, []);
+
+  const loadRoles = () => {
+    setLoading(true);
+    fetchRoles()
+      .then(data => {
+        setRoles(Array.isArray(data) ? data : (data?.results ?? []));
+        setLoading(false);
+      })
+      .catch(err => {
+        showMessage(err.message || 'Error al cargar perfiles', 'error');
+        setLoading(false);
+      });
+  };
+
+  useEffect(() => { loadRoles(); }, []);
+
+  const handleDeleteClick = (role) => {
+    setRoleToDelete(role);
+    setShowDeleteModal(true);
+  };
+
+  const handleDeleteConfirm = async () => {
+    if (!roleToDelete) return;
+    setDeleting(true);
+    try {
+      await deleteRole(roleToDelete.id);
+      showMessage('Perfil eliminado correctamente', 'success');
+      setShowDeleteModal(false);
+      setRoleToDelete(null);
+      loadRoles();
+    } catch (err) {
+      showMessage(err.message || 'Error al eliminar perfil', 'error');
+    } finally {
+      setDeleting(false);
+    }
+  };
+
+  const filtered = roles.filter(r =>
+    r.nombre?.toLowerCase().includes(searchTerm.toLowerCase())
+  );
+
+  const permCount = (role) => {
+    if (Array.isArray(role.permissions)) return role.permissions.length;
+    return '—';
+  };
+
+  return (
+    <div className="min-h-screen p-4 sm:p-6 bg-gradient-to-br from-gray-50 to-blue-50">
+      <div className="max-w-5xl mx-auto">
+
+        {/* Header */}
+        <div className="mb-8 relative overflow-hidden rounded-2xl shadow bg-gradient-to-r from-blue-600 via-blue-700 to-blue-800 border border-blue-200 p-6 sm:p-8 flex flex-col sm:flex-row items-start sm:items-center gap-4 sm:gap-6 fade-in-up-profiles">
+          <div className="flex-shrink-0 bg-white/20 backdrop-blur-sm rounded-full p-3 sm:p-4 shadow-lg">
+            <svg className="h-8 w-8 sm:h-10 sm:w-10 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
+            </svg>
+          </div>
+          <div className="flex-1">
+            <h1 className="text-2xl sm:text-3xl font-extrabold text-white tracking-tight mb-1">
+              Perfiles y Permisos
+            </h1>
+            <p className="text-sm sm:text-base text-white/80 font-medium">
+              Gestión de roles y accesos de la organización
+            </p>
+          </div>
+          <button
+            onClick={() => navigate('/profiles/new')}
+            className="flex-shrink-0 inline-flex items-center gap-2 px-4 py-2 bg-white/20 hover:bg-white/30 text-white text-sm font-medium rounded-lg border border-white/30 transition-all duration-200"
+          >
+            <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M12 6v6m0 0v6m0-6h6m-6 0H6" />
+            </svg>
+            Nuevo perfil
+          </button>
+          <div className="absolute -top-10 -right-10 opacity-20 pointer-events-none select-none">
+            <svg width="120" height="120" viewBox="0 0 120 120" fill="none">
+              <circle cx="60" cy="60" r="50" fill="white" fillOpacity="0.15" />
+            </svg>
+          </div>
+        </div>
+
+        {/* Buscador */}
+        <div className="mb-4 fade-in-up-profiles" style={{ animationDelay: '0.05s' }}>
+          <div className="relative">
+            <svg className="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-slate-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
+            </svg>
+            <input
+              type="text"
+              value={searchTerm}
+              onChange={e => setSearchTerm(e.target.value)}
+              placeholder="Buscar perfil..."
+              className="w-full pl-9 pr-4 py-2 border border-slate-200 rounded-lg shadow-sm bg-white text-sm text-slate-800 placeholder-slate-400 focus:ring-2 focus:ring-blue-500 focus:border-blue-500 transition-all"
+            />
+          </div>
+        </div>
+
+        {/* Tabla */}
+        <div className="bg-white rounded-2xl shadow-lg border border-gray-100 overflow-hidden fade-in-up-profiles" style={{ animationDelay: '0.1s' }}>
+          {loading ? (
+            <div className="flex items-center justify-center py-20">
+              <div className="animate-spin rounded-full h-10 w-10 border-b-2 border-blue-600" />
+            </div>
+          ) : filtered.length === 0 ? (
+            <div className="flex flex-col items-center justify-center py-20 text-slate-400">
+              <svg className="w-12 h-12 mb-3 opacity-40" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
+              </svg>
+              <p className="text-sm font-medium">
+                {searchTerm ? 'Sin resultados para la búsqueda' : 'No hay perfiles registrados'}
+              </p>
+            </div>
+          ) : (
+            <div className="overflow-x-auto">
+              <table className="min-w-full divide-y divide-gray-100">
+                <thead className="bg-slate-50">
+                  <tr>
+                    <th className="px-5 py-3 text-left text-xs font-semibold text-slate-500 uppercase tracking-wider">Perfil</th>
+                    <th className="px-5 py-3 text-left text-xs font-semibold text-slate-500 uppercase tracking-wider">Tipo</th>
+                    <th className="px-5 py-3 text-left text-xs font-semibold text-slate-500 uppercase tracking-wider">Permisos</th>
+                    <th className="px-5 py-3 text-right text-xs font-semibold text-slate-500 uppercase tracking-wider">Acciones</th>
+                  </tr>
+                </thead>
+                <tbody className="divide-y divide-gray-50">
+                  {filtered.map(role => (
+                    <tr key={role.id} className="hover:bg-slate-50/60 transition-colors duration-100">
+                      <td className="px-5 py-4">
+                        <div className="flex items-center gap-3">
+                          <div className={`w-8 h-8 rounded-lg flex items-center justify-center flex-shrink-0 ${role.is_admin_role ? 'bg-amber-100' : 'bg-blue-100'}`}>
+                            {role.is_admin_role ? (
+                              <svg className="w-4 h-4 text-amber-600" fill="currentColor" viewBox="0 0 24 24">
+                                <path d="M12 2l2.09 6.26L20 10l-5 4.87L16.18 22 12 18.77 7.82 22 9 14.87 4 10l5.91-1.74z" />
+                              </svg>
+                            ) : (
+                              <svg className="w-4 h-4 text-blue-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                                <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z" />
+                              </svg>
+                            )}
+                          </div>
+                          <span className="text-sm font-semibold text-slate-800">{role.nombre}</span>
+                        </div>
+                      </td>
+                      <td className="px-5 py-4">
+                        {role.is_admin_role ? (
+                          <span className="inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-xs font-semibold bg-amber-100 text-amber-700">
+                            <svg className="w-3 h-3" fill="currentColor" viewBox="0 0 24 24">
+                              <path d="M12 2l2.09 6.26L20 10l-5 4.87L16.18 22 12 18.77 7.82 22 9 14.87 4 10l5.91-1.74z" />
+                            </svg>
+                            Administrador
+                          </span>
+                        ) : (
+                          <span className="inline-flex items-center px-2 py-0.5 rounded-full text-xs font-medium bg-slate-100 text-slate-600">
+                            Estándar
+                          </span>
+                        )}
+                      </td>
+                      <td className="px-5 py-4">
+                        <span className="inline-flex items-center gap-1 text-sm text-slate-600">
+                          <svg className="w-3.5 h-3.5 text-blue-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z" />
+                          </svg>
+                          {permCount(role)}
+                        </span>
+                      </td>
+                      <td className="px-5 py-4 text-right">
+                        <div className="flex items-center justify-end gap-2">
+                          <button
+                            onClick={() => navigate(`/profiles/${role.id}/edit`)}
+                            className="inline-flex items-center gap-1 px-3 py-1.5 text-xs font-medium text-blue-700 bg-blue-50 hover:bg-blue-100 rounded-lg border border-blue-200 transition-colors duration-150"
+                          >
+                            <svg className="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M11 5H6a2 2 0 00-2 2v11a2 2 0 002 2h11a2 2 0 002-2v-5m-1.414-9.414a2 2 0 112.828 2.828L11.828 15H9v-2.828l8.586-8.586z" />
+                            </svg>
+                            Editar
+                          </button>
+                          <button
+                            onClick={() => handleDeleteClick(role)}
+                            disabled={role.is_admin_role}
+                            title={role.is_admin_role ? 'El perfil de administrador no puede eliminarse' : 'Eliminar perfil'}
+                            className="inline-flex items-center gap-1 px-3 py-1.5 text-xs font-medium text-red-600 bg-red-50 hover:bg-red-100 rounded-lg border border-red-200 transition-colors duration-150 disabled:opacity-40 disabled:cursor-not-allowed"
+                          >
+                            <svg className="w-3.5 h-3.5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" />
+                            </svg>
+                            Eliminar
+                          </button>
+                        </div>
+                      </td>
+                    </tr>
+                  ))}
+                </tbody>
+              </table>
+            </div>
+          )}
+        </div>
+
+        {/* Contador */}
+        {!loading && filtered.length > 0 && (
+          <p className="mt-3 text-xs text-slate-400 text-right">
+            {filtered.length} perfil{filtered.length !== 1 ? 'es' : ''}
+          </p>
+        )}
+      </div>
+
+      {/* Modal confirmar eliminación */}
+      {showDeleteModal && roleToDelete && (
+        <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/40 backdrop-blur-sm p-4">
+          <div className="bg-white rounded-2xl shadow-2xl max-w-md w-full p-6">
+            <div className="flex items-center gap-3 mb-4">
+              <div className="w-10 h-10 rounded-full bg-red-100 flex items-center justify-center flex-shrink-0">
+                <svg className="w-5 h-5 text-red-600" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L3.07 16.5c-.77.833.192 2.5 1.732 2.5z" />
+                </svg>
+              </div>
+              <div>
+                <h3 className="text-base font-semibold text-slate-800">Eliminar perfil</h3>
+                <p className="text-xs text-slate-500">Esta acción no se puede deshacer</p>
+              </div>
+            </div>
+            <p className="text-sm text-slate-600 mb-6">
+              ¿Confirmas eliminar el perfil <span className="font-semibold text-slate-800">"{roleToDelete.nombre}"</span>?
+              Los usuarios con este perfil perderán los permisos asociados.
+            </p>
+            <div className="flex gap-3 justify-end">
+              <button
+                onClick={() => { setShowDeleteModal(false); setRoleToDelete(null); }}
+                disabled={deleting}
+                className="px-4 py-2 text-sm font-medium text-slate-700 bg-white border border-slate-300 rounded-lg hover:bg-slate-50 transition-colors disabled:opacity-50"
+              >
+                Cancelar
+              </button>
+              <button
+                onClick={handleDeleteConfirm}
+                disabled={deleting}
+                className="px-4 py-2 text-sm font-medium text-white bg-red-600 hover:bg-red-700 rounded-lg transition-colors disabled:opacity-50 flex items-center gap-2"
+              >
+                {deleting && <div className="animate-spin rounded-full h-3.5 w-3.5 border-b-2 border-white" />}
+                Eliminar
+              </button>
+            </div>
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

src/pages/Reports.jsx

@@ -9,6 +9,7 @@ const fetchCurrentUserWithAuth = async () => {
 };
 import { fetchWithAuth } from '../fetchWithAuth';
 import { useNotification } from '../context/NotificationContext';
+import { extractApiError } from '../api/apiError';
 import datastageModelsData from '../data/datastageModels.json';
 import pedimentosModelsData from '../data/pedimentosModels.json';
 
@@ -42,27 +43,6 @@ if (typeof document !== 'undefined' && !document.getElementById('reports-animati
   document.head.appendChild(style);
 }
 
-const handleDownloadReport = async (reportId) => {
-  try {
-    const url = `${import.meta.env.VITE_EFC_API_URL}/reports/report-document-download/${reportId}/`;
-    const res = await fetchWithAuth(url);
-    if (!res.ok) throw new Error('Error al descargar el reporte');
-    const blob = await res.blob();
-    let filename = `reporte_${reportId}.csv`;
-    const disposition = res.headers.get('Content-Disposition');
-    if (disposition && disposition.includes('filename=')) {
-      filename = disposition.split('filename=')[1].replace(/"/g, '').trim();
-    }
-    const link = document.createElement('a');
-    link.href = window.URL.createObjectURL(blob);
-    link.download = filename;
-    document.body.appendChild(link);
-    link.click();
-    document.body.removeChild(link);
-  } catch (err) {
-    alert('No se pudo descargar el reporte.');
-  }
-};
 
 export default function Reports() {
   // Estado para organizacion_id
@@ -85,7 +65,7 @@ export default function Reports() {
   // Handler for Generar Reporte in Cumplimiento tab
   const handleGenerarReporteCumplimiento = async () => {
     if (!organizacionId) {
-      alert('No se pudo obtener el organizacion_id. Intenta de nuevo más tarde.');
+      showMessage('No se pudo obtener el ID de organización. Intenta de nuevo más tarde.', 'warning');
       return;
     }
     // Build query params from filtersCumplimiento and add organizacion_id
@@ -97,11 +77,13 @@ export default function Reports() {
     const url = `${import.meta.env.VITE_EFC_API_URL}/reports/table-summary/${params ? `?${params}` : ''}`;
     try {
       const res = await fetchWithAuth(url);
-      const data = await res.json();
+      if (!res.ok) {
-      if (!res.ok) throw new Error('Error al generar el reporte');
+        const errMsg = await extractApiError(res);
-      alert('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.');
+        throw new Error(errMsg);
+      }
+      showMessage('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.', 'success');
     } catch (err) {
-      alert('No se pudo generar el reporte.');
+      showMessage(err.message || 'No se pudo generar el reporte', 'error');
     }
   };
   // Filtros replicados de TableroAlmacenamiento
@@ -143,8 +125,8 @@ export default function Reports() {
     // Build query params from filtersCumplimiento and add organizacion_id
     const paramsObj = { ...filtersControlPedimento };
 
-    if(paramsObj.organizacion_id == ''){
+    if (paramsObj.organizacion_id === '') {
-      alert('No se pudo obtener el organizacion_id. Selecciona tu organizacion para intenta de nuevo.');
+      showMessage('Selecciona tu organización antes de generar el reporte.', 'warning');
       return;
     }
 
@@ -155,11 +137,13 @@ export default function Reports() {
     const url = `${import.meta.env.VITE_EFC_API_URL}/reports/control-pedimento/${params ? `?${params}` : ''}`;
     try {
       const res = await fetchWithAuth(url);
-      const data = await res.json();
+      if (!res.ok) {
-      if (!res.ok) throw new Error('Error al generar el reporte');
+        const errMsg = await extractApiError(res);
-      alert('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.');
+        throw new Error(errMsg);
+      }
+      showMessage('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.', 'success');
     } catch (err) {
-      alert('No se pudo generar el reporte.');
+      showMessage(err.message || 'No se pudo generar el reporte', 'error');
     }
   };
 
@@ -189,6 +173,31 @@ export default function Reports() {
   const isDebugMode = import.meta.env.VITE_DEBUG_MODE === 'true';
   const { showMessage } = useNotification();
 
+  const handleDownloadReport = async (reportId) => {
+    try {
+      const url = `${import.meta.env.VITE_EFC_API_URL}/reports/report-document-download/${reportId}/`;
+      const res = await fetchWithAuth(url);
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
+      const blob = await res.blob();
+      let filename = `reporte_${reportId}.csv`;
+      const disposition = res.headers.get('Content-Disposition');
+      if (disposition && disposition.includes('filename=')) {
+        filename = disposition.split('filename=')[1].replace(/"/g, '').trim();
+      }
+      const link = document.createElement('a');
+      link.href = window.URL.createObjectURL(blob);
+      link.download = filename;
+      document.body.appendChild(link);
+      link.click();
+      document.body.removeChild(link);
+    } catch (err) {
+      showMessage(err.message || 'No se pudo descargar el reporte', 'error');
+    }
+  };
+
   const [isExporting, setIsExporting] = useState(false);
   const [exportFormat, setExportFormat] = useState('excel');
   const [showExportSuccess, setShowExportSuccess] = useState(false);

src/pages/TableroAlmacenamiento.jsx

@@ -1,5 +1,7 @@
 import React, { useEffect, useState } from 'react';
 import fetchWithAuth from '../fetchWithAuth';
+import { useNotification } from '../context/NotificationContext';
+import { extractApiError } from '../api/apiError';
 const initialFilters = {
   pedimento_app: '',
   aduana: '',
@@ -12,6 +14,7 @@ const initialFilters = {
   contribuyente__rfc: '',
 };
 export default function TableroAlmacenamiento() {
+  const { showMessage } = useNotification();
   const [filters, setFilters] = useState(initialFilters);
   const [summary, setSummary] = useState(null);
   const [isLoading, setIsLoading] = useState(false);
@@ -25,10 +28,13 @@ export default function TableroAlmacenamiento() {
         .join('&');
       const url = `${import.meta.env.VITE_EFC_API_URL}/reports/table-summary/${params ? `?${params}` : ''}`;
       const res = await fetchWithAuth(url, { method: 'POST' });
-      if (!res.ok) throw new Error('Error al generar el reporte');
+      if (!res.ok) {
-      alert('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.');
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
+      showMessage('Reporte solicitado correctamente. Aparecerá en el historial cuando esté listo.', 'success');
     } catch (err) {
-      alert('No se pudo generar el reporte.');
+      showMessage(err.message || 'No se pudo generar el reporte', 'error');
     }
   };
 
@@ -36,7 +42,10 @@ export default function TableroAlmacenamiento() {
     try {
       const url = `${import.meta.env.VITE_EFC_API_URL}/reports/report-document-download/${reportId}/`;
       const res = await fetchWithAuth(url);
-      if (!res.ok) throw new Error('Error al descargar el reporte');
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
       const blob = await res.blob();
       let filename = `reporte_${reportId}.csv`;
       const disposition = res.headers.get('Content-Disposition');
@@ -50,7 +59,7 @@ export default function TableroAlmacenamiento() {
       link.click();
       document.body.removeChild(link);
     } catch (err) {
-      alert('No se pudo descargar el reporte.');
+      showMessage(err.message || 'No se pudo descargar el reporte', 'error');
     }
   };
 
@@ -64,9 +73,14 @@ export default function TableroAlmacenamiento() {
         .join('&');
       const url = `${import.meta.env.VITE_EFC_API_URL}/reports/dashboard/summary/${params ? `?${params}` : ''}`;
       const res = await fetchWithAuth(url);
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
       const data = await res.json();
       setSummary(data);
     } catch (err) {
+      showMessage(err.message || 'Error al cargar el resumen', 'error');
       setSummary(null);
     }
     setIsLoading(false);
@@ -82,6 +96,7 @@ export default function TableroAlmacenamiento() {
         const data = await res.json();
         setReports(data);
       } catch (err) {
+        showMessage(err.message || 'Error al cargar el historial de reportes', 'error');
         setReports([]);
       }
     };
@@ -147,7 +162,7 @@ export default function TableroAlmacenamiento() {
               <button
                 type="button"
                 className="bg-green-600 text-white px-4 py-2 rounded-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-green-500 focus:ring-offset-2 transition-colors"
-                onClick={() => alert('Generar reporte (implementación pendiente)')}
+                onClick={handleGenerateReport}
               >
                 Generar Reporte
               </button>

src/pages/UserForm.jsx

@@ -1,6 +1,7 @@
 import React, { useEffect, useState } from 'react';
 import { useNavigate, useParams, useSearchParams } from 'react-router-dom';
 import { createUser, updateUser } from '../api/users.ts';
+import { fetchRoles, fetchUserRoles, assignUserRole, revokeUserRole } from '../api/rbac';
 import { useNotification } from '../context/NotificationContext';
 
 const initialForm = {
@@ -12,38 +13,31 @@ const initialForm = {
   confirmPassword: '',
   rfc: [],
   userType: 'agente', // 'agente' | 'importador'
-  groups: [],
   is_active: true,
 };
 
-// Perfiles disponibles en el sistema
-const AVAILABLE_GROUPS = [
-  { id: 1, label: 'Admin', description: 'Administrador del sistema' },
-  { id: 2, label: 'Developer', description: 'Desarrollador' },
-  { id: 3, label: 'User', description: 'Acceso base (requerido)' },
-  { id: 4, label: 'Agente Aduanal', description: 'Agente aduanal' },
-  { id: 5, label: 'Importador', description: 'Importador general' }
-];
-
 export default function UserForm() {
-  const { id } = useParams(); // presente si es edición
+  const { id } = useParams();
   const isEditing = Boolean(id);
   const navigate = useNavigate();
   const [searchParams] = useSearchParams();
   const { showMessage } = useNotification();
 
-  // Preseleccionar tipo desde query param (?type=agente|importador)
   const initialType = searchParams.get('type') === 'importador' ? 'importador' : 'agente';
 
-  const [form, setForm] = useState({
+  const [form, setForm] = useState({ ...initialForm, userType: initialType });
-    ...initialForm,
-    userType: initialType,
-    groups: initialType === 'importador' ? [3, 5] : [4, 3],
-  });
   const [importadores, setImportadores] = useState([]);
   const [submitting, setSubmitting] = useState(false);
   const [loadingUser, setLoadingUser] = useState(isEditing);
 
+  // RBAC: roles disponibles de la organización
+  const [availableRoles, setAvailableRoles] = useState([]);
+  const [loadingRoles, setLoadingRoles] = useState(true);
+  // IDs de roles seleccionados en el formulario
+  const [selectedRoleIds, setSelectedRoleIds] = useState([]);
+  // Asignaciones actuales del usuario (para calcular diff en edición): [{ id, role }]
+  const [currentUserRoles, setCurrentUserRoles] = useState([]);
+
   // Validación de contraseña
   const [passwordValidation, setPasswordValidation] = useState({
     length: false, uppercase: false, lowercase: false, number: false, special: false,
@@ -75,6 +69,24 @@ export default function UserForm() {
     }
   }, []);
 
+  // Cargar roles disponibles de la organización
+  useEffect(() => {
+    fetchRoles()
+      .then(data => {
+        const list = Array.isArray(data) ? data : (data?.results ?? []);
+        setAvailableRoles(list);
+        // Preselección por tipo inicial solo en creación
+        if (!isEditing) {
+          setSelectedRoleIds(getDefaultRoleIds(list, initialType));
+        }
+      })
+      .catch(err => {
+        showMessage(err.message || 'Error al cargar los perfiles disponibles', 'error');
+        setAvailableRoles([]);
+      })
+      .finally(() => setLoadingRoles(false));
+  }, []);
+
   // Cargar importadores
   useEffect(() => {
     const access = localStorage.getItem('access');
@@ -82,22 +94,30 @@ export default function UserForm() {
     fetch(`${import.meta.env.VITE_EFC_API_URL}/customs/importadores/`, {
       headers: { Authorization: `Bearer ${access}` },
     })
-      .then(r => r.json())
+      .then(r => {
+        if (!r.ok) throw new Error(`Error ${r.status} al cargar importadores`);
+        return r.json();
+      })
       .then(data => setImportadores(Array.isArray(data) ? data : []))
-      .catch(() => setImportadores([]));
+      .catch(err => {
+        showMessage(err.message || 'Error al cargar el catálogo de importadores', 'error');
+        setImportadores([]);
+      });
   }, []);
 
   // Cargar datos del usuario si es edición
   useEffect(() => {
     if (!isEditing) return;
     const access = localStorage.getItem('access');
-    fetch(`${import.meta.env.VITE_EFC_API_URL}/user/users/${id}/`, {
+
-      headers: { Authorization: `Bearer ${access}` },
+    Promise.all([
-    })
+      fetch(`${import.meta.env.VITE_EFC_API_URL}/user/users/${id}/`, {
-      .then(r => r.json())
+        headers: { Authorization: `Bearer ${access}` },
-      .then(data => {
+      }).then(r => r.json()),
-        const isImportador = data.is_importador === true ||
+      fetchUserRoles(id).catch(() => []),
-          (Array.isArray(data.groups) && data.groups.includes(5));
+    ])
+      .then(([data, userRoles]) => {
+        const isImportador = data.is_importador === true;
         setForm({
           username: data.username || '',
           email: data.email || '',
@@ -105,12 +125,21 @@ export default function UserForm() {
           last_name: data.last_name || '',
           password: '',
           confirmPassword: '',
-          // rfc es M2M: viene como array de PKs (strings de RFC)
           rfc: Array.isArray(data.rfc) ? data.rfc : (data.rfc ? [data.rfc] : []),
           userType: isImportador ? 'importador' : 'agente',
-          groups: Array.isArray(data.groups) ? data.groups : [],
           is_active: data.is_active !== false,
         });
+
+        // user-roles respuesta: [{ id, user: {...}, role: { id, nombre, ... }, created_at }]
+        const normalized = (Array.isArray(userRoles) ? userRoles : (userRoles?.results ?? []))
+          .map(ur => ({
+            id: ur.id,
+            role: typeof ur.role === 'object' ? ur.role?.id : ur.role,
+          }))
+          .filter(ur => ur.role);
+
+        setCurrentUserRoles(normalized);
+        setSelectedRoleIds(normalized.map(ur => ur.role));
         setLoadingUser(false);
       })
       .catch(() => {
@@ -119,6 +148,15 @@ export default function UserForm() {
       });
   }, [id, isEditing, showMessage]);
 
+  // Preseleccionar roles por defecto según tipo de usuario
+  function getDefaultRoleIds(roles, type) {
+    const keyword = type === 'importador' ? 'importador' : 'agente';
+    const matches = roles
+      .filter(r => r.nombre?.toLowerCase().includes(keyword))
+      .map(r => r.id);
+    return matches;
+  }
+
   const validatePassword = (password) => {
     const v = {
       length: password.length >= 8,
@@ -143,7 +181,6 @@ export default function UserForm() {
       return isPasswordValid() && passwordsMatch &&
         form.password.length > 0 && form.confirmPassword.length > 0;
     }
-    // En edición la contraseña es opcional
     if (form.password.length > 0) {
       return isPasswordValid() && passwordsMatch && form.confirmPassword.length > 0;
     }
@@ -164,20 +201,18 @@ export default function UserForm() {
     setForm(prev => ({
       ...prev,
       userType: type,
-      // Limpiar RFCs si cambia a agente
       rfc: type === 'agente' ? [] : prev.rfc,
-      // Preseleccionar perfiles por defecto según tipo
-      groups: type === 'importador' ? [3, 5] : [4, 3],
     }));
+    // Preseleccionar roles según tipo
+    setSelectedRoleIds(getDefaultRoleIds(availableRoles, type));
   };
 
-  const handleGroupToggle = (groupId) => {
+  const handleRoleToggle = (roleId) => {
-    setForm(prev => {
+    setSelectedRoleIds(prev =>
-      const groups = prev.groups.includes(groupId)
+      prev.includes(roleId)
-        ? prev.groups.filter(g => g !== groupId)
+        ? prev.filter(id => id !== roleId)
-        : [...prev.groups, groupId];
+        : [...prev, roleId]
-      return { ...prev, groups };
+    );
-    });
   };
 
   const handleRfcToggle = (rfc) => {
@@ -190,6 +225,18 @@ export default function UserForm() {
     });
   };
 
+  // Sincronizar roles: calcular diff y llamar assign/revoke
+  const syncRoles = async (userId) => {
+    const currentRoleIds = currentUserRoles.map(ur => ur.role);
+    const toAdd = selectedRoleIds.filter(id => !currentRoleIds.includes(id));
+    const toRemove = currentUserRoles.filter(ur => !selectedRoleIds.includes(ur.role));
+
+    await Promise.all([
+      ...toAdd.map(roleId => assignUserRole(userId, roleId).catch(() => null)),
+      ...toRemove.map(ur => revokeUserRole(ur.id).catch(() => null)),
+    ]);
+  };
+
   const handleSubmit = async (e) => {
     e.preventDefault();
     if (!isFormValid()) return;
@@ -200,7 +247,6 @@ export default function UserForm() {
         email: form.email,
         first_name: form.first_name,
         last_name: form.last_name,
-        groups: form.groups,
         is_importador: form.userType === 'importador',
         is_active: form.is_active,
       };
@@ -211,9 +257,16 @@ export default function UserForm() {
 
       if (isEditing) {
         await updateUser(id, payload);
+        await syncRoles(id);
         showMessage('Usuario actualizado exitosamente', 'success');
       } else {
-        await createUser(payload);
+        const newUser = await createUser(payload);
+        const newUserId = newUser?.id;
+        if (newUserId && selectedRoleIds.length > 0) {
+          await Promise.all(
+            selectedRoleIds.map(roleId => assignUserRole(newUserId, roleId).catch(() => null))
+          );
+        }
         showMessage('Usuario creado exitosamente', 'success');
       }
       navigate('/users');
@@ -229,7 +282,7 @@ export default function UserForm() {
   if (loadingUser) {
     return (
       <div className="min-h-screen p-4 sm:p-6 bg-gradient-to-br from-gray-50 to-blue-50 flex items-center justify-center">
-        <div className="animate-spin rounded-full h-12 w-12 border-b-2 border-blue-600"></div>
+        <div className="animate-spin rounded-full h-12 w-12 border-b-2 border-blue-600" />
       </div>
     );
   }
@@ -253,7 +306,6 @@ export default function UserForm() {
               {isEditing ? 'Modifica los datos del usuario seleccionado' : 'Registro en el Sistema de Gestión de Usuarios'}
             </p>
           </div>
-          {/* Botón regresar */}
           <button
             type="button"
             onClick={() => navigate('/users')}
@@ -271,7 +323,6 @@ export default function UserForm() {
           </div>
         </div>
 
-        {/* Formulario */}
         <form onSubmit={handleSubmit} className="space-y-6">
 
           {/* Tipo de usuario — solo en creación */}
@@ -426,7 +477,6 @@ export default function UserForm() {
                 <p className="text-sm text-gray-500 italic">No hay importadores disponibles en el catálogo.</p>
               ) : (
                 <div className="flex flex-col sm:flex-row gap-3 items-stretch">
-
                   {/* Columna izquierda — disponibles */}
                   <div className="flex-1 flex flex-col min-w-0">
                     <div className="flex items-center justify-between mb-1.5">
@@ -518,54 +568,91 @@ export default function UserForm() {
                       </div>
                     </div>
                   </div>
-
                 </div>
               )}
             </div>
           )}
 
-          {/* Perfiles */}
+          {/* Perfiles RBAC */}
           <div className="bg-white rounded-2xl shadow-lg border border-gray-100 p-6 fade-in-up-users" style={{ animationDelay: '0.15s' }}>
-            <div className="flex items-center mb-4 pb-3 border-b border-gray-200">
+            <div className="flex items-center justify-between mb-4 pb-3 border-b border-gray-200">
-              <div className="bg-blue-600 rounded-lg p-2 mr-3 shadow-sm">
+              <div className="flex items-center">
-                <svg className="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <div className="bg-indigo-600 rounded-lg p-2 mr-3 shadow-sm">
-                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M17 20h5v-2a3 3 0 00-5.356-1.857M17 20H7m10 0v-2c0-.656-.126-1.283-.356-1.857M7 20H2v-2a3 3 0 015.356-1.857M7 20v-2c0-.656.126-1.283.356-1.857m0 0a5.002 5.002 0 019.288 0M15 7a3 3 0 11-6 0 3 3 0 016 0zm6 3a2 2 0 11-4 0 2 2 0 014 0zM7 10a2 2 0 11-4 0 2 2 0 014 0z" />
+                  <svg className="w-4 h-4 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
+                  </svg>
+                </div>
+                <div>
+                  <h4 className="text-sm font-semibold text-slate-800">Perfiles</h4>
+                  <p className="text-xs text-slate-500">
+                    Asigna los perfiles que tendrá este usuario en la organización
+                  </p>
+                </div>
+              </div>
+              {selectedRoleIds.length > 0 && (
+                <span className="text-xs text-indigo-600 font-semibold bg-indigo-50 px-2 py-0.5 rounded-full border border-indigo-200">
+                  {selectedRoleIds.length} seleccionado{selectedRoleIds.length !== 1 ? 's' : ''}
+                </span>
+              )}
+            </div>
+
+            {loadingRoles ? (
+              <div className="flex items-center justify-center py-8">
+                <div className="animate-spin rounded-full h-6 w-6 border-b-2 border-indigo-600" />
+              </div>
+            ) : availableRoles.length === 0 ? (
+              <div className="text-center py-8 text-slate-400">
+                <svg className="w-8 h-8 mx-auto mb-2 opacity-40" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
                 </svg>
+                <p className="text-xs">No hay perfiles disponibles en la organización</p>
               </div>
-              <div>
+            ) : (
-                <h4 className="text-sm font-semibold text-slate-800">Perfiles</h4>
+              <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-3">
-                <p className="text-xs text-slate-500">Asigna los perfiles a los que pertenecerá el usuario</p>
+                {availableRoles.map(role => {
-              </div>
+                  const active = selectedRoleIds.includes(role.id);
-            </div>
+                  return (
-            <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-3">
+                    <button
-              {AVAILABLE_GROUPS.map(group => {
+                      key={role.id}
-                const active = form.groups.includes(group.id);
+                      type="button"
-                return (
+                      onClick={() => handleRoleToggle(role.id)}
-                  <button
+                      className={`relative flex flex-col items-start p-3 rounded-xl border-2 text-left transition-all duration-200 ${
-                    key={group.id}
+                        active
-                    type="button"
+                          ? 'border-indigo-500 bg-indigo-50'
-                    onClick={() => handleGroupToggle(group.id)}
+                          : 'border-gray-200 bg-white hover:border-indigo-300 hover:bg-indigo-50/40'
-                    className={`relative flex flex-col items-start p-3 rounded-xl border-2 text-left transition-all duration-200 ${
+                      }`}
-                      active
+                    >
-                        ? 'border-blue-500 bg-blue-50'
+                      <div className="flex items-center gap-2 w-full">
-                        : 'border-gray-200 bg-white hover:border-gray-300 hover:bg-gray-50'
+                        <div className={`w-6 h-6 rounded-md flex items-center justify-center flex-shrink-0 ${active ? 'bg-indigo-600' : 'bg-gray-100'}`}>
-                    }`}
+                          {role.is_admin_role ? (
-                  >
+                            <svg className={`w-3.5 h-3.5 ${active ? 'text-white' : 'text-amber-500'}`} fill="currentColor" viewBox="0 0 24 24">
-                    <span className={`text-xs font-semibold ${active ? 'text-blue-800' : 'text-gray-700'}`}>
+                              <path d="M12 2l2.09 6.26L20 10l-5 4.87L16.18 22 12 18.77 7.82 22 9 14.87 4 10l5.91-1.74z" />
-                      {group.label}
+                            </svg>
-                    </span>
+                          ) : (
-                    <span className="text-xs text-gray-400 mt-0.5">{group.description}</span>
+                            <svg className={`w-3.5 h-3.5 ${active ? 'text-white' : 'text-gray-400'}`} fill="none" stroke="currentColor" viewBox="0 0 24 24">
-                    {active && (
+                              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M16 7a4 4 0 11-8 0 4 4 0 018 0zM12 14a7 7 0 00-7 7h14a7 7 0 00-7-7z" />
-                      <div className="absolute top-2 right-2 w-4 h-4 bg-blue-600 rounded-full flex items-center justify-center">
+                            </svg>
-                        <svg className="w-2.5 h-2.5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                          )}
-                          <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M5 13l4 4L19 7" />
+                        </div>
-                        </svg>
+                        <span className={`text-xs font-semibold truncate flex-1 ${active ? 'text-indigo-800' : 'text-gray-700'}`}>
+                          {role.nombre}
+                        </span>
                       </div>
-                    )}
+                      {role.is_admin_role && (
-                  </button>
+                        <span className="mt-1.5 text-xs text-amber-600 font-medium">Administrador</span>
-                );
+                      )}
-              })}
+                      {active && (
-            </div>
+                        <div className="absolute top-2 right-2 w-4 h-4 bg-indigo-600 rounded-full flex items-center justify-center">
+                          <svg className="w-2.5 h-2.5 text-white" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M5 13l4 4L19 7" />
+                          </svg>
+                        </div>
+                      )}
+                    </button>
+                  );
+                })}
+              </div>
+            )}
           </div>
 
           {/* Credenciales */}
@@ -585,7 +672,7 @@ export default function UserForm() {
             </div>
             <div className="space-y-4">
 
-              {/* Estado del usuario */}
+              {/* Estado */}
               <div className="flex items-center justify-between p-3 rounded-xl border border-slate-200 bg-slate-50">
                 <div className="flex items-center gap-3">
                   <div className={`w-8 h-8 rounded-lg flex items-center justify-center flex-shrink-0 ${form.is_active ? 'bg-blue-100' : 'bg-slate-200'}`}>
@@ -649,8 +736,6 @@ export default function UserForm() {
                     )}
                   </button>
                 </div>
-
-                {/* Indicadores de validación */}
                 {showPasswordValidation && (
                   <div className="mt-3 p-3 bg-slate-100 rounded-lg border">
                     <div className="flex items-center justify-between mb-2">
@@ -736,7 +821,7 @@ export default function UserForm() {
             </div>
           </div>
 
-          {/* Botones de acción */}
+          {/* Botones */}
           <div className="flex flex-col sm:flex-row justify-end gap-3 pb-8 fade-in-up-users" style={{ animationDelay: '0.25s' }}>
             <button
               type="button"
@@ -751,7 +836,7 @@ export default function UserForm() {
               disabled={submitting || (showPasswordValidation && !isFormValid())}
               className="w-full sm:w-auto px-6 py-2.5 border border-transparent rounded-lg shadow-lg text-sm font-semibold text-white bg-gradient-to-r from-blue-700 to-blue-900 hover:from-blue-800 hover:to-blue-950 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500 transition-all duration-200 flex items-center justify-center gap-2 disabled:opacity-50 disabled:cursor-not-allowed"
             >
-              {submitting && <div className="animate-spin rounded-full h-4 w-4 border-b-2 border-white"></div>}
+              {submitting && <div className="animate-spin rounded-full h-4 w-4 border-b-2 border-white" />}
               <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
                 <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d={isEditing ? 'M5 13l4 4L19 7' : 'M12 6v6m0 0v6m0-6h6m-6 0H6'} />
               </svg>

src/pages/Users.jsx

@@ -72,8 +72,8 @@ export default function Users() {
         setLoading(false);
       })
       .catch(err => {
-        console.error('Error loading users:', err);
+        setError(err.message);
-        setError('Error al cargar usuarios');
+        showMessage(err.message, 'error');
         setLoading(false);
       });
   };
@@ -99,7 +99,6 @@ export default function Users() {
     // Siempre sincroniza la información del usuario autenticado en localStorage
     getCurrentUser()
       .then(data => {
-        console.log('Respuesta de /api/users/me/:', data);
         if (data && data.username) {
           localStorage.setItem('username', data.username);
           if (data.email) localStorage.setItem('user_email', data.email);
@@ -108,14 +107,10 @@ export default function Users() {
           if (data.first_name) localStorage.setItem('user_first_name', data.first_name);
           if (data.last_name) localStorage.setItem('user_last_name', data.last_name);
           if (typeof data.is_importador !== 'undefined') localStorage.setItem('user_is_importador', String(data.is_importador));
-          console.log('Guardado en localStorage: username', data.username);
-        } else {
-          console.log('No se encontró username en la respuesta');
         }
       })
-      .catch((err) => { console.log('Error en fetch /api/users/me/', err); });
+      .catch(() => {});
-    // eslint-disable-next-line
+  }, []);
-  }, [showMessage]);
 
   // Debounce para el término de búsqueda
   useEffect(() => {
@@ -356,26 +351,6 @@ export default function Users() {
     );
   }
 
-  if (error) {
-    return (
-      <div className="bg-red-50 border border-red-200 rounded-md p-4">
-        <div className="flex">
-          <div className="flex-shrink-0">
-            <svg className="h-5 w-5 text-red-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-2.5L13.732 4c-.77-.833-1.964-.833-2.732 0L4.082 16.5c-.77.833.192 2.5 1.732 2.5z" />
-            </svg>
-          </div>
-          <div className="ml-3">
-            <h3 className="text-sm font-medium text-red-800">Error al cargar usuarios</h3>
-            <div className="mt-2 text-sm text-red-700">
-              <p>{error}</p>
-            </div>
-          </div>
-        </div>
-      </div>
-    );
-  }
-
   // Cuenta de usuarios verificados y activos
   const verifiedCount = users.filter(u => u.is_verified === true).length;
   const activeCount = users.filter(u => u.is_active === true).length;

src/pages/Vucem.jsx

@@ -2,6 +2,7 @@
 function RelacionarImportadoresModal({ open, onClose, vucem }) {
   const [importadoresDisponibles, setImportadoresDisponibles] = React.useState([]);
   const [importadoresSeleccionados, setImportadoresSeleccionados] = React.useState([]);
+  const { showMessage } = useNotification();
 
   React.useEffect(() => {
     if (!open || !vucem) return;
@@ -50,7 +51,10 @@ function RelacionarImportadoresModal({ open, onClose, vucem }) {
           body: JSON.stringify(body)
         }
       );
-      if (!res.ok) throw new Error('Error al relacionar importador');
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
       const data = await res.json();
       // Guardar el id de la relación en el importador seleccionado
       const impConRelacion = {
@@ -61,7 +65,7 @@ function RelacionarImportadoresModal({ open, onClose, vucem }) {
       setImportadoresDisponibles(importadoresDisponibles.filter(i => i.rfc !== imp.rfc));
       setImportadoresSeleccionados([...importadoresSeleccionados, impConRelacion]);
     } catch (err) {
-      alert('No se pudo relacionar el importador.');
+      showMessage(err.message || 'No se pudo relacionar el importador', 'error');
     }
   };
   // Mover importador de seleccionados a disponibles
@@ -71,16 +75,19 @@ function RelacionarImportadoresModal({ open, onClose, vucem }) {
       // Buscar el id de la relación usuario-importador en el objeto importador
       const relacionId = imp.usuario_importador_id || imp.id_relacion || imp.id;
       if (!relacionId) {
-        alert('No se encontró el id de la relación usuario-importador.');
+        showMessage('No se encontró el ID de la relación usuario-importador', 'warning');
         return;
       }
       const url = `${import.meta.env.VITE_EFC_API_URL}/vucem/usuario-importador/${relacionId}/`;
       const res = await fetchWithAuth(url, { method: 'DELETE' });
-      if (!res.ok) throw new Error('Error al eliminar relación');
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
       setImportadoresSeleccionados(importadoresSeleccionados.filter(i => i.rfc !== imp.rfc));
       setImportadoresDisponibles([...importadoresDisponibles, imp]);
     } catch (err) {
-      alert('No se pudo eliminar la relación del importador.');
+      showMessage(err.message || 'No se pudo eliminar la relación del importador', 'error');
     }
   };
 
@@ -203,11 +210,12 @@ function RelacionarImportadoresModal({ open, onClose, vucem }) {
 import React, { useEffect, useState } from 'react';
 import { fetchWithAuth, postWithAuth, putWithAuth, deleteWithAuth, putFormDataWithAuth, postFormDataWithAuth, patchWithAuth } from '../fetchWithAuth';
 import { useUser } from '../context/UserContext';
+import { useNotification } from '../context/NotificationContext';
+import { extractApiError } from '../api/apiError';
 
 const API_URL = import.meta.env.VITE_EFC_API_URL;
 export default function Vucem() {
-  // Estado para modal de relacionar importadores
+  const { showMessage } = useNotification();
-
   const isDebugMode = import.meta.env.VITE_DEBUG_MODE === 'true';
   const [showRelacionarModal, setShowRelacionarModal] = useState(false);
   const [selectedVucem, setSelectedVucem] = useState(null);
@@ -378,13 +386,15 @@ export default function Vucem() {
     setLoading(true);
     try {
       const res = await fetchWithAuth(`${API_URL}/vucem/vucem/`);
-      if (!res.ok) throw new Error('Error al cargar Ventanilla Unica');
+      if (!res.ok) {
+        const errMsg = await extractApiError(res);
+        throw new Error(errMsg);
+      }
       const data = await res.json();
-      // console.log('data > ', data);
       setVucemList(data);
       setError(null);
     } catch (err) {
-      setError('Error al cargar Ventanilla Unica');
+      setError(err.message);
     }
     setLoading(false);
   };
@@ -464,14 +474,15 @@ export default function Vucem() {
       });
 
       if (!response.ok) {
-        throw new Error('Error al cambiar el estado');
+        const errMsg = await extractApiError(response);
+        throw new Error(errMsg);
       }
 
       // Recargar la lista para reflejar los cambios
       await fetchVucem();
 
     } catch (err) {
-      alert('Error al cambiar el estado de la credencial');
+      showMessage(err.message || 'Error al cambiar el estado de la credencial', 'error');
     }
   };
 
@@ -1304,11 +1315,14 @@ export default function Vucem() {
                 if (form.cer) formData.append('cer', form.cer);
                 try {
                   const res = await postFormDataWithAuth(`${API_URL}/vucem/vucem/`, formData);
-                  if (!res.ok) throw new Error('Error al crear');
+                  if (!res.ok) {
+                    const errMsg = await extractApiError(res);
+                    throw new Error(errMsg);
+                  }
                   await fetchVucem();
                   closeModals();
                 } catch (err) {
-                  alert('Error al crear');
+                  showMessage(err.message || 'Error al crear la credencial', 'error');
                 }
               }}>
 
@@ -1697,11 +1711,14 @@ export default function Vucem() {
                 formData.append('is_active', form.is_active);
                 try {
                   const res = await putFormDataWithAuth(`${API_URL}/vucem/vucem/${editVucem.id}/`, formData);
-                  if (!res.ok) throw new Error('Error al actualizar');
+                  if (!res.ok) {
+                    const errMsg = await extractApiError(res);
+                    throw new Error(errMsg);
+                  }
                   await fetchVucem();
                   closeModals();
                 } catch (err) {
-                  alert('Error al actualizar');
+                  showMessage(err.message || 'Error al actualizar la credencial', 'error');
                 }
               }}>
 
@@ -2018,11 +2035,14 @@ export default function Vucem() {
                   if (!deleteVucem) return;
                   try {
                     const res = await deleteWithAuth(`${API_URL}/vucem/vucem/${deleteVucem.id}/`);
-                    if (!res.ok) throw new Error('Error al eliminar');
+                    if (!res.ok) {
+                      const errMsg = await extractApiError(res);
+                      throw new Error(errMsg);
+                    }
                     await fetchVucem();
                     closeModals();
                   } catch (err) {
-                    alert('Error al eliminar');
+                    showMessage(err.message || 'Error al eliminar la credencial', 'error');
                   }
                 }} className="px-4 py-2 border border-transparent rounded-md shadow-sm text-sm font-medium text-white bg-red-600 hover:bg-red-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-red-500 transition-colors disabled:opacity-50 flex items-center">Eliminar</button>
               </div>

src/utils/downloadUtils.js

@@ -1,4 +1,5 @@
 import { fetchWithAuth } from '../fetchWithAuth';
+import { extractApiError } from '../api/apiError';
 
 const API_URL = import.meta.env.VITE_EFC_API_URL;
 
@@ -13,7 +14,8 @@ export const downloadFile = async (id, filename = 'archivo', showMessage) => {
     const res = await fetchWithAuth(`${API_URL}/record/documents/descargar/${id}/`);
     
     if (!res.ok) {
-      showMessage('Error en la descarga del archivo', 'error');
+      const errMsg = await extractApiError(res);
+      showMessage(errMsg, 'error');
       return;
     }
     
@@ -50,8 +52,11 @@ export const downloadBulkZip = async (ids, showMessage, pedimentoName) => {
       body: JSON.stringify({ document_ids: ids })
     });
     
-    if (!response.ok) throw new Error('Error en la descarga');
+    if (!response.ok) {
-    
+      const errMsg = await extractApiError(response);
+      throw new Error(errMsg);
+    }
+
     const blob = await response.blob();
     const url = window.URL.createObjectURL(blob);
     const a = document.createElement('a');