Actions20
Overview
This node integrates with the iCount accounting system to manage various resources such as documents and customers. Specifically, for the Document - List operation, it retrieves a list of documents from iCount based on optional filters like date range, document type, and client name. This operation is useful for scenarios where you want to fetch multiple documents for reporting, auditing, or further processing in an automated workflow.
Practical examples include:
- Retrieving all invoices issued within a specific month.
- Listing all receipts related to a particular client.
- Fetching price quotes created during a sales campaign period.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all matching documents (true) or limit the number of results (false). |
| Limit | The maximum number of documents to return when "Return All" is false. Range: 1 to 100. |
| Filters | A collection of optional filters to narrow down the documents returned: |
| - From Date | Start date to filter documents from (inclusive). |
| - To Date | End date to filter documents up to (inclusive). |
| - Document Type | Filter by type of document. Options: "חשבונית מס" (320), "חשבונית מס קבלה" (305), "קבלה" (405), "הצעת מחיר" (300). |
| - Client Name | Filter documents by the client's name (string match). |
| - Combine All Items | Whether to return all documents combined into a single item (true) or each document as separate items (false). |
Output
The output is an array of JSON objects representing the documents retrieved from iCount. Each object corresponds to a document and contains its details as provided by the iCount API.
If the "Combine All Items" property is set to true, all documents are returned inside a single item, typically as an array under one key.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the iCount API.
- The node makes HTTP POST requests to the iCount API endpoints.
- Proper configuration of the iCount API credentials in n8n is necessary.
Troubleshooting
Common issues:
- Authentication errors if the API key is missing or invalid.
- No documents returned if filters are too restrictive or dates are incorrect.
- Exceeding the limit without setting "Return All" may truncate results unexpectedly.
Error messages:
"Unknown operation: list"— indicates the operation parameter was not recognized; ensure "List" is selected.- API request failures due to network or credential issues will throw errors; verify connectivity and credentials.
Resolutions:
- Double-check API credentials and permissions.
- Adjust filters to broaden the search if no results are returned.
- Use "Return All" cautiously to avoid large data loads.
Links and References
- iCount API Documentation (official API docs, for reference)
- n8n documentation on creating custom nodes