Codis d'error d'Automatitzacions

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

Code	Type	HTTP	Descripció
`automation_action_order_invalid`	`invalid_request_error`	422	La posició d'un pas dins de la seqüència no és un número enter, o és negativa. Aquella posició és la que fixa l'ordre en què s'executen les accions.
`automation_action_parameter_missing`	`invalid_request_error`	422	No ha arribat un paràmetre que l'acció declara obligatori. Es rebutja aquí, en lloc d'omplir-lo amb un valor per defecte dins de l'adaptador, perquè l'assaig predigui l'execució real.
`automation_action_parameter_unknown`	`invalid_request_error`	422	Una clau de paràmetre no pertany a l'esquema de l'acció. Acceptar-la desaria una configuració que cap adaptador llegeix, i la creuries activa fins que la regla es disparés i fes una altra cosa.
`automation_action_parameter_value_invalid`	`invalid_request_error`	422	Un paràmetre de l'acció porta un valor fora del conjunt que admet el seu esquema.
`automation_action_parameters_invalid`	`invalid_request_error`	422	Els paràmetres d'una acció no se sostenen com a conjunt: un valor no és serialitzable, una clau no és text, han arribat junts dos paràmetres excloents, o una parella que n'exigeix un dels dos ha arribat sense cap.
`automation_action_type_invalid`	`invalid_request_error`	422	Un dels passos declara un tipus d'acció sense adaptador al darrere, així que en aquella posició no s'executaria res.
`automation_chain_depth_exceeded`	`invalid_request_error`	422	Una automatització en va disparar una altra fins a exhaurir el marge d'encadenament, així que l'execució s'atura abans d'encuar cap pas. Esperar no ho arregla: el mateix esdeveniment tornaria a recórrer la mateixa cadena.
`automation_condition_combinator_invalid`	`invalid_request_error`	422	Una branca de la condició declara un combinador lògic fora del conjunt admès, així que la branca no es pot llegir com un «i» ni com un «o».
`automation_condition_depth_exceeded`	`invalid_request_error`	422	La condició nidifica més nivells dels que recorre l'avaluador, així que la regla no es pot avaluar sencera.
`automation_condition_expression_invalid`	`invalid_request_error`	422	La forma de l'arbre de condicions no se sosté: un node mal format, un operador que rep un valor de la mena equivocada, una ruta de camp que no és un camí amb punts, o un arbre que passa del límit de profunditat o de nodes.
`automation_condition_field_not_evaluable`	`invalid_request_error`	422	La condició llegeix un camp que el disparador no publica com a avaluable. La llista de camps admesos mai no resol una ruta desconeguda amb un valor per defecte, perquè un camp resolt en silenci és justament el forat que el sandbox existeix per tancar.
`automation_condition_operator_invalid`	`invalid_request_error`	422	Una comparació de la condició anomena un operador fora del conjunt admès.
`automation_condition_operator_not_applicable`	`invalid_request_error`	422	L'operador no s'aplica al tipus del camp que compara: preguntar si un text és més gran que un altre no és una comparació que l'avaluador pugui fer.
`automation_condition_operator_unsupported`	`invalid_request_error`	422	L'avaluador no implementa aquell operador, així que s'atura en lloc de respondre «fals»: un «fals» en silenci faria indistingible «la condició no es compleix» de «no es pot avaluar».
`automation_condition_payload_field_missing`	`invalid_request_error`	422	La clau que llegeix la condició no ve al payload de l'esdeveniment, que no és el mateix que venir present amb valor nul. Alguns esdeveniments porten un payload reduït: un esborrat, per exemple, pot conservar només l'identificador.
`automation_condition_payload_type_mismatch`	`invalid_request_error`	422	El valor de l'esdeveniment contradiu el tipus que el disparador declara per a aquell camp, i l'avaluador no converteix tipus: una comparació per conversió donaria un veredicte correcte per accident i amagaria que el payload va canviar de forma.
`automation_dry_run_event_type_mismatch`	`invalid_request_error`	422	L'assaig s'ha demanat amb un tipus d'esdeveniment diferent del disparador de l'automatització que s'assaja, i una regla només rep esdeveniments del seu propi disparador. La predicció descriuria un lliurament que mai no passarà.
`automation_event_company_unresolvable`	`invalid_request_error`	422	L'esdeveniment va arribar al motor sense una empresa resoluble, i el motor s'atura en lloc de suposar-ne una: escriure una execució sota una empresa substituïda trencaria l'aïllament entre empreses.
`automation_event_payload_not_resolvable`	`invalid_request_error`	422	No s'ha pogut recuperar el contingut de l'esdeveniment, així que no hi ha payload per congelar a l'execució. Passa quan el recurs que hi ha darrere de l'esdeveniment ja no es pot llegir en el moment del lliurament.
`automation_monthly_budget_exhausted`	`payment_required_error`	402	L'empresa va exhaurir les execucions d'automatització que el seu pla inclou per al període en curs, així que l'execució s'atura abans d'encuar cap pas. A diferència d'un límit de ritme, esperar uns segons no canvia res: el que s'ha exhaurit és el pressupost del cicle.
`automation_portfolio_scope_forbids_action`	`invalid_request_error`	422	Una de les accions de l'automatització actua sobre dades d'una sola empresa, i en abast de cartera cada execució té per subjecte una empresa gestionada diferent. Només s'admeten les accions que avisen la gestoria o que no toquen cap document.
`automation_portfolio_scope_not_available`	`authorization_error`	403	L'empresa no pot crear automatitzacions sobre la seva cartera: o no té contractat el mòdul de gestoria, o ella mateixa és una empresa gestionada per una altra, i la relació és d'un sol nivell.
`automation_rate_limit_exceeded`	`rate_limit_error`	429	L'empresa va superar les execucions d'automatització que el seu pla admet dins de la finestra del limitador. La feina sí que és admissible; senzillament va arribar massa de pressa.
`automation_replay_not_allowed`	`invalid_request_error`	422	L'execució existeix i és teva, però rellançar-la no escau: encara no ha acabat, va acabar bé i el seu efecte ja es va produir, el seu desenllaç tornaria a prendre exactament la mateixa branca, o no consta el motiu pel qual va acabar.
`automation_rule_actions_empty`	`invalid_request_error`	422	L'automatització no declara cap acció, així que no hi hauria res a executar quan saltés el seu disparador.
`automation_rule_actions_limit_exceeded`	`invalid_request_error`	422	La regla conté més de 50 accions. Un sol esdeveniment disparador es multiplicaria en massa passos, jobs en cua i possibles efectes externs.
`automation_rule_already_deleted`	`invalid_request_error`	422	L'automatització ja estava donada de baixa. L'esborrat és lògic i no retorna èxit en silenci la segona vegada, perquè dues baixes diferents no es confonguin entre elles.
`automation_rule_company_mismatch`	`invalid_request_error`	422	L'automatització que s'anava a materialitzar no pertany a l'empresa de l'esdeveniment, així que l'execució no es crea: congelar el snapshot d'un esdeveniment —client, imports, identificador fiscal— en files d'una altra empresa no es permet mai.
`automation_rule_name_invalid`	`invalid_request_error`	422	El nom és buit o supera el límit de longitud. El nom és el que identifica l'automatització als llistats i a l'historial de les seves execucions.
`automation_rule_not_found`	`not_found_error`	404	No existeix cap automatització amb aquest identificador per a l'empresa autenticada. Una regla d'una altra empresa respon exactament igual, així que la resposta mai no revela si existeix en un altre lloc.
`automation_rule_scope_immutable`	`invalid_request_error`	422	La petició intenta canviar l'abast d'una automatització que ja existeix. L'abast es fixa en crear-la perquè determina de quines empreses observa els esdeveniments, i canviar-lo reinterpretaria totes les execucions anteriors.
`automation_rule_scope_invalid`	`invalid_request_error`	422	L'abast enviat no pertany al catàleg de l'automatització. Només n'hi ha dos: l'empresa que la crea i la cartera d'empreses gestionades.
`automation_rule_status_transition_invalid`	`invalid_request_error`	422	L'automatització no pot passar del seu estat actual al que demanes: activar, pausar i donar de baixa accepten cadascun els seus propis estats d'origen.
`automation_rule_uuid_invalid`	`invalid_request_error`	422	L'identificador no és un UUID v7 vàlid. Les automatitzacions adrecen els seus recursos amb l'`id` que retorna l'API, mai amb un número intern.
`automation_rule_version_not_found`	`not_found_error`	404	L'automatització existeix, però no té cap versió amb aquest número: cada desada publica una versió nova i la numeració mai no reutilitza un valor.
`automation_rule_version_number_invalid`	`invalid_request_error`	422	El número de versió és menor que 1. Les versions es numeren des d'un cap amunt, en l'ordre en què es van publicar.
`automation_rule_version_snapshot_not_found`	`not_found_error`	404	L'execució apunta a una versió de l'automatització la definició congelada de la qual no està desada, així que no hi ha definició per executar: una execució sempre corre la versió amb què va començar, mai la regla viva.
`automation_run_not_found`	`not_found_error`	404	No existeix cap execució d'automatització amb aquest identificador per a l'empresa autenticada. Una execució d'una altra empresa respon exactament igual, així que la resposta mai no revela si existeix en un altre lloc.
`automation_run_status_transition_invalid`	`invalid_request_error`	422	L'execució no pot passar del seu estat actual al sol·licitat: el cicle de vida d'una execució només admet les transicions que declara el seu estat.
`automation_run_step_not_found`	`not_found_error`	404	L'execució existeix i és teva, però no té cap pas en aquest índex. Una execució materialitza tots els seus passos en arrencar i el nombre no canvia després.
`automation_run_uuid_invalid`	`invalid_request_error`	422	L'identificador de l'execució no és un UUID v7 vàlid.
`automation_step_index_invalid`	`invalid_request_error`	422	L'índex d'un pas no pot ser negatiu: cap execució adreça un pas així.
`automation_step_status_transition_invalid`	`invalid_request_error`	422	El pas no pot passar del seu estat actual al sol·licitat. És el que impedeix reclamar dues vegades un pas ja acabat, i aquella guarda és la que fa que un rellançament produeixi cada efecte una sola vegada.
`automation_step_subject_company_mismatch`	`invalid_request_error`	422	L'element sobre el qual anava a actuar l'acció no pertany a l'empresa de l'execució, o no s'ha pogut determinar a quina empresa pertany. En tots dos casos el pas avorta abans d'invocar l'adaptador, així que no es produeix cap efecte.
`automation_subject_company_ownership_not_verified`	`invalid_request_error`	422	En preparar l'execució no es va poder demostrar que l'empresa de l'esdeveniment continuï sent una empresa gestionada i activa de qui va crear l'automatització. Pot ser que el vincle s'arxivés, que l'empresa es donés de baixa o que l'execució arribés amb dades creuades.
`automation_trigger_not_found`	`not_found_error`	404	El disparador no és al catàleg que la teva empresa pot veure. Un nom que no existeix i un disparador real el mòdul del qual la teva empresa no té concedit responen igual, així que la resposta mai no confirma quin dels dos casos és.
`automation_trigger_payload_contract_unknown`	`invalid_request_error`	422	El disparador no publica contracte de camps avaluables, així que no hi ha catàleg contra el qual resoldre una condició.
`automation_trigger_type_invalid`	`invalid_request_error`	422	L'escriptura porta un disparador que no és al catàleg disponible per a la teva empresa, així que la regla no rebria cap esdeveniment.

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 d'Automatitzacions

Relacionat

En aquesta pàgina