Anfrage nach fehlendem Beleg vorbereiten
Benötigte Berechtigung:mail:send(E-Mails senden)
Echte Wirkung
/api/banktransaction/{id}/receipt-request/previewKein 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.
AuthentifizierungBearer <bm_…>Empfohlen: Authorization: Bearer bm_…. Der Schlüssel wird nur einmal angezeigt; nie in URLs, Logs oder Frontend-Code ablegen.
id*stringID des Umsatzes.
uuidKontakt
application/json- body
Optional der Kontakt, an den die Anfrage gehen soll.
contactId?stringID des Kontakts; ohne Angabe sucht bimetrics ihn.
uuidErfolg.
application/json- response
Die Anfrage, wie sie rausgehen würde.
blocked?stringWarum keine Mail rausgehen kann: no_contact, no_email, income, assigned, not_listed; fehlt, wenn sie rausgehen kann.
body?stringText ohne Signatur.
contact?|Der Kontakt; null, wenn keiner sicher passt.
dailyLimit?integerHöchstzahl der Anfragen je Tag.
followUp?Vorschlag für die Erinnerung.
html?stringDie ganze Mail, wie sie versendet würde.
lastRequest?Die letzte Anfrage zu diesem Umsatz; fehlt, wenn noch keine gesendet wurde.
replyTo?stringDas Belegpostfach der Firma: Antworten mit Rechnung landen dort.
sender?Absender und Versandstand der Firma, wie bei den Belegmails.
sentToday?integerHeute versendete Anfragen der Firma.
signature?stringSignatur unter dem Text.
subject?stringBetreff.
to?array<string>|Empfänger, die E-Mail-Adresse des Kontakts; leer, wenn keine Mail rausgehen kann.
transactionId?stringID des Umsatzes.
uuidvalues?|Werte der Platzhalter.
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 '{}'{ "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`.