{"title":"Prepare the reports","category":"Classic Platforms","creationDate":1776961628,"content":"<div class=\"sc-notice info\"><div>\n<p>This page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our <a href=\"\/pt\/adyen-for-platforms-model\">new integration guide<\/a> instead.<\/p>\n<\/div><\/div>\n<h2>Requirements<\/h2>\n<p>Before you start preparing reports, make sure to:<\/p>\n<ul>\n<li>Be familiar with the <a href=\"\/pt\/reporting\/reports-and-the-payments-lifecycle\">payment lifecycle<\/a>, <a href=\"\/pt\/classic-platforms\/account-structure\">a platform's account structure<\/a>, and <a href=\"\/pt\/classic-platforms\/account-structure#how-funds-flow\">how funds flow<\/a>.<\/li>\n<li>Find out which <a href=\"\/pt\/classic-platforms\/reports-and-fees#relevant-reports\">types of reports<\/a> are relevant for your use case.<\/li>\n<li>Understand the <a href=\"\/pt\/classic-platforms\/reports-and-fees#fees\">types of fees<\/a>.<\/li>\n<\/ul>\n<h2 id=\"configure-reports\">Step 1. Configure reports<\/h2>\n<p>When you know the reports that are relevant for your reconciliation processes, proceed to:<\/p>\n<ul>\n<li><a href=\"\/pt\/reporting\/time-zone-setting\">Configure timezones<\/a>. Reports are generated at different periods and can be based on different time zones. If reconciliation fails, mismatches in reporting periods or time zones are the common causes.<\/li>\n<li><a href=\"#add-report-columns\">Configure more report columns<\/a>.<\/li>\n<\/ul>\n<h3 id=\"add-report-columns\">Configure more report columns<\/h3>\n<p>The reports come with default columns, and for some of the reports you can optionally configure the columns, adding more if necessary. Adding columns increases the report file size. We recommend to first review the default settings and only add columns necessary for your specific insights and reconciliation process needs.<\/p>\n<ul>\n<li><a href=\"\/pt\/classic-platforms\/reports-and-fees#adyen-account-reports\">Adyen account reports<\/a>: configure the columns in your Customer Area. To know if additional columns are available for a report, refer to the report documentation. For example, <a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report#additional-columns\">additional columns for Settlement details report<\/a>.<\/li>\n<li><a href=\"\/pt\/classic-platforms\/reports-and-fees#platform-reports\">Platform reports<\/a>: to configure additional columns, contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a>.<\/li>\n<\/ul>\n<p>For a full financial reconciliation, we recommend enabling the following additional report columns.<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th>Report<\/th>\n<th>Recommended additional columns<\/th>\n<th>Description<\/th>\n<th><\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"\/pt\/reporting\/settlement-detail-report\">Settlement\u00a0details\u00a0report<\/a><\/td>\n<td>Split Payment Data<\/td>\n<td>Shows the exact split instructions provided during payments processing requests. You can use this to fully reconcile against corresponding funds postings in the Marketplace Payments accounting report. <br><br> <a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report#configure-report-columns\">Configure this column<\/a> for relevant merchant accounts connected to your platform.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/reporting\/settlement-detail-report\">Settlement\u00a0details\u00a0report<\/a><\/td>\n<td>AMS Booking Date<\/td>\n<td>Shows when Adyen assessed and booked a line item to the monthly invoicing period. Depending on the scope and volume of your platform operations, settlement line items can potentially span the start or end of a monthly invoicing period. You can use this to reconcile the invoicing period. <br><br> <a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report#configure-report-columns\">Configure this column<\/a> for relevant merchant accounts connected to your platform.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/classic-platforms\/reports-and-fees\/marketplace-payments-accounting-report\">Marketplace\u00a0Payments\u00a0accounting\u00a0report<\/a><\/td>\n<td>storecode, storereference<\/td>\n<td>Shows the store code and store reference from which a payment is processed.  Enable one or both of these columns if your platform uses <a href=\"\/pt\/classic-platforms\/split-configuration-for-stores\">stores<\/a>, such as for in-person payments. Adding these columns may reduce the need to combine report data. <br><br> Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to add these columns.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/classic-platforms\/reports-and-fees\/marketplace-payments-accounting-report\">Marketplace\u00a0Payments\u00a0accounting\u00a0report<\/a><\/td>\n<td>settlementbatchid<\/td>\n<td>Shows the identifier of the corresponding Settlement Detail Report batch identifier. If your platform is subject to shopper disputes and chargebacks, enable this column on your platform to fully reconcile the funds postings related to specific dispute events.<br><br> Contact our <a href=\"https:\/\/ca-test.adyen.com\/ca\/ca\/contactUs\/support.shtml?form=other\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Support Team<\/a> to add this column.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h2 id=\"download-reports\">Step 2. Download reports<\/h2>\n<p>Download reports, either <a href=\"\/pt\/reporting\/manually-get-reports\">manually<\/a> through your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a> or <a href=\"\/pt\/reporting\/automatically-get-reports\">generate and download reports automatically<\/a>. If you want to regularly do a full reconciliation, consider building a scalable solution by automatically ingesting and combining reports.<\/p>\n<h2 id=\"combine-reports\">Step 3. Combine reports<\/h2>\n<p>Combining data from several reports can be helpful when tracking a transaction throughout its <a href=\"\/pt\/reporting\/reports-and-the-payments-lifecycle\">entire lifecycle<\/a> and is necessary for full reconciliation. To facilitate the use of multiple reports, Adyen includes the references that you sent in the original transactions to help you correctly identify and match each entry.<\/p>\n<p>To combine reports, you need to match the following references:<\/p>\n<table>\n<thead>\n<tr>\n<th>Settlement&nbsp;details&nbsp;report,<br>Payment accounting report<\/th>\n<th>Marketplace&nbsp;Payments&nbsp;accounting report<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Psp Reference<\/td>\n<td>Payment Psp Reference<\/td>\n<td>A unique identifier generated by Adyen for each transaction.<\/td>\n<\/tr>\n<tr>\n<td>Merchant Reference<\/td>\n<td>Payment Merchant Reference<\/td>\n<td>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments#request-reference\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">reference<\/a> field that you provide to Adyen for each transaction. The API does not require that the value be unique, but we recommend that you use a unique value per transaction so you can use the field to match payments with your records.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>These references are also returned in the API responses and sent in the <a href=\"\/pt\/development-resources\/webhooks\">notification webhooks<\/a>.<\/p>\n<p>When combining reports, make sure you check that:<\/p>\n<ul>\n<li>The reports are from the same reporting period.<\/li>\n<li>The reports are generated using the same time zone.<\/li>\n<\/ul>\n<p>Reports are generated at different periods and can be based on different time zones. If reconciliation fails, mismatches in reporting periods or time zones are the common causes.<\/p>\n<h2 id=\"test-reconciliation-process\">Step 4. Test your reconciliation process<\/h2>\n<p>Before you start reconciliation in the live environment, we also recommend that you test your processes using complete reports. In the <a href=\"\/pt\/classic-platforms\/reconciliation-use-cases\">common reconciliation processes guides<\/a>, we only show selected rows and columns to illustrate the examples.<\/p>\n<p>To get complete reports, you can:<\/p>\n<ul>\n<li>Download examples from the <a href=\"\/pt\/reporting\">Reporting documentation<\/a>.<\/li>\n<li>Make test transactions and then <a href=\"\/pt\/reporting\/downloading-reports\">download reports in the test environment<\/a>.<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/prepare-reports","articleFields":{"description":"Configure, download, and combine reports.","search_category":"Classic Platforms","feedback_component":true,"last_edit_on":"09-01-2023 13:30","next_steps":[{"title":"Common reconciliation processes","description":"Learn how you can use reports in common reconciliation use cases.","url":"\/classic-platforms\/reconciliation-use-cases","required":false}],"parameters":{"directoryPath":"\/classic-platforms"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/classic-platforms\/prepare-reports","title":"Prepare the reports","content":"\nThis page is for classic Adyen for Platforms integrations. If you are just starting your implementation, refer to our new integration guide instead.\n\nRequirements\nBefore you start preparing reports, make sure to:\n\nBe familiar with the payment lifecycle, a platform's account structure, and how funds flow.\nFind out which types of reports are relevant for your use case.\nUnderstand the types of fees.\n\nStep 1. Configure reports\nWhen you know the reports that are relevant for your reconciliation processes, proceed to:\n\nConfigure timezones. Reports are generated at different periods and can be based on different time zones. If reconciliation fails, mismatches in reporting periods or time zones are the common causes.\nConfigure more report columns.\n\nConfigure more report columns\nThe reports come with default columns, and for some of the reports you can optionally configure the columns, adding more if necessary. Adding columns increases the report file size. We recommend to first review the default settings and only add columns necessary for your specific insights and reconciliation process needs.\n\nAdyen account reports: configure the columns in your Customer Area. To know if additional columns are available for a report, refer to the report documentation. For example, additional columns for Settlement details report.\nPlatform reports: to configure additional columns, contact our Support Team.\n\nFor a full financial reconciliation, we recommend enabling the following additional report columns.\n\n    \n\n\n\nReport\nRecommended additional columns\nDescription\n\n\n\n\n\nSettlement\u00a0details\u00a0report\nSplit Payment Data\nShows the exact split instructions provided during payments processing requests. You can use this to fully reconcile against corresponding funds postings in the Marketplace Payments accounting report.  Configure this column for relevant merchant accounts connected to your platform.\n\n\nSettlement\u00a0details\u00a0report\nAMS Booking Date\nShows when Adyen assessed and booked a line item to the monthly invoicing period. Depending on the scope and volume of your platform operations, settlement line items can potentially span the start or end of a monthly invoicing period. You can use this to reconcile the invoicing period.  Configure this column for relevant merchant accounts connected to your platform.\n\n\nMarketplace\u00a0Payments\u00a0accounting\u00a0report\nstorecode, storereference\nShows the store code and store reference from which a payment is processed.  Enable one or both of these columns if your platform uses stores, such as for in-person payments. Adding these columns may reduce the need to combine report data.  Contact our Support Team to add these columns.\n\n\nMarketplace\u00a0Payments\u00a0accounting\u00a0report\nsettlementbatchid\nShows the identifier of the corresponding Settlement Detail Report batch identifier. If your platform is subject to shopper disputes and chargebacks, enable this column on your platform to fully reconcile the funds postings related to specific dispute events. Contact our Support Team to add this column.\n\n\n\n\n\n\nStep 2. Download reports\nDownload reports, either manually through your Customer Area or generate and download reports automatically. If you want to regularly do a full reconciliation, consider building a scalable solution by automatically ingesting and combining reports.\nStep 3. Combine reports\nCombining data from several reports can be helpful when tracking a transaction throughout its entire lifecycle and is necessary for full reconciliation. To facilitate the use of multiple reports, Adyen includes the references that you sent in the original transactions to help you correctly identify and match each entry.\nTo combine reports, you need to match the following references:\n\n\n\nSettlement&nbsp;details&nbsp;report,Payment accounting report\nMarketplace&nbsp;Payments&nbsp;accounting report\nDescription\n\n\n\n\nPsp Reference\nPayment Psp Reference\nA unique identifier generated by Adyen for each transaction.\n\n\nMerchant Reference\nPayment Merchant Reference\nThe  reference field that you provide to Adyen for each transaction. The API does not require that the value be unique, but we recommend that you use a unique value per transaction so you can use the field to match payments with your records.\n\n\n\nThese references are also returned in the API responses and sent in the notification webhooks.\nWhen combining reports, make sure you check that:\n\nThe reports are from the same reporting period.\nThe reports are generated using the same time zone.\n\nReports are generated at different periods and can be based on different time zones. If reconciliation fails, mismatches in reporting periods or time zones are the common causes.\nStep 4. Test your reconciliation process\nBefore you start reconciliation in the live environment, we also recommend that you test your processes using complete reports. In the common reconciliation processes guides, we only show selected rows and columns to illustrate the examples.\nTo get complete reports, you can:\n\nDownload examples from the Reporting documentation.\nMake test transactions and then download reports in the test environment.\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Classic integration","lvl2":"Prepare the reports"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/classic-platforms","lvl2":"\/pt\/classic-platforms\/prepare-reports"},"levels":3,"category":"Classic Platforms","category_color":"green","tags":["Prepare","reports"]},"articleFiles":{"reports-and-funds.svg":"<img alt=\"\" src=\"https:\/\/docs.adyen.com\/user\/pages\/docs\/06.classic-platforms\/21.prepare-reports\/reports-and-funds.svg\" \/>"}}