{"metadata":{"image":[],"title":"","description":""},"api":{"url":"","auth":"required","results":{"codes":[]},"settings":"","params":[]},"next":{"description":"","pages":[]},"title":"Reporting","type":"basic","slug":"reporting","excerpt":"Learn about our reporting capabilities available through the Merchant Portal and Reporting API\nIf you have questions after reading this guide, check out our [FAQs page](https://support.bluesnap.com/docs/faqs-marketplace).","body":"This section will cover the following topics: \n* [Reporting overview](#section-reporting-overview)\n* [Common reporting scenarios](#section-common-reporting-scenarios)\n\n##Reporting overview\nTo keep track of your vendors, use our reports to review topics, such as transaction details and payout summaries. Additionally, you can run a report to see all your vendors and specific details associated with each. Your vendor reporting detail is available through both the BlueSnap Merchant Portal and our [Reporting API](/v8976-Tools/docs/reporting-api-overview). \n\nYour vendor details can be found within the following reports:\n\n * Account Balance report \n * Account Balance Detail report\n * Sales by Product & Currency report\n * Transactions Summary report\n * Transaction Details report\n * Declined Transactions report\n * Subscriptions reports\n * Payout Details report\n * Payout Summary Statement report\n * Vendor Details report\n\nMore information on reporting can be found [here](https://support.bluesnap.com/docs/reporting).\n\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Common reporting scenarios \n###Scenario 1: Communicating payout information to your vendor\nUse the Payout Detail report to communicate payout information to your vendor. To run the report via our [Reporting API](/v8976-Tools/docs/get-report-data), include the URL parameters `forvendorid` and `period` in the query string. Note that the value for `forvendorid` is the vendor ID and `period` is the period for which you would like to run the report. \n\nSuppose that you want to run the report for vendor ID 515503 for the last six months. The API endpoint for **sandbox** will be: \n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"https://sandbox.bluesnap.com/services/2/report/PayoutDetail?period=LAST_6_MONTHS&forvendorid=515503\",\n \"language\": \"text\",\n \"name\": \"Payout Detail: API Endpoint\"\n }\n ]\n}\n[/block]\n###Scenario 2: Communicating sales history to your vendor\nSuppose your vendor (whose vendor ID is 515503) would like to know their sales history for the last three months. To provide this information, you'll run the Transaction Detail report. To do this via our Reporting API, you'll pass the URL parameters `vendor`, `period`, and `transactionType` in the query string. The resulting endpoint for **sandbox** will be: \n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"https://sandbox.bluesnap.com/services/2/report/TransactionDetail?period=LAST_3_MONTHS&transactionType=SALE&vendor=515503\",\n \"language\": \"text\",\n \"name\": \"Transaction Detail: API Endpoint \"\n }\n ]\n}\n[/block]\n<a class=\"btn btn-primary\" href=\"#\" role=\"button\">Back to Top</a>\n\n<hr>\n\n##Next: Payout \nNow that you've learned about our reporting capabilities, move on to learn about payout. \n\n**[➔ Payout](/docs/payout)**","updates":[],"order":8,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"62178c1e445ec2009631ec1e","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Marketplace/Split Payments","slug":"marketplace","order":4,"from_sync":false,"reference":false,"_id":"62178c1e445ec2009631ebee","version":"62178c1e445ec2009631ec4d","project":"57336fd5a6a9c40e00e13a0b","createdAt":"2017-03-17T15:51:04.102Z","__v":1},"project":"57336fd5a6a9c40e00e13a0b","user":"560d5913af97231900938124","parentDoc":null,"version":{"version":"8976-Embedded-Payments","version_clean":"8976.0.0-Embedded-Payments","codename":"3.40 Release","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["62178c1e445ec2009631ebeb","62178c1e445ec2009631ebec","62178c1e445ec2009631ebed","62178c1e445ec2009631ebee","62178c1e445ec2009631ebef","62178c1e445ec2009631ebf0","5beb278ac442ab0213f00990","62178c1e445ec2009631ebf1","5c3f542c12c4ac004bc51718","62178c1e445ec2009631ebf2","5df806ccecebde0059f17225","5dfa8a8f340c2b007418eb8a","62178c1e445ec2009631ebf3","5e597199fd2b0200117c2c1c"],"_id":"62178c1e445ec2009631ec4d","project":"57336fd5a6a9c40e00e13a0b","__v":0,"forked_from":"6183ed028202aa00161024e9","createdAt":"2018-04-23T14:36:48.535Z","releaseDate":"2018-04-23T14:36:48.535Z"},"createdAt":"2017-03-30T13:17:19.675Z","githubsync":"","__v":0}
Reporting
This section will cover the following topics:
Reporting overview
To keep track of your vendors, use our reports to review topics, such as transaction details and payout summaries. Additionally, you can run a report to see all your vendors and specific details associated with each. Your vendor reporting detail is available through both the BlueSnap Merchant Portal and our Reporting API.
Your vendor details can be found within the following reports:
- Account Balance report
- Account Balance Detail report
- Sales by Product & Currency report
- Transactions Summary report
- Transaction Details report
- Declined Transactions report
- Subscriptions reports
- Payout Details report
- Payout Summary Statement report
- Vendor Details report
More information on reporting can be found here.
Common reporting scenarios
Scenario 1: Communicating payout information to your vendor
Use the Payout Detail report to communicate payout information to your vendor. To run the report via our Reporting API, include the URL parameters forvendorid
and period
in the query string. Note that the value for forvendorid
is the vendor ID and period
is the period for which you would like to run the report.
Suppose that you want to run the report for vendor ID 515503 for the last six months. The API endpoint for sandbox will be:
https://sandbox.bluesnap.com/services/2/report/PayoutDetail?period=LAST_6_MONTHS&forvendorid=515503
Scenario 2: Communicating sales history to your vendor
Suppose your vendor (whose vendor ID is 515503) would like to know their sales history for the last three months. To provide this information, you'll run the Transaction Detail report. To do this via our Reporting API, you'll pass the URL parameters vendor
, period
, and transactionType
in the query string. The resulting endpoint for sandbox will be:
https://sandbox.bluesnap.com/services/2/report/TransactionDetail?period=LAST_3_MONTHS&transactionType=SALE&vendor=515503