Aller au contenu principal

API - Gestion des quantités

Introduction

L’utilisation des quantités via l’API Suite Expert nécessite que plusieurs conditions soient réunies :

  • la fonctionnalité Gestion des quantités doit être activée dans le dossier,

  • les unités doivent être correctement paramétrées,

  • le compte comptable doit autoriser la saisie de quantités.

Lorsque l’ensemble de ces éléments est conforme, l’enregistrement d’écritures contenant des quantités peut s’effectuer normalement en API.

Pour plus d’informations sur le paramétrage des quantités dans le logiciel ACD COMPTA, vous pouvez consulter cet article depuis ce lien.
 

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

Pour déterminer si la gestion des quantités est activée sur un dossier, il convient d’interroger le endpoint :

  • GET /compta/dossier

Dans la réponse API, la rubrique "GestionQuantites" précise si cette fonctionnalité est active ou non.

Récupération des unités

Avant de saisir une écriture comptable avec des quantités, il est nécessaire de vérifier les paramètres de gestion des quantités via l'endpoint suivant :

Endpoint : compta/paramètres/quantite

Exemple de réponse :

[

    {
        "Code": "KG",
        "Libelle": "Kilos",
        "PrixUnitMin": 0.0001,
        "PrixUnitMax": 999999.9999,
        "QuantiteMin": 0.01,
        "QuantiteMax": 1000000.0,
        "NbreDecimale": 2
    },
    {
        "Code": "L",
        "Libelle": "Litres",
        "PrixUnitMin": 0.0001,
        "PrixUnitMax": 999999.9999,
        "QuantiteMin": 0.01,
        "QuantiteMax": 1000000.0,
        "NbreDecimale": 2
    }
]

Cas particulier : Gestion des quantités non activée

Si l'API renvoie la réponse suivante, alors l’envoi de quantités via l’API n’est pas autorisé pour ce dossier.

{
    "Message": "La gestion des quantités n'est pas activée sur le dossier."
}

Vérification de l'activation des quantités sur un compte

Pour saisir une écriture avec quantités, il faut également vérifier que le compte général utilisé autorise la gestion des quantités.

Endpoint : compta/comptes/generaux 

Rubrique concernée : "Qte"

  • "O" : quantités autorisées

  • "N" : quantités non autorisées

Exemple de réponse pour un compte avec quantités activées

{
        "Code": "60730000",
        "Categ": "G",
        "Lib": "ACHATS BOISSONS TR",
        "Let": "N",
        "RegEc": "",
        "Qte": "O",
        "Coll": false,
        "CptCptCol": "",
        "CodeTVA": "TR",
        "CptInactif": false,
        "EcritureId": false,
        "ActivationAnalytique": false
}

Saisie de l'écriture comptable avec quantités

Une fois les vérifications réalisées, l’écriture peut être envoyée via :

Endpoint : compta/ecriture

Exemple de requête JSON :

{
  "journal": "AC",
  "mois": 1,
  "annee": 2025,
  "lignesEcriture": [
    {
      "jour": 5,
      "numeroPiece": "82221",
      "compte": "FAARO",
      "libelle": "Achat de Graminox",
      "credit": 1050,
      "debit": 0
    },
    {
      "jour": 5,
      "numeroPiece": "82221",
      "compte": "60730000",
      "libelle": "Achat de Graminox",
      "credit": 0,
      "debit": 1000,
      "Quantite": {
        "Quantite1": 85,
        "CodeUnite1": "L"
      }
    },
    {
      "jour": 5,
      "numeroPiece": "82221",
      "compte": "44566200",
      "libelle": "Achat de Graminox",
      "credit": 0,
      "debit": 50
    }
  ]
}

 

Articles associés