Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Archive Document Actions
Cashbook Actions
Client Actions
Company Actions
- Get Info
- Get Plan Usage
E-Invoice Actions
Email Actions
- List
Info Actions
- Get
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 manage various company settings. Specifically, for the Setting - Get operation, it retrieves configuration details related to a company’s financial and tax settings. This includes payment accounts, payment methods, VAT types, and tax profiles.

Typical use cases include:

Fetching a list of payment accounts or methods configured for a company.
Retrieving VAT type definitions used for invoicing and accounting.
Obtaining the tax profile information for compliance or reporting purposes.

For example, a user might want to automatically pull the current payment methods available for a company to display them in an internal dashboard or synchronize them with another system.

Properties

Name	Meaning
Company ID	The numeric identifier of the company whose settings are being accessed.
Settings Type	The category of settings to retrieve. Options: Payment Accounts, Payment Methods, VAT Types, Tax Profile.
Item ID	(Optional) The specific ID of an item within the selected settings type to get detailed info on. Only applicable for Payment Accounts, Payment Methods, and VAT Types.
Additional Fields	Optional extra parameters to customize the response: • Fields: Comma-separated list of fields to include in the response. • Fieldset: Level of detail in the response; options are Basic or Detailed.

Output

The node outputs JSON data representing the requested settings information from the Fatture in Cloud API. The structure depends on the settingsType and whether an itemId was specified:

For lists (e.g., all payment accounts), the output is an array of objects each describing one setting item.
For single items (when itemId is provided), the output is a detailed object of that particular setting.
The fields included in the output can be customized via the "Fields" and "Fieldset" additional properties.

No binary data output is produced by this node.

Dependencies

Requires an active connection to the Fatture in Cloud API using OAuth2 authentication.
The node expects valid credentials configured in n8n for accessing the Fatture in Cloud service.
Network access to the Fatture in Cloud API endpoints is necessary.

Troubleshooting

Common issues:
- Invalid or missing company ID may cause errors or empty responses.
- Requesting an item ID that does not exist will likely result in an error.
- Incorrect or expired API credentials will cause authentication failures.
- Specifying unsupported fields in the "Fields" property may lead to incomplete or failed responses.
Error messages:
- Errors returned from the API are caught and presented with status codes and messages.
- If the node is set to continue on failure, errors are output as JSON objects with error details.
- Typical error resolution involves verifying input parameters, ensuring correct credentials, and checking API limits or permissions.