Revenue

Revenue

Retrieving Revenue Report Information

If you are distributing under any Revelator distribution deals, your Revelator revenue reports are added directly to your account. Download these reports for use in any an external system.

If you are using any non-Revelator distribution deals and not using Revelator for reporting or analytics, make sure that you do not configure your account to import your 3rd party revenue reports. Also, do not enter your credentials for the reporting fields when configuring your integration settings.

GET /finance/salereport/all

Retrieves all statement IDs and other identifying parameters of revenue reports in your account. Use this endpoint with filtering parameters, to find a specific statementTypeId.

Query Params

ParameterTypeDescription
storeId
optional
integerTo filter for a specific DSP, provide the DSP’s storeId.
storeIds
optional
array of integersTo filter for multiple DSPs, provide multiple DSP’s storeId separately
processed
optional
boolean
  • true - to filter for processed reports
  • false - to filter for unprocessed reports
approved
optional
boolean
  • true - to filter for approved reports
  • false - to filter for unapproved reports

GET /finance/salereport/{statementId}

Retrieves only the specified statement and its parameters.

The format of statmentId in the query is: statmentId={statementTypeId}%7C{stamentId} , %7C is URL-encoded for ”|” (bar/pipe).

Failure to use this format will result in an error response. Use the Retrieving Revenue Report Information endpoint with filtering parameters, to find the specific statementTypeId of the statement you need.

Example

Request
curl -X GET --header 'Accept: text/plain'\
'https://api.revelator.com/finance/salereport/all?storeIds=1&storeIds=2&approved=true'
Request
curl -X GET --header 'Accept: text/plain'\
'https://api.revelator.com/finance/salereport/1%7C4188172'

Downloading Revenue Reports

Revenue Reports can be downloaded in 2 formats; Summary, as an HTML file, or Details, in a .csv file. All download requests must use the format below. Failure to use the correct format will result in an error response.

GET /finance/salereport/download/summary

Downloads the Summary revenue report as an HTML file for the specified statement ID.

The format of statmentId in the query is: statmentId={statementTypeId}%7C{stamentId} , %7C is URL-encoded for ”|” (bar/pipe).

Failure to use this format will result in an error response.

Its recommended to first retrieve and view the Revenue Reports using the Retrieving Revenue Report Information endpoints to confirm the correct values of statementTypeId and statmentId.

Query Params

ParameterTypeDescription
statementId
required
stringStatement ID of the report.

GET /finance/salereport/download/details

Downloads the Details revenue report as a .csv file for the specified statement ID.

The format of statmentId in the query is: statmentId={statementTypeId}%7C{stamentId} , %7C is URL-encoded for ”|” (bar/pipe).

Failure to use this format will result in an error response.

Its recommended to first retrieve and view the Revenue Reports using the Retrieving Revenue Report Information endpoints to confirm the correct values of statementTypeId and statmentId.

Query Params

ParameterTypeDescription
statementId
required
stringStatement ID of the report.

Example

Request
curl -X GET --header 'Accept: text/plain'\
'http://api.revelator.com/finance/salereport/download/summary?statementId=1%7C123456'
Request
curl -X GET --header 'Accept: text/plain'\
'http://api.revelator.com/finance/salereport/download/details?statementId=1%7C123456'