Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Overview

This node interacts with the Fatture in Cloud API to manage various company settings. Specifically, for the Setting - Delete operation, it allows users to delete a specific setting item within a company’s account. This is useful for maintaining and cleaning up configuration data such as payment accounts, payment methods, VAT types, or tax profiles.

Practical examples include:

  • Removing an obsolete payment account from a company’s settings.
  • Deleting a deprecated payment method no longer used by the company.
  • Cleaning up VAT types that are no longer applicable.
  • Deleting a tax profile entry when it is outdated or incorrect.

This operation helps automate administrative tasks related to company financial configurations, ensuring data remains accurate and up-to-date.

Properties

Name Meaning
Company ID The unique numeric identifier of the company whose settings you want to manage.
Settings Type The category of settings to manage. Options: Payment Accounts, Payment Methods, VAT Types, Tax Profile.
Item ID The numeric ID of the specific item within the selected settings type to delete.

Output

The output JSON contains the result of the delete operation. Typically, this will be a confirmation of successful deletion or details about the deleted item. If the operation fails, the output may contain error information.

No binary data output is expected from this operation.

Dependencies

  • Requires an authenticated connection to the Fatture in Cloud API via an OAuth2 credential or equivalent API key setup.
  • The node depends on the internal SettingsModule class to perform the delete operation.
  • Proper permissions on the Fatture in Cloud account to delete settings items are necessary.

Troubleshooting

  • Common issues:

    • Providing an invalid or non-existent Company ID or Item ID will cause errors.
    • Attempting to delete an item from a settings type that does not support deletion (e.g., "Tax Profile" might be read-only).
    • Insufficient API permissions or expired authentication tokens can lead to authorization errors.
  • Error messages:

    • "Fatture in Cloud API Error: <message>" indicates an issue returned by the API. Check the message for details such as invalid IDs or permission problems.
    • Validation errors may appear if required parameters are missing or incorrectly formatted.
  • Resolutions:

    • Verify all input IDs correspond to existing entities in the Fatture in Cloud account.
    • Ensure the API credentials are valid and have the necessary scopes.
    • Use the node’s "Continue On Fail" option to handle errors gracefully during batch operations.

Links and References

Discussion