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 update supplier information within a specified company. It allows users to modify details of an existing supplier by specifying the company and supplier IDs along with updated supplier data. This operation is useful for maintaining accurate supplier records, such as updating contact information, addresses, tax codes, or other relevant supplier attributes.

Practical examples include:

  • Updating a supplier's address after relocation.
  • Changing the contact person or phone number for supplier communications.
  • Correcting or adding tax identification numbers or VAT numbers.
  • Modifying supplier type from company to person or vice versa.

Properties

Name Meaning
Company ID The unique identifier of the company where the supplier belongs.
Supplier ID The unique identifier of the supplier to be updated.
Supplier Name The new or updated name of the supplier.
Additional Fields Optional extra fields to provide more detailed supplier information. Includes:
- Address City City of the supplier's address.
- Address Extra Additional address information (e.g., suite, floor).
- Address Postal Code Postal code of the supplier's address.
- Address Province Province of the supplier's address.
- Address Street Street address of the supplier.
- Certified Email Supplier's certified email address (PEC).
- Code A custom code identifying the supplier.
- Contact Person Name of the contact person at the supplier.
- Country Supplier's country (default is "Italia").
- Email Supplier's email address.
- Fax Supplier's fax number.
- First Name Supplier's first name (used if supplier is a person).
- Last Name Supplier's last name (used if supplier is a person).
- Notes Additional notes about the supplier.
- Phone Supplier's phone number.
- Tax Code Supplier's tax code.
- Type Supplier type; options are "Company" or "Person".
- VAT Number Supplier's VAT number.

Output

The node outputs JSON data representing the updated supplier record as returned by the Fatture in Cloud API. Each item in the output corresponds to one input item processed, containing the updated supplier details including all fields sent and any additional metadata provided by the API.

If the API supports binary data for suppliers (not indicated here), it would be included accordingly, but 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.
  • Network access to the Fatture in Cloud service endpoint is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Company ID or Supplier ID will cause the update to fail.
    • Incorrect or incomplete supplier data may result in validation errors from the API.
    • Network connectivity problems can prevent successful API calls.
    • Insufficient permissions or expired credentials will lead to authentication errors.

  • Error messages:

    • Errors returned by the API are captured and presented with status codes and descriptive messages.
    • Validation errors typically indicate which fields are incorrect or missing.
    • Authentication errors suggest checking the API key or OAuth token validity.

  • Resolution tips:

    • Verify that the Company ID and Supplier ID exist and are correct.
    • Ensure all required fields, especially Supplier Name, are provided.
    • Check API credentials and refresh tokens if needed.
    • Review additional fields for proper formatting and completeness.

Links and References

Discussion