Record payment
Record a customer payment on an open invoice.
POST https://cotlet.dev/api/v1/lexware-office/documents/{document_id}/payments
write Confirm
Clicks Zahlung erfassen on the invoice with the amount, the payment date and the payment type. The invoice drops out of the open and overdue lists once the open amount is paid. A payment recorded by hand is removed with the trash icon in the invoice details, but users with the restricted role "Belege, Kontakte & Produkte" cannot delete payments. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| document_id string required | string | Document ID from list_documents or create_invoice. |
| amount number required | number | Amount received in EUR. |
| payment_date string required | string | Date the money arrived, YYYY-MM-DD. |
| payment_type enum | enum | private or cash. Cash only if a cash book is set up; otherwise private. Default: private. |
Request
curl -X POST https://cotlet.dev/api/v1/lexware-office/documents/document_8c41d2/payments \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"amount":1,"payment_date":"payment date"}'result = client.call("lexware-office", "record_payment", {"document_id":"document_8c41d2","amount":1,"payment_date":"payment date"})const result = await cotlet.call('lexware-office', 'record_payment', {"document_id":"document_8c41d2","amount":1,"payment_date":"payment date"});cotlet call lexware-office record_payment --data '{"document_id":"document_8c41d2","amount":1,"payment_date":"payment date"}'Example response
{
"document_id": "d_9c31be",
"number": "RE1031",
"amount": 1130.5,
"payment_date": "2026-10-13",
"payment_type": "private",
"open_amount": 0,
"currency": "EUR"
}