Konto

Die Accounts-API ermöglicht es Ihnen, Konten aufzulisten, zu erstellen, abzurufen, zu aktualisieren, zu löschen und wiederherzustellen.

Accounts-API und Abonnements

Da sich die Funktionen zwischen den Abonnements eDocSync und eDocExchange unterscheiden, ist es wichtig zu verstehen, wie sich das Hinzufügen von Konten auf die Kosten und Limits Ihres Abonnements auswirken kann.

eDocSync

Mit eDocSync können Sie Konten für Ihre Benutzer direkt über die API erstellen und verwalten.

Wichtige Punkte vor dem Hinzufügen von Konten:

• Kosten: Das Hinzufügen von Konten kann zusätzliche Kosten verursachen, abhängig von Ihrem aktuellen Abonnement und der Gesamtanzahl der Konten.
• Transaktionslimits: Das Hinzufügen von Konten kann sich auf Ihre Transaktionslimits auswirken, abhängig von Ihrem aktuellen Abonnement und der Gesamtanzahl der Konten. Die Kontengruppe teilt sich ein gemeinsames Transaktionslimit. Wenn Sie das Limit überschreiten, werden zusätzliche Gebühren pro Transaktion berechnet.
• Änderungen: Das Transaktionslimit des Abonnements kann nicht über die API geändert werden. Um eine Änderung anzufordern, senden Sie bitte ein Support-Ticket zur Anpassung Ihres Abonnements.

eDocExchange

Mit eDocExchange können Sie Konten nicht über die API erstellen, löschen/archivieren oder wiederherstellen. Stattdessen muss dies über die Webanwendung erfolgen:

1. Wechseln Sie zum Tab Developers.
2. Klicken Sie auf das Symbol Edit group neben Ihrem Gruppennamen.
3. Dort können Sie Konten hinzufügen oder löschen.

Hinweise: Um Konten hinzuzufügen oder zu entfernen, müssen Sie über Administrator- oder Eigentümerrechte sowohl für das Konto mit dem Abonnement als auch für das Konto verfügen, das Sie hinzufügen möchten. Bevor Sie ein Konto zur Gruppe hinzufügen, stellen Sie sicher, dass es mit dem Basic-Plan erstellt wurde.

Wichtige Punkte vor dem Hinzufügen von Konten:

• Kosten: Das Hinzufügen eines Kontos verursacht einmalige zusätzliche Kosten.
• Transaktionslimits: Die Kontengruppe teilt sich ein gemeinsames Transaktionslimit. Wenn Sie das Limit überschreiten, werden zusätzliche Gebühren pro Transaktion berechnet.
• Änderungen: Das Transaktionslimit kann nicht über die API geändert werden. Wenn die Webanwendung im Abonnementbereich keine Option zum Upgrade Ihres Tarifs anbietet, senden Sie bitte ein Support-Ticket, um eine Änderung Ihres Abonnements anzufordern.

Beispielanfrage:

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"
    }
  }'