Actions46
- Calendar Actions
- ClientProfile Actions
- Company Actions
- Invoice Actions
- Project Actions
- Role Actions
- Status Actions
- Task Actions
- Time Entry Actions
- Trigger Actions
- User Actions
Overview
This node interacts with the Scoro API to retrieve multiple invoice records based on user-defined criteria. Specifically, the "Invoice" resource with the "Get Many" operation allows users to fetch a list of invoices, optionally filtered by various parameters, including modification date and deletion status. It supports pagination and batching to efficiently handle large datasets.
Common scenarios for this node include:
- Synchronizing invoice data from Scoro into another system or database.
- Generating reports or dashboards that require up-to-date invoice information.
- Automating workflows that depend on recent or specific subsets of invoices.
For example, a user might configure the node to retrieve all invoices modified since January 1, 2023, excluding deleted entries, and process them in batches to avoid hitting API rate limits.
Properties
| Name | Meaning |
|---|---|
| Options | A collection of optional settings to customize the retrieval of invoices: |
| - Filter | A JSON object used to filter results, e.g., by modification date. Example: { "modified_date": { "from_date": "2023-01-01" } } |
| - Include Deleted | Boolean flag indicating whether to include invoices deleted within the last 30 days (true) or exclude them (false). |
| - Pagination | Controls how many results are returned: |
| -- Return All | If true, returns all matching invoices; if false, limits the number of results. |
| -- Page Limit | When not returning all, specifies the maximum number of invoices to return (minimum 1, default 50). |
| - Batching | Settings to manage concurrent requests and avoid rate limits: |
| -- Pages per Batch | Number of pages requested concurrently in each batch (minimum 1, default 20). |
| -- Batch Interval (ms) | Time in milliseconds to wait between each batch of requests (minimum 0, default 1000 ms). |
Output
The node outputs an array of JSON objects representing invoices retrieved from Scoro. Each object contains invoice details as provided by the Scoro API, such as invoice ID, dates, amounts, client information, status, and other relevant fields.
If binary data is present (not indicated explicitly here), it would typically represent attachments or documents related to invoices, but this node primarily focuses on JSON data output.
Dependencies
- Requires an active connection to the Scoro API via an API key credential.
- The node expects the base URL and authentication credentials to be configured in n8n's credential manager.
- No additional external dependencies beyond the Scoro API and standard n8n environment.
Troubleshooting
- Unsupported Operation Error: If the node throws an error like
Operation 'getAll' for resource 'invoice' is not supported, verify that the resource and operation names are correctly set. - API Authentication Failures: Ensure the API key and company account ID are valid and have sufficient permissions.
- Rate Limiting Issues: If requests fail due to rate limits, adjust the batching options to reduce concurrency or increase the batch interval.
- Invalid Filter JSON: When using the filter option, ensure the JSON syntax is correct; otherwise, parsing errors may occur.
- Empty Results: Confirm that the filter criteria match existing invoices and that "Include Deleted" is set appropriately.