Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Overview

This node interacts with the "Fatture in Cloud" API, specifically allowing operations on various resources including Cashbook entries. The Cashbook - Get operation retrieves a specific cashbook entry by its document ID within a specified company.

Typical use cases include:

  • Fetching detailed information about a particular cashbook record for accounting or auditing purposes.
  • Integrating cashbook data retrieval into automated workflows for financial reporting.
  • Synchronizing cashbook entries from Fatture in Cloud into other systems.

Example: A user wants to retrieve the details of a cashbook entry with a known Document ID for Company ID 123 to verify payment records or update another system accordingly.

Properties

Name Meaning
Company ID The numeric identifier of the company under which the cashbook entry exists.
Document ID The unique string identifier of the cashbook entry to retrieve.

Output

The node outputs JSON data representing the requested cashbook entry. The structure corresponds to the cashbook entry object returned by the Fatture in Cloud API, typically including fields such as date, amount, description, and related metadata.

If multiple items are processed, each output item corresponds to one retrieved cashbook entry.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Fatture in Cloud API via an OAuth2-based API key credential configured in n8n.
  • Network access to the Fatture in Cloud service endpoint.
  • Proper permissions on the API key to read cashbook entries.

Troubleshooting

  • Common issues:

    • Invalid or missing Company ID or Document ID parameters will cause errors.
    • Insufficient API permissions may result in authorization errors.
    • Network connectivity problems can lead to request failures.
  • Error messages:

    • "Unknown resource: cashbook": Indicates the resource parameter was not recognized; ensure it is set correctly.
    • "Fatture in Cloud API Error: <message>": General API error; check the message for details such as invalid IDs or permission issues.
    • Validation errors may be returned if required parameters are missing or malformed.
  • Resolutions:

    • Verify that Company ID and Document ID are correctly provided and valid.
    • Confirm the API credentials have necessary scopes/permissions.
    • Check network connectivity and API endpoint availability.
    • Use the node's "Continue On Fail" option to handle errors gracefully in batch executions.

Links and References

Discussion