{"title":"Get reports automatically","category":"default","creationDate":1681975680,"content":"<p>Use our <a href=\"\/pt\/development-resources\/webhooks\">webhooks<\/a> to automatically download the reports generated in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>.<\/p>\n<h2>Important changes<\/h2>\n<div class=\"notices yellow\">\n<p>We have <a href=\"https:\/\/help.adyen.com\/updates\/upcoming-changes-to-payment-oriented-reports-as-of-august-2023\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">migrated to a new technology platform<\/a> to make report generation faster.<\/p>\n<\/div>\n<p>This migration has an effect on the Received payment details, Interactive payment accounting, and Settlement details reports. You may have to update your report data ingestion logic if you automatically generate, download, and ingest reports or ingest manually downloaded reports into your system. To determine if you have to take action, check the <a href=\"https:\/\/help.adyen.com\/updates\/upcoming-changes-to-payment-oriented-reports-as-of-august-2023\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">migration overview<\/a>.<\/p>\n<h2 id=\"automate-generating-reports\">Step 1: Automate generating reports<\/h2>\n<h3 id=\"generate-automatically\">Configure reports to generate automatically<\/h3>\n<p>You need the\u00a0<strong>Merchant Report<\/strong>\u00a0<a href=\"\/pt\/account\/user-roles\">user role<\/a>.<\/p>\n<ol>\n<li>In your\u00a0<a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, go to <strong>Reports<\/strong> in the left navigation.<\/li>\n<li>Under\u00a0<strong>Report overview<\/strong>, you can select a report category from the drop-down menu or enter the name of a specific report in the <strong>Search<\/strong> bar. By default, <strong>All reports<\/strong> is selected.<\/li>\n<li>From the list of reports, select the report you want to configure under the <strong>Name<\/strong> column.<\/li>\n<li>Select\u00a0<strong>Manage report<\/strong>. This gives you the option to generate the report automatically or manually. Select\u00a0<strong>Automatic (generate on a schedule)<\/strong>.<\/li>\n<li>Select <strong>On<\/strong>.  You will see a pop-up message that says <strong>Automatic report generation has been enabled<\/strong> at the top of your screen.<br \/>\nFor some reports, you need to configure additional report settings such as the <a href=\"#report-frequency\">frequency<\/a>.<\/li>\n<li>Select a report format, for example, <strong>.CSV<\/strong>. If you change the file format, select <strong>Change format<\/strong> to confirm.<\/li>\n<\/ol>\n<h3 id=\"report-frequency\">Schedule when you receive reports<\/h3>\n<p>For some reports, like the Aggregate settlement details report, you need to choose how often to generate them. Your <a href=\"\/pt\/reporting\/time-zone-setting\">time zone setting<\/a> affects how your reports are generated.<\/p>\n<p>Select <strong>Add report schedule<\/strong> and do the following:<\/p>\n<ol>\n<li>\n<p>Select the <strong>Frequency<\/strong> of report generation:<\/p>\n<ul>\n<li><strong>Daily<\/strong>: each day between 02:00 and 10:00 CET and contains the previous 24 hours of data.<\/li>\n<li><strong>Weekly<\/strong>: each week on the selected day and contains the previous 7 days of data. For example, if scheduled on Wednesday, the report will contain data for the previous Wednesday to Tuesday.<\/li>\n<li><strong>Monthly<\/strong>: on the selected day of the month and contains data for the previous calendar month.<\/li>\n<li><strong>Quarterly<\/strong>: on the selected day of the month and contains data for the previous quarter.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Optionally configure:<\/p>\n<ul>\n<li><strong>The merchant country code(s)<\/strong>: enter your country code.<\/li>\n<li><strong>Also display the store<\/strong>: select <strong>Yes<\/strong> to display and <strong>No<\/strong> to not display the store.<\/li>\n<li><strong>Also display the terminal Id<\/strong>: select <strong>Yes<\/strong> to display and <strong>No<\/strong> to not display the terminal identifier.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Select <strong>Schedule<\/strong> to create a new schedule for automatic report generation.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"get-notifications\">Step 2: Get webhooks when reports are available<\/h2>\n<p>Follow the instructions on our <a href=\"\/pt\/development-resources\/webhooks\">Webhooks page<\/a> to expose an endpoint, set up webhooks in your <a href=\"https:\/\/ca-test.adyen.com\/\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">Customer Area<\/a>, and accept webhooks.<\/p>\n<p>When a new report has been generated, you will receive a <strong>REPORT_AVAILABLE<\/strong> webhook. It contains the following fields that you need to download the report:<\/p>\n<ul>\n<li><code>pspReference<\/code>: the file name of the report.<\/li>\n<li><code>reason<\/code>: the URL used to download the report.<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n    <code-sample :title=\"'Example REPORT_AVAILABLE webhook'\" :id=\"'713702106'\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"JSON\",\"content\":\"{\\n   \\\"live\\\":\\\"false\\\",\\n   \\\"notificationItems\\\":[\\n      {\\n         \\\"NotificationRequestItem\\\":{\\n            \\\"amount\\\":{\\n               \\\"currency\\\":\\\"EUR\\\",\\n               \\\"value\\\":0\\n            },\\n            \\\"eventCode\\\":\\\"REPORT_AVAILABLE\\\",\\n            \\\"eventDate\\\":\\\"2018-04-18T10:03:08+02:00\\\",\\n            \\\"merchantAccountCode\\\":\\\"[merchantAccountCode]\\\",\\n            \\\"merchantReference\\\":\\\"\\\",\\n            \\\"pspReference\\\":\\\"settlement_detail_report_batch_12.csv\\\",\\n            \\\"reason\\\":\\\"https:\\\\\\\/\\\\\\\/ca-test.adyen.com\\\\\\\/reports\\\\\\\/download\\\\\\\/MerchantAccount\\\\\\\/[merchantAccountCode]\\\\\\\/settlement_detail_report_batch_12.csv\\\",\\n            \\\"success\\\":\\\"true\\\"\\n         }\\n      }\\n   ]\\n}\"},{\"language\":\"xml\",\"tabTitle\":\"Soap\",\"content\":\"&lt;?xml version=\\\"1.0\\\" encoding=\\\"UTF-16\\\"?&gt;\\n&lt;soap:Envelope xmlns:soap=\\\"http:\\\/\\\/schemas.xmlsoap.org\\\/soap\\\/envelope\\\/\\\"\\n    xmlns:xsd=\\\"http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema\\\" xmlns:xsi=\\\"http:\\\/\\\/www.w3.org\\\/2001\\\/XMLSchema-instance\\\"&gt;\\n    &lt;soap:Body&gt;\\n        &lt;sendNotification xmlns=\\\"http:\\\/\\\/notification.services.adyen.com\\\"&gt;\\n            &lt;notification&gt;\\n                &lt;live&gt;true&lt;\\\/live&gt;\\n                &lt;notificationItems&gt;\\n                    &lt;NotificationRequestItem&gt;\\n                        &lt;amount&gt;\\n                            &lt;currency xmlns=\\\"http:\\\/\\\/common.services.adyen.com\\\"&gt;EUR&lt;\\\/currency&gt;\\n                            &lt;value xmlns=\\\"http:\\\/\\\/common.services.adyen.com\\\"&gt;0&lt;\\\/value&gt;\\n                        &lt;\\\/amount&gt;\\n                        &lt;eventCode&gt;REPORT_AVAILABLE&lt;\\\/eventCode&gt;\\n                        &lt;eventDate&gt;2018-04-18T10:03:08+02:00&lt;\\\/eventDate&gt;\\n                        &lt;merchantAccountCode&gt;[merchantAccountCode]&lt;\\\/merchantAccountCode&gt;\\n                        &lt;merchantReference\\\/&gt;\\n                        &lt;pspReference&gt;settlement_detail_report_batch_12.csv&lt;\\\/pspReference&gt;\\n                        &lt;reason&gt;https:\\\/\\\/ca-test.adyen.com\\\/reports\\\/download\\\/MerchantAccount\\\/[merchantAccountCode]\\\/settlement_detail_report_batch_12.csv&lt;\\\/reason&gt;\\n                        &lt;success&gt;true&lt;\\\/success&gt;\\n                    &lt;\\\/NotificationRequestItem&gt;\\n                &lt;\\\/notificationItems&gt;\\n            &lt;\\\/notification&gt;\\n        &lt;\\\/sendNotification&gt;\\n    &lt;\\\/soap:Body&gt;\\n&lt;\\\/soap:Envelope&gt;\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<h2 id=\"create-api-credential\">Step 3: Create a Report service user API credential<\/h2>\n<p>You need a Report Service user API credential to download reports using HTTP GET requests. To be able to create new API credentials, 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>Manage API credentials<\/li>\n<\/ul>\n<p>To create a new credential:<\/p>\n<ol>\n<li>\n<p>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>, and go to <strong>Developers<\/strong>\u00a0&gt;\u00a0<strong>API credentials<\/strong>.<br \/>\nThis opens a list with all API credentials linked to your company account.<\/p>\n<\/li>\n<li>\n<p>Select <strong>Create new credential<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Under <strong>User type<\/strong>, select <strong>Report user<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Go to the end of the page and select <strong>Save<\/strong>.<\/p>\n<\/li>\n<li>\n<p>Under <strong>Authentication<\/strong>, create a password in <strong>Basic Auth<\/strong> section.<\/p>\n<ul>\n<li>If creating a new credential, copy the suggested password.<\/li>\n<li>If changing the password of an existing credential, select Generate password, and copy the generated password.<\/li>\n<li>Copy and securely store the API key in your system &mdash; you won't be able to restore it later.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Under <strong>Authentication<\/strong>, select <strong>Generate New API Key<\/strong>. This will generate an API key for the new API credential.<\/p>\n<ul>\n<li>Copy and securely store the API key in your system &mdash; you won't be able to restore it later.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Under <strong>Roles and Associated Accounts<\/strong>,<\/p>\n<ol>\n<li>\n<p>Select <strong>Roles<\/strong>, and make sure the toggle for <strong>Merchant Report Download role<\/strong> is assigned.<\/p>\n<\/li>\n<li>\n<p>If you only want to use this API credential for specific merchant accounts, select <strong>Account<\/strong>, and use the toggles to limit access to specific merchant accounts. When you toggle the company account, you toggle all merchant accounts under that company account.<\/p>\n<\/li>\n<\/ol>\n<\/li>\n<li>\n<p>Select <strong>Save<\/strong> at the bottom of the page.<\/p>\n<\/li>\n<\/ol>\n<h2 id=\"encrypt-report-files\">Step 4 (Optional): Encrypt report files<\/h2>\n<p>For additional security, you can optionally encrypt your report files with a PGP Key:<\/p>\n<ol>\n<li>If you haven't already done so, <a href=\"\/pt\/development-resources\/pgp-encryption#step-1-generate-new-pgp-key\">generate a PGP key<\/a>.<\/li>\n<li><a href=\"\/pt\/development-resources\/pgp-encryption#step-2-register-pgp-key-with-adyen\">Register your PGP public key with Adyen<\/a>, specifying <strong>Reports<\/strong> as the <strong>Purpose<\/strong> of the key.<\/li>\n<\/ol>\n<p>All future generated reports will be encrypted with this PGP key.<\/p>\n<h2 id=\"download-reports\">Step 5: Download reports<\/h2>\n<p>Download a report with an HTTP GET request. To authenticate the request, use an API key or Basic auth.<\/p>\n<p>Enable compression to reduce the file size of the report. Our servers look for the <code>Accept-Encoding: gzip<\/code> header in your request. Use the <code>--compressed<\/code> flag in <code>curl<\/code> or an equivalent option in your client to enable compression.<\/p>\n\n<div id=\"tabJ1DPW\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;API key&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To authenticate an HTTP GET request, replace the following in the example &lt;strong&gt;Download report&lt;\\\/strong&gt; below:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;$REPORT_SERVICE_USER_API_KEY&lt;\\\/code&gt; with the API key for your &lt;a href=\\&quot;#create-api-credential\\&quot;&gt;Report service user API credential&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;$REPORT_FILE_URL&lt;\\\/code&gt; with the URL from the &lt;code&gt;reason&lt;\\\/code&gt; field in the &lt;a href=\\&quot;#get-notifications\\&quot;&gt;&lt;strong&gt;REPORT_AVAILABLE&lt;\\\/strong&gt; webhook&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Example: Download reports&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;shell&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl -O $REPORT_FILE_URL \\\\\\\\\\\\n  --header &#039;X-API-KEY: $REPORT_SERVICE_USER_API_KEY&#039; \\\\\\\\\\\\n  --compressed&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;api_key_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Basic auth&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;To authenticate a report download with an HTTP GET request, replace the following in the code examples below:&lt;\\\/p&gt;\\n&lt;ul&gt;\\n&lt;li&gt;&lt;code&gt;$REPORT_SERVICE_USER&lt;\\\/code&gt; with the name of your &lt;a href=\\&quot;#create-api-credential\\&quot;&gt;Report service user&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;$REPORT_SERVICE_USER_PASSWORD&lt;\\\/code&gt; with the basic authentication password for your report &lt;a href=\\&quot;#create-api-credential\\&quot;&gt;Report service user&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;li&gt;&lt;code&gt;$REPORT_FILE_URL&lt;\\\/code&gt; with the URL from the &lt;code&gt;reason&lt;\\\/code&gt; field in the &lt;a href=\\&quot;#get-notifications\\&quot;&gt;&lt;strong&gt;REPORT_AVAILABLE&lt;\\\/strong&gt; webhook&lt;\\\/a&gt;.&lt;\\\/li&gt;\\n&lt;\\\/ul&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n    &lt;code-sample :title=\\&quot;&#039;Example: Download merchant account reports&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=\\&quot;[{&amp;quot;language&amp;quot;:&amp;quot;shell&amp;quot;,&amp;quot;tabTitle&amp;quot;:&amp;quot;&amp;quot;,&amp;quot;content&amp;quot;:&amp;quot;curl -O $REPORT_FILE_URL \\\\\\\\\\\\n  --user &#039;$REPORT_SERVICE_USER:$REPORT_SERVICE_USER_PASSWORD&#039; \\\\\\\\\\\\n  --compressed&amp;quot;}]\\&quot; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\\\/code-sample&gt;\\n&lt;\\\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;basic_auth_1_2&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<h3 id=\"determine-reports-to-download-by-parsing-file-names\">Parsing file names<\/h3>\n<p>Parse the file names of reports to choose which ones you want to download. Here are the file names of some commonly downloaded reports:<\/p>\n<table>\n    <colgroup>\n        <col style=\"width: 21%\">\n        <col style=\"width: 78%\">\n    <\/colgroup>\n    <thead>\n    <tr class=\"header\">\n        <th>Report type<\/th>\n        <th>File name format<\/th>\n    <\/tr>\n    <\/thead>\n    <tbody>\n    <tr><td>\n<p><a href=\"\/reporting\/settlement-reconciliation\/transaction-level\/settlement-details-report\">Settlement details report<\/a><\/p>\n<\/td><td>\n<p>settlement_detail_report_batch_[Batch Number].[file format]<br>Parameters batch closing report:<ul><li markdown=\"1\">[Batch Number] \u2013 sequential number of the settlement batch<\/li><li markdown=\"1\">[file format] \u2013 the file format of the report, <code>csv<\/code> by default<\/li><\/ul>settlement_detail_report_[report end date].[file format]<br>Parameters single day report:<ul><li markdown=\"1\">[report end date] \u2013 the date of the report. Format: <code>yyyy-mm-dd<\/code><\/li><li markdown=\"1\">[file format] \u2013 the file format of the report, <code>csv<\/code> by default<\/li><\/ul>settlement_detail_report_[report start date]_[report end date].[file format]<br>Parameters multiple day report (scheduled reports only):<ul><li markdown=\"1\">[report start date] \u2013 the start date of the report. Format: <code>yyyy_mm_dd<\/code><\/li><li markdown=\"1\">[report end date] \u2013 the end date of the report. Format: <code>yyyy_mm_dd<\/code><\/li><li markdown=\"1\">[file format] \u2013 the file format of the report, <code>csv<\/code> by default<\/li><\/ul>When you generate a report for multiple accounts, a unique identifier in the form of an eight-character alphanumeric string is added to the file name.<\/p>\n<\/td><\/tr>\n    <tr><td>\n<p><a href=\"\/reporting\/settlement-reconciliation\/batch-level\/aggregate-settlement-details-report\">Aggregate settlement details report<\/a><\/p>\n<\/td><td>\n<p>settlement_report_aggregate_[yourAccountName]_[countrycode]_[additionalData]_[fromdate]_[untildate].csv Parameters:<ul><li markdown=\"1\">[yourAccountname] \u2013 Adyen company or merchant account name<\/li><li markdown=\"1\">[countryCode] \u2013 First country code in case the report is limited to one or more merchant countries<\/li><li markdown=\"1\">[additionalData] \u2013 Indicates whether aggregation by Store, Terminal, or both is enabled. Possible values: empty, \"S\", \"T\", or \"ST\".<\/li><li markdown=\"1\">[fromdate] \u2013 The start date of report. Format: <code>yyyy-mm-dd<\/code><\/li><li markdown=\"1\">[untildate] \u2013 The end date of report. Format: <code>yyyy-mm-dd<\/code><\/li><\/ul><\/p>\n<\/td><\/tr>\n    <tr><td>\n<p><a href=\"\/reporting\/invoice-reconciliation\/payment-accounting-report\">Payment accounting report<\/a><\/p>\n<\/td><td>\n<p>payments_accounting_report_[date].csv Parameters:<ul><li markdown=\"1\">[date] \u2013 the date for which the report is generated. Format: <code>yyyy_mm_dd<\/code><\/li><\/ul><\/p>\n<\/td><\/tr>\n    <tr><td>\n<p><a href=\"\/reporting\/account-updater-results-report\">Account Updater results report<\/a><\/p>\n<\/td><td>\n<p>account_updater_results__[additionalData]_[dateformat]_[fromdate]-[untildate].csv Parameters:<ul><li markdown=\"1\">[additionalData] - Indicates whether aggregation by Merchant, Acquirer, or Card scheme, or a combination of them, is enabled. Possible values: empty, M=Merchant, A=Acquirer, P=Card scheme.<\/li><li markdown=\"1\">[dateformat] - Indicates the format of the selected date. M=month, W=Week number, D=Calendar day.<\/li><li markdown=\"1\">[fromdate] \u2013 Start date of the report. Format: <code>yyyy-mm-dd<\/code><\/li><li markdown=\"1\">[untildate] \u2013 End date of the report. Format: <code>yyyy-mm-dd<\/code><\/li><\/ul><\/p>\n<\/td><\/tr>\n    <tr><td>\n<p><a href=\"\/reporting\/disputed-transactions\">Dispute transaction details report<\/a><\/p>\n<\/td><td>\n<p>dispute_report_[date].csv Parameters:<ul><li markdown=\"1\">[date] \u2013 the date for which the report is generated. Format: <code>yyyy_mm_dd<\/code><\/li><\/ul><\/p>\n<\/td><\/tr>\n    <\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/reporting\/manually-get-reports\"\n                        target=\"_self\"\n                        >\n                    Manually get reports\n                <\/a><\/li><li><a href=\"\/reporting\/time-zone-setting\"\n                        target=\"_self\"\n                        >\n                    Time zone setting\n                <\/a><\/li><li><a href=\"\/reporting\/automatically-get-reports\/get-reports-using-sftp\"\n                        target=\"_self\"\n                        >\n                    Get reports using SFTP\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/reporting\/automatically-get-reports","articleFields":{"description":"Learn how to generate and download Adyen reports automatically.","feedback_component":true,"type":"page","status":"current","last_edit_on":"20-04-2023 09:28","filters_component":false,"page_id":"18fe5fbd-6fbf-400c-8e54-b4d130f10e67","decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/reporting\/automatically-get-reports","title":"Get reports automatically","content":"Use our webhooks to automatically download the reports generated in your Customer Area.\nImportant changes\n\nWe have migrated to a new technology platform to make report generation faster.\n\nThis migration has an effect on the Received payment details, Interactive payment accounting, and Settlement details reports. You may have to update your report data ingestion logic if you automatically generate, download, and ingest reports or ingest manually downloaded reports into your system. To determine if you have to take action, check the migration overview.\nStep 1: Automate generating reports\nConfigure reports to generate automatically\nYou need the\u00a0Merchant Report\u00a0user role.\n\nIn your\u00a0Customer Area, go to Reports in the left navigation.\nUnder\u00a0Report overview, you can select a report category from the drop-down menu or enter the name of a specific report in the Search bar. By default, All reports is selected.\nFrom the list of reports, select the report you want to configure under the Name column.\nSelect\u00a0Manage report. This gives you the option to generate the report automatically or manually. Select\u00a0Automatic (generate on a schedule).\nSelect On.  You will see a pop-up message that says Automatic report generation has been enabled at the top of your screen.\nFor some reports, you need to configure additional report settings such as the frequency.\nSelect a report format, for example, .CSV. If you change the file format, select Change format to confirm.\n\nSchedule when you receive reports\nFor some reports, like the Aggregate settlement details report, you need to choose how often to generate them. Your time zone setting affects how your reports are generated.\nSelect Add report schedule and do the following:\n\n\nSelect the Frequency of report generation:\n\nDaily: each day between 02:00 and 10:00 CET and contains the previous 24 hours of data.\nWeekly: each week on the selected day and contains the previous 7 days of data. For example, if scheduled on Wednesday, the report will contain data for the previous Wednesday to Tuesday.\nMonthly: on the selected day of the month and contains data for the previous calendar month.\nQuarterly: on the selected day of the month and contains data for the previous quarter.\n\n\n\nOptionally configure:\n\nThe merchant country code(s): enter your country code.\nAlso display the store: select Yes to display and No to not display the store.\nAlso display the terminal Id: select Yes to display and No to not display the terminal identifier.\n\n\n\nSelect Schedule to create a new schedule for automatic report generation.\n\n\nStep 2: Get webhooks when reports are available\nFollow the instructions on our Webhooks page to expose an endpoint, set up webhooks in your Customer Area, and accept webhooks.\nWhen a new report has been generated, you will receive a REPORT_AVAILABLE webhook. It contains the following fields that you need to download the report:\n\npspReference: the file name of the report.\nreason: the URL used to download the report.\n\n\n    \n\nStep 3: Create a Report service user API credential\nYou need a Report Service user API credential to download reports using HTTP GET requests. To be able to create new API credentials, you need to have one of the following user roles:\n\nMerchant admin\nManage API credentials\n\nTo create a new credential:\n\n\nLog in to your Customer Area, and go to Developers\u00a0&gt;\u00a0API credentials.\nThis opens a list with all API credentials linked to your company account.\n\n\nSelect Create new credential.\n\n\nUnder User type, select Report user.\n\n\nGo to the end of the page and select Save.\n\n\nUnder Authentication, create a password in Basic Auth section.\n\nIf creating a new credential, copy the suggested password.\nIf changing the password of an existing credential, select Generate password, and copy the generated password.\nCopy and securely store the API key in your system &mdash; you won't be able to restore it later.\n\n\n\nUnder Authentication, select Generate New API Key. This will generate an API key for the new API credential.\n\nCopy and securely store the API key in your system &mdash; you won't be able to restore it later.\n\n\n\nUnder Roles and Associated Accounts,\n\n\nSelect Roles, and make sure the toggle for Merchant Report Download role is assigned.\n\n\nIf you only want to use this API credential for specific merchant accounts, select Account, and use the toggles to limit access to specific merchant accounts. When you toggle the company account, you toggle all merchant accounts under that company account.\n\n\n\n\nSelect Save at the bottom of the page.\n\n\nStep 4 (Optional): Encrypt report files\nFor additional security, you can optionally encrypt your report files with a PGP Key:\n\nIf you haven't already done so, generate a PGP key.\nRegister your PGP public key with Adyen, specifying Reports as the Purpose of the key.\n\nAll future generated reports will be encrypted with this PGP key.\nStep 5: Download reports\nDownload a report with an HTTP GET request. To authenticate the request, use an API key or Basic auth.\nEnable compression to reduce the file size of the report. Our servers look for the Accept-Encoding: gzip header in your request. Use the --compressed flag in curl or an equivalent option in your client to enable compression.\n\n\n    \n        \n        \n    \n\n\nParsing file names\nParse the file names of reports to choose which ones you want to download. Here are the file names of some commonly downloaded reports:\n\n    \n        \n        \n    \n    \n    \n        Report type\n        File name format\n    \n    \n    \n    \nSettlement details report\n\nsettlement_detail_report_batch_[Batch Number].[file format]Parameters batch closing report:[Batch Number] \u2013 sequential number of the settlement batch[file format] \u2013 the file format of the report, csv by defaultsettlement_detail_report_[report end date].[file format]Parameters single day report:[report end date] \u2013 the date of the report. Format: yyyy-mm-dd[file format] \u2013 the file format of the report, csv by defaultsettlement_detail_report_[report start date]_[report end date].[file format]Parameters multiple day report (scheduled reports only):[report start date] \u2013 the start date of the report. Format: yyyy_mm_dd[report end date] \u2013 the end date of the report. Format: yyyy_mm_dd[file format] \u2013 the file format of the report, csv by defaultWhen you generate a report for multiple accounts, a unique identifier in the form of an eight-character alphanumeric string is added to the file name.\n\n    \nAggregate settlement details report\n\nsettlement_report_aggregate_[yourAccountName]_[countrycode]_[additionalData]_[fromdate]_[untildate].csv Parameters:[yourAccountname] \u2013 Adyen company or merchant account name[countryCode] \u2013 First country code in case the report is limited to one or more merchant countries[additionalData] \u2013 Indicates whether aggregation by Store, Terminal, or both is enabled. Possible values: empty, \"S\", \"T\", or \"ST\".[fromdate] \u2013 The start date of report. Format: yyyy-mm-dd[untildate] \u2013 The end date of report. Format: yyyy-mm-dd\n\n    \nPayment accounting report\n\npayments_accounting_report_[date].csv Parameters:[date] \u2013 the date for which the report is generated. Format: yyyy_mm_dd\n\n    \nAccount Updater results report\n\naccount_updater_results__[additionalData]_[dateformat]_[fromdate]-[untildate].csv Parameters:[additionalData] - Indicates whether aggregation by Merchant, Acquirer, or Card scheme, or a combination of them, is enabled. Possible values: empty, M=Merchant, A=Acquirer, P=Card scheme.[dateformat] - Indicates the format of the selected date. M=month, W=Week number, D=Calendar day.[fromdate] \u2013 Start date of the report. Format: yyyy-mm-dd[untildate] \u2013 End date of the report. Format: yyyy-mm-dd\n\n    \nDispute transaction details report\n\ndispute_report_[date].csv Parameters:[date] \u2013 the date for which the report is generated. Format: yyyy_mm_dd\n\n    \n\nSee also\n\n\n                    Manually get reports\n                \n                    Time zone setting\n                \n                    Get reports using SFTP\n                \n","type":"page","locale":"pt","boost":18,"hierarchy":{"lvl0":"Home","lvl1":"Reporting","lvl2":"Get reports automatically"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/reporting","lvl2":"\/pt\/reporting\/automatically-get-reports"},"levels":3,"category":"Reporting","category_color":"green","tags":["reports","automatically"]},"articleFiles":{"713702106.json":"<p alt=\"\">713702106.json<\/p>"}}
