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
Vendor Credit → Apply to Bill
AI-generatedOverview
This node operation applies a vendor credit to one or more bills in Zoho Books. It allows users to specify a vendor credit by its ID and allocate portions of that credit to different bills by their IDs, specifying the amount of credit to apply to each bill.
This is useful in scenarios where a vendor has issued a credit (e.g., for returned goods or overpayment), and you want to apply that credit against outstanding bills to reduce the amount payable. For example, if you have a $500 vendor credit and two bills of $300 and $400 respectively, you can apply $300 of the credit to the first bill and $200 to the second bill.
Properties
| Name | Meaning |
|---|---|
| Vendor Credit ID | The unique identifier of the vendor credit to be applied. |
| Bill Allocations | A collection of allocations specifying which bills to apply the credit to, including: |
| - Bill ID: The unique identifier of the bill to apply credit to. | |
| - Amount Applied: The amount of the vendor credit to apply to this specific bill. |
Output
The output JSON contains the response from Zoho Books API after applying the vendor credit to the specified bills. This typically includes confirmation details such as updated balances or status of the vendor credit and bills.
No binary data output is involved in this operation.
Dependencies
- Requires an active connection to Zoho Books via OAuth2 authentication.
- The node depends on the Zoho Books API to perform the apply-to-bill operation.
- Proper API credentials must be configured in n8n to authorize requests.
Troubleshooting
Common Issues:
- Invalid or missing Vendor Credit ID: Ensure the vendor credit ID provided exists and is correct.
- Incorrect Bill IDs: Bills specified must exist and belong to the same vendor credit context.
- Amount applied exceeding available credit: The sum of amounts applied should not exceed the total vendor credit amount.
- API authentication errors: Verify that the OAuth2 credentials are valid and have necessary permissions.
Error Messages:
"Unsupported resource": Occurs if the resource parameter is incorrect; ensure "vendorCredit" is selected.- API errors related to invalid IDs or insufficient credit will be returned from Zoho Books and surfaced by the node.
Resolution:
- Double-check all IDs and amounts before execution.
- Confirm API credentials and permissions.
- Use the "Continue On Fail" option in the node settings to handle partial failures gracefully.