Register invoice payment
Register a received payment, full or partial, on a customer invoice.
MCP tool fiken_write → register_invoice_payment
write Confirm
Registers a payment on one invoice with the bank account, the date and the amount you give, like Registrer ny innbetaling in Fiken. A payment lower than the balance leaves the invoice open for the rest; one that covers it marks the invoice as settled. Read the balance with get_invoice first, and take the bank account from list_bank_accounts. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id integer required | integer | Invoice ID from list_invoices or create_invoice. |
| amount number required | number | Amount received, in the invoice currency. |
| payment_date date | date | Date the money arrived. Default: today. |
| bank_account string required | string | Account code from list_bank_accounts, e.g. 1920:10001. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "fiken_write",
"arguments": {
"operation": "register_invoice_payment",
"arguments": {
"invoice_id": 1,
"amount": 1,
"bank_account": "bank account"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice_id": 5120301,
"invoice_number": 10037,
"paid_amount": 15000,
"payment_date": "2026-10-13",
"bank_account": "1920:10001",
"balance": 0,
"status": "settled",
"currency": "NOK"
},
"isError": false
}