API02005: Permissões Insuficientes
O Que Isso Significa
Sua conta de usuário não possui as capacidades específicas do WordPress necessárias para esta ação. Embora você tenha acesso básico, a operação específica que você está tentando realizar precisa de permissões adicionais.
Causas Comuns
- Função de usuário limitada — Sua função não inclui todas as capacidades necessárias
- Capacidade não atribuída — Uma capacidade específica está faltando em sua função
- Restrições de plugin — Um plugin de segurança está limitando capacidades
- Problemas com funções personalizadas — Funções personalizadas podem estar faltando capacidades
Mapeamento de Erros do Servidor
Este código de erro é acionado quando o servidor retorna:
| Código do Servidor | Fonte |
|---|---|
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 | Qualquer resposta do servidor (fallback) |
Como Corrigir
1. Revise as Capacidades Necessárias
Capacidades comuns necessárias para operações do POS:
manage_woocommerce— Gerenciamento geral do WooCommerceedit_shop_orders— Criar e editar pedidosedit_products— Modificar informações do produtoedit_users— Gerenciar contas de clientes
2. Atualize a Função do Usuário
Peça a um administrador para atribuir uma função mais capaz:
- Gerente da Loja — Acesso total ao WooCommerce
- Administrador — Acesso total ao site
3. Adicione Capacidades Específicas
Se você precisar de uma função personalizada, adicione as capacidades necessárias:
// Example: Add POS capabilities to a custom role
$role = get_role('your_custom_role');
$role->add_cap('manage_woocommerce');
$role->add_cap('edit_shop_orders');
4. Verifique Conflitos de Plugins
Alguns plugins de segurança ou gerenciamento de funções podem restringir capacidades:
- Revise as configurações do plugin
- Verifique se há filtros de capacidade
- Desative temporariamente para testar