Compte

L’API Accounts vous permet de lister, créer, récupérer, mettre à jour, supprimer et désarchiver des comptes.

API Accounts et abonnements

Comme les fonctionnalités varient entre les abonnements eDocSync et eDocExchange, il est important de comprendre comment l’ajout de comptes peut avoir un impact sur les coûts et les limites de votre abonnement.

eDocSync

Avec eDocSync, vous pouvez créer et gérer les comptes de vos utilisateurs directement via l’API.

Points à prendre en compte avant d’ajouter des comptes :

Coût : l’ajout de comptes peut entraîner des frais supplémentaires selon votre abonnement actuel et le nombre total de comptes.
Limites de transactions : l’ajout de comptes peut affecter vos limites de transactions selon votre abonnement actuel et le nombre total de comptes. Le groupe de comptes partage une même limite de transactions. Si vous dépassez cette limite, des frais supplémentaires seront appliqués par transaction.
Modifications : la limite de transactions de l’abonnement ne peut pas être modifiée via l’API. Pour demander un changement, veuillez ouvrir un ticket de support afin de demander une modification de votre abonnement.

eDocExchange

Avec eDocExchange, vous ne pouvez pas créer, supprimer/archiver ni désarchiver des comptes via l’API. À la place, cela doit être fait depuis l’application web :

Ouvrez l’onglet Developers.
Cliquez sur l’icône de modification du groupe à côté du nom de votre groupe.
Depuis cet écran, vous pourrez ajouter ou supprimer des comptes.

Remarques :
Pour ajouter ou supprimer des comptes, vous devez avoir des permissions Admin ou Owner sur le compte qui porte l’abonnement ainsi que sur le compte que vous souhaitez ajouter.
Avant d’ajouter un compte au groupe, assurez-vous qu’il a été créé avec le plan Basic.

Points à prendre en compte avant d’ajouter des comptes :

Coût : l’ajout d’un compte entraîne un coût additionnel unique.
Limites de transactions : le groupe de comptes partage une limite de transactions commune. Si vous la dépassez, des frais supplémentaires seront appliqués par transaction.
Modifications : la limite de transactions ne peut pas être modifiée via l’API. Si l’application web ne propose pas l’option de mise à niveau de votre palier dans la section d’abonnement, veuillez ouvrir un ticket de support pour demander un changement de votre abonnement.

Exemple de requête :

curl --request POST \
  --url https://api-staging.b2brouter.net/accounts \
  --header 'X-B2B-API-KEY: {API_KEY}' \
  --header 'X-B2B-API-Version: {API_VERSION}' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --data '{
    "account": {
      "country": "de",
      "rounding_method": "half_up",
      "tin_scheme": 9930,
      "tin_value": "DE123456789",
      "name": "Muster GmbH",
      "address": "Musterstraße 45",
      "city": "Berlin",
      "postalcode": "10115",
      "province": "Berlin",
      "email": "jane.doe@example.com"
    }
  }'