Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Overview

The node interacts with the "Issued Document" resource of the Fatture in Cloud API, specifically supporting the Update operation. It allows users to update details of an existing issued document (such as an invoice or similar financial document) within a specified company.

This node is beneficial in scenarios where issued documents need to be programmatically modified after creation, for example:

  • Correcting or updating client information on an invoice.
  • Adjusting item details such as quantities, prices, or VAT rates.
  • Changing payment terms or adding additional notes.
  • Updating document metadata like date, number, or subject.

Practical examples include automating invoice corrections, synchronizing issued documents with external systems, or batch updating multiple invoices based on new data.

Properties

Name Meaning
Company ID The numeric identifier of the company under which the issued document exists. Required to specify the context for the update.
Document ID The numeric identifier of the issued document to update.
Entity (Client) Details about the client entity related to the document. Includes fields such as name (required), address components (city, street, postal code, province, country), certified email, electronic invoice code, tax code, VAT number, and optional entity ID for existing clients.
Document Date The date of the document.
Document Number The number assigned to the document.
Subject The subject or title of the document.
Items A list of items included in the document. Each item can have category, code, description, discount percentage, gross price, unit of measure, product/service name (required), net price (required), optional product ID, quantity (required), and VAT details (ID, value, description).
Payments A list of payments associated with the document. Each payment includes amount (required), due date (required), status (Not Paid, Paid, Reversed), and payment terms (days and type: Standard or End of Month).
Additional Fields Optional extra fields such as whether the document is an electronic invoice, notes, numeration, revenue center, whether to use gross prices, and visible subject on the document.

Output

The node outputs JSON data representing the updated issued document as returned by the Fatture in Cloud API. This typically includes all updated fields of the document, reflecting the changes made.

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.
  • The node depends on the Issued Documents module of the Fatture in Cloud API.
  • Proper permissions and valid company and document IDs are necessary to perform updates.

Troubleshooting

  • Common Issues:

    • Invalid or missing Company ID or Document ID will cause errors.
    • Providing incomplete or invalid entity or item details may result in validation errors from the API.
    • Network or authentication issues with the API credentials can cause request failures.

  • Error Messages:

    • Errors returned from the API are captured and presented with details including HTTP status and error messages.
    • If the node is set to continue on failure, errors for individual items are returned as JSON objects with error details.
    • Common resolution steps include verifying input parameters, checking API credentials, and ensuring the document exists and is editable.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion