Schedule Report Input Parameters

Learn about the input fields used to specify the information included in the report.

These field references describe the fields in the Schedule Report request.

Integrated services

The following fields are available for integrated services, including Vertex for e-Commerce, Vertex for Marketplaces, and Vertex O Series Online Commerce:

FieldTypePatternMinMaxRequiredDescription
report-typeStringYesThe report type. Possible values are Audit and Tax-ID.
formatStringNoSpecifies csv for an uncompressed file or csv.gz for a compressed file.
product-classesString^(S|P|D)\*NoSpecifies S for all product classes, P for physical goods, or D for digital goods. If you do not specify a value, the report includes all product classes. The value can be null.
end-dateString^\\d{4}-\\d{2}-\\d{2}$YesThe end date for the report.
fx-sourceStringYesThe source for currency conversions.
tax-country-subdivision-codeString\\w\\w-\\w\\w55NoThe country subdivision code. For example, use CA-QC for Quebec. The value can be null.
tax-country-codeString22NoThe two-letter ISO country code. The value can be null.
currency-codeString^\\w{3}$33No

The currency for the report. The report converts all amounts to this currency. If you do not specify a value, the service uses the country's default currency.

The value can be null.

fx-date-typeStringYesThe date used for currency conversions. Select day, prev-day, or end. This parameter is required when you specify currency-code.
tax-region-keyString^[A-Z]{2}$22NoThe value to filter the report by country or region. For example, specify CA to include only transactions within Canada. The value can be null.
report-scopeStringNoSee Report Scope Values.
transaction-typeStringNoSpecifies Sale for sales or Refund for refunds. If you do not specify a value, the report includes both. The value can be null.
start-dateString^\\d{4}-\\d{2}-\\d{2}$YesThe start date for the report.
fx-date-fieldStringNoSpecifies tax-timestamp to use the tax timestamp as the FX date, or invoice-timestamp to use the invoice timestamp. If you do not specify a value, the service uses tax-timestamp. The value can be null.

Standalone services

The following fields are available for Standalone Vertex Validator:

FieldTypePatternMinMaxRequiredDescription
start-dateString^\\d{4}-\\d{2}-\\d{2}$YesThe start date for the report period.
end-dateString^\\d{4}-\\d{2}-\\d{2}$YesThe end date for the report period.
tax-idsString1NoThe list of tax numbers to include in the report. The value can be null.
region-keysString^[A-Z]{2}$22NoThe value to filter the report by country or region. For example, specify CA to include only transactions within Canada. The value can be null.
validation-statusesStringNoSee Validation Status Values.
result-changedBooleantrue or falseNoSpecifies true to include only tax numbers whose validation results changed.

Did this page help you?