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 interacts with the Fatture in Cloud API to retrieve various types of informational data related to a specified company. The "Info" resource with the "Get" operation allows users to fetch reference data such as countries, cities, currencies, payment methods, product categories, VAT types, and more.
Common scenarios where this node is beneficial include:
- Populating dropdowns or selection lists in workflows with up-to-date reference data from Fatture in Cloud.
- Validating or enriching data by cross-referencing with official categories or codes.
- Automating document creation or processing by retrieving necessary metadata like templates or revenue centers.
For example, a user might use this node to get a list of Italian cities filtered by postal code to validate customer addresses or to retrieve available payment methods before creating an invoice.
Properties
| Name | Meaning |
|---|---|
| Company ID | The numeric identifier of the company for which the information is requested. |
| Info Type | The category of information to retrieve. Options include: |
| - Archive Categories: Get archive categories | |
| - Cities: Get Italian cities | |
| - Countries: Get list of countries | |
| - Currencies: Get list of currencies | |
| - Languages: Get list of languages | |
| - Payment Accounts: Get payment accounts | |
| - Payment Methods: Get payment methods | |
| - Product Categories: Get product categories | |
| - Received Document Categories: Get received document categories | |
| - Revenue Centers: Get revenue centers | |
| - Templates: Get document templates | |
| - Units of Measure: Get units of measure | |
| - VAT Types: Get VAT types | |
| Additional Fields | Optional filters depending on the Info Type selected. For example, when Info Type is "Cities": |
| - Postal Code: Filter cities by postal code | |
| - City: Filter cities by city name (ignored if postal code is provided) |
Output
The node outputs JSON data containing the requested information from the Fatture in Cloud API. The structure of the output depends on the selected Info Type but generally consists of arrays of objects representing entities such as countries, cities, payment methods, etc.
Each item in the output corresponds to one element of the requested info type, including relevant fields as defined by the API (e.g., country code and name for countries, city name and postal code for cities).
The node does not output binary data.
Dependencies
- Requires an active connection to the Fatture in Cloud API using OAuth2 authentication.
- The node expects valid credentials configured in n8n to authenticate API requests.
- Network access to the Fatture in Cloud service endpoint is required.
Troubleshooting
Common Issues:
- Invalid or expired API credentials will cause authentication errors.
- Providing an incorrect or non-existent Company ID may result in errors or empty responses.
- Using unsupported or misspelled Info Type values will cause the node to fail.
- Filtering cities without providing valid postal codes or city names may return no results.
Error Messages:
Fatture in Cloud API Error: <message>indicates an error response from the API. Check the message details for causes such as invalid parameters or permission issues.- Network or timeout errors may occur if the API service is unreachable.
Resolutions:
- Verify that the API credentials are correctly set up and have sufficient permissions.
- Confirm the Company ID exists and is accessible by the authenticated user.
- Double-check the Info Type and filter fields for correctness.
- Enable "Continue On Fail" in the node settings to handle errors gracefully during batch executions.