KostenKlar API

Mit der KostenKlar API lesen Sie Kunden, Rechnungen, Angebote und Produkte aus Ihrem Konto, legen Kunden und Rechnungsentwürfe an und lassen sich per Webhook benachrichtigen, wenn sich etwas ändert. So verbinden Sie KostenKlar mit Ihrem Shop, Ihrer Warenwirtschaft, Ihrem CRM oder einem eigenen Skript.

Überblick

• REST und JSON. Alle Antworten sind JSON (außer dem PDF-Download). Daten werden mit GET, POST und PATCH übertragen.
• Basis-Adresse: https://api.kosten-klar.de. Alle Pfade beginnen mit /v1. Nur https wird angenommen.
• Authentifizierung per API-Schlüssel im Header Authorization.
• Maschinenlesbare Beschreibung: openapi.json (OpenAPI 3.1). Damit erzeugen Sie Clients mit gängigen Generatoren oder importieren die API in Postman und Insomnia.

Was die API bewusst nicht tut

Die API legt Rechnungen, Angebote und Gutschriften nur als Entwurf an und ändert nur Entwürfe. Rechnungsnummer, Versand und das Festschreiben bleiben in KostenKlar. Das schützt die lückenlose Nummernfolge, die Sie nach GoBD brauchen, und verhindert Fehlbuchungen durch fremden Code. Belege, Zahlungen und Ausgaben lassen sich nicht löschen. Zahlungseingänge und Ausgaben laufen durch dieselben Prüfungen wie in der App, etwa für festgeschriebene Monate und den Kassenabschluss. Buchungssätze der doppelten Buchführung sind nicht über die API erreichbar.

Zugang und Schlüssel

Die API ist in jedem Konto zunächst aus. Sie brauchen zwei Dinge:

1. Den Business-Tarif.
2. Eine Freischaltung. Sie beantragen sie in KostenKlar unter Einstellungen, Entwickler & API mit einer kurzen Begründung, wofür Sie die API nutzen wollen. Wir prüfen den Antrag und schalten das Konto frei.

Nach der Freischaltung legen Sie an derselben Stelle Schlüssel an. Nur der Kontoinhaber kann Schlüssel erzeugen, bearbeiten und widerrufen.

• Pro Schlüssel wählen Sie einen Namen, die Berechtigungen und optional ein Ablaufdatum (höchstens 5 Jahre).
• Der Schlüssel beginnt mit kk_live_ und wird genau einmal angezeigt. Wir speichern nur einen Hash. Ist er weg, legen Sie einen neuen an und widerrufen den alten.
• Sie können bis zu 10 Schlüssel gleichzeitig aktiv haben. Legen Sie pro Integration einen eigenen Schlüssel an, dann lässt sich jeder einzeln widerrufen.
• Jede Änderung über die API erscheint im Änderungsprotokoll mit dem Schlüsselnamen. Anlage, Änderung und Widerruf eines Schlüssels melden wir Ihnen per E-Mail.

Fällt der Business-Tarif weg, ruht der Zugang sofort und alle Aufrufe antworten mit API_NOT_AVAILABLE. Ihre Schlüssel bleiben erhalten und funktionieren wieder, sobald der Tarif aktiv ist.

Schnellstart

In fünf Minuten von null zur ersten Rechnung im Entwurf. Legen Sie vorher einen Schlüssel mit den Berechtigungen customers:read, customers:write und invoices:write an und setzen Sie ihn als Umgebungsvariable:

export KOSTENKLAR_API_KEY="kk_live_..."

1. Verbindung testen

curl https://api.kosten-klar.de/v1/me \
  -H "Authorization: Bearer $KOSTENKLAR_API_KEY"

const BASE = 'https://api.kosten-klar.de';
const headers = { Authorization: `Bearer ${process.env.KOSTENKLAR_API_KEY}` };

const res = await fetch(`${BASE}/v1/me`, { headers });
console.log(res.status, await res.json());

<?php
$base = 'https://api.kosten-klar.de';
$ch = curl_init("$base/v1/me");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('KOSTENKLAR_API_KEY')],
]);
$body = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_RESPONSE_CODE), ' ', $body;

import os, requests

BASE = 'https://api.kosten-klar.de'
headers = {'Authorization': f"Bearer {os.environ['KOSTENKLAR_API_KEY']}"}

res = requests.get(f'{BASE}/v1/me', headers=headers)
print(res.status_code, res.json())

Antwort:

{
  "keyId": "0c1c8a3e-5b0e-4d52-9a57-6b2f3f6a9d10",
  "name": "Shop-Anbindung",
  "prefix": "kk_live_AbCd1234",
  "scopes": ["customers:read", "customers:write", "invoices:write"],
  "scopeLabels": {
    "customers:read": "Kunden lesen",
    "customers:write": "Kunden anlegen und ändern",
    "invoices:write": "Rechnungsentwürfe anlegen und ändern"
  },
  "expiresAt": null
}

Bekommen Sie 401 oder 403, schauen Sie in die Fehlertabelle.

2. Kunden anlegen

Pflicht sind ein Name (company oder firstName plus lastName), street, postalCode (genau fünf Ziffern), city und email. Jeder POST braucht einen Idempotency-Key, siehe Idempotenz.

curl -X POST https://api.kosten-klar.de/v1/customers \
  -H "Authorization: Bearer $KOSTENKLAR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "customerType": "business",
    "company": "Beispiel GmbH",
    "email": "buchhaltung@beispiel.de",
    "street": "Musterstraße 1",
    "postalCode": "10115",
    "city": "Berlin"
  }'

import { randomUUID } from 'node:crypto';

const res = await fetch(`${BASE}/v1/customers`, {
  method: 'POST',
  headers: {
    ...headers,
    'Content-Type': 'application/json',
    'Idempotency-Key': randomUUID(),
  },
  body: JSON.stringify({
    customerType: 'business',
    company: 'Beispiel GmbH',
    email: 'buchhaltung@beispiel.de',
    street: 'Musterstraße 1',
    postalCode: '10115',
    city: 'Berlin',
  }),
});
const customer = await res.json();
console.log(res.status, customer.id);

<?php
$payload = json_encode([
    'customerType' => 'business',
    'company' => 'Beispiel GmbH',
    'email' => 'buchhaltung@beispiel.de',
    'street' => 'Musterstraße 1',
    'postalCode' => '10115',
    'city' => 'Berlin',
]);
$ch = curl_init("$base/v1/customers");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('KOSTENKLAR_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
]);
$customer = json_decode(curl_exec($ch), true);
echo $customer['id'];

import uuid

res = requests.post(
    f'{BASE}/v1/customers',
    headers={**headers, 'Idempotency-Key': str(uuid.uuid4())},
    json={
        'customerType': 'business',
        'company': 'Beispiel GmbH',
        'email': 'buchhaltung@beispiel.de',
        'street': 'Musterstraße 1',
        'postalCode': '10115',
        'city': 'Berlin',
    },
)
customer = res.json()
print(res.status_code, customer['id'])

Die Antwort hat Status 201 und enthält den Kunden mit seiner id (gekürzt):

{
  "id": "5d1f3a52-8f0c-4c0e-9d0a-2f8d6a7b9c11",
  "customerNumber": "K-0042",
  "type": "business",
  "company": "Beispiel GmbH",
  "email": "buchhaltung@beispiel.de",
  "address": { "street": "Musterstraße 1", "postalCode": "10115", "city": "Berlin", "country": null },
  "createdAt": "2026-10-06T10:15:00.000Z",
  "updatedAt": "2026-10-06T10:15:00.000Z"
}

3. Rechnungsentwurf anlegen

curl -X POST https://api.kosten-klar.de/v1/invoices \
  -H "Authorization: Bearer $KOSTENKLAR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "5d1f3a52-8f0c-4c0e-9d0a-2f8d6a7b9c11",
    "issueDate": "2026-10-06",
    "dueDate": "2026-10-20",
    "taxRate": 19,
    "items": [
      { "description": "Beratung Oktober", "quantity": 8, "unit": "Std.", "unitPrice": 95 }
    ]
  }'

const res = await fetch(`${BASE}/v1/invoices`, {
  method: 'POST',
  headers: { ...headers, 'Content-Type': 'application/json', 'Idempotency-Key': randomUUID() },
  body: JSON.stringify({
    customerId: customer.id,
    issueDate: '2026-10-06',
    dueDate: '2026-10-20',
    taxRate: 19,
    items: [{ description: 'Beratung Oktober', quantity: 8, unit: 'Std.', unitPrice: 95 }],
  }),
});
const invoice = await res.json();
console.log(invoice.status, invoice.total); // draft 904.4

<?php
$payload = json_encode([
    'customerId' => $customer['id'],
    'issueDate' => '2026-10-06',
    'dueDate' => '2026-10-20',
    'taxRate' => 19,
    'items' => [['description' => 'Beratung Oktober', 'quantity' => 8, 'unit' => 'Std.', 'unitPrice' => 95]],
]);
$ch = curl_init("$base/v1/invoices");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $payload,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('KOSTENKLAR_API_KEY'),
        'Content-Type: application/json',
        'Idempotency-Key: ' . bin2hex(random_bytes(16)),
    ],
]);
$invoice = json_decode(curl_exec($ch), true);
echo $invoice['status'], ' ', $invoice['total'];

res = requests.post(
    f'{BASE}/v1/invoices',
    headers={**headers, 'Idempotency-Key': str(uuid.uuid4())},
    json={
        'customerId': customer['id'],
        'issueDate': '2026-10-06',
        'dueDate': '2026-10-20',
        'taxRate': 19,
        'items': [{'description': 'Beratung Oktober', 'quantity': 8, 'unit': 'Std.', 'unitPrice': 95}],
    },
)
invoice = res.json()
print(invoice['status'], invoice['total'])

Die Rechnung liegt jetzt in KostenKlar als Entwurf ohne Rechnungsnummer. Prüfen und versenden Sie sie dort. Die Summen berechnet KostenKlar selbst: 8 Stunden zu 95 Euro netto ergeben 760 Euro netto, 144,40 Euro Umsatzsteuer und 904,40 Euro brutto.

Authentifizierung

Senden Sie den Schlüssel bei jedem Aufruf im Header:

Authorization: Bearer kk_live_...

Der Schlüssel gehört zu einem Konto und sieht ausschließlich dessen Daten. Fremde Datensätze antworten wie nicht vorhandene mit 404, nie mit 403, damit sich IDs nicht erraten lassen.

Name, Berechtigungen und Ablaufdatum eines Schlüssels lassen sich nachträglich ändern, der Schlüssel selbst bleibt gleich. Änderungen gelten ab dem nächsten Aufruf. Ein abgelaufener Schlüssel funktioniert mit einem neuen Ablaufdatum wieder; ein widerrufener Schlüssel kann nicht reaktiviert werden. Ein widerrufener, abgelaufener oder unbekannter Schlüssel antwortet mit 401.

Berechtigungen

Jeder Schlüssel hat genau die Berechtigungen, die Sie beim Anlegen oder später beim Bearbeiten wählen. Vergeben Sie so wenig wie möglich. Fehlt eine Berechtigung, antwortet die API mit 403 und API_SCOPE_MISSING.

Projekte und Zeitbuchungen gehören zum Modul Zeiterfassung, Termine zum Modul Kalender. Ist das Modul im Konto ausgeschaltet, antworten die Endpunkte unter /v1/projects und /v1/time-entries bzw. /v1/calendar mit 403 und FEATURE_DISABLED, auch mit passender Berechtigung.

GET /v1/me braucht keine bestimmte Berechtigung. Schreibende Berechtigungen schließen das Lesen nicht ein: Wer Kunden per POST anlegt und die Antwort auswertet, braucht dafür kein customers:read, wer sie später abrufen will, schon.

Seiten und Filter

Listen kommen seitenweise im selben Umschlag:

{
  "data": [ { "id": "...", "...": "..." } ],
  "nextCursor": "NWQxZjNhNTItOGYwYy00YzBlLTlkMGEtMmY4ZDZhN2I5YzEx"
}

async function* alleRechnungen(params = {}) {
  let cursor;
  do {
    const query = new URLSearchParams({ limit: '100', ...params, ...(cursor ? { cursor } : {}) });
    const res = await fetch(`${BASE}/v1/invoices?${query}`, { headers });
    if (!res.ok) throw new Error(`KostenKlar ${res.status}`);
    const page = await res.json();
    yield* page.data;
    cursor = page.nextCursor;
  } while (cursor);
}

for await (const invoice of alleRechnungen({ status: 'overdue' })) {
  console.log(invoice.number, invoice.total);
}

def alle_rechnungen(**params):
    cursor = None
    while True:
        query = {'limit': 100, **params, **({'cursor': cursor} if cursor else {})}
        res = requests.get(f'{BASE}/v1/invoices', headers=headers, params=query)
        res.raise_for_status()
        page = res.json()
        yield from page['data']
        cursor = page['nextCursor']
        if not cursor:
            break

for invoice in alle_rechnungen(status='overdue'):
    print(invoice['number'], invoice['total'])

Fehler

Fehler erkennen Sie am HTTP-Status (4xx Ihre Anfrage, 5xx unser Problem). Der Body hat immer dieselbe Form:

{
  "statusCode": 403,
  "code": "API_SCOPE_MISSING",
  "message": "Dem API-Schlüssel fehlt die Berechtigung \"invoices:write\".",
  "hint": "Legen Sie in KostenKlar einen Schlüssel mit dieser Berechtigung an.",
  "details": { "requiredScope": "invoices:write" },
  "timestamp": "2026-10-06T10:15:00.000Z",
  "path": "/v1/invoices"
}

Programmieren Sie auf code und den HTTP-Status. Die Texte in message und hint sind für Menschen gedacht und können sich ändern.

Limits

Das Limit gilt je Schlüssel, nicht je IP-Adresse. Jede Antwort enthält:

• X-RateLimit-Limit: erlaubte Aufrufe im aktuellen Fenster
• X-RateLimit-Remaining: noch verbleibende Aufrufe
• X-RateLimit-Reset: Sekunden bis zum Beginn des nächsten Fensters

Bei Überschreitung antwortet die API mit 429 und Retry-After. Bauen Sie Wiederholungen mit Wartezeit ein, statt sofort erneut zu senden. Für große Abgleiche nutzen Sie limit=100, updatedSince und Webhooks, statt regelmäßig alles abzufragen.

Idempotenz

Netzwerke fallen aus. Wenn Ihr Aufruf abbricht, wissen Sie nicht, ob die Rechnung angelegt wurde. Damit eine Wiederholung keinen zweiten Entwurf erzeugt, verlangt jeder POST den Header Idempotency-Key:

Idempotency-Key: 6f9c1c9a-3a1e-4a8e-9a53-0c2b6f6a1d44

• Wählen Sie einen eindeutigen Wert je beabsichtigter Aktion, am einfachsten eine UUID. Erlaubt sind 8 bis 100 Zeichen: Buchstaben, Ziffern sowie . : _ -.
• Wiederholen Sie bei einem Abbruch die Anfrage mit demselben Key und demselben Inhalt. Sie erhalten die gespeicherte Antwort, erkennbar am Header Idempotent-Replayed: true, und es entsteht nichts doppelt.
• Derselbe Key mit anderem Inhalt ist ein Fehler (422), damit Sie keine falsche Antwort bekommen.
• Fehlgeschlagene Anfragen werden nicht gespeichert. Nach einem 4xx korrigieren Sie den Inhalt und senden mit einem neuen Key.
• Keys gelten 24 Stunden und gehören zu Ihrem Konto.

PATCH und GET sind von Natur aus wiederholbar und brauchen den Header nicht.

Datenformate

• IDs sind UUIDs und bleiben für einen Datensatz dauerhaft gleich.
• Beträge sind Zahlen in Euro (904.4), kein Text und keine Cent-Werte. Die Währung ist immer EUR. Rechnen Sie in Ihrem System mit Dezimalzahlen, nicht mit Fließkomma.
• Datum ohne Uhrzeit (issueDate, dueDate) kommt als 2026-10-06, Zeitstempel (createdAt, updatedAt) als ISO 8601 in UTC (2026-10-06T10:15:00.000Z).
• Fehlende Werte sind null, das Feld fehlt nicht.
• Neue Felder können in Antworten jederzeit hinzukommen. Ihr Code darf unbekannte Felder nicht ablehnen. Bestehende Felder ändern ihre Bedeutung nicht, siehe Versionierung.
• Preisart: priceMode bestimmt, ob Einzelpreise netto (net, Umsatzsteuer kommt obendrauf) oder brutto (gross, Umsatzsteuer ist enthalten) sind. Bei Kleinunternehmern, Reverse-Charge und steuerfreien Kunden gibt es keine Umsatzsteuer, dort gilt immer net.
• Rechnungsstatus: draft, sent, paid, partially_paid, overdue, dunning_level_1 bis dunning_level_3, payment_plan, cancelled, cancellation (Stornorechnung) und archived. Neue Status können dazukommen.

Webhooks: Ereignisse empfangen

Statt regelmäßig nachzufragen, lassen Sie sich benachrichtigen. KostenKlar sendet bei einem Ereignis einen POST mit JSON an Ihre Adresse.

Einrichten

1. Öffnen Sie in KostenKlar Einstellungen, Entwickler & API und legen Sie unter Webhooks einen Endpunkt an: Ihre https-Adresse und die gewünschten Ereignisse.
2. Kopieren Sie das Signatur-Secret (whsec_...). Es wird nur einmal angezeigt. Speichern Sie es wie einen API-Schlüssel.
3. Mit Test senden schickt KostenKlar sofort ein ping-Ereignis und zeigt Ihnen die Antwort Ihres Servers.

Der Endpunkt muss öffentlich per https erreichbar sein. Adressen im lokalen Netz oder auf den eigenen Rechner (localhost, 192.168.x.x) werden aus Sicherheitsgründen abgelehnt. Zum Entwickeln nutzen Sie einen Tunnel-Dienst, der eine öffentliche https-Adresse bereitstellt. Weiterleitungen (3xx) werden nicht verfolgt.

Ereignisse

Webhooks entstehen auch bei Änderungen, die Sie selbst über die API auslösen, zum Beispiel bei customer.created nach einem POST /v1/customers. Das müssen Sie in Ihrer Anwendung berücksichtigen, damit keine Schleife entsteht.

Aufbau einer Zustellung

POST /webhooks/kostenklar HTTP/1.1
Content-Type: application/json
User-Agent: KostenKlar-Webhooks/1
KostenKlar-Event: invoice.paid
KostenKlar-Delivery: 9b6a2c0e-6d62-4a4b-8c53-5a0f2c3d1e77
KostenKlar-Signature: t=1790000000,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd

{
  "id": "9b6a2c0e-6d62-4a4b-8c53-5a0f2c3d1e77",
  "type": "invoice.paid",
  "createdAt": "2026-10-06T10:15:00.000Z",
  "data": { "id": "...", "number": "RE-2026-0042", "status": "paid", "total": 904.4, "...": "..." }
}

data hat dieselbe Form wie die Antwort der jeweiligen Abruf-Endpunkte. id ist je Zustellung eindeutig und bei Wiederholungen identisch. Merken Sie sich die id, um doppelte Zustellungen zu erkennen.

Signatur prüfen

Jede Zustellung ist signiert. Prüfen Sie die Signatur immer, sonst kann jeder, der Ihre Adresse kennt, Ereignisse vortäuschen.

Der Header hat die Form t=<Unix-Zeit>,v1=<Signatur>. So prüfen Sie ihn:

1. Lesen Sie t und v1 aus dem Header.
2. Bilden Sie den Text <t>.<Body>. Der Body ist der unveränderte Rohtext der Anfrage, nicht neu serialisiertes JSON.
3. Berechnen Sie HMAC-SHA256 über diesen Text mit Ihrem Secret (einschließlich des Präfixes whsec_) als Schlüssel, als Hex-Text.
4. Vergleichen Sie das Ergebnis zeitkonstant mit v1.
5. Lehnen Sie Zustellungen ab, deren t mehr als 5 Minuten von Ihrer Uhrzeit abweicht. Das verhindert, dass jemand eine abgefangene Zustellung später erneut einspielt.

import crypto from 'node:crypto';
import express from 'express';

const app = express();

// Wichtig: den Rohtext behalten, nicht express.json() davor schalten.
app.post('/webhooks/kostenklar', express.raw({ type: 'application/json' }), (req, res) => {
  const header = req.get('KostenKlar-Signature') ?? '';
  const parts = Object.fromEntries(header.split(',').map((p) => p.trim().split('=')));
  const body = req.body.toString('utf8');

  const expected = crypto
    .createHmac('sha256', process.env.KOSTENKLAR_WEBHOOK_SECRET)
    .update(`${parts.t}.${body}`)
    .digest('hex');

  const given = Buffer.from(parts.v1 ?? '');
  const valid = given.length === expected.length && crypto.timingSafeEqual(given, Buffer.from(expected));
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) <= 300;
  if (!valid || !fresh) return res.sendStatus(400);

  const event = JSON.parse(body);
  // Erst speichern, dann antworten. Doppelte Zustellungen anhand von event.id ignorieren.
  res.sendStatus(200);
});

<?php
$secret = getenv('KOSTENKLAR_WEBHOOK_SECRET');
$body = file_get_contents('php://input');          // Rohtext, nicht json_decode und wieder encode
$header = $_SERVER['HTTP_KOSTENKLAR_SIGNATURE'] ?? '';

$parts = [];
foreach (explode(',', $header) as $part) {
    [$key, $value] = array_pad(explode('=', trim($part), 2), 2, '');
    $parts[$key] = $value;
}

$expected = hash_hmac('sha256', ($parts['t'] ?? '') . '.' . $body, $secret);
$valid = hash_equals($expected, $parts['v1'] ?? '');
$fresh = abs(time() - (int) ($parts['t'] ?? 0)) <= 300;

if (!$valid || !$fresh) {
    http_response_code(400);
    exit;
}

$event = json_decode($body, true);
// Erst speichern, dann antworten. Doppelte Zustellungen anhand von $event['id'] ignorieren.
http_response_code(200);

import hashlib, hmac, os, time
from flask import Flask, request, abort

app = Flask(__name__)

@app.post('/webhooks/kostenklar')
def kostenklar():
    body = request.get_data()                       # Rohbytes
    parts = dict(p.strip().split('=', 1) for p in request.headers.get('KostenKlar-Signature', '').split(',') if '=' in p)

    signed = parts.get('t', '').encode() + b'.' + body
    expected = hmac.new(os.environ['KOSTENKLAR_WEBHOOK_SECRET'].encode(), signed, hashlib.sha256).hexdigest()

    valid = hmac.compare_digest(expected, parts.get('v1', ''))
    fresh = abs(time.time() - int(parts.get('t', '0') or 0)) <= 300
    if not (valid and fresh):
        abort(400)

    event = request.get_json()
    # Erst speichern, dann antworten. Doppelte Zustellungen anhand von event['id'] ignorieren.
    return '', 200

Zustellung und Wiederholung

• Antworten Sie innerhalb von 5 Sekunden mit einem Status 2xx. Verarbeiten Sie aufwendige Arbeit danach im Hintergrund.
• Jede andere Antwort, ein Timeout oder ein Verbindungsfehler zählt als Fehlschlag. KostenKlar versucht es dann bis zu fünfmal erneut, nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 12 Stunden. Danach gilt die Zustellung als fehlgeschlagen.
• Wiederholungen tragen dieselbe id. Verarbeiten Sie jede id nur einmal.
• Die Reihenfolge ist nicht garantiert. Ein invoice.paid kann nach einem späteren Ereignis eintreffen. Fragen Sie im Zweifel die aktuellen Daten über die API ab.
• Schlagen 20 Zustellungen in Folge fehl, deaktivieren wir den Endpunkt automatisch und informieren den Kontoinhaber per E-Mail. In den Einstellungen aktivieren Sie ihn wieder, sobald Ihr Empfänger erreichbar ist.
• In den Einstellungen sehen Sie die letzten Zustellungen mit Status und Antwortcode und können einzelne erneut senden.
• Ereignisse, die auftraten, während der Endpunkt deaktiviert war, werden nicht nachgeliefert. Holen Sie sie mit updatedSince nach.

Referenz: Endpunkte

Diese Referenz wird aus openapi.json erzeugt und stimmt daher mit der API überein. Alle Pfade beziehen sich auf https://api.kosten-klar.de.

Konto

Kunden

Rechnungen

Angebote

Gutschriften

Lieferscheine

Mahnungen

Verträge

Zahlungen

Ausgaben

Produkte

Projekte

Aufgaben

Zeiterfassung

Kalender

Referenz: Objekte

Die Felder der Antworten und der Eingaben. Typ string | null bedeutet, dass der Wert fehlen kann und dann null ist.

Customer

CustomerInput

Invoice

InvoiceItem

InvoiceInput