Transaktion

Definition einer Transaktion

Eine Transaktion ist eine Aktion, die an einem Dokument ausgeführt wird, z. B. dessen Versand oder Empfang. Diese Aktion kann die Validierung, Registrierung und Verfolgung des Dokuments einschließen, um sicherzustellen, dass die festgelegten Anforderungen erfüllt werden und das Dokument korrekt übertragen wird.

Wir betrachten ein Dokument als:

• Rechnung (vereinfacht, Selbstrechnung, regulär)
• Angebot
• Bestellung
• Lieferschein
• Steuerbericht

Abrechenbare Transaktionen

Jede der folgenden Aktionen wird als abrechenbare Transaktion betrachtet:

• Versand eines Dokuments.
• Empfang eines Dokuments.
• Umwandlung eines Dokuments zum Download (API und APP).

Ausnahmen

• Das Herunterladen einer PDF-Kopie einer ausgestellten Rechnung wird nicht als abrechenbar betrachtet.
• Statusänderungen sind keine Dokumente; daher werden Aktionen zu Statusänderungen nicht als Transaktionen gezählt.
• Das Ereignis error_sending: Versandfehler (Status: Error, Corner C2) wird nicht als Transaktion betrachtet.

Spezielle Fälle

• Steuerbericht aktiviert: Wenn eine Rechnung versendet wird und der Steuerbericht aktiviert ist, wird der entsprechende Bericht automatisch erzeugt und versendet. Daher generiert der Versand einer Rechnung zwei abrechenbare Transaktionen.
• Verifactu-Fall: Das Erstellen und Versenden einer Rechnung mit Verifactu zählt als zwei abrechenbare Transaktionen, eine für die Rechnung und eine für den Steuerbericht. Das “Ledger” zählt so viele Einträge, wie es enthält. Ein Ledger mit 10 Einträgen zählt als 10 einzelne Transaktionen.
• SDI-Fall: Wenn eine grenzüberschreitende Rechnung versendet wird, berechnen wir den Versand der Rechnung an die Steuerbehörde. In diesem Fall ist der Steuerbericht die an die Steuerbehörde versendete Rechnung.

API-Endpunkte, die eine abrechenbare Transaktion generieren

• Rechnung versenden
• Ausgestellte Rechnung erstellen (mit send_after_import: true)
• Rechnung aus Datei importieren (mit send_after_import: true)
• Rechnung mit bestimmtem Dokumenttyp abrufen (außer im PDF-Format)
• Steuerbericht aus Rechnung generieren
• Steuerbericht erstellen
• Steuerbericht importieren
• Steuerbericht stornieren

Beispiele anderer API-Endpunkte, die derzeit keine abrechenbare Transaktion generieren

• Ausgestellte Rechnung erstellen (mit send_after_import: false)
• Rechnung aus Datei importieren (mit send_after_import: false)
• Rechnungsstatus wechseln
• Validierung
• Rechnung als bestätigt markieren
• Lookup (Verzeichnis)

Transaktionszähler nach Dokumenttyp

Transaktionen können durch Zählung von Ereignissen erfasst werden (1 Ereignis = 1 Transaktion).

Liste der Ereignisse

• success_sending: Erfolgreicher Versand (Status: Sent, Corner C2)
• success_clearing: Clearance-Prozess erfolgreich abgeschlossen (ZATCA)
• error_clearing: Fehler während des Clearance-Prozesses (ZATCA)
• notification_c2_state_downloaded: Rechnung heruntergeladen. Entspricht Corner C2. Wenn der Transport “Download” ist und der Benutzer die Schaltfläche Issue and Download klickt (Status: Downloaded)

Ausgehend

Ausgestellte Rechnungen verschiedener Typen (sendable_type: Invoice)

API-Endpunkte:

• Rechnung versenden
• Rechnung importieren (mit Parameter send_after_import: true)

Ereignisse:

• success_sending
• error_sending

Nicht API-bezogene Ereignisse:

• notification_c2_state_downloaded

Angebote (sendable_type: Quote)

API-Endpunkte: Angebote können nicht über API versendet werden.

Nicht API-bezogene Ereignisse:

• success_sending
• error_sending

Lieferscheine (sendable_type: DespatchAdvice)

API-Endpunkte: Lieferscheine können nicht über API versendet werden.

Nicht API-bezogene Ereignisse:

• success_sending
• error_sending

Bestellungen (sendable_type: Order)

API-Endpunkte:

• Als verarbeitet markieren (dieser Endpunkt generiert keine Transaktion)

Nicht API-bezogene Ereignisse: Beim Akzeptieren oder Ablehnen einer Bestellung (nur UI) wird eine Bestellantwort versendet, die eines dieser Ereignisse generiert:

• success_sending
• error_sending

Steuerberichte (sendable_type: TaxReport)

API-Endpunkte:

• Rechnung versenden (wenn die Rechnung den Steuerbericht erfordert)
• Steuerbericht erstellen
• Steuerbericht importieren
• Steuerbericht ändern
• Steuerbericht stornieren
• Steuerbericht stornieren (Legacy)

Ereignisse:

• success_sending
• error_sending
• success_clearing
• error_clearing

Anmerkungen: Wenn die tax_authority Verifactu oder TicketBAI (Bizkaia) ist, wird zusätzlich zum Versand des TaxReport auch ein Ledger versendet.

Ledger

API-Endpunkte: Dieselben wie für TaxReport.

Ereignisse:

• success_sending
• error_sending

Eingehend

Empfangene Rechnungen verschiedener Typen (sendable_type: Invoice)

Eine Transaktion wird generiert, wenn eine “empfangene Rechnung” empfangen wird. Wenn die empfangene Rechnung manuell erstellt oder über die Plattform importiert wird, wird sie nicht als Transaktion gezählt.

API-Endpunkte:

• Rechnung importieren (mit issued=false, entsprechend from_net: 'uploaded')

Bestellungen (sendable_type: Order)

API-Endpunkte: Bestellungen können nicht über API generiert oder versendet werden.

Anmerkungen: Eine Transaktion wird generiert, wenn eine Bestellung empfangen wird. Wenn sie über die Plattform importiert wird, wird sie nicht als Transaktion gezählt.

View_as

Jedes Mal, wenn die view_as API mit einem document_type-Parameter aufgerufen wird, der sich von “original” oder “legal” unterscheidet, wird eine Transaktion generiert. Jedes Mal, wenn ein neues Dokument aus unserem Datenbankobjekt generiert wird, wird eine neue Transaktion erstellt.

Nicht abrechenbare Dokumenttypen

original — Gibt das Dokument genau so zurück, wie es ursprünglich eingereicht oder importiert wurde, aus dem Speicher bereitgestellt. Es findet keine Neugenerierung statt.

curl --request GET \
  --url https://api.b2brouter.net/invoices/{id}/as/original \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

legal — Gibt das archivierte Rechtsdokument (z. B. die signierte und zeitgestempelte Version) wie gespeichert zurück. Es findet keine Neugenerierung statt.

curl --request GET \
  --url https://api.b2brouter.net/invoices/{id}/as/legal \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

pdf.invoice und pdf.invoice.signed — Obwohl die PDF bei Bedarf gerendert wird, wird das Herunterladen einer PDF-Kopie einer ausgestellten Rechnung nicht als abrechenbar betrachtet.

Abrechenbare Dokumenttypen

Jeder andere document_type-Wert generiert das Dokument im angeforderten Format neu und zählt als abrechenbare Transaktion.

curl --request GET \
  --url https://api.b2brouter.net/invoices/{id}/as/xml.ubl.invoice.bis3 \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}'

Hinweis: Wenn Sie nur das bereits gesendete oder empfangene Dokument abrufen müssen, verwenden Sie stattdessen /as/legal oder /as/original.

So überwachen Sie Ihren Transaktionsverbrauch

Wenn Sie ein Partner oder Reseller sind, können Sie den Transaktionsverbrauch jeder Integrationsgruppe direkt aus dem B2Brouter-Portal überwachen.

Wenn Sie eine Integrationsgruppe bereitstellen, sei es, weil Sie eine einzelne Geschäftsgruppe verwalten oder als eDocSync tätig sind, besteht die effizienteste Möglichkeit, die Gesamtnutzung und die Transaktionsnutzung pro Konto zu überwachen, über den folgenden API-Endpunkt: GET /accounts

Beispielanfrage

curl --request GET \
  --url 'https://api-staging.b2brouter.net/accounts?offset=0&limit=25' \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'

Beispielantwort

{
  "accounts": [
    {
      "id": 12345,
      "name": "Ejemplo S.L.",
      ...
      "transactions_count": 24,
      "transactions_count_previous_period": 41,
      "transactions_limit": 100
    },
    {
      "id": 23456,
      "name": "Muster GmbH",
      ...
      "transactions_count": 32,
      "transactions_count_previous_period": 9,
      "transactions_limit": 100
    },
    {
      "id": 34567,
      "name": "Esempio S.r.l.",
      ...
      "transactions_count": 124,
      "transactions_count_previous_period": 326,
      "transactions_limit": 100
    }
    ...
  ]
}

Jedes Konto enthält:

• transactions_count → Im aktuellen Abrechnungszeitraum verbrauchte Transaktionen.
• transactions_count_previous_period → Im vorherigen Abrechnungszeitraum verbrauchte Transaktionen.
• transactions_limit → Maximale Anzahl der im Abonnement enthaltenen Transaktionen.

Durch die Kontrolle dieser Daten können Sie den Verbrauch jedes Kontos und das Gesamttotal automatisch verwalten. Dies ermöglicht es Ihnen, Zahlungen basierend auf dem Transaktionsvolumen für Ihre Endkunden zu automatisieren oder Ihre Nutzung gegen das vereinbarte Kontingent zu überwachen und Ihre Transaktionslimits zu erhöhen, bevor Sie diese überschreiten.