Actions20
Overview
This node integrates with the iCount accounting system to manage various document-related operations. Specifically, the Cancel Document operation allows users to cancel an existing document in iCount by specifying its type and number. This is useful for scenarios where a document such as an invoice or receipt was issued incorrectly or needs to be voided for any reason.
Practical examples include:
- Canceling an invoice that was created with incorrect details.
- Voiding a receipt issued by mistake.
- Canceling an order or delivery note that will not be fulfilled.
The cancellation can optionally include a reason and handle refunding credit card transactions associated with the document.
Properties
| Name | Meaning |
|---|---|
| Document Type | The type of document to cancel. Options: Invoice, Invoice Receipt, Receipt, Refund, Order, Offer, Delivery. |
| Document Number | The unique number identifying the document to cancel. |
| Refund Credit Card | Whether to cancel the credit card transaction linked to the document (will error if none). |
| Cancellation Reason | Optional text describing the reason for cancellation. |
Output
The node outputs JSON data representing the result of the cancellation request. This typically includes confirmation details from the iCount API about the canceled document. If the cancellation involves a credit card refund, the output may also reflect the status of that transaction.
No binary data output is involved.
Dependencies
- Requires an active connection to the iCount API via an API key credential.
- The node makes HTTP POST requests to iCount endpoints to perform document cancellations.
- Proper permissions on the iCount account are necessary to cancel documents and process refunds.
Troubleshooting
- Error: Unknown operation — Ensure the operation parameter is set correctly to "cancel" when working with documents.
- Error related to credit card refund — If
Refund Credit Cardis enabled but no credit card transaction exists for the document, the API will return an error. Disable this option if no refund is needed. - Invalid document number or type — Verify that the document number and type correspond to an existing document in iCount.
- Authentication errors — Confirm that the API key credential is valid and has sufficient permissions.
- Network or API errors — Check connectivity and iCount service status.
Links and References
- iCount API Documentation (general reference for API endpoints)
- n8n documentation on creating custom nodes