{"title":"Prepare the reports","category":"default","creationDate":1776961627,"content":"<p>Make sure that your reports contain the information that you need for full reconciliation, and try out your reconciliation processes before going live.<\/p>\n<h2>Requirements<\/h2><\/li>\n<\/ul>\n<p>Before you start preparing reports, make sure to:<\/p>\n<ul>\n<li>Be familiar with the <a href=\"\/pt\/marketplaces\/account-structure-resources\">balance platform's account structure<\/a>, and <a href=\"\/pt\/marketplaces\/account-structure-resources\/marketplace-structure\">how funds flow<\/a>.<\/li>\n<li>Find out which <a href=\"\/pt\/marketplaces\/reports-and-fees#relevant-reports\">types of reports<\/a> are relevant for your use case.<\/li>\n<li>Understand the <a href=\"\/pt\/marketplaces\/reports-and-fees#fees\">types of fees<\/a>.\n<\/li>\n<\/ul>\n<h2 id=\"configure-reports\">Configure reports<\/h2>\n<p>When you know the reports that are relevant for your reconciliation processes, proceed to:<\/p>\n<ol>\n<li><a href=\"\/pt\/reporting\/time-zone-setting\">Configure timezones<\/a>. Reports are generated for 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 report columns<\/a>.<\/li>\n<\/ol>\n<h3 id=\"add-report-columns\">Configure report columns<\/h3>\n<p>All reports have default columns, but in many <a href=\"\/pt\/marketplaces\/reports-and-fees#adyen-account-reports\">Adyen account reports<\/a> you can add more columns. Adding columns increases the report file size. We recommend that you first review the default settings and only add columns that you really need.<\/p>\n<p>You can also change the location of the columns within your reports, or remove columns that are not relevant to your reporting use case.<\/p>\n<h4>Additional columns<\/h4>\n<p>For a full financial reconciliation, we recommend enabling the following additional report columns for relevant merchant accounts connected to your balance platform.<\/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<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment accounting report<\/a><\/td>\n<td>Store<\/td>\n<td>Shows the store ID for which a payment is processed. Enable this column if your balance platform uses stores, such as for in-person payments. Adding this column helps you to fully reconcile payment funds as well as fee cost balance changes down to the store level.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment accounting report<\/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 Accounting report.<\/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 relative to the monthly invoicing period. Depending on the scope and volume of your balance 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.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment accounting report<\/a>, <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 relative to the monthly invoicing period. Depending on the scope and volume of your balance platform operations, reports can contain line items that fall into two different invoicing periods. You can use the  AMS Booking Date to reconcile the invoicing period.<\/td>\n<\/tr>\n<tr>\n<td><a href=\"\/pt\/reporting\/settlement-detail-report\">Settlement\u00a0details\u00a0report<\/a><\/td>\n<td>Funds Destination<\/td>\n<td>This column is only relevant if you are upgrading your balance platform from our Classic integration. This column indicates the destination platform system for each settlement line item. You can use this to support a period of parallel reconciliation.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h4>Instructions<\/h4>\n<p>If you want to add additional columns or change the order of columns in a report, you can do so in the <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>. If you have an automated system that uses the report's data, configuring the report columns can affect your automated system.<\/p>\n<p>To configure report columns, you need to have one of the following <a href=\"\/pt\/account\/user-roles\">user roles<\/a>:<\/p>\n<ul>\n<li>Merchant admin<\/li>\n<li>Merchant report role<\/li>\n<li>Merchant financial<\/li>\n<li>Merchant POS Report role<\/li>\n<\/ul>\n<p>To configure report columns:<\/p>\n<ol>\n<li>Log in to your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/li>\n<li>Go to <strong>Settings<\/strong> &gt; <strong>Report columns<\/strong>.<br \/>\nThis opens a page with all the reports that you can configure.<\/li>\n<li>Find the report that you want to configure and select <strong>Configure<\/strong>.<\/li>\n<li>Select checkboxes to indicate which columns you want to include in the report.<\/li>\n<li>Drag the columns into the order you want them to appear in.<\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"download-reports\">Download reports<\/h2>\n<p>Download reports, either manually or automatically through your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>. If you want to regularly do a full reconciliation, consider building a scalable solution by automatically ingesting and combining reports.<\/p>\n<p>Refer to these instructions:<\/p>\n<ul>\n<li>For <strong>Adyen account reports<\/strong> see <a href=\"\/pt\/reporting\/manually-get-reports\">Generate and download reports manually<\/a> and <a href=\"\/pt\/reporting\/automatically-get-reports\">Get reports automatically<\/a>.<\/li>\n<li>For <strong>balance platform reports<\/strong>, see <a href=\"\/pt\/marketplaces\/prepare-reports\/generate-download-reports\">Get platform reports<\/a>.<\/li>\n<\/ul>\n<h2 id=\"combine-reports\">Combine reports<\/h2>\n<p>To track a transaction throughout its <a href=\"\/pt\/reporting\/reports-and-the-payments-lifecycle\">entire lifecycle<\/a> and do a full reconciliation, you should:<\/p>\n<ul>\n<li>Combine data from several reports.<\/li>\n<li>Understand where the references that you send in API requests end up in Adyen reports. Adyen includes these references to help you correctly identify and match each entry.<\/li>\n<\/ul>\n<p>The next table shows the most important reference fields. For an explanation of the relation between these fields and the reports, see <a href=\"\/pt\/marketplaces\/reconciliation-use-cases\">Common reconciliation processes<\/a>.<\/p>\n<table>\n<thead>\n<tr>\n<th><a href=\"\/pt\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment\u00a0accounting\u00a0report<\/a> <br> <a href=\"\/pt\/reporting\/settlement-detail-report\">Settlement\u00a0details\u00a0report<\/a><\/th>\n<th><a href=\"\/pt\/marketplaces\/reports-and-fees\/balance-platform-accounting-report\">Accounting\u00a0report<\/a><\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Psp Reference<\/td>\n<td>Psp 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>Psp Payment Merchant Reference<\/td>\n<td>The <code>reference<\/code> field that you provide to Adyen in your  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/latest\/post\/payments\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/payments<\/a> request. Although the API doesn't require it, we recommend that you use a unique value for each payment.<\/td>\n<\/tr>\n<tr>\n<td>Modification Merchant Reference, <br>Modification Reference<\/td>\n<td>Psp Modification Merchant Reference<\/td>\n<td>The <code>reference<\/code> field that you provide to Adyen for a payment modification, like a <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/70\/post\/payments\/_paymentPspReference_\/captures\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/captures<\/a> or <a href=\"https:\/\/docs.adyen.com\/api-explorer\/Checkout\/70\/post\/payments\/_paymentPspReference_\/refunds\" class=\"codeLabel external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">\/refunds<\/a> request. Although the API doesn't require it, we recommend that you use a unique value for each modification.<\/td>\n<\/tr>\n<tr>\n<td>N\/A<\/td>\n<td>Reference<\/td>\n<td>The <code>reference<\/code> that you provide for a payment split. Although the API doesn't require it, we recommend that you use a unique value for each payment split so you can use the value to match report data 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\/marketplaces\/webhook-types#transfer-webhooks\">webhooks<\/a>.<\/p>\n<p>When combining reports, 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 common causes.<\/p>\n<h2 id=\"test-reconciliation-process\">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\/marketplaces\/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 sample reports from the documentation pages that discuss specific reports.<\/li>\n<li>Make test transactions and then <a href=\"#download-reports\">download reports in the test environment<\/a>.<\/li>\n<\/ul>","url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/prepare-reports","articleFields":{"description":"Configure, download, and combine reports.","feedback_component":true,"next_steps":[{"title":"Common reconciliation processes","description":"Learn how you can use reports in common reconciliation use cases.","url":"\/marketplaces\/reconciliation-use-cases","required":false}],"page_id":"b622a317-823b-4375-935e-568a598c9a68","filters_component":false,"parameters":{"directoryPath":"\/marketplaces","model":"marketplace"}},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/marketplaces\/prepare-reports","title":"Prepare the reports","content":"Make sure that your reports contain the information that you need for full reconciliation, and try out your reconciliation processes before going live.\nRequirements\n\nBefore you start preparing reports, make sure to:\n\nBe familiar with the balance 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\n\nConfigure reports\nWhen you know the reports that are relevant for your reconciliation processes, proceed to:\n\nConfigure timezones. Reports are generated for 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 report columns.\n\nConfigure report columns\nAll reports have default columns, but in many Adyen account reports you can add more columns. Adding columns increases the report file size. We recommend that you first review the default settings and only add columns that you really need.\nYou can also change the location of the columns within your reports, or remove columns that are not relevant to your reporting use case.\nAdditional columns\nFor a full financial reconciliation, we recommend enabling the following additional report columns for relevant merchant accounts connected to your balance platform.\n\n    \n\n\n\nReport\nRecommended additional columns\nDescription\n\n\n\n\nPayment accounting report\nStore\nShows the store ID for which a payment is processed. Enable this column if your balance platform uses stores, such as for in-person payments. Adding this column helps you to fully reconcile payment funds as well as fee cost balance changes down to the store level.\n\n\nPayment accounting report\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 Accounting report.\n\n\nSettlement\u00a0details\u00a0report\nAMS Booking Date\nShows when Adyen assessed and booked a line item relative to the monthly invoicing period. Depending on the scope and volume of your balance 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.\n\n\nPayment accounting report, Settlement\u00a0details\u00a0report\nAMS Booking Date\nShows when Adyen assessed and booked a line item relative to the monthly invoicing period. Depending on the scope and volume of your balance platform operations, reports can contain line items that fall into two different invoicing periods. You can use the  AMS Booking Date to reconcile the invoicing period.\n\n\nSettlement\u00a0details\u00a0report\nFunds Destination\nThis column is only relevant if you are upgrading your balance platform from our Classic integration. This column indicates the destination platform system for each settlement line item. You can use this to support a period of parallel reconciliation.\n\n\n\n\n\n\nInstructions\nIf you want to add additional columns or change the order of columns in a report, you can do so in the Customer Area. If you have an automated system that uses the report's data, configuring the report columns can affect your automated system.\nTo configure report columns, you need to have one of the following user roles:\n\nMerchant admin\nMerchant report role\nMerchant financial\nMerchant POS Report role\n\nTo configure report columns:\n\nLog in to your Customer Area.\nGo to Settings &gt; Report columns.\nThis opens a page with all the reports that you can configure.\nFind the report that you want to configure and select Configure.\nSelect checkboxes to indicate which columns you want to include in the report.\nDrag the columns into the order you want them to appear in.\nSelect Save configuration.\n\nDownload reports\nDownload reports, either manually or automatically through your Customer Area. If you want to regularly do a full reconciliation, consider building a scalable solution by automatically ingesting and combining reports.\nRefer to these instructions:\n\nFor Adyen account reports see Generate and download reports manually and Get reports automatically.\nFor balance platform reports, see Get platform reports.\n\nCombine reports\nTo track a transaction throughout its entire lifecycle and do a full reconciliation, you should:\n\nCombine data from several reports.\nUnderstand where the references that you send in API requests end up in Adyen reports. Adyen includes these references to help you correctly identify and match each entry.\n\nThe next table shows the most important reference fields. For an explanation of the relation between these fields and the reports, see Common reconciliation processes.\n\n\n\nPayment\u00a0accounting\u00a0report  Settlement\u00a0details\u00a0report\nAccounting\u00a0report\nDescription\n\n\n\n\nPsp Reference\nPsp Payment Psp Reference\nA unique identifier generated by Adyen for each transaction.\n\n\nMerchant Reference\nPsp Payment Merchant Reference\nThe reference field that you provide to Adyen in your  \/payments request. Although the API doesn't require it, we recommend that you use a unique value for each payment.\n\n\nModification Merchant Reference, Modification Reference\nPsp Modification Merchant Reference\nThe reference field that you provide to Adyen for a payment modification, like a \/captures or \/refunds request. Although the API doesn't require it, we recommend that you use a unique value for each modification.\n\n\nN\/A\nReference\nThe reference that you provide for a payment split. Although the API doesn't require it, we recommend that you use a unique value for each payment split so you can use the value to match report data with your records.\n\n\n\nThese references are also returned in the API responses and sent in the webhooks.\nWhen combining reports, 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 common causes.\nTest 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 sample reports from the documentation pages that discuss specific reports.\nMake test transactions and then download reports in the test environment.\n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Marketplaces","lvl2":"Prepare the reports"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/marketplaces","lvl2":"\/pt\/marketplaces\/prepare-reports"},"levels":3,"category":"Marketplaces","category_color":"green","tags":["Prepare","reports"]}}