Actions20
Overview
This node integrates with the iCount accounting system to manage various document-related operations. Specifically, the Convert Document operation allows users to convert an existing document from one type to another within iCount. This is useful in workflows where documents need to be transformed, for example, converting a quotation into an invoice or a draft into a finalized document.
Practical scenarios include:
- Automating the conversion of sales quotes to invoices after customer approval.
- Changing document types as part of financial closing processes.
- Streamlining document lifecycle management by programmatically updating document statuses and types.
Properties
| Name | Meaning |
|---|---|
| Document Type | The current type of the document to convert (e.g., invoice, quote). Loaded dynamically from iCount's available document types. |
| Document Number | The unique number identifying the specific document to convert. |
| Get Conversion Options | Boolean flag indicating whether to fetch possible conversion types automatically. If false, you must specify the conversion type manually. |
| Conversion Type | The target type to convert the document into. Must be selected from options retrieved when "Get Conversion Options" is enabled. |
Output
The node outputs JSON data representing the result of the document conversion operation. This typically includes details about the newly converted document such as its new type, number, status, and any relevant metadata returned by the iCount API.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the iCount API.
- Makes HTTP POST requests to iCount endpoints to perform operations and retrieve metadata such as document types and conversion options.
- Requires network access to
https://api.icount.co.il/api/v3.php.
Troubleshooting
Common issues:
- Invalid or expired API credentials will cause authentication failures.
- Specifying an invalid document number or document type may result in errors from the iCount API.
- If "Get Conversion Options" is disabled but an incorrect or unsupported conversion type is provided, the conversion will fail.
Error messages:
"Unknown operation: convert"— indicates the operation parameter was set incorrectly; ensure it is exactly "convert".- API errors returned from iCount (e.g., document not found, invalid conversion) will be passed through; check the error message for details.
Resolutions:
- Verify API credentials are correct and have necessary permissions.
- Use the "Get Conversion Options" feature to retrieve valid conversion types before running conversions.
- Confirm the document number exists and matches the specified document type.
Links and References
- iCount API Documentation (general reference for API endpoints)
- n8n documentation on creating custom nodes (for understanding node structure and usage)