Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Overview

The node interacts with the "Fatture in Cloud" API to manage received documents within a company’s accounting system. Specifically, the Update operation for the Received Document resource allows users to modify details of an existing received document such as expenses, passive delivery notes, or passive credit notes.

This node is beneficial in scenarios where you need to automate updates to received invoices or documents from suppliers, ensuring your accounting records stay current without manual entry. For example, you could update payment statuses, amend amounts, or attach additional metadata programmatically after receiving new information or corrections.

Practical examples:

  • Automatically updating the description and amounts of a received invoice after reconciliation.
  • Changing the due date or payment terms of a supplier’s credit note based on new agreements.
  • Adding attachments or marking documents as detailed for audit purposes.

Properties

Name Meaning
Company ID The unique identifier of the company under which the document exists.
Document ID The unique identifier of the received document to update.
Document Type The type of the received document. Options: Expense, Passive Delivery Note, Passive Credit Note.
Description A textual description of the received document.
Entity The supplier entity associated with this document, including:
- Entity ID (supplier ID)
- Entity Name (supplier name)
Date The date of the received document.
Amount Net The net amount (before VAT and taxes) of the document.
Amount VAT The VAT amount included in the document.
Amount Gross The gross total amount of the document (net + VAT + other taxes).
Additional Fields Optional extra fields that can be set, including:
- Amortization value
- Other withholding tax amount
- Withholding tax amount
- Attachment token for document files
- Currency details (ID, exchange rate, symbol)
- E-Invoice flag
- Invoice number
- Flags for detailed or marked status
- Next due date
- Revenue/Cost center
- Tax and VAT deductibility percentages
Payments List A list of payments related to the document, each containing:
- Amount
- Due date
- Paid date
- Payment account details (ID, name, virtual flag)
- Payment terms (days and type)
- Status (Not Paid, Paid, Reversed)

Output

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

If multiple input items are processed, the output will be an array of updated document objects corresponding to each input.

The node does not output binary data.

Dependencies

  • Requires an active connection to the Fatture in Cloud API via an OAuth2 API credential configured in n8n.
  • The node depends on the external Fatture in Cloud service being available and accessible.
  • Proper permissions on the API key or OAuth token to update received documents are necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Company ID or Document ID will cause errors.
    • Incorrect document type or invalid field values may result in validation errors from the API.
    • Network or authentication failures can prevent successful updates.

  • Error messages:

    • Errors returned by the API are captured and presented with details including HTTP status and error message.
    • If the node is set to continue on fail, errors for individual items will be output as error objects instead of stopping execution.

  • Resolutions:

    • Verify that the Company ID and Document ID exist and are correct.
    • Ensure the OAuth2 credentials are valid and have sufficient permissions.
    • Check the format and validity of dates, numbers, and enumerated options.
    • Review API limits or downtime if network errors occur.

Links and References

Discussion