Factuarea APIDevelopers

Codis d'error d'Autorització

Tots els codis d'error de l'API pública que emet Autorització, amb el seu estat HTTP, el seu type i una pàgina per codi.

Codis d'error que emet Autorització. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.

CodeTypeHTTPDescripció
addon_not_activeauthorization_error403La funcionalitat pertany a un add-on que ara mateix no està actiu per a l'empresa.
company_read_onlyauthorization_error403Qui va emetre la credencial té accés de només lectura (nivell view) a l'empresa efectiva: el seu rol al compte li permet veure aquest NIF, no escriure-hi. El nivell efectiu és el menor entre el desat a la credencial i el que la persona té avui.
emitter_capability_restrictedauthorization_error403La persona que va emetre la credencial té retirada, a l'empresa efectiva, la secció o l'acció que exigeix l'operació. És la mateixa restricció per mòdul que l'administrador de l'empresa li va posar a l'aplicació web, i s'aplica encara que el seu nivell d'accés al NIF sigui operate.
feature_not_available_in_planauthorization_error403La funcionalitat no està inclosa en el pla de l'empresa.
forbidden_actionauthorization_error403L'acció es rebutja encara que l'abast sigui el correcte. Els motius habituals són: la teva credencial arriba al NIF per una relació entre comptes (accés cedit al teu compte, o compte gestionat) i l'operació pertany al compte amo del NIF —el registre de peticions, els esdeveniments, els webhook endpoints, la facturació del compte, l'ús d'automatitzacions i les escriptures de credencials de cobrament connectades mai no estan disponibles per una relació—; el NIF és d'un compte gestionat el titular del qual ja el paga, així que el seu proveïdor el pot consultar i editar-ne les dades però ja no activar-lo, desactivar-lo ni arxivar-lo; la persona que va emetre la credencial no és owner ni admin del compte, o la credencial no arriba a tots els NIF del compte; o el recurs pertany a un catàleg compartit, o el canvi va per un altre endpoint.
insufficient_scopeauthorization_error403La clau autentica correctament però no porta l'abast que exigeix aquesta operació. Els abasts es concedeixen en emetre la clau i no s'amplien en temps de crida.
max_api_keys_exceededauthorization_error422L'empresa va arribar al nombre de claus API que permet el seu pla.
max_webhook_endpoints_exceededauthorization_error422L'empresa va arribar al nombre d'endpoints de webhook que permet el seu nivell d'add-on.
module_not_available_in_sandboxauthorization_error403El recurs pertany a un mòdul vetat en mode test. La sandbox mai toca l'AEAT, els bancs ni cobraments reals, així que aquests mòduls queden fora a propòsit.
portfolio_max_api_keys_exceededauthorization_error422El compte ja té el màxim de credencials ACTIVES que admet una cartera. El sostre regeix quan el compte té dos o més NIF reals i es compta sobre totes les credencials actives del compte, no per NIF, de manera que donar d'alta un altre NIF per encunyar-li la credencial tampoc no permet crear aquesta.
scope_not_allowed_by_planauthorization_error422Un dels abasts demanats pertany a un mòdul que el pla no inclou, així que la clau naixeria amb un permís que mai podria exercir.
scope_not_allowed_in_sandboxauthorization_error422Una clau de prova no pot néixer amb abasts de mòduls vetats a la sandbox.

Relacionat

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport