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 manage various company settings. Specifically, for the Setting - Create operation, it allows users to create new configuration entries related to payment accounts, payment methods, VAT types, or tax profiles within a specified company.
Typical use cases include:
- Adding a new payment account (e.g., bank or cash account) for a company.
- Defining new payment methods that the company accepts.
- Creating VAT type entries with specific VAT percentages and descriptions.
- Setting up tax profile information relevant to the company's tax handling.
For example, a user might create a new payment account with an IBAN for their company or add a VAT type with a particular percentage rate and notes for invoicing purposes.
Properties
| Name | Meaning |
|---|---|
| Company ID | The numeric identifier of the company for which the setting is being created. |
| Settings Type | The category of setting to manage. Options: Payment Accounts, Payment Methods, VAT Types, Tax Profile. |
| Name | The name of the item being created (required for Payment Accounts and Payment Methods). |
| Payment Account Type | The type of payment account. Options: Standard, Bank, Cash. (Only for Payment Accounts) |
| IBAN | The International Bank Account Number for the payment account. (Only for Payment Accounts) |
| VAT Value | The VAT percentage value (required for VAT Types). |
| VAT Description | A textual description of the VAT type. |
| VAT Notes | Additional notes related to the VAT type. |
| E-Invoice | Boolean flag indicating whether this VAT type applies to e-invoices. |
Output
The node outputs JSON data representing the newly created setting object as returned by the Fatture in Cloud API. This typically includes all details of the created entity such as IDs, names, types, and other relevant fields depending on the settings type.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the Fatture in Cloud API via an OAuth2-based API key credential.
- The node depends on the n8n environment having this credential configured properly.
- Network access to the Fatture in Cloud API endpoints is necessary.
Troubleshooting
Common Issues:
- Invalid or missing company ID can cause errors.
- Providing incomplete or invalid data for required fields (e.g., missing VAT value when creating VAT types).
- Incorrect settings type selection may lead to unexpected errors.
- API authentication failures if the OAuth2 token is expired or misconfigured.
Error Messages:
- Errors from the API are surfaced with messages like
Fatture in Cloud API Error: <message>. - Validation errors from the API will be included in the error details.
- Network or permission issues may result in status codes and messages indicating failure to connect or unauthorized access.
- Errors from the API are surfaced with messages like
Resolution Tips:
- Verify all required fields are provided and correctly formatted.
- Ensure the OAuth2 credentials are valid and have not expired.
- Check the company ID exists and is accessible with the current credentials.
- Use the "Continue On Fail" option in n8n to handle individual item errors gracefully.