Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Overview

This node interacts with the "Fatture in Cloud" API to update various company settings related to financial and tax configurations. Specifically, for the Setting resource and Update operation, it allows users to modify existing configuration items such as payment accounts, payment methods, VAT types, and tax profiles within a specified company.

Typical use cases include:

  • Updating bank account details or cash accounts used for payments.
  • Modifying payment method names or attributes.
  • Adjusting VAT type percentages, descriptions, or notes.
  • Changing tax profile information relevant to the company's fiscal setup.

For example, a user might update a payment account's IBAN or change the VAT percentage rate for a specific VAT type.

Properties

Name Meaning
Company ID The unique identifier of the company whose settings are being updated.
Settings Type The category of settings to manage. Options: Payment Accounts, Payment Methods, VAT Types, Tax Profile.
Item ID The identifier of the specific item (e.g., payment account, payment method, VAT type) to update. Required for certain settings types.
Name The name of the item being updated (e.g., payment account name, payment method name).
Payment Account Type The type of payment account. Options: Standard, Bank, Cash. Relevant only for payment accounts.
IBAN The International Bank Account Number for the payment account.
VAT Value The VAT percentage value (e.g., 22 for 22%).
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 is applicable for electronic invoices.

Output

The node outputs JSON data representing the updated setting item(s) returned by the Fatture in Cloud API. Each output item corresponds to one input item processed and contains the updated details of the setting after the operation.

If the API returns binary data (not typical for this resource/operation), it would be included accordingly, but this node primarily deals with JSON data representing settings.

Dependencies

  • Requires an active connection to the Fatture in Cloud API via OAuth2 authentication.
  • The node depends on the appropriate API credentials configured in n8n to authenticate requests.
  • No additional external services beyond the Fatture in Cloud API are required.

Troubleshooting

  • Common issues:

    • Invalid or missing Company ID can cause errors; ensure the correct company identifier is provided.
    • Providing an incorrect Item ID when updating specific items will result in "item not found" errors.
    • Missing required fields like Name or VAT Value for their respective settings types will cause validation errors.
    • Incorrect IBAN format may lead to API rejection.

  • Error messages:

    • Errors from the API are surfaced with messages including status codes and error details.
    • Validation errors typically indicate which field is missing or invalid.
    • Network or authentication errors suggest checking API credentials and connectivity.

  • Resolution tips:

    • Double-check all required parameters before execution.
    • Use the "continue on fail" option in n8n to handle partial failures gracefully.
    • Review API documentation for valid values and formats.

Links and References

Discussion