Zahlungseingang erfassen
record_paymentTarif: ab Business (darunter antwortet die API mit plan_required).
Zahlungseingang erfassen
Erfasst eine (Teil-)Zahlung zu invoice_id: einer Rechnung oder einer Korrektur mit positivem Betrag (Nachberechnung, Grenze ist ihr eigener Betrag). Der Status wird abgeleitet: sent → partial → paid. Ein negativer Betrag ist eine Rückzahlung, höchstens bis zur erhaltenen Summe (sonst 409); zu einer Minus-Korrektur lässt sich nur die Erstattung an den Kunden erfassen. Übersteigt der Betrag den offenen Rest (Rechnungsbetrag nach Minus-Korrekturen minus erfasste Zahlungen), entscheidet overpayment wie der Zahlungsdialog der App: credit erfasst den vollen Betrag und weist das Guthaben aus (amount_open der Rechnung wird negativ, die Zahlung trägt overpayment: true), ignore erfasst nur den offenen Rest und vermerkt den Mehrbetrag in note. Ohne overpayment lehnt die API eine Überzahlung mit 422 ab (Feldfehler an amount und overpayment); ist bei ignore nichts mehr offen, 409. Kommt eine gleichzeitige Zahlung dazwischen, lehnt die Datenbank ab (409). Eine stornierte Rechnung (void) nimmt nur noch Rückzahlungen bis zur erhaltenen Summe an, sonst 409; der Status bleibt void. kind: skonto gleicht den offenen Rest als Skonto aus, ohne amount und note: nur bei einer Rechnung mit Skonto in den Zahlungsbedingungen, Status sent oder partial, und höchstens bis zum Skonto-Abzug (sonst 409). Die Rechnung steht dann auf paid; der DATEV-Stapel bucht den Rest auf „Gewährte Skonti“ statt auf die Bank. Business-Tarif.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "record_payment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON-Request-Body. | |
| _idempotency_key | No | Optional. Geht als Header `Idempotency-Key` an die API: derselbe Wert mit demselben Aufruf liefert 24 Stunden lang die erste Antwort zurück, statt den Vorgang zu wiederholen. Bei einem Wiederholversuch denselben Wert schicken. |