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
This node integrates with the "Fatture in Cloud" API to create a new receipt record. It is designed to automate the process of adding receipts into the accounting system managed by Fatture in Cloud. This can be particularly useful for businesses that want to streamline their bookkeeping by programmatically submitting receipt data, such as sales receipts or till receipts, directly from other systems or workflows.
Typical use cases include:
- Automatically logging daily sales receipts from a point-of-sale system.
- Uploading expense receipts for company accounting.
- Integrating receipt creation into broader financial automation workflows.
Properties
| Name | Meaning |
|---|---|
| Company ID | The numeric identifier of the company for which the receipt is being created. |
| Date | The date and time when the receipt was issued. |
| Number | The receipt number (a numeric identifier). |
| Numeration | A string representing the receipt numeration (optional additional numbering info). |
| Amount Net | The net amount (before VAT) of the receipt. |
| Amount VAT | The VAT amount included in the receipt. |
| Receipt Type | The type of receipt; options are: "Sales Receipt" or "Till Receipt". |
| Description | A textual description of the receipt. |
| RC Center | Revenue/Cost center associated with the receipt (optional). |
| Payment Account | Details of the payment account used for this receipt, including: |
| - Account ID (number) | |
| - Account Name (string) | |
| Items List | A list of items included in the receipt. Each item includes: |
| - Amount Net (number): Net amount for the item. | |
| - Amount VAT (number): VAT amount for the item. | |
| - Category (string): Item category. | |
| - Item ID (number, optional): Identifier for the item. | |
| - VAT Details: | |
| - VAT ID (number): VAT type identifier. | |
| - VAT Value (number): VAT percentage (e.g., 22). | |
| - VAT Description (string, optional): Description of the VAT. |
Output
The node outputs an array of JSON objects representing the response from the Fatture in Cloud API after creating the receipt. Each output item corresponds to one input item processed.
The json output typically contains details about the newly created receipt, such as its unique ID, status, and any metadata returned by the API.
If an error occurs during processing, and if the node is configured to continue on failure, the output will include an error object describing the issue for the respective item.
No binary data output is produced by this node.
Dependencies
- Requires an active connection to the Fatture in Cloud API via an OAuth2-based API key credential.
- The node depends on the n8n environment having this credential configured properly.
- No other external dependencies are required beyond the API access.
Troubleshooting
Common Issues:
- Invalid or missing API credentials will cause authentication errors.
- Incorrect or incomplete receipt data (e.g., missing required fields like Company ID or Amount Net) will result in validation errors from the API.
- Network connectivity issues may cause request failures.
Error Messages:
- Errors returned by the API are captured and presented with details including HTTP status and error messages.
- Validation errors often indicate which field is missing or invalid.
- If the node is set to stop on failure, it will throw an error halting execution; otherwise, it will output error details per item.
Resolution Tips:
- Verify that all required properties are correctly filled.
- Ensure the API credentials are valid and have sufficient permissions.
- Check network connectivity and API service status.
- Use the error message details to correct input data formatting or values.