Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Overview

This node integrates with the Fatture in Cloud API to create issued documents such as invoices, credit notes, delivery notes, and other document types related to company billing and accounting. It is useful for automating the generation of official financial documents within business workflows, reducing manual entry and ensuring consistency with company data.

Typical use cases include:

  • Automatically creating invoices or quotes when a sale is made.
  • Generating delivery notes or receipts after order fulfillment.
  • Issuing credit notes for returns or adjustments.
  • Managing electronic invoicing compliant with local regulations.

For example, a user can configure this node to create an invoice document for a specific client with detailed line items and payment terms, triggered by an order event in another system.

Properties

Name Meaning
Company ID The numeric identifier of the company under which the document will be created.
Document Type The type of document to create. Options include: Credit Note, Delivery Note, Invoice, Order, Proforma, Quote, Receipt, Self Invoice, Supplier Order, Work Report.
Entity (Client) Details about the client or entity associated with the document. Includes name (required), address fields (city, street, postal code, province, country), contact emails, tax codes, VAT number, and optional existing entity ID.
Document Date The date of the document.
Document Number The numeric identifier or number of the document. Defaults to 1 if not specified.
Subject A string describing the subject or title of the document.
Items A list of line items included in the document. Each item includes product/service name (required), category, code, description, quantity (required), net price (required), gross price, discount percentage, unit of measure, product ID, 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 created issued document(s) as returned by the Fatture in Cloud API. This typically includes all details of the newly created document such as its ID, number, date, client info, items, payments, totals, and status.

No binary data output is produced by this node.

Dependencies

  • Requires an API authentication credential configured in n8n to connect to the Fatture in Cloud API.
  • The node depends on the external Fatture in Cloud service being available and accessible.
  • Proper permissions and valid company/client IDs must be set up in the Fatture in Cloud account.

Troubleshooting

  • Common issues:

    • Invalid or missing company ID or client information may cause errors.
    • Incorrect document type or missing required fields like item names or net prices will result in validation failures.
    • API authentication errors if the credential is invalid or expired.
    • Network or service downtime causing request failures.

  • Error messages:

    • Errors from the API are captured and reported with details including HTTP status and error message.
    • Validation errors from the API response indicate missing or incorrect input data.
    • "Unknown resource" error if the resource parameter is misconfigured.

  • Resolutions:

    • Verify all required fields are correctly filled.
    • Check API credentials and refresh if needed.
    • Confirm that referenced entities (company, client, products) exist in the Fatture in Cloud account.
    • Enable "Continue On Fail" option in the node to handle partial failures gracefully.

Links and References

Discussion