books_create_payment
Create a payment in Zoho Books and allocate it to specific invoices. Input customer, payment method, total amount, and invoice allocations to settle balances.
Instructions
Create a payment in Books to apply against specific invoices. First use books_get_invoices to find invoice IDs and amounts, then create payment to apply against those invoices.
Example workflow:
books_get_invoices({customer_id: "123"}) // Find unpaid invoices
books_create_payment({customer_id: "123", amount: 1000, invoices: [{invoice_id: "inv-456", amount_applied: 1000}]})
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | Payment date in YYYY-MM-DD format (e.g., "2024-12-31") | |
| amount | Yes | Total payment amount (must equal sum of amount_applied across invoices) | |
| invoices | Yes | List of invoices to apply payment against (get invoice details from books_get_invoices first) | |
| customer_id | Yes | Customer ID (get from books_get_customers) | |
| description | No | Payment description or notes | |
| bank_charges | No | Bank processing fees or charges | |
| payment_mode | Yes | Payment method (e.g., "cash", "check", "bank_transfer", "credit_card") | |
| currency_code | No | Currency code (e.g., "USD", "EUR") | |
| exchange_rate | No | Exchange rate if different from base currency | |
| reference_number | No | Reference number (check number, transaction ID, etc.) |