Actions76
- Bill Actions
- Contact Actions
- Credit Note Actions
- Invoice Actions
- Item Actions
- Sales Order Actions
- Tax Actions
- Tax Group Actions
- Tax Exemption (US only) Actions
- Vendor Actions
- Vendor Credit Actions
Credit Note → Apply to Invoice
AI-generatedOverview
This node operation applies a credit note to one or more invoices in Zoho Books. It allows users to allocate specific amounts from a credit note to designated invoices, effectively reducing the outstanding balances on those invoices.
Common scenarios where this node is beneficial include:
- Automatically applying customer credit notes to open invoices during payment processing.
- Managing partial payments by allocating portions of a credit note across multiple invoices.
- Streamlining accounting workflows by programmatically linking credits and invoices.
Practical example:
- A business issues a credit note to a customer for returned goods. Using this node, the credit note can be applied to reduce the balance of one or more outstanding invoices for that customer.
Properties
| Name | Meaning |
|---|---|
| Credit Note ID | The unique identifier of the credit note to be applied. |
| Invoice Allocations | A collection specifying which invoices to apply the credit note to. Each allocation includes: • Invoice ID: The ID of the invoice to apply credit to. • Amount Applied: The amount of credit to apply to this invoice (number with two decimal precision). |
Output
The output is a JSON object representing the result of applying the credit note to the specified invoices. This typically includes confirmation details such as updated invoice statuses or allocation records.
If multiple input items are processed, the output will be an array of such JSON objects, each paired with the corresponding input item.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to the Zoho Books API using OAuth2 authentication.
- The node depends on the Zoho Books API endpoint for credit notes and invoice allocations.
- Proper API credentials must be configured in n8n to authorize requests.
Troubleshooting
- Invalid Credit Note ID: If the provided credit note ID does not exist or is incorrect, the API will return an error. Verify the ID before running the node.
- Allocation Amount Exceeds Credit Note Balance: Applying an amount greater than the available credit will cause an error. Ensure the sum of all allocations does not exceed the credit note's remaining balance.
- Invalid Invoice ID: If any invoice ID in the allocations is invalid or does not belong to the same customer as the credit note, the operation may fail.
- API Rate Limits: Excessive calls might trigger rate limiting errors. Implement retry logic or reduce request frequency.
- Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details in the output JSON.
Links and References
- Zoho Books API Documentation - Credit Notes
- Zoho Books API Documentation - Invoices
- n8n Documentation - Expressions (for dynamic property values)