Códigos de error de Autorización
Todos los códigos de error de la API pública que emite Autorización, con su estado HTTP, su type y una página por código.
Códigos de error que emite Autorización. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
addon_not_active | authorization_error | 403 | La funcionalidad pertenece a un add-on que ahora mismo no está activo para la empresa. |
company_read_only | authorization_error | 403 | Quien emitió la credencial tiene acceso de solo lectura (nivel view) a la empresa efectiva: su rol en la cuenta le permite ver ese NIF, no escribir en él. El nivel efectivo es el menor entre el guardado en la credencial y el que la persona tiene hoy. |
emitter_capability_restricted | authorization_error | 403 | La persona que emitió la credencial tiene retirada, en la empresa efectiva, la sección o la acción que exige la operación. Es la misma restricción por módulo que el administrador de la empresa le puso en la aplicación web, y se aplica aunque su nivel de acceso al NIF sea operate. |
feature_not_available_in_plan | authorization_error | 403 | La funcionalidad no está incluida en el plan de la empresa. |
forbidden_action | authorization_error | 403 | La acción se rechaza aunque el scope sea el correcto. Los motivos habituales son: tu credencial llega al NIF por una relación entre cuentas (acceso cedido a tu cuenta, o cuenta gestionada) y la operación pertenece a la cuenta dueña del NIF —el registro de peticiones, los eventos, los webhook endpoints, la facturación de la cuenta, el uso de automatizaciones y las escrituras de credenciales de cobro conectadas nunca están disponibles por una relación—; el NIF es de una cuenta gestionada cuyo titular ya la paga, así que su proveedor puede consultarlo y editar sus datos pero ya no activarlo, desactivarlo ni archivarlo; la persona que emitió la credencial no es owner ni admin de la cuenta, o la credencial no alcanza todos los NIF de la cuenta; o el recurso pertenece a un catálogo compartido, o el cambio va por otro endpoint. |
insufficient_scope | authorization_error | 403 | La clave autentica correctamente pero no lleva el scope que exige esta operación. Los scopes se conceden al emitir la clave y no se amplían en tiempo de llamada. |
max_api_keys_exceeded | authorization_error | 422 | La empresa alcanzó el número de API keys que permite su plan. |
max_webhook_endpoints_exceeded | authorization_error | 422 | La empresa alcanzó el número de endpoints de webhook que permite su nivel de add-on. |
module_not_available_in_sandbox | authorization_error | 403 | El recurso pertenece a un módulo vetado en modo test. La sandbox nunca toca AEAT, bancos ni cobros reales, así que esos módulos quedan fuera a propósito. |
portfolio_max_api_keys_exceeded | authorization_error | 422 | La cuenta ya tiene el máximo de credenciales ACTIVAS que admite una cartera. El tope rige cuando la cuenta tiene dos o más NIF reales y se cuenta sobre todas las credenciales activas de la cuenta, no por NIF, así que dar de alta otro NIF para acuñarle su credencial tampoco deja crear ésta. |
scope_not_allowed_by_plan | authorization_error | 422 | Uno de los scopes pedidos pertenece a un módulo que el plan no incluye, así que la clave nacería con un permiso que nunca podría ejercer. |
scope_not_allowed_in_sandbox | authorization_error | 422 | Una clave de prueba no puede nacer con scopes de módulos vetados en sandbox. |
Relacionado
Códigos de error por categoría
Localiza un error por la categoría que lo emite.
Tabla de referencia completa
Todos los códigos, estados HTTP, tipos y descripciones en una referencia.
Modelo de errores
Interpreta la respuesta de error y gestiona los errores por código.