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 interacts with the "Fatture in Cloud" API to retrieve monthly totals of receipts for a specified company. It is designed to fetch aggregated financial data grouped by month, filtered by receipt type and year. This operation is useful for accounting, financial reporting, or business analytics where users need to analyze monthly sales or transaction volumes.
Common scenarios:
- A business owner wants to see monthly sales receipt totals for the current year.
- An accountant needs to generate monthly summaries of till receipts for reconciliation.
- Financial analysts require monthly aggregated data filtered by receipt type to track trends.
Practical example:
- Retrieve monthly totals of sales receipts for company ID 1234 for the year 2025 to visualize revenue trends over the year.
Properties
| Name | Meaning |
|---|---|
| Company ID | The numeric identifier of the company for which to retrieve monthly receipt totals. |
| Filter Options | Collection of optional filters to refine the query: |
| Fields | Comma-separated list of specific fields to include in the response. |
| Fieldset | Level of detail in the response; options are Basic or Detailed. |
| Page | Page number for paginated results (default is 1). |
| Per Page | Number of results per page (default is 50). |
| Query | Search query string to filter results. |
| Receipt Type | Filter by receipt type; options are Sales Receipt or Till Receipt. |
| Sort | Sort order specification for the results. |
| Year | The year (as a string) for which to retrieve monthly totals (default is "2025"). |
Output
The node outputs an array of JSON objects representing the monthly totals of receipts according to the specified filters. Each object typically contains aggregated financial data grouped by month, such as total amounts and counts of receipts.
If binary data were involved (not indicated here), it would represent files or attachments related to receipts, but this operation focuses on JSON summary data only.
Dependencies
- Requires an active connection to the Fatture in Cloud API via an OAuth2 API credential.
- The node depends on the internal Receipts module of the bundled source code to perform the API call.
- No additional external dependencies beyond the configured API authentication.
Troubleshooting
Common issues:
- Invalid or missing company ID will cause the API to reject the request.
- Incorrect year format or unsupported years may return empty results.
- Network or authentication errors if the OAuth2 token is expired or invalid.
- Using unsupported receipt types or invalid filter values can lead to errors.
Error messages:
"Fatture in Cloud API Error: <message>"indicates an error returned from the API, often including HTTP status and details.- Validation errors may mention missing required parameters or invalid filter options.
Resolutions:
- Verify that the company ID is correct and exists in the Fatture in Cloud account.
- Ensure the OAuth2 credentials are valid and refreshed.
- Check that the year and receipt type values conform to expected formats.
- Use the "Continue On Fail" option in n8n to handle partial failures gracefully.