API - Liste des codes erreurs lors de la création d’une écriture
Cet article recense l’ensemble des codes erreurs susceptibles d’être retournés par l’API lors de la création d’une écriture comptable (endpoint POST /v1/compta/ecriture).
Ces erreurs sont retournées lorsque les règles métier de la comptabilité ne sont pas respectées (contrôles de journal, équilibre, analytique, échéancier, TVA, etc.).
Format de retour
En cas d’erreur, l’API retourne :
Un code HTTP
Un message d’erreur
Un code métier permettant d’identifier précisément la règle bloquante
Liste des codes erreurs
Règles générales sur l’écriture
Code
Description
ecritureSansLigne
Une écriture doit contenir au minimum 2 lignes d'écriture
ecritureNonEquilibree
L'écriture n'est pas équilibrée
generationEcriture
Erreur lors de la génération de l'écriture
Journal
Code
Description
journalInexistant
Le journal n'existe pas
journalBloque
Le journal est bloqué
jourNonUniqueModePiece
La date doit être unique sur l'ensemble des lignes de l'écriture dans un journal de type pièce
Dates
Code
Description
dateInvalide
La date est invalide
dateNonCompriseNN1
La date ne se trouve pas dans l'exercice N ou N+1 du dossier
dateAnterieurEditionDef
La date de l'écriture ne doit pas être antérieure à la date de l'édition définitive
Pièce et facture
Code
Description
pieceInvalide
La pièce fait plus de 16 caractères
pieceNonUnique
Le numéro de pièce doit être unique sur l'ensemble des lignes de l'écriture sur un journal de type pièce
numeroFactureInactif
Le numéro de facture n'est pas activé sur le journal
numeroFactureInvalide
Le numéro de facture fait plus de 20 caractères
numeroFactureNonUnique
Le numéro de facture doit être unique sur l'ensemble des lignes de l'écriture sur un journal de type pièce
Comptes comptables
Code
Description
compteInexistant
Vous ne pouvez pas ajouter un compte de trésorerie à un journal qui n'est pas de nature trésorerie
compteCollectif
Impossible de générer une écriture sur le compte collectif
compteInterditSaisie
Le compte est paramétré comme interdit à la saisie
compteCaractereInterdit
Le code du compte comporte un ou des caractères interdits
TVA
Code
Description
codeTVAInexistant
Le code TVA n'existe pas
codeTVACompteInvalide
Le code de TVA doit être saisi sur une ligne d'écriture avec un compte hors taxe
Libellé et montants
Code
Description
libelleInvalide
Le libellé comporte un ou des caractères interdits
montantDebitEtCredit
Une ligne d'écriture ne peut pas contenir un montant au débit et au crédit
Mode de règlement
Code
Description
modeReglementInvalide
Le mode de règlement n'existe pas
modeReglementCompteInvalide
La ligne d'écriture avec le compte X ne peut pas contenir de mode de règlement
Gestion analytique
Code
Description
sectionAnalytiqueInexistante
Pour la gestion analytique de niveau 1, la section analytique X doit être renseignée et exister
analytiqueInactive
L'analytique n'est pas activé sur le dossier
analytiqueInactiveCompte
Le compte n'a pas l'analytique d'activée
analytiqueDebitCredit
Une ligne analytique ne peut pas avoir un montant au débit et au crédit
analytiqueSansMontant
Une ligne analytique doit avoir un montant au crédit ou au débit
analytiqueSoldeIncorrect
Le solde analytique n'est pas égal au montant de la ligne d'écriture
Échéancier
Code
Description
echeanceInactive
L'échéancier n'est pas activé
echeanceSoldeIncorrect
Pour un achat fournisseur, la somme des échéances doit être positive et égale au montant de la ligne d'écriture
echeanceSansMontant
Une ligne d'échéance doit avoir un montant
echeanceReglementInvalide
Le mode de règlement n'existe pas dans l'échéance
Unités et quantités
Code
Description
compteUniteInvalide
La quantité ou l'unité utilisée est invalide
quantiteManquante
Les unités de quantité 1 et 2 sont toutes les deux manquantes
quantiteAnalytiqueIncoherente
La ligne d'écriture ne contient pas de quantité, mais les analytiques comportent des quantités non nulles.