Zoho Books icon

Zoho Books

Consume Zoho Books API

Credit Note → Refund

AI-generated

Overview

This node operation allows you to refund a credit note in Zoho Books. It is useful when you need to process refunds against issued credit notes, specifying details such as the refund amount, method, date, and related references. Typical scenarios include returning funds to customers after issuing a credit note for returned goods or service adjustments.

For example, if a customer returns a product and you have already issued a credit note, you can use this operation to record the refund transaction with details like refund mode (cash, bank transfer, check, or credit card), refund amount, and reference number.

Properties

Name Meaning
Credit Note ID The unique identifier of the credit note to be refunded.
Refund Data A collection of fields describing the refund details:
- Amount The amount to refund (required).
- Refund Mode Method of refund; options are: Cash, Bank Transfer, Check, Credit Card.
- Date The date of the refund in YYYY-MM-DD format.
- Reference Number Reference number associated with the refund transaction.
- Description Additional description or notes about the refund.
- Account ID Account identifier related to the refund, if required by your accounting setup.

Output

The output JSON contains the response from Zoho Books API regarding the refund operation on the credit note. This typically includes confirmation details of the refund transaction such as refund ID, status, and any other metadata returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an active Zoho Books API connection authenticated via OAuth2.
  • The node depends on the Zoho Books API endpoint for credit note refunds.
  • Proper API credentials must be configured in n8n to authorize requests.

Troubleshooting

  • Common issues:

    • Invalid or missing Credit Note ID will cause the API to reject the request.
    • Incorrect refund amount (e.g., exceeding the credit note balance) may result in errors.
    • Missing required refund fields like amount or refund mode can cause validation failures.
    • Network or authentication errors if the OAuth2 token is expired or invalid.
  • Error messages:

    • "Unsupported resource": Indicates the resource parameter is incorrect or not implemented.
    • API error messages from Zoho Books will be passed through; check the message for details such as "Invalid Credit Note ID" or "Refund amount exceeds available balance".
  • Resolution tips:

    • Verify that the Credit Note ID exists and is correct.
    • Ensure refund amount does not exceed the credit note's refundable amount.
    • Confirm all required refund fields are provided.
    • Refresh or reauthenticate the API credentials if authorization errors occur.

Links and References

Discussion