Modifier une affectation bancaire

PATCH 
/api/v1/bank_allocations/:id

Change le montant brouillonné, ou retire l'affectation en positionnant status: "rejected". Les deux champs sont facultatifs mais au moins l'un des deux est requis ; les champs que vous envoyez sont appliqués et les autres gardent leur valeur stockée.

rejected est le seul statut que ce point d'entrée écrit. Une confirmation, c'est POST /api/v1/bank_operations/{id}/reconciliation, et une affectation déjà décidée ne peut jamais revenir à proposed. Une affectation CONFIRMÉE ne peut pas non plus être rejetée ici : l'argent doit d'abord revenir, par DELETE /api/v1/bank_operations/{id}/reconciliation.

Idempotency-Key est acceptée et facultative.

Request

Responses

200

L'affectation modifiée.

401

La requête ne porte aucun jeton, ou un jeton invalide ou expiré.

403

Votre jeton ne porte pas le scope write, ou la fonctionnalité bank_reconciliation est désactivée sur l'espace de travail de l'affectation.

404

Aucune affectation de cet identifiant n'est atteignable par les habilitations du jeton.

422

Le corps a été refusé. details nomme le champ. Causes : aucun champ inscriptible ; un allocated_amount négatif ou illisible ; un status autre que rejected ; un montant qui ferait dépasser le mouvement aux affectations actives de l'opération (allocation_exceeds_operation) ; une affectation dont l'état courant ne peut pas être rejeté - confirmed et le terminal rejected.

allocated_amount ne peut être modifié que tant que l'affectation est encore un brouillon - proposed ou unconfirmed. Sur une affectation confirmed, c'est refusé, parce que le montant n'est pas le seul enregistrement de ce qui a été soldé : un Invoice::Payment et une ligne de contrepartie sur l'écriture comptable disent la même chose, et modifier la seule colonne laisserait les trois en désaccord. Pour redimensionner une affectation soldée, transmettez le jeu complet souhaité à POST /api/v1/bank_operations/{id}/reconciliation, qui annule et reconfirme en une seule transaction et vérifie le verrou d'export. Sur une affectation rejected, c'est refusé également : un refus est définitif et son enregistrement n'est pas réécrit.