Fatture in Cloud icon

Fatture in Cloud

Interact with Fatture in Cloud API

Actions67

Overview

The node integrates with the "Fatture in Cloud" API to manage products within a company’s account. Specifically, the Product - Create operation allows users to add new products by specifying details such as name, code, pricing, VAT, and stock status.

This node is beneficial for automating product catalog management workflows, such as:

  • Adding new products from an external inventory system.
  • Syncing product data between e-commerce platforms and accounting software.
  • Automating bulk product creation during onboarding or migration processes.

For example, a user can create a product with its name, price, category, and VAT details, which will then be available in their Fatture in Cloud account for invoicing and inventory tracking.

Properties

Name Meaning
Company ID The numeric identifier of the company under which the product will be created (required).
Product Name The name/title of the product (required).
Product Code A custom code or SKU identifying the product.
Net Price The net selling price of the product before taxes.
Net Cost The net cost price of the product before taxes.
Measure The unit of measure for the product (e.g., pcs, kg).
Description A textual description providing additional details about the product.
Category The category or classification of the product.
In Stock Boolean flag indicating if the product is currently in stock (true/false).
Default VAT Configuration object for the product's default VAT, including:
- Is Disabled: Whether VAT is disabled for this product (boolean).
- VAT Description: Text describing the VAT type.
- VAT ID: Numeric identifier of the VAT type.
- VAT Notes: Additional notes related to VAT.
- VAT Value: Percentage value of the VAT (e.g., 22 for 22%).

Output

The node outputs JSON data representing the newly created product as returned by the Fatture in Cloud API. This typically includes all product details such as ID, name, pricing, VAT configuration, stock status, and any metadata assigned by the service.

If the API supports binary data for products (e.g., images), it would be included in the binary output field; however, based on the provided code and properties, this node primarily deals with JSON data.

Dependencies

  • Requires an active connection to the Fatture in Cloud API via OAuth2 authentication.
  • The node depends on the presence of a valid API key credential configured in n8n.
  • No other external dependencies are indicated beyond the bundled modules handling different resource types.

Troubleshooting

  • Common Issues:

    • Missing or invalid Company ID: The API requires a valid company context to create products.
    • Invalid or missing required fields like Product Name may cause validation errors.
    • Incorrect VAT configuration might lead to API rejection or unexpected tax calculations.
    • Network or authentication failures due to expired or misconfigured OAuth2 credentials.

  • Error Messages:

    • Errors returned from the API are captured and presented with details including HTTP status and error messages.
    • Validation errors from the API response will be shown, often indicating which input property caused the issue.
    • If continueOnFail is enabled, errors for individual items will be returned as part of the output instead of stopping execution.

  • Resolution Tips:

    • Verify that the Company ID corresponds to an existing company in your Fatture in Cloud account.
    • Ensure all required fields are populated correctly.
    • Check VAT settings for correctness and completeness.
    • Refresh or reconfigure OAuth2 credentials if authentication errors occur.

Links and References

Discussion