bimetricsEntwickler
Umsätze

Anfrage nach fehlendem Beleg vorbereiten

Als Markdown ansehen

Benötigte Berechtigung:mail:send(E-Mails senden)

Echte Wirkung

Dieser Aufruf ist nicht als rein lesend gekennzeichnet und kann echte Daten in der Firma anlegen oder ändern. Es gibt keine Testumgebung.
post/api/banktransaction/{id}/receipt-request/preview

Kein Testversand aus der Dokumentation: Dieser Aufruf ist nicht als rein lesend gekennzeichnet. Nutze das Codebeispiel.

Zeigt die Mail, mit der du beim Lieferanten die Rechnung zu einer Zahlung ohne Beleg anforderst: Empfänger ist die E-Mail-Adresse eines Kontakts, nie eine freie Adresse. Ohne contactId nimmt bimetrics den Kontakt einer früheren Anfrage, sonst den eindeutigen Kontakt mit der IBAN der Gegenpartei, sonst den eindeutigen Kontakt mit ihrem genauen Namen. Der Body ist optional. contact.match sagt, wie er gefunden wurde. blocked nennt, warum keine Mail rausgehen kann: no_contact, no_email, income (Zahlungseingang), assigned (schon zugeordnet), not_listed. Antworten gehen an das Belegpostfach der Firma (replyTo). Versendet wird nichts.

Benötigt einen Schlüssel mit der Berechtigung mail:send.

Authentifizierung

headerAuthentifizierungBearer <bm_…>

Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.

Pfadparameter

id*string

ID des Umsatzes.

Formatuuid

Request-Body

Kontakt

application/json
  1. body

Optional der Kontakt, an den die Anfrage gehen soll.

contactId?string

ID des Kontakts; ohne Angabe sucht bimetrics ihn.

Formatuuid

Antworten

Erfolg.

application/json
  1. response

Die Anfrage, wie sie rausgehen würde.

blocked?string

Warum keine Mail rausgehen kann: no_contact, no_email, income, assigned, not_listed; fehlt, wenn sie rausgehen kann.

body?string

Text ohne Signatur.

contact?|

Der Kontakt; null, wenn keiner sicher passt.

dailyLimit?integer

Höchstzahl der Anfragen je Tag.

followUp?

Vorschlag für die Erinnerung.

html?string

Die ganze Mail, wie sie versendet würde.

lastRequest?

Die letzte Anfrage zu diesem Umsatz; fehlt, wenn noch keine gesendet wurde.

replyTo?string

Das Belegpostfach der Firma: Antworten mit Rechnung landen dort.

sender?

Absender und Versandstand der Firma, wie bei den Belegmails.

sentToday?integer

Heute versendete Anfragen der Firma.

signature?string

Signatur unter dem Text.

subject?string

Betreff.

to?array<string>|

Empfänger, die E-Mail-Adresse des Kontakts; leer, wenn keine Mail rausgehen kann.

transactionId?string

ID des Umsatzes.

Formatuuid
values?|

Werte der Platzhalter.

Beispielanfrage
curl --fail-with-body "https://app.bimetrics.de/api/banktransaction/497f6eca-6276-4993-bfeb-53cbbbba6f08/receipt-request/preview" \  -H "Authorization: Bearer $BIMETRICS_API_KEY" \  -H "Content-Type: application/json" \  -d '{}'
Beispielantwort
{  "body": "Guten Tag,\n\nzu unserer Zahlung vom 02.11.2026 über 119,00 € liegt uns noch keine Rechnung vor.\nVerwendungszweck: RE 2026-117 Flyer Druck\n\nBitte senden Sie uns die Rechnung als PDF oder E-Rechnung an a1b2c3d4@mail.bimetrics.de, am einfachsten direkt als Antwort auf diese E-Mail.\n\nFalls Sie die Rechnung bereits geschickt haben oder diese Zahlung nicht zuordnen können, genügt eine kurze Rückmeldung.\n\nViele Grüße",  "contact": {    "email": "rechnung@demodruckerei.example",    "id": "78c4ff15-f2a0-4eae-945d-73a969adab4b",    "match": "iban",    "name": "Demodruckerei"  },  "dailyLimit": 10,  "followUp": {    "body": "Guten Tag,\n\nam 21.11.2026 hatten wir Sie um die Rechnung zu unserer Zahlung vom 02.11.2026 über 119,00 € gebeten. Leider liegt sie uns noch nicht vor.",    "days": [      7,      14    ],    "subject": "Erinnerung: Rechnung zu unserer Zahlung vom 02.11.2026"  },  "html": "<!doctype html><html><body><p>Guten Tag,</p></body></html>",  "replyTo": "a1b2c3d4@mail.bimetrics.de",  "sender": {    "companyDailyLimit": 20,    "mode": "bimetrics",    "replyTo": "buchhaltung@muster-studio.de",    "senderAddress": "versand@rechnungen.bimetrics.de",    "senderName": "Muster Studio",    "sendingEnabled": true,    "sentToday": 2,    "status": "active"  },  "sentToday": 0,  "signature": "Muster Studio",  "subject": "Rechnung zu unserer Zahlung vom 02.11.2026",  "to": [    "rechnung@demodruckerei.example"  ],  "transactionId": "a1ba4b85-5bd8-4cef-bbbd-16eaa2c46033",  "values": {    "Angefragt am": "21.11.2026",    "Belegpostfach": "a1b2c3d4@mail.bimetrics.de",    "Betrag": "119,00 €",    "Datum": "02.11.2026",    "Lieferant": "Demodruckerei",    "Unternehmen": "Muster Studio",    "Verwendungszweck": "RE 2026-117 Flyer Druck"  }}

Erinnerung an den Lieferanten abbrechen DELETE

Bricht die geplante Erinnerung zur Anfrage ab. Der Merker bleibt. Ohne geplante Erinnerung bleibt alles unverändert; ein Umsatz einer anderen Firma antwortet mit 404. Benötigt einen Schlüssel mit der Berechtigung `mail:send`.

Fehlenden Beleg beim Lieferanten anfordern POST

Sendet die Anfrage an die E-Mail-Adresse des Kontakts, nur nach Bestätigung der Vorschau durch einen Menschen. Absender ist bimetrics mit dem Namen der Firma, Antworten gehen an das Belegpostfach, darunter stehen Signatur und Pflichtangaben, kein Anhang. Betreff und Text gehen genau so raus, wie du sie schickst. Der Umsatz bekommt den Merker (`receiptRequest`) mit der Anfrage, in der App „Beleg angefordert“. Hat der Kontakt keine E-Mail-Adresse, geht keine Mail raus: Der Umsatz ist dann nur vorgemerkt, der Merker bekommt den Hinweis `no_email`, `documentMail` ist `null`. Mit `followUpDays` (7 oder 14) geht danach einmal zwischen 9 und 18 Uhr deutscher Zeit die Erinnerung mit `followUpSubject` und `followUpBody`, solange der Umsatz keine Zuordnung hat, die Anfrage nicht abgewiesen, fehlgeschlagen oder als Spam gemeldet wurde, keine Antwort des Empfängers im Belegpostfach liegt, der Kontakt noch dieselbe E-Mail-Adresse trägt und der Absender aktives Mitglied ist. Je Firma gehen höchstens 10 Anfragen am Tag raus, innerhalb der 20 Empfänger aller Belegmails, in der Testphase 3 (`429 DocumentMailLimitExceeded`, `context.scope` `receipt_request_day` bzw. `company_day`). Ohne eingerichteten Versand antwortet die Route mit `409 DocumentMailNotConfigured`, in der Testphase vor Bestätigung der E-Mail-Adresse mit `403 MailNotConfirmed`. Unumkehrbar. Eine Wiederholung mit gleichem Idempotency-Key sendet nichts doppelt. Benötigt einen Schlüssel mit der Berechtigung `mail:send`.