Codis d'error de Compte

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

Code	Type	HTTP	Descripció
`access_level_raise_forbidden`	`invalid_request_error`	422	S'ha intentat pujar el nivell d'accés sobre un compte gestionat que el seu titular ja ha reclamat. Des de la reclamació només el titular pot pujar aquest nivell; el proveïdor només el pot baixar.
`account_not_found`	`not_found_error`	404	No es va poder resoldre el compte associat a la clau, cosa que sol voler dir que la clau ja no apunta a una empresa viva.
`administrator_key_not_grantable`	`invalid_request_error`	422	Una de les seccions de `grants` és una clau de l’Administrador (gestió d’usuaris, pla i subscripció, API i desenvolupadors o certificat digital) i aquestes seccions no es concedeixen a un membre.
`api_key_already_revoked`	`invalid_request_error`	422	La clau ja estava revocada, i una clau revocada no admet més operacions: la revocació és terminal.
`api_key_not_found`	`not_found_error`	404	L'identificador no correspon a cap clau API de l'empresa autenticada.
`enterprise_contract_transition_required`	`invalid_request_error`	422	El compte gestionat té un contracte enterprise i, en acabar la gestió, el seu pagament passaria al titular sense que Factuarea hagi fixat encara el pla amb què continua. Mai no es crea una subscripció sense preu, així que no s'ha canviat res.
`external_advisor_already_assigned`	`invalid_request_error`	422	El compte ja té un assessor extern marcat: només n'hi pot haver un per compte.
`grant_company_not_in_account`	`invalid_request_error`	422	El NIF del grant no és un NIF real del compte o queda fora de l'àmbit de NIF de la credencial. La resposta és la mateixa en tots dos casos, sense revelar quin.
`grants_only_for_member`	`invalid_request_error`	422	Només un membre amb rol `member` pot tenir permisos per NIF (grants). El titular (`owner`) i els administradors (`admin`) arriben a tots els NIF del compte, així que un grant sobre ells no significaria res.
`import_file_invalid`	`invalid_request_error`	422	Un dels fitxers de la importació no es pot llegir amb el format de la plantilla: no és un CSV llegible, la capçalera no apareix a les 20 primeres línies, li falta una columna obligatòria o té una línia trencada. `param` indica quin fitxer falla (`accounts_file` o `customers_file`) i el missatge, la columna o la línia. No s'ha escrit res.
`import_file_too_large`	`invalid_request_error`	413	Un dels fitxers de la importació supera els 5 MB. La mida es comprova abans de llegir cap fila, així que no s'ha processat ni escrit res. `param` indica quin fitxer falla (`accounts_file` o `customers_file`).
`import_in_progress`	`conflict_error`	409	Ja hi ha una importació massiva d'aquest compte proveïdor en curs. Les importacions d'un mateix compte s'apliquen d'una en una per no crear comptes, càrrecs ni NIF duplicats, així que aquesta no s'ha aplicat ni ha escrit res.
`import_row_limit_exceeded`	`invalid_request_error`	422	Un dels fitxers de la importació porta més files de les que admet una importació: 100 al fitxer de comptes (`accounts_file`) i 1.000 al de clients (`customers_file`). Les files es compten abans de llegir-les, així que no s'ha processat ni escrit res. `param` indica quin fitxer falla.
`invitation_expired`	`invalid_request_error`	422	La invitació existeix i és d'aquesta empresa, però la seva finestra d'acceptació ja s'ha tancat, de manera que qui la va rebre no la pot bescanviar.
`invitation_not_found`	`not_found_error`	404	L'identificador no correspon a cap invitació pendent de l'empresa autenticada: pot haver-se cancel·lat, haver-se acceptat ja o pertànyer a una altra empresa.
`live_credential_required`	`authorization_error`	403	Una clau de proves ha intentat modificar un compte de producció. Només passa en les operacions que canvien el compte —membres, invitacions, titularitat, traspassos de NIF, cartera de NIF, claus i seients—: una clau de proves no pot alterar dades reals.
`managed_account_external_ref_in_other_environment`	`conflict_error`	409	La referència externa ja la fa servir un compte gestionat de l'altre entorn (real o de proves). La referència és única entre els dos entorns, i la resposta no anomena aquest compte perquè aquest entorn no el llista. No s'ha escrit res.
`managed_account_not_claimable`	`invalid_request_error`	422	El compte gestionat és de proves, i un compte de proves no es reclama mai: no té val de reclamació per emetre ni per reemetre.
`managed_account_plan_not_self_serve`	`invalid_request_error`	422	S'ha demanat el pla `enterprise` per a un compte gestionat. Un compte gestionat es crea o es canvia a emprendedor o empresario; enterprise només l'assigna Factuarea per contracte.
`managed_account_provider_in_trial`	`invalid_request_error`	422	El compte proveïdor és en període de prova i ha demanat un compte gestionat real, que es cobra. Durant la prova només es poden crear comptes gestionats de proves.
`managed_accounts_limit_reached`	`invalid_request_error`	422	El compte proveïdor ja té tants comptes gestionats reals amb la gestió vigent com admet el seu límit. Els comptes gestionats de proves no compten per a aquest límit.
`member_is_last_owner`	`invalid_request_error`	422	L'operació deixaria el NIF sense cap persona que l'administri: el membre que es dona de baixa, o que es degrada a un rol sense administració, és l'últim amb rol `owner` o `admin` en aquest NIF.
`member_not_found`	`not_found_error`	404	L'identificador no correspon a cap membre de l'equip del compte: o aquesta persona no va pertànyer mai a l'empresa autenticada, o és d'una altra. La superfície de compte respon igual en tots dos casos.
`module_not_grantable`	`invalid_request_error`	422	Una de les seccions de `grants` no es pot concedir: no és una secció exclusiva d’administradors (un membre ja hi accedeix amb permisos normals) o l’empresa no la té pel seu pla.
`nif_transfer_expired`	`invalid_request_error`	422	El traspàs de NIF es va emetre de debò, però el seu termini de validesa ha vençut. A diferència d'un traspàs no reconegut, aquesta resposta només arriba a qui ja en tenia un de real, així que no revela res de nou.
`nif_transfer_invalid`	`invalid_request_error`	422	El traspàs de NIF presentat no autoritza res: el seu secret està mal copiat, truncat, ja consumit o no es va emetre mai. Tots aquests casos responen igual expressament, perquè l'operació no serveixi per sondejar quins traspassos existeixen.
`owner_transfer_forbidden`	`authorization_error`	403	Qui fa la petició no està autoritzat a transferir la titularitat del compte: o no és el titular actual, o el destinatari proposat no la pot rebre. És qüestió de permís, no de payload mal format.
`permissions_not_applicable_to_administrator`	`invalid_request_error`	422	El membre és `owner` o `admin` del compte: té tots els permisos del seu pla i no admet restriccions ni concessions de seccions.
`permissions_not_applicable_to_employee`	`invalid_request_error`	422	La persona és un empleat del portal de l’empleat: el seu accés el governa el portal i no la matriu de seccions, així que no admet restriccions ni concessions.
`plan_limit_exceeded`	`payment_required_error`	402	S'ha assolit un límit de recursos del pla de l'empresa.
`privileged_scope_required`	`authorization_error`	403	L'operació exigeix el privilegi de proveïdor de comptes (`accounts:read` o `accounts:write`) i no es compleix: o el compte de la clau no el té concedit, o la persona que va emetre la clau ja no és propietària ni administradora del compte. Les dues causes responen igual.
`provisioning_account_claimed`	`conflict_error`	409	El titular ja ha reclamat aquest compte gestionat i l'administra pel seu compte: ja no es pot tornar a reclamar, reemetre el seu val de reclamació ni tornar-lo a provisionar amb la mateixa referència externa.
`relation_already_exists`	`invalid_request_error`	422	Ja hi ha un accés pendent o vigent entre aquests dos comptes, i només en pot haver un d'obert per cada parella de comptes.
`relation_company_not_in_grantor`	`invalid_request_error`	422	La llista de NIF de l'accés no és vàlida: o anomena un NIF que no pertany al compte que cedeix l'accés, o arriba buida. L'error assenyala el camp `company_ids` i no diu quin dels NIF falla.
`relation_invitation_expired`	`invalid_request_error`	422	La invitació d'accés existeix i continua pendent, però el seu termini d'acceptació ha vençut, així que ja no es pot acceptar.
`relation_invitation_invalid`	`invalid_request_error`	422	La invitació d'accés presentada no serveix: el seu secret no existeix, ja s'ha fet servir, s'ha revocat o va adreçada a un altre compte. Tots aquests casos responen igual a propòsit, perquè l'operació no serveixi per sondejar invitacions alienes.
`relation_self_grant_not_allowed`	`invalid_request_error`	422	El compte indicat no pot rebre l'accés: o és el mateix compte que el cedeix, o l'identificador no correspon a un compte vàlid. Els dos casos responen igual.
`relation_transition_not_allowed`	`invalid_request_error`	422	L'accés entre comptes és en un estat que no admet el canvi demanat: per exemple, acceptar-ne un que ja és vigent o reenviar la invitació d'un que ja ha acabat.
`sender_identity_not_verified`	`invalid_request_error`	422	L'empresa emissora encara no ha acreditat la seva identitat, i sense això no pot escriure a destinataris externs des del domini remitent compartit. No és un cupó exhaurit ni un problema de permisos: la credencial té l'abast, i esperar no ho resol.

Relacionat

Codis d'error per categoria

Localitza un error per la categoria que l'emet.

Taula de referència completa

Tots els codis, estats HTTP, tipus i descripcions en una referència.

Model d'errors

Interpreta la resposta d'error i gestiona els errors per codi.

Codis d'error de Compte

Relacionat

En aquesta pàgina