Reporter User Guide

Select a topic from the table of contents or search the guide.

Print this Document

Overview

Reporter is a command-line tool that you can use to download your Sales and Trends reports and Payments and Financial reports. It allows you to easily switch accounts if you use one Apple ID for multiple developer accounts. You can also look up descriptions for errors and view the estimated time of availability for any delayed reports.

This guide explains how to use Reporter to download your reports. To better understand information in the actual reports, see the Sales and Trends Guide, and the Payments and Financial Reports Guide.

Using Reporter

Setup

Before using Reporter, make sure you have Java 1.6 or later installed.

To use Reporter:

  1. Download Reporter. The package contains two files:

    • Reporter.jar

    • Reporter.properties

  2. Open the Reporter.properties file using a text editor and add your Apple ID and password you use for iTunes Connect.

  3. Open a command-line tool (for example, Terminal in OS X). Note that Reporter works with any command-line tool that supports Java, including on PC.

  4. Navigate to the directory of the Reporter.jar file.

  5. Use any of the commands described in this guide, such as getReport, using the syntax below.

$ java -jar Reporter.jar p=[properties file] a=[account number] m=["Normal"|"Robot.XML"] Sales.[command]$ java -jar Reporter.jar p=[properties file] a=[account number] m=["Normal"|"Robot.XML"] Finance.[command]

Commands for Sales and Trends begin with “Sales.” Commands for Payments and Financial Reports begin with “Finance.”

Options

Reporter supports three command-line options: a required properties file, an optional account number, and an optional mode. Options use the following format:

OptionName=OptionValue

Properties

Configuration settings for Reporter are specified in a properties file, where each property consists of a key-value pair on a separate line. Save the properties file in the same directory as the Reporter.jar file, using the ".properties" file extension.

On the command line, use the following format to specify the properties file:

p=[properties file name]

The table below describes the properties used by Reporter, all of which are required.

Property

Description

UserId

Your Apple ID for iTunes Connect.

Password

Your Apple ID’s password.

Account

See section on Account (below) for details.

Mode

See section on Modes (below) for details.

SalesUrl

URL of the Sales and Trends service for Reporter.

You can change the URL to specify different versions of the service. Only version 1 is currently available. Unless you upgrade to a new version, you usually won’t need to change this.

FinanceUrl

URL of the Payments and Financial Reports service for Reporter.

You can change the URL to specify different versions of the service. Only version 1 is currently available. Unless you upgrade to a new version, you usually won’t need to change this.

Account

If your Apple ID has access to multiple accounts, you’ll need to specify the account number you’d like to use.

On the command line, use the following format to specify the account number:

a=[account number]

You can also specify an account number in the properties file. The command-line mode, if specified, will override the value in the properties file. In the properties file, use the following format to specify the account number:

Account=[account number]

To see a list of your accounts, use the getAccounts command.

Modes

Reporter has two modes of operation: Normal and Robot.

Normal mode is intended for an actual user that executes ad-hoc commands. Messages are displayed in easily readable text.

Robot mode is intended for an automated script that’s used regularly. Messages in robot mode are displayed in XML for easy parsing.

You can specify the mode in the properties file or directly on the command line. The command line mode, if specified, will override the value in the properties file.

Mode

Properties File Format

Command Line Format

Normal

Mode=Normal

m=Normal

Robot

Mode=Robot.XML

m=Robot.XML

Errors

The table below describes possible errors returned by Reporter. In Robot mode, errors are returned with a code, as listed below:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>108</Code> <Message>Invalid username and password. Change values and try again.</Message></Error>

Error Code

Error Description

100

Invalid app or command format.

101

Invalid command.

102

Too few or too many parameters specified for the method.

103

No properties file specified.

104

Can’t find properties file.

105

Can’t read properties file.

106

Properties file doesn’t contain an Apple ID or password.

107

The Apple ID or password is in the wrong format.

108

The Apple ID or password is wrong.

109

Properties file doesn’t contain an endpoint.

110

Network isn’t available.

111

Network is available but can’t connect to Sales and Trends or Payments and Financial Reports.

112

Can’t save file because there isn’t enough space (or you don’t have write access to the current directory).

113

Invalid mode. Valid values include: Normal and Robot.

214

You have access to several providers. Specify the provider ID (account number) in your properties file or on the command line. To see a list of providers, use the command getAccounts.

215

Invalid provider ID specified on command line. To see a list of providers, use getAccounts.

216

Invalid provider ID specified in properties file. To see a list of providers, use getAccounts.

General Commands

getVersion

The getVersion command returns the version of Reporter that you’re using. This command always returns plain text, even in Robot mode.

Syntax

$ java -jar Reporter.jar getVersion

Example

$ java -jar Reporter.jar getVersion1.0

getStatus

This command returns the status of the Reporter service for your Sales and Trends reports or your Payments and Financial reports.

In Robot mode, if the service is available, getStatus will return a “0” code. If the service is unavailable, getStatus will return a “1” error code.

If an estimated time of availability is known, getStatus will return a “retry” value. The retry value is expressed in milliseconds, and indicates how long to wait before trying again.

Syntax

$ java -jar Reporter.jar Sales.getStatus$ java -jar Reporter.jar Finance.getStatus

Examples

Status of Sales and Trends When Available (Normal Mode)

$ java -jar Reporter.jar Sales.getStatusSales and Trends is currently available.

Status of Sales and Trends When Available (Robot Mode)

$ java -jar Reporter.jar m=Robot.XML Sales.getStatus<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Status> <Message>Sales and Trends Reporter is currently available.</Message> <Code>0</Code></Status>

Status of Sales and Trends When Unavailable (Normal Mode)

$ java -jar Reporter.jar m=Robot.XML Sales.getStatusSales and Trends is currently unavailable. Please try again in 15 minutes.

Status of Sales and Trends When Unavailable (Robot Mode)

$ java -jar Reporter.jar m=Robot.XML Sales.getStatus<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>1</Code> <Message>Sales and Trends is currently unavailable. Please try again in 15 minutes.</Message> <Retry>875000</Retry></Error>

Status of Payments and Financial Reports When Available (Normal Mode)

$ java -jar Reporter.jar m=Robot.XML Finance.getStatusFinance Reporter is currently available.

Status of Payments and Financial Reports When Available (Robot Mode)

$ java -jar Reporter.jar m=Robot.XML Finance.getStatus<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Status> <Message>Finance Reporter is currently available.</Message> <Code>0</Code></Status>

getAccounts

This command returns a list of your accounts for your Sales and Trends reports or your Payments and Financial reports.

In Normal mode, each account is on a separate line with the account name and account ID, separated by a comma.

Format

$ java -jar Reporter.jar p=[properties file] Sales.getAccounts$ java -jar Reporter.jar p=[properties file] Finance.getAccounts

Examples

Accounts for Sales and Trends (Normal Mode)

$ java -jar Reporter.jar p=Reporter.properties Sales.getAccountsJane Appleseed Inc, 12345John Appleseed Inc, 67890

Accounts for Sales and Trends (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getAccounts<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Accounts> <Account> <Name>Jane Appleseed Inc</Name> <Number>12345</Number> </Account> <Account> <Name>John Appleseed Inc</Name> <Number>67890</Number> </Account></Accounts>

Sales and Trends

About Sales and Trends Commands

This section describes the Reporter commands you can use for Sales and Trends. All commands for Sales and Trends start with:

Sales.[command]

getVendors

About getVendors

This command returns a list of vendor numbers for which you can download reports.

In Normal mode, each vendor is on a separate line.

Syntax

$ java -jar Reporter.jar p=[properties file] Sales.getVendors

Examples

Normal mode

$ java -jar Reporter.jar p=Reporter.properties Sales.getVendors8001234580067890

Robot mode

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getVendors<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Vendors> <Vendor>80012345</Vendor> <Vendor>80067890</Vendor></Vendors>

getReport

About getReport

This command downloads a report.

If a report is delayed, getReport will return a delay message, including an estimated time of availability, if known.

In robot mode, delays will return an error code of “117”. If an estimated time of availability is known, a “retry” value is also returned. The retry value is expressed in milliseconds, and indicates how long to wait before trying again. See below for an example.

Syntax

$ java -jar Reporter.jar p=[properties file] Sales.getReport [vendor number], [report type], [report subtype], [date type], [date]

Parameter

Description

Vendor Number

Vendor number of the report to download. For a list of your vendor numbers, use the getVendors command.

Report Type

Type of information contained in report (for example, Sales).

Report Subtype

Level of detail in the report (for example, Summary).

Date Type

Length of time covered by the report (for example, Daily or Weekly).

Date

Specific time covered by the report (for example, 20150201). See below for details on date format.

Parameter Combinations for Music

The table below describes the valid values and combinations of parameters to use with getReport.

Report Type

Report Subtype

Date Types

Description

Sales

Summary

Daily, Weekly, Monthly, Yearly

Aggregated sales report.

Sales

Detailed

Daily, Weekly

Transaction-level sales report.

Pre-Order

Summary

Daily, Weekly, Monthly, Yearly

Aggregated sales report for pre-orders.

Pre-Order

Detailed

Daily, Weekly

Transaction-level sales report for pre-orders.

Cloud

Detailed

Daily

Aggregated report for iTunes in the Cloud content that is downloaded again.

Event

Detailed

Daily

Event-level report on customer listening activity for Radio.

Event report for a day consists of four parts, and each one must be downloaded separately. See Date Format below for details.

Customer

Detailed

Daily

Customer metadata report for Radio.

Content

Detailed

Daily

Content metadata report for Radio.

Station

Detailed

Daily

Station metadata report for Radio.

Control

Detailed

Daily

List of MD5 checksums for each of the Radio reports.

amEvent

Detailed

Daily

Event-level report on streaming activity for Apple Music.

Event report for a day consists of two parts, and each one must be downloaded separately. See Date Format below for details.

amContent

Detailed

Daily

Content metadata report for Apple Music.

amControl

Detailed

Daily

List of MD5 checksums for each of the Apple Music reports.

amStreams

Detailed

Daily

Transactional-level information about streams of your catalog on Apple Music. Reports are unaggregated. Using a database application is recommended.

Date Format for Music

The date parameter uses different formats, depending on the report type and date type:

  • Daily reports use YYYYMMDD (for example, 20150201)

  • Weekly reports use YYYYMMDD, where the day used is the Sunday that week ends (for example, 20150208)

  • Monthly reports use YYYYMM (for example, 201502)

  • Yearly reports use YYYY (for example, 2015)

  • Daily Radio Event reports use YYYYMMDDPP, where PP is one of the four parts (for example, 2015020101, 2015020102, 2015020103, 2015020104)

  • Daily Apple Music Event reports use YYYYMMDD (for example, 20150201)

Examples for Music

Sales Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Detailed, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded D_D_80012345_20150201.txt.gz.</Message></Output>

Sales Report When Delayed (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>117</Code> <Message>Daily reports are delayed. Please try again in 1 hour.</Message> <Retry>3600000</Retry></Error>

Pre-Order Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Pre-Order, Summary, Weekly, 20150208<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded P_S_W_80012345_20150208.txt.gz.</Message></Output>

Cloud Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Cloud, Detailed, Daily, 20150208<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded C_D_80012345_20150208.txt.gz.</Message></Output>

Radio Event Reports (Robot Mode)

Note the additional two numbers at the end of the date parameter to specify one of the four parts of the report.

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Event, Detailed, Daily, 2015020101$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Event, Detailed, Daily, 2015020102$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Event, Detailed, Daily, 2015020103$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Event, Detailed, Daily, 2015020104

Apple Music Event Reports (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, amEvent, Detailed, Daily, 20150201

Wrong Vendor Number (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 90012345, Event, Detailed, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>200</Code> <Message>Invalid vendor number specified. Try again.</Message></Error>

Parameter Combinations for TV

The table below describes the valid values and combinations of parameters to use with getReport.

Report Type

Report Subtype

Date Types

Description

Sales

Summary

Daily, Weekly, Monthly, Yearly

Aggregated sales report.

Sales

Detailed

Daily, Weekly

Transaction-level sales report.

Cloud

Detailed

Daily

Aggregated report for iTunes in the Cloud content that's downloaded again.

Date Format for TV

The date parameter uses different formats, depending on the report type and date type:

  • Daily reports use YYYYMMDD (for example, 20150201)

  • Weekly reports use YYYYMMDD, where the day used is the Sunday that week ends (for example, 20150208)

  • Monthly reports use YYYMM (for example, 201502)

  • Yearly reports use YYYY (for example, 2015)

Examples for TV

Sales Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded S_D_80012345_20150201.txt.gz.</Message></Output>

Sales Report When Delayed (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>117</Code> <Message>Daily reports are delayed. Please try again in 1 hour.</Message> <Retry>3600000</Retry></Error>

Cloud Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Cloud, Detailed, Daily, 20150208<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded C_D_80012345_20150208.txt.gz.</Message></Output>

Wrong Vendor Number (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 90012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>200</Code> <Message>Invalid vendor number specified. Try again.</Message></Error>

Parameter Combinations for Movies

The table below describes the valid values and combinations of parameters to use with getReport.

Report Type

Report Subtype

Date Types

Description

Sales

Summary

Daily, Weekly, Monthly, Yearly

Aggregated sales report.

Sales

Detailed

Daily, Weekly

Transaction-level sales report.

Pre-Order

Summary

Daily, Weekly, Monthly, Yearly

Aggregated sales report for pre-orders.

Pre-Order

Detailed

Daily, Weekly

Transaction-level sales report for pre-orders.

Cloud

Detailed

Daily

Aggregated report for iTunes in the Cloud content that’s downloaded again.

Date Format for Movies

The date parameter uses different formats, depending on the report type and date type:

  • Daily reports use YYYYMMDD (for example, 20150201)

  • Weekly reports use YYYYMMDD, where the day used is the Sunday that week ends (for example, 20150208)

  • Monthly reports use YYYYMM (for example, 201502)

  • Yearly reports use YYYY (for example, 2015)

Examples for Movies

Sales Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded S_D_80012345_20150201.txt.gz.</Message></Output>

Sales Report When Delayed (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>117</Code> <Message>Daily reports are delayed. Please try again in 1 hour.</Message> <Retry>3600000</Retry></Error>

Pre-Order Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Pre-Order, Summary, Weekly, 20150208<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded P_S_W_80012345_20150208.txt.gz.</Message></Output>

Cloud Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 80012345, Cloud, Detailed, Daily, 20150208<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded C_D_80012345_20150208.txt.gz.</Message></Output>

Wrong Vendor Number (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Sales.getReport 90012345, Sales, Summary, Daily, 20150201<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>200</Code> <Message>Invalid vendor number specified. Try again.</Message></Error>

Errors

If the getReport command returns errors, they each contain a code. The table below describes these possible errors and their codes:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>200</Code> <Message>Invalid vendor number specified. Try again.</Message></Error>

Error Code

Error Description

200

Invalid vendor number.

201

Invalid report type specified. Valid values include: Sales, Newsstand, Pre-order, Cloud, Event, Customer, Content, Station, Control, amEvent, amContent, amControl, amStreams, Subscription, SubscriptionEvent, and Subscriber.

202

Invalid report subtype.

203

Invalid combination of report type and report subtype.

204

Invalid date type.

205

Invalid weekly date.

206

Invalid combination of report subtype and date type.

207

Invalid date.

208

Invalid combination of date type and date.

209

Report no longer available because it expired.

210

Report not available because it is not ready yet.

211

Report not available.

212

Unexpected error.

213

Report not available because there were no sales.

Payments and Financial Reports

About Payments and Financial Reports Commands

This section describes the Reporter commands you can use for Payments and Financial reports. All commands for Payments and Financial reports start with:

Finance.[command]

For more information on reading your reports, see the iTunes Connect Payments and Financial Reports Guide.

getVendorsAndRegions

About getVendorsAndRegions

This command returns a list of report types you can download by vendor number and region. See the getReport command for a description of report types.

Syntax

$ java -jar Reporter.jar p=[properties file] Finance.getVendorsAndRegions

Examples for Music

Normal Mode

$ java -jar Reporter.jar p=Reporter.properties Finance.getVendorsAndRegionsThe following reports are available for vendor 80012345:US: Financial,Match,Radio,RadioSummaryJP: Financial,MatchThe following reports are available for vendor 80067891:CA: Financial,Match,Radio,RadioSummary,AppleMusic,AppleMusicSummary

Robot Mode

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getVendorsAndRegions<?xml version="1.0" encoding="UTF-8" standalone="yes"?><VendorsAndRegions> <Vendor> <Number>80012345</Number> <Region> <Code>US</Code> <Reports> <Report>Financial</Report> <Report>Match</Report> <Report>Radio</Report> <Report>RadioSummary</Report> </Reports> </Region> <Region> <Code>JP</Code> <Reports> <Report>Financial</Report> <Report>Match</Report> </Reports> </Region> </Vendor> <Vendor> <Number>80067891</Number> <Region> <Code>CA</Code> <Reports> <Report>Financial</Report> <Report>Match</Report> <Report>Radio</Report> <Report>RadioSummary</Report> <Report>AppleMusic</Report> <Report>AppleMusicSummary</Report> </Reports> </Region> </Vendor></VendorsAndRegions>

Examples for Movies, TV

Normal Mode

$ java -jar Reporter.jar p=Reporter.properties Finance.getVendorsAndRegionsThe following reports are available for vendor 80012345:US: FinancialJP: FinancialThe following reports are available for vendor 80067891:CA: Financial

Robot Mode

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getVendorsAndRegions<?xml version="1.0" encoding="UTF-8" standalone="yes"?><VendorsAndRegions> <Vendor> <Number>80012345</Number> <Region> <Code>US</Code> <Reports> <Report>Financial</Report> </Reports> </Region> <Region> <Code>JP</Code> <Reports> <Report>Financial</Report> </Reports> </Region> </Vendor> <Vendor> <Number>80067891</Number> <Region> <Code>US</Code> <Reports> <Report>Financial</Report> </Reports> </Region> </Vendor></VendorsAndRegions>

getReport

This command downloads a financial report for you.

Syntax

$ java -jar Reporter.jar p=[properties file] Finance.getReport [vendor number], [region code], [report type], [fiscal year], [fiscal period]

Parameters

Parameter

Description

Vendor Number

Use the vendor number for the report you want to download. For a list of your vendor numbers, use the getVendorsAndRegions command.

Region Code

Two-character code of country of report to download. For a list of country codes by vendor number, use getVendorsAndRegions command.

Report Type

Specific type of report to download (for example, Financial).

Fiscal Year

Four-digit year of report to download. Year is specific to Apple’s fiscal calendar.

Fiscal Period

This is the period in fiscal year for the report you’re downloading (1–12). The period is specific to Apple’s fiscal calendar.

Report Type for Movies and TV

Currently only one report type is available: Financial.

Examples for Movies and TV

Financial Report (Robot mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getReport 80012345, US, Financial, 2015, 1<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded 80012345_1015_US.txt.gz</Message></Output>

Report Type for Music

The table below describes the valid values to use for each report type with getReport.

Report Type

Description

Finance

Standard financial report for sold content.

Match

Report of royalties due for iTunes Match downloads.

Radio

Detailed report of royalties due for Radio plays.

RadioSummary

Summary report of royalties due for Radio plays.

AppleMusic

Detailed report of royalties due for Apple Music streams.

AppleMusicSummary

Summary report of royalties due for Apple Music streams.

BeatsRadio

Detailed report of royalties due for Beats 1 plays.

Examples for Music

Financial Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getReport 80012345, US, Financial, 2015, 1<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded 80012345_1015_US.txt.gz</Message></Output>

Radio Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getReport 80012345, US, Radio, 2015, 1<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded R1_80012345_1015_US.txt.gz</Message></Output>

Apple Music Summary Report (Robot Mode)

$ java -jar Reporter.jar p=Reporter.properties m=Robot.XML Finance.getReport 80012345, US, AppleMusicSummary, 2015, 1<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Output> <Message>Successfully downloaded S1_80012345_1015_US.txt.gz</Message></Output>

Errors

The table below describes possible errors returned by the getReport command. In Robot mode, errors are returned with a code, as listed below:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Error> <Code>300</Code> <Message>Invalid vendor number specified. Try again.</Message></Error>

Error Code

Error Description

300

Invalid vendor number.

301

Invalid report type.

316

Invalid region code.

314

Invalid fiscal year.

315

Invalid fiscal period.

211

Report is unexpectedly not available.

212

An unexpected error occurred.

213

Report isn’t available, because there were no sales for that date.

Copyright

Apple Inc.

© 2016 Apple Inc. All rights reserved.

No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Apple Inc., with the following exceptions: Any person is hereby authorized to store documentation on a single computer for personal use only and to print copies of documentation for personal use provided that the documentation contains Apple’s copyright notice.

No licenses, express or implied, are granted with respect to any of the technology described in this document. Apple retains all intellectual property rights associated with the technology described in this document. This document is intended to assist application developers to develop applications only for Apple-labeled computers.

Apple

1 Infinite Loop

Cupertino, CA 95014-2084

408-996-1010

www.apple.com

Apple, the Apple logo, iBook, iBooks, iPad, iPhone, iTunes, Mac, macOS, OS X, WebObjects, and Xcode are trademarks of Apple Inc., registered in the U.S. and other countries.

Multi-Touch is a trademark of Apple Inc.

iBooks, iTunes, and iTunes Store are registered trademarks of Apple Inc., in the U.S. and other countries.

iTunes Extras and iTunes Plus are service marks of Apple Inc., registered in the U.S. and other countries.

App Store, iBooks Store, and iTunes LP are service marks of Apple Inc.

Intel and Intel Core are registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

Java is a registered trademark of Oracle and/or its affiliates.

UNIX is a registered trademark of The Open Group.

Even though Apple has reviewed this document, APPLE MAKES NO WARRANTY OR REPRESENTATION, EITHER EXPRESS OR IMPLIED, WITH 
 RESPECT TO THIS DOCUMENT, ITS QUALITY, ACCURACY, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE. AS A RESULT, THIS DOCUMENT IS PROVIDED “AS IS,” AND YOU, THE READER, ARE ASSUMING THE ENTIRE RISK AS TO ITS QUALITY AND ACCURACY.

IN NO EVENT WILL APPLE BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT OR INACCURACY IN THIS DOCUMENT, even if advised of the possibility of such damages.

THE WARRANTY AND REMEDIES SET FORTH ABOVE ARE EXCLUSIVE AND IN LIEU OF ALL OTHERS, ORAL OR WRITTEN, EXPRESS OR IMPLIED. No Apple dealer, agent, or employee is authorized to make any modification, extension, or addition to this warranty. Some states do not allow the exclusion or limitation of implied warranties or liability for incidental or consequential damages, so the above limitation or exclusion may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state.