Actions67
- Archive Document Actions
- Cashbook Actions
- Client Actions
- Company Actions
- E-Invoice Actions
- Email Actions
- Info Actions
- Issued Document Actions
- Product Actions
- Receipt Actions
- Received Document Actions
- Setting Actions
- Supplier Actions
- Tax (F24) Actions
- Webhook Actions
Overview
The node integrates with the "Fatture in Cloud" API to update receipt records within a specified company. It allows users to modify details of an existing receipt such as date, number, amounts, type, description, payment account, and itemized list. This operation is useful for maintaining accurate financial records, correcting errors on receipts, or updating receipt information after transactions.
Practical examples include:
- Updating a receipt's date or number after a transaction correction.
- Changing the net and VAT amounts to reflect discounts or tax adjustments.
- Modifying the payment account details if the payment method changes.
- Editing the list of items on the receipt to add or remove products or services.
Properties
| Name | Meaning |
|---|---|
| Company ID | The unique identifier of the company where the receipt belongs. |
| Document ID | The unique identifier of the receipt document to update. |
| Date | The date associated with the receipt. |
| Number | The receipt number used for identification. |
| Numeration | A string representing the receipt numeration (e.g., series or code). |
| Amount Net | The net amount (excluding VAT) of the receipt. |
| Amount VAT | The VAT amount included in the receipt. |
| Receipt Type | The type of receipt. Possible values: • Sales Receipt • Till Receipt |
| Description | A textual description of the receipt. |
| RC Center | Revenue/Cost center associated with the receipt, used for accounting categorization. |
| Payment Account | Details of the payment account used for the receipt, including: • Account ID (number) • Account Name (string) |
| Items List | A list of items included in the receipt. Each item includes: • Amount Net (number) • Amount VAT (number) • Category (string) • Item ID (number, optional) • VAT details: – VAT ID (number) – VAT Value (percentage) – VAT Description (string, optional) |
Output
The node outputs JSON data representing the updated receipt as returned by the Fatture in Cloud API. This typically includes all updated fields of the receipt such as IDs, dates, amounts, types, descriptions, payment account info, and itemized details.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the Fatture in Cloud API using 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 Document ID will cause the update to fail.
- Incorrect formatting of date or numeric fields may result in validation errors.
- Missing required fields like Amount Net, Amount VAT, or Receipt Type can cause API rejection.
- Network connectivity issues or expired authentication tokens will prevent successful API calls.
Error Messages:
- Errors from the API are captured and presented with details including status code and error message.
- Validation errors often indicate which field is incorrect or missing.
- If the node is set to continue on failure, errors are returned as part of the output JSON with an
errorproperty. - To resolve errors, verify all required properties are correctly set, ensure credentials are valid, and check network connectivity.