{"id":444900,"date":"2026-09-21T01:31:24","date_gmt":"2026-09-20T23:31:24","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/api-rest-comptabilite-analytique\/"},"modified":"2026-09-21T02:14:14","modified_gmt":"2026-09-21T00:14:14","password":"","slug":"api-rest-comptabilite-analytique","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/api\/api-rest-comptabilite-analytique\/","title":{"rendered":"API REST \u2013 Comptabilit\u00e9 analytique"},"content":{"rendered":"

L’API permet de consulter les affectations comptabilis\u00e9es, les \u00e9tats analytiques et leur rapprochement avec la comptabilit\u00e9 g\u00e9n\u00e9rale. Elle permet aussi de configurer les axes, de corriger une ligne enregistr\u00e9e et de reclasser une part apr\u00e8s cl\u00f4ture.<\/p>\n

Les op\u00e9rations ci-dessous utilisent la session de l’API REST<\/a>. Les droits de l’utilisateur connect\u00e9 s’appliquent \u00e0 la soci\u00e9t\u00e9, \u00e0 la pi\u00e8ce, aux axes et aux valeurs demand\u00e9s.<\/p>\n

Consulter les chiffres<\/h2>\n
\n\n\n\n\n\n\n\n\n\n\n
Op\u00e9ration GET<\/th>\nR\u00e9sultat<\/th>\n<\/tr>\n<\/thead>\n
analytic_entry<\/code><\/td>\nParts enregistr\u00e9es d’une \u00e9criture comptable, avec leurs axes, valeurs et origine. Param\u00e8tre : id<\/code>, identifiant Webservice de l’\u00e9criture.<\/td>\n<\/tr>\n
analytic_axis_totals<\/code><\/td>\nD\u00e9bit, cr\u00e9dit et net par valeur d’un axe. Param\u00e8tres : organizationId<\/code>, dateFrom<\/code>, dateTo<\/code>, axisId<\/code>, accountPrefix<\/code> facultatif.<\/td>\n<\/tr>\n
analytic_cross_axis<\/code><\/td>\nTableau crois\u00e9 de deux axes, avec \u00ab Non ventil\u00e9 \u00bb, totaux et indicateurs de rapprochement. Param\u00e8tres : soci\u00e9t\u00e9, dates, rowAxisId<\/code>, columnAxisId<\/code>.<\/td>\n<\/tr>\n
analytic_profit_and_loss<\/code><\/td>\nCompte de r\u00e9sultat analytique et comparaison au total comptable. Param\u00e8tres : soci\u00e9t\u00e9, dates, axisId<\/code>, analyticValueId<\/code> facultatif.<\/td>\n<\/tr>\n
analytic_general_ledger<\/code><\/td>\nLignes du grand livre filtr\u00e9es par axe, valeur, compte et \u00e9ventuellement un second axe. Param\u00e8tres : soci\u00e9t\u00e9, dates, axisId<\/code>, analyticValueId<\/code>, accountPrefix<\/code>, secondAxisId<\/code>, secondValueId<\/code>.<\/td>\n<\/tr>\n
analytic_key_distribution<\/code><\/td>\nParts d’une cl\u00e9 fixe et valeurs disponibles. Param\u00e8tre : id<\/code>, identifiant Webservice de la cl\u00e9.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

Dans les op\u00e9rations de rapport, les identifiants de soci\u00e9t\u00e9 et d’axes sont les identifiants num\u00e9riques des enregistrements ; les identifiants de pi\u00e8ce et de cl\u00e9 utilisent le format Webservice Nx123<\/code>. Les dates sont au format AAAA-MM-JJ<\/code>.<\/p>\n

Les montants sont exprim\u00e9s dans la devise comptable de la soci\u00e9t\u00e9. \u00ab Non ventil\u00e9 \u00bb est inclus dans les totaux analytiques ; un \u00e9cart de couverture indique s\u00e9par\u00e9ment les \u00e9critures g\u00e9n\u00e9rales qui n’ont pas encore de parts enregistr\u00e9es. Pour deux soci\u00e9t\u00e9s de devises comptables diff\u00e9rentes, demandez deux rapports distincts.<\/p>\n

Saisir ou corriger une affectation par ligne<\/h2>\n

Utilisez l’op\u00e9ration POST<\/strong> update_analytic_line_choice<\/code> pour changer un axe sur une ligne d\u00e9j\u00e0 enregistr\u00e9e. L’op\u00e9ration met \u00e0 jour le choix, r\u00e9g\u00e9n\u00e8re les \u00e9critures et renvoie l’affectation enregistr\u00e9e. Elle exige une p\u00e9riode comptable ouverte et le droit de modifier la pi\u00e8ce ainsi que l’affectation analytique.<\/p>\n

\n\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nValeur<\/th>\n<\/tr>\n<\/thead>\n
sourceId<\/code><\/td>\nIdentifiant Webservice de la facture fournisseur ou de la saisie manuelle.<\/td>\n<\/tr>\n
lineKey<\/code><\/td>\nCl\u00e9 stable de la ligne, renvoy\u00e9e avec la ligne enregistr\u00e9e.<\/td>\n<\/tr>\n
axisId<\/code><\/td>\nIdentifiant Webservice de l’axe.<\/td>\n<\/tr>\n
mode<\/code><\/td>\nautomatic<\/code>, value<\/code>, key<\/code> ou unallocated<\/code>.<\/td>\n<\/tr>\n
targetId<\/code><\/td>\nIdentifiant Webservice de la valeur pour value<\/code>, ou de la cl\u00e9 de r\u00e9partition pour key<\/code> ; cha\u00eene vide dans les autres cas.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
curl -X POST 'https:\/\/apps.kafinea.com\/YourKafinea\/webservice.php' \\\n  -d 'operation=update_analytic_line_choice' \\\n  -d 'sessionName=YOUR_SESSION_ID' \\\n  -d 'sourceId=81x123' \\\n  -d 'lineKey=00000000-0000-4000-8000-000000000001' \\\n  -d 'axisId=82x456' \\\n  -d 'mode=value' \\\n  -d 'targetId=83x789'\n<\/code><\/pre>\n
La cl\u00e9 de ligne doit provenir de la r\u00e9ponse de l’API pour la pi\u00e8ce concern\u00e9e. Sur une facture fournisseur, elle figure avec les lignes du document ; sur une saisie manuelle, avec ses lignes comptables. Le num\u00e9ro d’ordre de la ligne et le num\u00e9ro de compte ne remplacent pas cette cl\u00e9.<\/p>\n
Pour revenir aux r\u00e8gles de la soci\u00e9t\u00e9, envoyez mode=automatic<\/code> et un targetId<\/code> vide. Pour garder le montant dans l’analyse sans valeur sur cet axe, envoyez mode=unallocated<\/code>. Une cl\u00e9 fixe peut partager la m\u00eame ligne entre plusieurs valeurs ; les parts sont calcul\u00e9es \u00e0 partir du montant r\u00e9ellement comptabilis\u00e9.<\/p>\n
Reclasser apr\u00e8s cl\u00f4ture<\/h2>\n
Pour une p\u00e9riode close, l’op\u00e9ration POST<\/strong> reclassify_analytic_allocation<\/code> enregistre une correction dat\u00e9e du jour dans une p\u00e9riode ouverte. Elle cr\u00e9e deux mouvements analytiques de montants oppos\u00e9s : l’affectation de la p\u00e9riode close et l’\u00e9criture de comptabilit\u00e9 g\u00e9n\u00e9rale restent inchang\u00e9es.<\/p>\n
\n\n\n\n\n\n\n\n\n
Param\u00e8tre<\/th>\nValeur<\/th>\n<\/tr>\n<\/thead>\n
allocationId<\/code><\/td>\nIdentifiant Webservice de la part, fourni dans analytic_entry<\/code> sous portions[].id<\/code>.<\/td>\n<\/tr>\n
axisId<\/code><\/td>\nIdentifiant Webservice de l’axe \u00e0 corriger.<\/td>\n<\/tr>\n
targetValueId<\/code><\/td>\nIdentifiant Webservice de la nouvelle valeur ; cha\u00eene vide pour \u00ab Non ventil\u00e9 \u00bb.<\/td>\n<\/tr>\n
reason<\/code><\/td>\nMotif explicite de 5 \u00e0 255 caract\u00e8res.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n
L’op\u00e9ration exige une p\u00e9riode ouverte \u00e0 la date du jour, des droits comptables complets et la m\u00eame devise comptable pour les deux p\u00e9riodes. Une part d\u00e9j\u00e0 reclass\u00e9e demande une revue comptable avant une autre correction. Le grand livre analytique pr\u00e9sente les deux mouvements \u00e0 leur date ; les tableaux crois\u00e9s et le compte de r\u00e9sultat reprennent leur effet net.<\/p>\n
Configurer les axes et les cl\u00e9s<\/h2>\n
Les axes, valeurs, correspondances, r\u00e8gles et cl\u00e9s sont des param\u00e8tres accessibles par les op\u00e9rations habituelles de lecture et de saisie<\/a>, selon les droits de l’utilisateur. V\u00e9rifiez les champs disponibles et la port\u00e9e de la soci\u00e9t\u00e9 avant d’\u00e9crire. L’op\u00e9ration update_analytic_key_distribution<\/code> remplace toutes les parts d’une cl\u00e9 fixe en une fois ; le total doit \u00eatre exactement de 100 %.<\/p>\n
Le serveur MCP et l’Assistant Kafinea donnent acc\u00e8s \u00e0 ces m\u00eames \u00e9tats, aux corrections par ligne et au reclassement dat\u00e9, sous leurs contr\u00f4les de modification des donn\u00e9es. Une modification de param\u00e8tre ne r\u00e9\u00e9crit pas les montants d\u00e9j\u00e0 comptabilis\u00e9s.<\/p>\n
R\u00e9f\u00e9rences associ\u00e9es<\/h2>\n