Zum Inhalt springen

Daten direkt in Ihr System

Diese Oberfläche ist nicht der Hauptweg. Der Hauptweg ist die Schnittstelle: Sie fragen aus Ihrer Warenwirtschaft heraus ab, tragen Mahnungen automatisiert ein und bekommen jede Zustandsänderung als Rückruf zugestellt. Drei Minuten Einrichtung, ein Schlüssel.

Zugangsschlüssel Prüfumgebung, kostenlos und ohne Echtdaten
Ihr SchlüsselNur serverseitig verwenden, nie im Browser
Prüfumgebung
Der Schlüssel wird erst auf Klick geholt und steht nicht im Seitenquelltext.
Der Schlüssel gehört auf Ihren Server, nicht in eine Webseite. Wer ihn in ein Skript im Browser schreibt, gibt jedem Besucher Zugriff auf seine Abfragen — und die Abrufe werden ihm berechnet.
Die vier Aufrufe, die alles abdecken
AbfrageLiegt zu einem Geschäftspartner etwas vor
GET
curl -s https://zentrales-deutsches-mahnregister.de/v1/auskunft \
  -H "Authorization: Bearer $DZM_SCHLUESSEL" \
  -G --data-urlencode "ust_id=DE123456789"
{
  "treffer": true,
  "eintraege": 2,
  "summe_offen": 5194.50,
  "zustaende": { "offen": 1, "unwidersprochen": 1 },
  "aeltester_eintrag": "2026-03-12",
  "abgerufen_am": "2026-08-27T14:31:07Z"
}
Die Antwort nennt Zahlen und Zustände, keine Bewertung. Es gibt keinen Punktwert und keine Ampel — wer daraus eine Entscheidung ableitet, tut das selbst und trägt sie auch.
Mahnung einreichenEintragen kostet nichts
POST
curl -s https://zentrales-deutsches-mahnregister.de/v1/mahnung \
  -H "Authorization: Bearer $DZM_SCHLUESSEL" \
  -H "Idempotency-Key: rechnung-2026-4711" \
  -H "content-type: application/json" \
  -d '{
        "schuldner": { "ust_id": "DE987654321", "name": "Beispiel GmbH" },
        "rechnung":  { "nummer": "2026-4711", "datum": "2026-06-02",
                       "faellig_am": "2026-06-16", "betrag": 1284.00 },
        "beleg_pdf_base64": "JVBERi0xLjQK..."
      }'
Der Idempotenz-Schlüssel ist Pflicht. Ohne ihn erzeugt ein wiederholter Aufruf einen zweiten Eintrag zu derselben Rechnung — und ein doppelter Eintrag ist gegenüber dem Schuldner ein Fehler, den niemand mehr sauber zurückdreht.
Beleg auslesen lassenKostenpflichtig, manuelle Eingabe bleibt frei
POST
curl -s https://zentrales-deutsches-mahnregister.de/v1/beleg/auslesen \
  -H "Authorization: Bearer $DZM_SCHLUESSEL" \
  -F "datei=@rechnung.pdf"
{
  "erkannt": {
    "glaeubiger": "Beispiel GmbH",
    "rechnungsnummer": "2026-4711",
    "rechnungsdatum": "2026-06-02",
    "faellig_am": "2026-06-16",
    "netto": 1078.99, "steuer": 205.01, "brutto": 1284.00
  },
  "sicherheit_je_feld": { "rechnungsnummer": 0.99, "faellig_am": 0.94, "brutto": 0.99 },
  "bestaetigung_noetig": ["faellig_am"],
  "kosten_eur": 0.07
}
Sie sehen immer, was wir erkannt haben, bevor es zählt. Jedes Feld trägt seine Sicherheit; alles unter der Schwelle geht in die Bestätigung statt in den Datenbestand. Wer selbst tippt, zahlt nichts.
Rückruf bei ZustandsänderungSie fragen nicht, wir melden
Webhook
POST https://ihr-system.example/dzm-eingang
X-ZDM-Signatur: sha256=<HMAC über den Rumpf>

{
  "vorgang": "2026-4711",
  "alt": "offen",
  "neu": "ausgeglichen",
  "gezahlt_am": "2026-08-27T14:29:55Z",
  "betrag": 1284.00
}
Prüfen Sie die Signatur, bevor Sie den Rumpf lesen. Eine Meldung ohne gültige Signatur ist keine Meldung von uns.
Was es kostet
Das Geld des Schuldners fliesst nie über uns. Der Gläubiger hinterlegt sein eigenes Zahlungskonto; die Zahlung geht direkt dorthin. Wir sehen das Ereignis, nicht den Betrag auf einem eigenen Konto — deshalb sind wir kein Treuhänder und kein Zahlungsdienst.