Aller au contenu principal

API - Gestion de l'analytique

Introduction

L’API Suite Expert permet de gérer l’analytique en comptabilité en offrant des endpoints dédiés à la récupération et à l’affectation des données analytiques aux écritures comptables. Cette fiche technique présente les fonctionnalités disponibles, les endpoints associés et les bonnes pratiques d’utilisation.

Consulter l'article Paramétrage de l'analytique pour plus d'informations.

Paramétrage du dossier ACD COMPTA

  • La gestion de l'analytique doit être activée dans ACD COMPTA pour permettre l'envoi d'écritures analytiques.
  • Il est possible de gérer jusqu'à 3 niveaux de sections.
  • Il est aussi possible de choisir une gestion analytique non hiérarchique, où les sections analytiques ne sont pas organisées selon un ordre de dépendance entre elles. Chaque section est alors indépendante et peut être utilisée sans contrainte de hiérarchie.

Récupération du Paramétrage comptable du dossier

Afin de savoir si la gestion de l’analytique est activée ou non sur le dossier, il faut utiliser le endpoint GET /compta/dossier.
Dans la réponse API, la section "Analytique" contient les informations suivantes :

"Analytique": {
   "Active": true,
   "Parametrage": {
       "NonHierarchise": false,
       "NombreNiveaux": X,
       "CompteCharges": true,
       "CompteProduits": true,
       "CompteBilan": false
   }
}

"Active": true → la gestion analytique est activée.

"NonHierarchise": true → le plan analytique est non hiérarchisé.

"NombreNiveaux" : nombre de niveaux analytiques configurés (1, 2 ou 3).

"CompteCharges": true → l’analytique est activée sur les comptes de charges.

"CompteProduits": true → l’analytique est activée sur les comptes de produits.

"CompteBilan": true → l’analytique est activée sur les comptes de bilan.

Récupération du Paramétrage

Sections analytiques

Il est indispensable de récupérer le paramétrage des sections analytiques afin de l'utiliser dans une écriture comptable.

GET /v1/compta/paramètres/analytique

Exemple 1 : L'analytique n'est pas paramétrée sur le dossier

Réponse du endpoint :

[]

Exemple 2 : L'analytique est paramétrée avec 1 niveau (hiérarchique)

[
  {
    "SEC_LIB": "Nord",
    "SEC_N1": "NORD",
    "SEC_N2": "",
    "SEC_N3": "",
    "Sections": []
  },
  {
    "SEC_LIB": "SUD",
    "SEC_N1": "SUD",
    "SEC_N2": "",
    "SEC_N3": "",
    "Sections": []
  }
]

Exemple 3 : L'analytique est paramétrée avec 2 niveaux (hiérarchique)

[
  {
    "SEC_LIB": "Nord",
    "SEC_N1": "NORD",
    "Sections": [
      {"SEC_LIB": "Paris", "SEC_N1": "NORD", "SEC_N2": "PARIS", "Sections": []},
      {"SEC_LIB": "Lille", "SEC_N1": "NORD", "SEC_N2": "LILLE", "Sections": []}
    ]
  },
  {
    "SEC_LIB": "SUD",
    "SEC_N1": "SUD",
    "Sections": [
      {"SEC_LIB": "Marseille", "SEC_N1": "SUD", "SEC_N2": "MARS", "Sections": []},
      {"SEC_LIB": "Toulouse", "SEC_N1": "SUD", "SEC_N2": "TOUL", "Sections": []}
    ]
  }
]

Exemple 4 : L'analytique est paramétrée avec 2 niveaux (NON hiérarchique)

[
   {
       "SEC_LIB": "Site 1",
       "SEC_N1": "SITE1",
       "SEC_N2": "",
       "SEC_N3": "",
       "Sections": []
   },
   {
       "SEC_LIB": "Site 2",
       "SEC_N1": "SITE2",
       "SEC_N2": "",
       "SEC_N3": "",
       "Sections": []
   },
   {
       "SEC_LIB": "Commercial",
       "SEC_N1": "",
       "SEC_N2": "COM",
       "SEC_N3": "",
       "Sections": []
   },
   {
       "SEC_LIB": "Administratif",
       "SEC_N1": "",
       "SEC_N2": "ADM",
       "SEC_N3": "",
       "Sections": []
   },
   {
       "SEC_LIB": "Production",
       "SEC_N1": "",
       "SEC_N2": "PROD",
       "SEC_N3": "",
       "Sections": []
   }
]

Paramétrage des comptes

La récupération du plan comptable permet de vérifier si la gestion analytique est autorisée sur un compte et si une clé de répartition y est associée.

L'endpoint qui doit être utilisé est le suivant :

GET /v1/compta/comptes/generaux

  • "ActivationAnalytique": false → indique que la transmission d’une répartition analytique n’est pas autorisée pour ce compte

  • "ActivationAnalytique": true → indique qu’une répartition analytique doit être transmise pour ce compte.

Si une clé de répartition est définie sur le compte, elle est indiquée dans le champ CleRepartition.

Si cette clé est paramétrée en saisie automatique, l’information est renvoyée avec "Auto": true.

Dans ce cas, si aucune section analytique n’est transmise dans l’écriture comptable, la clé de répartition sera appliquée automatiquement lors de l’intégration de l’écriture.

Exemple 1 : l’analytique n'est pas activée sur le compte.

Dans ce cas, il sera interdit d'utiliser une répartition analytique lors de l’utilisation de ce compte dans une écriture comptable.

{
   "Code": "60700001",
   "ActivationAnalytique": false
   }
}

Exemple 2 : l’analytique est activée sur le compte et une clé de répartition automatique est rattachée à ce compte.

Dans ce cas, il ne sera pas nécessaire de préciser la répartition analytique lors de l’utilisation de ce compte dans une écriture comptable.

{
   "Code": "60700002",
   "ActivationAnalytique": true,
   "CleRepartition": {
       "Code": "CLE1",
       "Lib": "Clé 1",
       "Auto": true
   }
}

Exemple 3 : l’analytique est activée sur le compte, une clé de répartition non automatique est rattachée à ce compte.

Dans ce cas, il sera obligatoire de préciser la répartition analytique lors de l’utilisation de ce compte dans une écriture comptable.

{
   "Code": "60700002",
   "ActivationAnalytique": true,
   "CleRepartition": {
       "Code": "CLE1",
       "Lib": "Clé 1",
       "Auto": false
   }
}

 

Exemple 4 : l’analytique est activée sur le compte, mais aucune clé de répartition n’est rattachée à ce compte.

Dans ce cas, il sera obligatoire de préciser la répartition analytique lors de l’utilisation de ce compte dans une écriture comptable.

{
   "Code": "60700004",
   "ActivationAnalytique": true
}

 

Saisie d'une Écriture Comptable avec des Sections Analytiques

Il est possible d'indiquer sur une ligne d'écriture la répartition analytique de la ligne en utilisant les sections récupérées avec le endpoint.

Exemple 1 : Analytique sur Compte de Charge (Dossier paramétré avec 1 section analytique)

{
  "journal": "AC",
  "mois": 1,
  "annee": 2025,
  "lignesEcriture": [
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "FAARO",
      "libelle": "Achat de marchandise",
      "credit": 7722,
      "debit": 0,
      "modeReglement": "V"
    },
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "60700100",
      "libelle": "Achat de marchandise",
      "credit": 0,
      "debit": 6435,
      "analytiques": [
        { "Debit": 5791.5, "Credit": 0, "Section1": "NORD" },
        { "Debit": 643.5, "Credit": 0, "Section1": "SUD" }
      ]
    },
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "44566000",
      "libelle": "Achat de marchandise",
      "credit": 0,
      "debit": 1287
    }
  ]
}

 

Exemple 1 : Analytique sur Compte de Charge (Dossier paramétré avec 2 sections analytiques)

{
  "journal": "AC",
  "mois": 1,
  "annee": 2025,
  "lignesEcriture": [
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "FAARO",
      "libelle": "Achat de marchandise",
      "credit": 7722,
      "debit": 0,
      "modeReglement": "V"
    },
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "60700100",
      "libelle": "Achat de marchandise",
      "credit": 0,
      "debit": 6435,
      "analytiques": [
        { "Debit": 5791.5, "Credit": 0, "Section1": "NORD", "Section2": "PARIS" },
        { "Debit": 643.5, "Credit": 0, "Section1": "SUD", "Section2": "TOUL" }
      ]
    },
    {
      "jour": 5,
      "numeroPiece": "155737",
      "compte": "44566000",
      "libelle": "Achat de marchandise",
      "credit": 0,
      "debit": 1287
    }
  ]
}

Articles associés