Actions2
Download & Parse
AI-generatedOverview
This node downloads and parses Apple App Store financial reports based on user-specified parameters such as report type, vendor number, report date, and region code. It is useful for automating the retrieval and processing of financial data from the Apple App Store, enabling users to integrate this data into workflows for analysis, reporting, or further processing. For example, a user can download a detailed financial report for a specific vendor and region, then parse and extract structured data for use in business intelligence tools.
Use Case Examples
- Downloading and parsing a financial report for vendor number 123456 for the month 2023-05 in region ZZ (all regions).
- Retrieving a financial detail report for a specific vendor and region, then extracting detailed and aggregated sales data for further analysis.
Properties
| Name | Meaning |
|---|---|
| Report Type | Specifies the type of financial report to download, either a general Financial Report or a detailed Financial Detail Report. |
| Vendor Number | The vendor number identifying the Apple App Store vendor whose report is to be downloaded. |
| Report Date (YYYY-MM) | The date of the report in year-month format, specifying which month's report to download. |
| Region Code | The region code for which the report is requested; 'ZZ' or 'Z1' can be used to request reports for all regions. |
| Options | Additional options for the node execution, including the name of the output field where the parsed report data will be stored. |
Output
Binary
Contains the raw downloaded report file when the operation is set to download only.
JSON
_meta - Metadata extracted from the financial detail report, such as header information._detailed - Detailed parsed data from the report, structured as an array of objects representing rows._aggregated - Aggregated summary data extracted from the report, such as totals by country and currency.
Dependencies
- An API key credential for Apple App Store API authentication is required.
Troubleshooting
- Common issues include authentication errors due to invalid or expired API credentials. Ensure the API key and related credentials are correctly configured.
- Network errors or API request failures may occur; verify network connectivity and API endpoint availability.
- Parsing errors might happen if the report format changes or the report data is incomplete; check the report content and format.
Links
- Apple App Store Connect API Documentation - Official documentation for the Apple App Store Connect API, including financial reports endpoints.