# API02005: Permisos Insuficientes

## Lo Que Esto Significa[​](#what-this-means "Enlace directo a Lo Que Esto Significa")

Tu cuenta de usuario carece de las capacidades específicas de WordPress requeridas para esta acción. Aunque tienes acceso básico, la operación particular que estás intentando necesita permisos adicionales.

## Causas Comunes[​](#common-causes "Enlace directo a Causas Comunes")

* **Rol de usuario limitado** — Tu rol no incluye todas las capacidades necesarias
* **Capacidad no asignada** — Falta una capacidad específica en tu rol
* **Restricciones de plugins** — Un plugin de seguridad está limitando capacidades
* **Problemas de roles personalizados** — Los roles personalizados pueden carecer de capacidades

## Mapeo de Errores del Servidor[​](#server-error-mapping "Enlace directo a Mapeo de Errores del Servidor")

Este código de error se activa cuando el servidor devuelve:

| Código del Servidor              | Fuente                                      |
| -------------------------------- | ------------------------------------------- |
| `rest_forbidden`                 | WordPress REST API                          |
| `rest_cannot_create`             | WordPress REST API                          |
| `rest_cannot_edit`               | WordPress REST API                          |
| `rest_cannot_delete`             | WordPress REST API                          |
| `woocommerce_rest_cannot_create` | WooCommerce REST API                        |
| `woocommerce_rest_cannot_edit`   | WooCommerce REST API                        |
| `woocommerce_rest_cannot_delete` | WooCommerce REST API                        |
| HTTP 403                         | Cualquier respuesta del servidor (fallback) |

## Cómo Solucionar[​](#how-to-fix "Enlace directo a Cómo Solucionar")

### 1. Revisa las Capacidades Requeridas[​](#1-review-required-capabilities "Enlace directo a 1. Revisa las Capacidades Requeridas")

Capacidades comunes necesarias para operaciones POS:

* `manage_woocommerce` — Gestión general de WooCommerce
* `edit_shop_orders` — Crear y editar pedidos
* `edit_products` — Modificar información de productos
* `edit_users` — Gestionar cuentas de clientes

### 2. Mejorar el Rol del Usuario[​](#2-upgrade-user-role "Enlace directo a 2. Mejorar el Rol del Usuario")

Pide a un administrador que asigne un rol más capaz:

* **Shop Manager** — Acceso completo a WooCommerce
* **Administrador** — Acceso completo al sitio

### 3. Añadir Capacidades Específicas[​](#3-add-specific-capabilities "Enlace directo a 3. Añadir Capacidades Específicas")

Si necesitas un rol personalizado, añade las capacidades requeridas:

```
// Ejemplo: Añadir capacidades POS a un rol personalizado

$role = get_role('your_custom_role');

$role->add_cap('manage_woocommerce');

$role->add_cap('edit_shop_orders');
```

### 4. Verifica Conflictos de Plugins[​](#4-check-plugin-conflicts "Enlace directo a 4. Verifica Conflictos de Plugins")

Algunos plugins de seguridad o gestión de roles pueden restringir capacidades:

* Revisa la configuración de los plugins
* Verifica filtros de capacidades
* Desactiva temporalmente para probar

## Errores Relacionados[​](#related-errors "Enlace directo a Errores Relacionados")

* [API02004](/es/error-codes/API02004.md) — Usuario No Autorizado
* [API02010](/es/error-codes/API02010.md) — Autenticación Requerida

***