Skip to main content
Qargo

FAQ : Qu'est-ce que la prise en charge des entités de facturation dans l'API de comptabilité et quel est son impact sur les intégrations externes ?

L'API de comptabilité prend désormais en charge plusieurs entités de facturation. Pour renforcer la sécurité et le contrôle d'accès, les intégrateurs externes ne peuvent comptabiliser que les factures de l'entité de facturation associée à leurs identifiants.

Table des matières
  1. Que comprend cette fonctionnalité ?
  2. Quel est l’impact sur la gestion des factures par l’intégration externe ?

La nouvelle prise en charge de plusieurs entités de facturation dans l’API de comptabilité renforce la sécurité et le contrôle d’accès pour les organisations qui gèrent des factures entre différentes entités internes.

Que comprend cette fonctionnalité ?

  • Mise à jour des points de terminaison des factures : les points de terminaison de facturation de l’API externe comprennent désormais une nouvelle section billing_entity. Elle fournit davantage d’informations sur l’entité liée à une facture.

  • Intégrations multiples : il est désormais possible de créer plusieurs intégrations API de comptabilité, chacune explicitement liée à une entité de facturation précise.
  • Filtrage : il est possible de filtrer les factures et les tâches selon l’entité de facturation à laquelle elles sont liées.
  • Clients API dédiés : il est possible de créer des clients API de comptabilité dans la page Paramètres de l’intégration API de comptabilité. Ces clients sont indispensables pour disposer de toutes les fonctionnalités.

Quel est l’impact sur la gestion des factures par l’intégration externe ?

Le principal impact concerne le contrôle d’accès pour la comptabilisation des factures (terminer/comptabiliser) :

  • Comptabilisation restreinte : l’intégrateur externe ne peut désormais terminer/comptabiliser que les factures liées à l’entité de facturation associée aux identifiants qu’il utilise.

  • Consultation des factures : les utilisateurs peuvent toujours voir les factures qui ne sont pas liées à leur entité de facturation (selon les autorisations de consultation existantes), mais il leur est impossible de les comptabiliser.

  • La configuration des identifiants est essentielle :

    • Pour pouvoir comptabiliser des factures (passer leur état à terminé), les intégrateurs doivent configurer leurs identifiants API dans la page Paramètres de l’intégration API de comptabilité et les lier à la bonne entité de facturation.
    • Les identifiants créés dans la page générale Paramètres de l’organisation ne permettent pas de passer l’état d’une facture à terminé ni de lister les factures encore en attente de synchronisation.