--- title: "Corrige une écriture : montant, date, type, commentaire, TVA ou période couverte." method: PATCH path: "/api/v1/balances/{balance_id}" tags: ["balances"] --- # Corrige une écriture : montant, date, type, commentaire, TVA ou période couverte. `PATCH /api/v1/balances/{balance_id}` ## Request - Base URL: `https://api.qalimo.fr` - URL: `https://api.qalimo.fr/api/v1/balances/{balance_id}` - Auth: HTTP bearer Une écriture brouillon est modifiée en place. Une écriture comptabilisée dans une période close est contrepassée puis remplacée par une écriture corrigée datée du jour — les deux sont renvoyées. ## Request body - BalanceUpdateInput - `amount` number: Nouveau montant signé. - `date` string, date: Nouvelle date de l'écriture. - `type` string: Nouveau type d'écriture. - `comment` string, nullable: Nouveau commentaire. - `vat_rate` 0 | 2.1 | 5.5 | 8.5 | 10 | 20: Nouveau taux de TVA. - `period_start` string, date, nullable: Nouveau début de la période couverte. - `period_end` string, date, nullable: Nouvelle fin de la période couverte. ## Response `200` OK - BalanceUpdateResult - `balance` BalanceDetail, required - `id` integer, required: Identifiant de l'écriture. - `date` string, date, required: Date de l'écriture. - `type` 'abonnement_internet_locataire' | 'abonnement_logiciel' | 'achat_electromenager' | 'achat_materiel' | 'achat_mobilier' | 'agios' | 'appel_charge' | 'appel_charge_exceptionnelle' | 'appel_complementaire' | 'appel_dg' | 'appel_divers' | 'appel_fonds_bailleur' | 'appel_loyer' | 'appel_remboursement' | 'appel_reparation' | 'appel_taxe_fonciere' | 'appel_toem' | 'apport_cca' | 'assurance' | 'assurance_autres' | 'assurance_gli' | 'assurance_mri' | 'assurance_pj' | 'assurance_pno' | 'assurance_pret' | 'assurance_vacance' | 'autre' | 'autre_nd_nr' | 'autre_recette' | 'autre_recuperable' | 'autre_revenus' | 'autres_locations' | 'avance_tresorerie' | 'avoir_honoraires' | 'avoir_remise' | 'blanchisserie' | 'cadeaux' | 'carburant' | 'charge' | 'charges_autre' | 'charges_autre_recuperable' | 'commissions' | 'complement_dg' | 'comptabilite' | 'conciergerie' | 'conservation_dg' | 'constitution_reserve' | 'construction' | 'copro_non_recuperable' | 'copro_provisions' | 'copro_recuperable' | 'copro_regularisation' | 'cotisation_oga' | 'cotisation_syndicale' | 'creance_irrecouvrable' | 'creance_perte' | 'deplacement' | 'deplacement_ik' | 'deplacement_peage' | 'deplacement_transport' | 'desinsectisation' | 'dg_restitue' | 'diagnostics' | 'dividendes' | 'droit_entree' | 'droits_mutation' | 'emprunt_autres' | 'energie_commun' | 'energie_privee' | 'entretien_menage' | 'entretien_nr' | 'entretien_r' | 'espaces_verts' | 'fonds_travaux' | 'forfait_gestion' | 'formation' | 'fournitures' | 'frais_administratifs_agence' | 'frais_agence_achat' | 'frais_assemblee' | 'frais_bancaire' | 'frais_bancaires_mandat' | 'frais_constitution' | 'frais_dossier_bancaire' | 'frais_eviction' | 'frais_garantie' | 'frais_gestion' | 'frais_justice_locataire' | 'frais_notaire' | 'frais_procedure_nr' | 'frais_procedure_r' | 'honoraires_agence_divers' | 'honoraires_divers' | 'honoraires_edl_bailleur' | 'honoraires_edl_locataire' | 'honoraires_juridiques' | 'honoraires_location_locataire' | 'honoraires_mise_en_location' | 'honoraires_recouvrement' | 'honoraires_relocation' | 'honoraires_renouvellement' | 'honoraires_sinistre' | 'honoraires_suivi_travaux' | 'impots' | 'impots_cfe' | 'impots_habitation' | 'impots_is' | 'impots_tf' | 'impots_tva' | 'indemnite' | 'indemnite_assurance' | 'indemnite_assurance_locataire' | 'indemnite_eviction_locataire' | 'indemnite_occupation' | 'interet' | 'interets_cca' | 'interets_retard' | 'location_vehicule_tourisme' | 'location_vehicule_utilitaire' | 'loyer_siege' | 'paiement' | 'paiement_bailleur' | 'paiement_caf' | 'paiement_caution' | 'paiement_dg' | 'paiement_honoraires' | 'penalites' | 'prelevement_honoraires' | 'prelevement_personnel' | 'prime_gli_refacturee' | 'publicite' | 'recette_autre' | 'recettes_diverses' | 'recettes_loyer' | 'reglement_assurance' | 'reglement_fournisseur' | 'reglement_frais_justice' | 'reglement_syndic' | 'reglement_taxe_fonciere' | 'regul_charges_locataire' | 'remboursement' | 'remboursement_avance' | 'remboursement_cca' | 'remboursement_dg' | 'remboursement_emprunt' | 'remboursement_tva' | 'remuneration_gerant' | 'renovation_energetique' | 'reparation' | 'repas' | 'reprise_reserve' | 'reprise_solde_avoir' | 'reprise_solde_dette' | 'retenue_dg' | 'retenue_dg_loyers' | 'reversement_dg_bailleur' | 'solde_cloture_mandat' | 'subvention' | 'taxe_balayage' | 'taxe_logement_vacant' | 'taxe_sejour' | 'telephone' | 'timbres_colis' | 'toem' | 'transfert_dg' | 'travaux_carrelage' | 'travaux_chauffage' | 'travaux_cuisine_sdb' | 'travaux_electricite' | 'travaux_facade' | 'travaux_isolation' | 'travaux_maconnerie' | 'travaux_menuiserie' | 'travaux_peinture' | 'travaux_plomberie' | 'travaux_serrurerie' | 'travaux_toiture' | 'travaux_vmc' | 'vaisselle_linge' | 'versement_emprunt' | 'null', nullable: Type d'écriture. - `amount` number, required: Montant signé : négatif pour un appel (dû), positif pour un paiement. - `domain` 'tenant' | 'property' | 'folder' | 'profile_bailleur' | 'compte', required: Domaine de rattachement. - `parent_id` integer, required: Identifiant de l'entité de rattachement, à interpréter selon domain. - `comment` string, nullable: Commentaire libre. - `correlation_id` string, nullable: Identifiant de corrélation des écritures créées ensemble. - `transaction_id` integer, nullable: Identifiant de la transaction bancaire rapprochée. - `file_id` integer, nullable: Identifiant du justificatif attaché. - `period_start` string, date, nullable: Début de la période couverte. - `period_end` string, date, nullable: Fin de la période couverte. - `vat_rate` number, nullable: Taux de TVA appliqué (0 si non soumis). - `reversal` union: Contrepassation créée si l'écriture originale était comptabilisée dans une période close. - BalanceDetail - `id` integer, required: Identifiant de l'écriture. - `date` string, date, required: Date de l'écriture. - `type` 'abonnement_internet_locataire' | 'abonnement_logiciel' | 'achat_electromenager' | 'achat_materiel' | 'achat_mobilier' | 'agios' | 'appel_charge' | 'appel_charge_exceptionnelle' | 'appel_complementaire' | 'appel_dg' | 'appel_divers' | 'appel_fonds_bailleur' | 'appel_loyer' | 'appel_remboursement' | 'appel_reparation' | 'appel_taxe_fonciere' | 'appel_toem' | 'apport_cca' | 'assurance' | 'assurance_autres' | 'assurance_gli' | 'assurance_mri' | 'assurance_pj' | 'assurance_pno' | 'assurance_pret' | 'assurance_vacance' | 'autre' | 'autre_nd_nr' | 'autre_recette' | 'autre_recuperable' | 'autre_revenus' | 'autres_locations' | 'avance_tresorerie' | 'avoir_honoraires' | 'avoir_remise' | 'blanchisserie' | 'cadeaux' | 'carburant' | 'charge' | 'charges_autre' | 'charges_autre_recuperable' | 'commissions' | 'complement_dg' | 'comptabilite' | 'conciergerie' | 'conservation_dg' | 'constitution_reserve' | 'construction' | 'copro_non_recuperable' | 'copro_provisions' | 'copro_recuperable' | 'copro_regularisation' | 'cotisation_oga' | 'cotisation_syndicale' | 'creance_irrecouvrable' | 'creance_perte' | 'deplacement' | 'deplacement_ik' | 'deplacement_peage' | 'deplacement_transport' | 'desinsectisation' | 'dg_restitue' | 'diagnostics' | 'dividendes' | 'droit_entree' | 'droits_mutation' | 'emprunt_autres' | 'energie_commun' | 'energie_privee' | 'entretien_menage' | 'entretien_nr' | 'entretien_r' | 'espaces_verts' | 'fonds_travaux' | 'forfait_gestion' | 'formation' | 'fournitures' | 'frais_administratifs_agence' | 'frais_agence_achat' | 'frais_assemblee' | 'frais_bancaire' | 'frais_bancaires_mandat' | 'frais_constitution' | 'frais_dossier_bancaire' | 'frais_eviction' | 'frais_garantie' | 'frais_gestion' | 'frais_justice_locataire' | 'frais_notaire' | 'frais_procedure_nr' | 'frais_procedure_r' | 'honoraires_agence_divers' | 'honoraires_divers' | 'honoraires_edl_bailleur' | 'honoraires_edl_locataire' | 'honoraires_juridiques' | 'honoraires_location_locataire' | 'honoraires_mise_en_location' | 'honoraires_recouvrement' | 'honoraires_relocation' | 'honoraires_renouvellement' | 'honoraires_sinistre' | 'honoraires_suivi_travaux' | 'impots' | 'impots_cfe' | 'impots_habitation' | 'impots_is' | 'impots_tf' | 'impots_tva' | 'indemnite' | 'indemnite_assurance' | 'indemnite_assurance_locataire' | 'indemnite_eviction_locataire' | 'indemnite_occupation' | 'interet' | 'interets_cca' | 'interets_retard' | 'location_vehicule_tourisme' | 'location_vehicule_utilitaire' | 'loyer_siege' | 'paiement' | 'paiement_bailleur' | 'paiement_caf' | 'paiement_caution' | 'paiement_dg' | 'paiement_honoraires' | 'penalites' | 'prelevement_honoraires' | 'prelevement_personnel' | 'prime_gli_refacturee' | 'publicite' | 'recette_autre' | 'recettes_diverses' | 'recettes_loyer' | 'reglement_assurance' | 'reglement_fournisseur' | 'reglement_frais_justice' | 'reglement_syndic' | 'reglement_taxe_fonciere' | 'regul_charges_locataire' | 'remboursement' | 'remboursement_avance' | 'remboursement_cca' | 'remboursement_dg' | 'remboursement_emprunt' | 'remboursement_tva' | 'remuneration_gerant' | 'renovation_energetique' | 'reparation' | 'repas' | 'reprise_reserve' | 'reprise_solde_avoir' | 'reprise_solde_dette' | 'retenue_dg' | 'retenue_dg_loyers' | 'reversement_dg_bailleur' | 'solde_cloture_mandat' | 'subvention' | 'taxe_balayage' | 'taxe_logement_vacant' | 'taxe_sejour' | 'telephone' | 'timbres_colis' | 'toem' | 'transfert_dg' | 'travaux_carrelage' | 'travaux_chauffage' | 'travaux_cuisine_sdb' | 'travaux_electricite' | 'travaux_facade' | 'travaux_isolation' | 'travaux_maconnerie' | 'travaux_menuiserie' | 'travaux_peinture' | 'travaux_plomberie' | 'travaux_serrurerie' | 'travaux_toiture' | 'travaux_vmc' | 'vaisselle_linge' | 'versement_emprunt' | 'null', nullable: Type d'écriture. - `amount` number, required: Montant signé : négatif pour un appel (dû), positif pour un paiement. - `domain` 'tenant' | 'property' | 'folder' | 'profile_bailleur' | 'compte', required: Domaine de rattachement. - `parent_id` integer, required: Identifiant de l'entité de rattachement, à interpréter selon domain. - `comment` string, nullable: Commentaire libre. - `correlation_id` string, nullable: Identifiant de corrélation des écritures créées ensemble. - `transaction_id` integer, nullable: Identifiant de la transaction bancaire rapprochée. - `file_id` integer, nullable: Identifiant du justificatif attaché. - `period_start` string, date, nullable: Début de la période couverte. - `period_end` string, date, nullable: Fin de la période couverte. - `vat_rate` number, nullable: Taux de TVA appliqué (0 si non soumis). - object, nullable ## Other responses - `422`: Unprocessable Content - `default`: Default error response --- [API](https://skmtc.dev/qalimo/apis/qalimo-api.md) · [All operations](https://skmtc.dev/qalimo/apis/qalimo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qalimo/apis/qalimo-api/revisions/f97d62827e94?raw)