Actions67
- Archive Document Actions
- Cashbook Actions
- Client Actions
- Company Actions
- E-Invoice Actions
- Email Actions
- Info Actions
- Issued Document Actions
- Product Actions
- Receipt Actions
- Received Document Actions
- Setting Actions
- Supplier Actions
- Tax (F24) Actions
- Webhook Actions
Overview
This node integrates with the Fatture in Cloud API to manage products within a company. Specifically, the Product - List operation retrieves a list of products associated with a specified company. It supports filtering, pagination, and sorting, making it useful for workflows that need to fetch product data dynamically.
Common scenarios include:
- Synchronizing product lists from Fatture in Cloud into other systems.
- Automating inventory checks or updates based on product data.
- Generating reports or dashboards that require up-to-date product information.
Example: A user can list all products for a given company, filter them by a search query, and paginate through results to process or display them elsewhere.
Properties
| Name | Meaning |
|---|---|
| Company ID | The numeric identifier of the company whose products you want to list. |
| Additional Fields | Optional parameters to customize the response: |
| Fields | Comma-separated list of specific product fields to include in the response. |
| Fieldset | Choose between "Basic" or "Detailed" sets of fields to return. |
| Page | Page number for paginated results (default is 1). |
| Per Page | Number of products to return per page (default is 50). |
| Query | Search string to filter products by matching criteria. |
| Sort | Sort order for the returned products (e.g., by name, date). |
Output
The node outputs an array of JSON objects representing products. Each object contains product details according to the selected fieldset or specified fields. Typical fields may include product ID, name, description, price, stock levels, and other metadata depending on the chosen options.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the Fatture in Cloud API via OAuth2 authentication.
- The node expects valid credentials configured in n8n to authenticate API requests.
- Network access to the Fatture in Cloud service endpoint is necessary.
Troubleshooting
Common issues:
- Invalid or missing Company ID will cause the API to reject the request.
- Incorrect OAuth2 credentials or expired tokens will result in authentication errors.
- Exceeding API rate limits may cause temporary failures.
- Providing invalid values for pagination or sorting parameters might lead to unexpected responses.
Error messages:
Fatture in Cloud API Error: <message>indicates an error returned by the API. The message often includes HTTP status and detailed error info.- Validation errors typically mention which parameter is incorrect or missing.
Resolutions:
- Verify the Company ID is correct and accessible by the authenticated user.
- Refresh or reconfigure OAuth2 credentials if authentication fails.
- Adjust pagination parameters to valid ranges.
- Use the "Continue On Fail" option in n8n to handle errors gracefully during batch processing.
Links and References
- Fatture in Cloud API Documentation (official API docs)
- n8n OAuth2 Credential Setup Guide (for configuring authentication)
- Pagination and Filtering Best Practices (API usage tips)