{"title":"Advancements detail report","category":"default","creationDate":1776961629,"content":"<p>The Advancements Detail Report is available in countries\/regions where Adyen offers the Advancement Product (which usually include countries\/regions where we process and receive payments in installments).<\/p>\n<p>This report provides details of the installments that were used by Adyen to determine the amount advanced to the merchant.<\/p>\n<p><strong>File name format:<\/strong> Includes the advancement code, the date we first register the advancement in Adyen, and the date the report is generated.<\/p>\n<p><strong>Generating and downloading:<\/strong> Get this report <a href=\"#manual-multi\">manually<\/a> or <a href=\"#auto-multi\">automatically<\/a>.<\/p>\n<p><strong>Time zone:<\/strong> Currently the time zone is only CET\/CEST.<\/p>\n<p><strong>Availability:<\/strong> Only available for <a href=\"\/pt\/account\/account-structure\/#merchant-accounts\">merchant accounts<\/a>.<\/p>\n<h2>File name format<\/h2>\n<p>The name of the report in Customer Area \/ Back Office follows specific rules to ensure a standard for name generation. This helps to prevent existing reports from being overwritten by newly generated reports.<\/p>\n<p>Report names follow this format:<\/p>\n<p><code>advancements_detail_report_&lt;ADVANCEMENT_CODE&gt;_&lt;DATE_1&gt;_&lt;DATE_2&gt;<\/code><\/p>\n<ul>\n<li>\n<p><code>ADVANCEMENT_CODE<\/code> specifies a single advancement operation. However, because these operations are by legal entity number (for example <strong>CNPJ<\/strong> in Brazil), it is possible that the total advancement operation amount includes merchant accounts with the same legal entity number. Therefor, the merchant must consult the report for different merchant accounts to get the total amount for that advancement operation.<\/p>\n<p>You can see the type of the advancement by looking at the advancement code:<\/p>\n<ul>\n<li>When it starts with <strong>ADYEN-ADV<\/strong>, it is an operation performed through <strong>Own Advancements<\/strong>.<\/li>\n<li>When it starts with <strong>ADYEN-PRX<\/strong>, it is an operation performed through <strong>Proxy Advancements<\/strong>.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p><code>DATE_1<\/code> indicates when the advancement was first registered in our accounting system.<\/p>\n<\/li>\n<li>\n<p><code>DATE_2<\/code> indicates the request date of the report. If you request multiple times for the report to be generated on different days, the older versions will not be overwritten.<\/p>\n<\/li>\n<\/ul>\n<p>Examples of report names:<\/p>\n<ul>\n<li>advancements_detail_report_ADYEN-ADV_20241030-143614_1065_155_2024_11_19_2024_11_21<\/li>\n<li>advancements_detail_report_ADYEN-PRX_20241014_14796606000351_00001149_2024_11_19_2024_11_21<\/li>\n<\/ul>\n<h2>Generate and download reports<\/h2>\n<p>This report is generated per merchant account, and per advancement code.<\/p>\n<p>To manually or automatically generate an Advancements Detail Report, or download a previously generated report, you must have the <strong>See installments reports<\/strong> user role. You need this role for each merchant account that you want to include in the report.<\/p>\n<h3 id=\"manual-multi\">Manually generate a report<\/h3>\n<p>To manually generate a report:<\/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>, and switch to the relevant merchant account.<\/li>\n<li>Select <strong>Reports<\/strong> &gt; <strong>Advancements details<\/strong>.<\/li>\n<li>Select <strong>Manage report<\/strong> &gt; <strong>Manual (generate once)<\/strong>.<\/li>\n<li>Input the complete advancement code. Important: If you type an advancement code that does not exist in the account, you may receive an empty report.<\/li>\n<li>Under <strong>File type<\/strong>, select one of the following:\n<ul>\n<li><strong>CSV<\/strong> (default)<\/li>\n<li><strong>XLS_GEN<\/strong><\/li>\n<li><strong>TSV<\/strong><\/li>\n<li><strong>XML<\/strong><\/li>\n<li><strong>XMLE<\/strong><\/li>\n<\/ul><\/li>\n<li>Select <strong>Generate report<\/strong>. At the top of your screen you will see a pop-up message that says <strong>Report is successfully queued<\/strong>.<\/li>\n<\/ol>\n<h3 id=\"auto-multi\">Automatically generate a report<\/h3>\n<p>To automatically generate a report:<\/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>, and switch to the relevant merchant account.<\/li>\n<li>Select <strong>Reports<\/strong> &gt; <strong>Advancements detail<\/strong>.<\/li>\n<li>Select <strong>Manage report<\/strong> &gt; <strong>Automatic (generate on a schedule)<\/strong>.<\/li>\n<li>Select <strong>On<\/strong>.<\/li>\n<li>Under <strong>File type<\/strong>, select one of the following:\n<ul>\n<li><strong>CSV<\/strong> (default)<\/li>\n<li><strong>XLS_GEN<\/strong><\/li>\n<li><strong>TSV<\/strong><\/li>\n<li><strong>XML<\/strong><\/li>\n<li><strong>XMLE<\/strong><\/li>\n<\/ul><\/li>\n<li>Select <strong>Schedule<\/strong>.<\/li>\n<\/ol>\n<h2>Sample report<\/h2>\n<p><a href=\"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/advancements-detail-report\/advancements_detail_report_ADYEN-ADV_20250114-123456_1234_123_2025_01_15_2025_01_16_complete_columns-advancements_detail_report_ADYE.csv\">Download a sample Advancements Detail Report<\/a> for examples of the included data.<\/p>\n<p>Based on your account and settings, a report you generate in your account can contain additional data or columns that are not included in the sample report.<\/p>\n<h2 id=\"report-structure\">Report structure<\/h2>\n<h3 id=\"entries\">Entries<\/h3>\n<p>Under the header line, each line in the report is a separate entry. The types of entries include:<\/p>\n<h4>Transaction lines<\/h4>\n<p>This indicates how much of an installment was advanced for a specific advancement code. It can appear as <strong>AdvancedInstallment<\/strong> or <strong>AdvancedInstallmentCancelled<\/strong>.<\/p>\n<h4>Aggregated lines<\/h4>\n<p>In the event that we are unable to select specific installments for the advancement, we will show the remaining amount as <strong>AdvancedBulk<\/strong> and\/or <strong>AdvancedBulkCancelled<\/strong>.<\/p>\n<h4>Total line<\/h4>\n<p>The total amount advanced for a specific advancement code, and for a specific merchant account.<\/p>\n<h3 id=\"columns\">Columns<\/h3>\n<p>Each column shows specific information about the entries.<\/p>\n<h4>Standard columns<\/h4>\n<p>The table below reflects the standard columns that are included in the report, and the default order. You can add <a href=\"#additional-columns\">more columns<\/a>, or change the order of the default columns.<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th>#<\/th>\n<th>Column name<\/th>\n<th>Data type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Company Account<\/td>\n<td>Unicode Text (80-character)<\/td>\n<td>The name of your company account as registered in the Adyen payments platform.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Merchant Account<\/td>\n<td>Unicode Text (80-character)<\/td>\n<td>The name of the merchant account that was used to process the original payment request.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>PSP Reference<\/td>\n<td>Unicode Text (16-character limit)<\/td>\n<td>Adyen's 16-character unique reference associated with the transaction\/the request. This value is globally unique; quote it when communicating with us about this request.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Merchant Reference<\/td>\n<td>Unicode Text (80-character)<\/td>\n<td>The reference that was specified by you in the payment request.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Payment Method Variant<\/td>\n<td>Unicode Text (30-character)<\/td>\n<td>The payment method used for the transaction.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>Creation Date<\/td>\n<td>Date field + Time field<\/td>\n<td>The timestamp indicates when the payment was captured on the Adyen payments platform. Format:YYYY-MM-DD HH:MM:SS. For example: 2025-01-02 19:58:55.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>TimeZone<\/td>\n<td>Unicode Text<\/td>\n<td>The time zone of the Creation Date in ISO code. At the moment it will always be in CET\/CEST.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>Modification Reference<\/td>\n<td>Unicode Text<\/td>\n<td>A unique ID that identifies the modification request, in this report it relates to an Advancement registration. Maximum length: 16 characters. For records of journal type Advancement, this is a description containing Account code, advancement code and batch number.<\/td>\n<\/tr>\n<tr>\n<td>9<\/td>\n<td>Gross Currency<\/td>\n<td>Unicode Text (3-character limit)<\/td>\n<td>The three-character ISO currency code for the payment currency.<\/td>\n<\/tr>\n<tr>\n<td>10<\/td>\n<td>Gross Debit (GC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The debit amount of an installment. For example 100.00.<\/td>\n<\/tr>\n<tr>\n<td>11<\/td>\n<td>Gross Credit (GC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The credit amount of an installment. For example 100.00.<\/td>\n<\/tr>\n<tr>\n<td>12<\/td>\n<td>Exchange Rate<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The exchange rate used for converting the gross amount into the net amount. This will be 1 if you process and settle in the same currency.<\/td>\n<\/tr>\n<tr>\n<td>13<\/td>\n<td>Net Currency<\/td>\n<td>Unicode Text (3-character limit)<\/td>\n<td>The three-character ISO currency code for the settlement currency.<\/td>\n<\/tr>\n<tr>\n<td>14<\/td>\n<td>Net Debit (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The debit amount of an advancement. For example when we have a cancellation of advancement in a particular installment minus the advancement fee.<\/td>\n<\/tr>\n<tr>\n<td>15<\/td>\n<td>Net Credit (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The net credit amount of an advancement. For example the amount you will receive for an advancement of a particular installment minus the advancement fee.<\/td>\n<\/tr>\n<tr>\n<td>16<\/td>\n<td>Commission (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>Informs the aggregated estimated commission amount for a particular installment.<\/td>\n<\/tr>\n<tr>\n<td>17<\/td>\n<td>Markup (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The fee charged by the acquiring bank. However, since the events on this report are not related to settlement, <strong>this column will be empty<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td>18<\/td>\n<td>Scheme Fees (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The fee charged by the schemes (for example Visa, Mastercard). However, since the events on this report are not related to settlement, <strong>this column will be empty<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td>19<\/td>\n<td>Interchange (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The fee charged by the issuing bank. However, since the events on this report are not related to settlement, <strong>this column will be empty<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td>20<\/td>\n<td>Sub Payment Variant<\/td>\n<td>Unicode Text (50-character)<\/td>\n<td>The sub-brand of the payment method (if applicable). For example: visaclassic, visadebit, mccorporate.<\/td>\n<\/tr>\n<tr>\n<td>21<\/td>\n<td>Batch Number<\/td>\n<td>Unicode Text (50-character)<\/td>\n<td>The code of the advancement batch.<\/td>\n<\/tr>\n<tr>\n<td>22<\/td>\n<td>Advanced (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The requested advanced amount of an installment.<\/td>\n<\/tr>\n<tr>\n<td>23<\/td>\n<td>Advancement Code<\/td>\n<td>Unicode Text (50-character)<\/td>\n<td>The code of advancement.<\/td>\n<\/tr>\n<tr>\n<td>24<\/td>\n<td>Advancement Batch<\/td>\n<td>Unicode Text (50-character)<\/td>\n<td>The code of the advancement batch.<\/td>\n<\/tr>\n<tr>\n<td>25<\/td>\n<td>Installments<\/td>\n<td>Unicode Text<\/td>\n<td>This informs the installment sequence. For example 1\/12 (first installment of a 12 installment-plan).<\/td>\n<\/tr>\n<tr>\n<td>26<\/td>\n<td>Advancement cost<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The calculated fee for the advancement of an installment, in monetary value. Since this is a calculated value, rounding issues may arise. When the \u201cjournal type\u201d is \u201cAdvancement\u201d, this column will show the actual total cost amount of an advancement.<\/td>\n<\/tr>\n<tr>\n<td>27<\/td>\n<td>Advancement fee (%)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>The calculated fee for the advancement of an installment, in percentage.<\/td>\n<\/tr>\n<tr>\n<td>28<\/td>\n<td>Rounding difference<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>This column will only be populated when the \u201cjournal type\u201d is \u201cAdvancement\u201d. It will show the value to correct the rounding issues that may have arise in the advancement cost for installment, and by consequence the net advanced amount.<\/td>\n<\/tr>\n<tr>\n<td>29<\/td>\n<td>Modification Merchant Reference<\/td>\n<td>Unicode Text (50-character)<\/td>\n<td>The optional modification reference sent in a capture or refund, if specified in the transaction.<\/td>\n<\/tr>\n<tr>\n<td>30<\/td>\n<td>Acquirer<\/td>\n<td>Unicode Text<\/td>\n<td>The name of the acquirer that processed the original payment. For example: AdyenMasterCard_BR_Ins_23316.<\/td>\n<\/tr>\n<tr>\n<td>31<\/td>\n<td>Journal type<\/td>\n<td>Unicode Text<\/td>\n<td>The event to which the row relates to.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h4 id=\"additional-columns\">Additional columns<\/h4>\n<p>You can <a href=\"#configure-report-columns\">configure report columns<\/a> to add these to your report:<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th>#<\/th>\n<th>Column name<\/th>\n<th>Data type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>Payment Method<\/td>\n<td>Unicode Text (80-character)<\/td>\n<td>The name of your company account as registered in the Adyen payments platform.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>Booking type<\/td>\n<td>Unicode Text<\/td>\n<td>Identifies the type of an installment. Possible values:<br\/>FIRST: original presentment<br\/>ACCELL: acceleration of an installment<br\/>REPRESENTMENT: installment resubmitted<br\/>RETRY: new presentation attempt of an installment<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>Type<\/td>\n<td>Unicode Text<\/td>\n<td>The event to which the row relates to concatenated with the installment booking type.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>Previously Advanced (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>If an installment was partially advanced, this column will show the gross advanced amount before the current event.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>Remaining Advanceable (NC)<\/td>\n<td>Numeric or String (only in .XLS and .XLSX report files)<\/td>\n<td>If an installment was partially advanced, this column will show the gross amount still available to be advanced after the current event.<\/td>\n<\/tr>\n<tr>\n<td>\n<\/div>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3 id=\"configure-report-columns\">Configure report columns<\/h3>\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:<\/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>, and switch to a merchant account.<\/li>\n<li>Select <strong>Reports<\/strong> &gt; <strong>Advancements detail<\/strong>.<\/li>\n<li>Select the <strong>Column configuration<\/strong> tab. If you don't see it your user may be missing some permissions.<\/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 that you want them to appear.<\/li>\n<li>Select <strong>Save configuration<\/strong>.<\/li>\n<\/ol>\n<h2 id=\"journal-types\">Journal types<\/h2>\n<p>The journal types listed below correspond to the <strong>Type<\/strong> field in the <a href=\"#columns\">report structure<\/a> above.<\/p>\n<div class=\"sticky-table-container\">\n    \n<table>\n<thead>\n<tr>\n<th>Journal type<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>AdvancedInstallment<\/td>\n<td>This journal indicates the amount of an installment that has been advanced. It informs the gross amount of the installment, the estimated fees regarding acquirer process (installment fees), the gross amount advanced, the advancement cost, the net amount advanced. In the event of a partial advancement, you can also see if any amount has been previously advanced and if any amount remains available to be advanced.<\/td>\n<\/tr>\n<tr>\n<td>AdvancedInstallmentCancelled<\/td>\n<td>This journal indicates the amount that is no longer advanced from an installment. This can happen when an advancement contract has been cancelled, has its amount diminished or had its amount over registered. It will still inform the same information as the AdvancedInstallment, but it will only inform the gross\/net amount and the advancement cost for the portion that is no longer advanced. In the event of a partial advancement, you will also see any amount that is still advanced and the amount that is now available to be advanced.<\/td>\n<\/tr>\n<tr>\n<td>AdvancedBulk<\/td>\n<td>This journal only appears when we cannot describe the total advanced amount in transaction level. This can happen for many reasons such as advancement of debit card transactions, advancement of installments no longer available to be advanced. It will indicate the amount advanced in a particular advancement batch that we could not identify the installments, and will show the gross, net and the advancement cost of that portion. Since we cannot identify the transactions, it won't have any estimated commission in the commission column.<\/td>\n<\/tr>\n<tr>\n<td>AdvancedBulkCancelled<\/td>\n<td>This journal only appears when we cannot describe the amount that is no longer advanced in transaction level. It will indicate the cancelled amount in a particular advancement batch that we could not identify the installments, and will show the gross, net and the advancement cost of that portion. Since we cannot identify the transactions, it won't have any estimated commission in the commission column.<\/td>\n<\/tr>\n<tr>\n<td>Advancement<\/td>\n<td>This journal appears on the last line of the report and shows the total amounts for gross (in the Advanced (NC) column), net and advancement cost for a particular advancement code in a particular merchant account. This is where you will find the amount received in the bank account related to advancement.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n<\/div>\n\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/reporting\/settlement-reconciliation\/transaction-level\/reconcile-installment-payments\"\n                        target=\"_self\"\n                        >\n                    Installments and advancements in Brazil\n                <\/a><\/li><li><a href=\"\/reporting\/settlement-reconciliation\/transaction-level\"\n                        target=\"_self\"\n                        >\n                    Transaction-level reconciliation\n                <\/a><\/li><li><a href=\"\/reporting\/balance-transfers\"\n                        target=\"_self\"\n                        >\n                    Check balance transfers\n                <\/a><\/li><li><a href=\"\/reporting\/dcc-transactions-and-fees\"\n                        target=\"_self\"\n                        >\n                    Check Dynamic Currency Conversion (DCC) transactions and fees\n                <\/a><\/li><li><a href=\"\/reporting\/dynamic-sales-day\"\n                        target=\"_self\"\n                        >\n                    Dynamic sales day closing time\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/pt\/reporting\/settlement-reconciliation\/transaction-level\/advancements-detail-report","articleFields":{"description":"Use this report to get transaction level information of the funding for an advancement.","feedback_component":true,"parameters":{"report_name":"Advancements detail report","automatic":"yes","dates":"bulk","company_level":"no"},"type":"page","_expandable":{"operations":""},"status":"current"},"algolia":{"url":"https:\/\/docs.adyen.com\/pt\/reporting\/settlement-reconciliation\/transaction-level\/advancements-detail-report","title":"Advancements detail report","content":"The Advancements Detail Report is available in countries\/regions where Adyen offers the Advancement Product (which usually include countries\/regions where we process and receive payments in installments).\nThis report provides details of the installments that were used by Adyen to determine the amount advanced to the merchant.\nFile name format: Includes the advancement code, the date we first register the advancement in Adyen, and the date the report is generated.\nGenerating and downloading: Get this report manually or automatically.\nTime zone: Currently the time zone is only CET\/CEST.\nAvailability: Only available for merchant accounts.\nFile name format\nThe name of the report in Customer Area \/ Back Office follows specific rules to ensure a standard for name generation. This helps to prevent existing reports from being overwritten by newly generated reports.\nReport names follow this format:\nadvancements_detail_report_&lt;ADVANCEMENT_CODE&gt;_&lt;DATE_1&gt;_&lt;DATE_2&gt;\n\n\nADVANCEMENT_CODE specifies a single advancement operation. However, because these operations are by legal entity number (for example CNPJ in Brazil), it is possible that the total advancement operation amount includes merchant accounts with the same legal entity number. Therefor, the merchant must consult the report for different merchant accounts to get the total amount for that advancement operation.\nYou can see the type of the advancement by looking at the advancement code:\n\nWhen it starts with ADYEN-ADV, it is an operation performed through Own Advancements.\nWhen it starts with ADYEN-PRX, it is an operation performed through Proxy Advancements.\n\n\n\nDATE_1 indicates when the advancement was first registered in our accounting system.\n\n\nDATE_2 indicates the request date of the report. If you request multiple times for the report to be generated on different days, the older versions will not be overwritten.\n\n\nExamples of report names:\n\nadvancements_detail_report_ADYEN-ADV_20241030-143614_1065_155_2024_11_19_2024_11_21\nadvancements_detail_report_ADYEN-PRX_20241014_14796606000351_00001149_2024_11_19_2024_11_21\n\nGenerate and download reports\nThis report is generated per merchant account, and per advancement code.\nTo manually or automatically generate an Advancements Detail Report, or download a previously generated report, you must have the See installments reports user role. You need this role for each merchant account that you want to include in the report.\nManually generate a report\nTo manually generate a report:\n\nLog in to your Customer Area, and switch to the relevant merchant account.\nSelect Reports &gt; Advancements details.\nSelect Manage report &gt; Manual (generate once).\nInput the complete advancement code. Important: If you type an advancement code that does not exist in the account, you may receive an empty report.\nUnder File type, select one of the following:\n\nCSV (default)\nXLS_GEN\nTSV\nXML\nXMLE\n\nSelect Generate report. At the top of your screen you will see a pop-up message that says Report is successfully queued.\n\nAutomatically generate a report\nTo automatically generate a report:\n\nLog in to your Customer Area, and switch to the relevant merchant account.\nSelect Reports &gt; Advancements detail.\nSelect Manage report &gt; Automatic (generate on a schedule).\nSelect On.\nUnder File type, select one of the following:\n\nCSV (default)\nXLS_GEN\nTSV\nXML\nXMLE\n\nSelect Schedule.\n\nSample report\nDownload a sample Advancements Detail Report for examples of the included data.\nBased on your account and settings, a report you generate in your account can contain additional data or columns that are not included in the sample report.\nReport structure\nEntries\nUnder the header line, each line in the report is a separate entry. The types of entries include:\nTransaction lines\nThis indicates how much of an installment was advanced for a specific advancement code. It can appear as AdvancedInstallment or AdvancedInstallmentCancelled.\nAggregated lines\nIn the event that we are unable to select specific installments for the advancement, we will show the remaining amount as AdvancedBulk and\/or AdvancedBulkCancelled.\nTotal line\nThe total amount advanced for a specific advancement code, and for a specific merchant account.\nColumns\nEach column shows specific information about the entries.\nStandard columns\nThe table below reflects the standard columns that are included in the report, and the default order. You can add more columns, or change the order of the default columns.\n\n    \n\n\n\n#\nColumn name\nData type\nDescription\n\n\n\n\n1\nCompany Account\nUnicode Text (80-character)\nThe name of your company account as registered in the Adyen payments platform.\n\n\n2\nMerchant Account\nUnicode Text (80-character)\nThe name of the merchant account that was used to process the original payment request.\n\n\n3\nPSP Reference\nUnicode Text (16-character limit)\nAdyen's 16-character unique reference associated with the transaction\/the request. This value is globally unique; quote it when communicating with us about this request.\n\n\n4\nMerchant Reference\nUnicode Text (80-character)\nThe reference that was specified by you in the payment request.\n\n\n5\nPayment Method Variant\nUnicode Text (30-character)\nThe payment method used for the transaction.\n\n\n6\nCreation Date\nDate field + Time field\nThe timestamp indicates when the payment was captured on the Adyen payments platform. Format:YYYY-MM-DD HH:MM:SS. For example: 2025-01-02 19:58:55.\n\n\n7\nTimeZone\nUnicode Text\nThe time zone of the Creation Date in ISO code. At the moment it will always be in CET\/CEST.\n\n\n8\nModification Reference\nUnicode Text\nA unique ID that identifies the modification request, in this report it relates to an Advancement registration. Maximum length: 16 characters. For records of journal type Advancement, this is a description containing Account code, advancement code and batch number.\n\n\n9\nGross Currency\nUnicode Text (3-character limit)\nThe three-character ISO currency code for the payment currency.\n\n\n10\nGross Debit (GC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe debit amount of an installment. For example 100.00.\n\n\n11\nGross Credit (GC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe credit amount of an installment. For example 100.00.\n\n\n12\nExchange Rate\nNumeric or String (only in .XLS and .XLSX report files)\nThe exchange rate used for converting the gross amount into the net amount. This will be 1 if you process and settle in the same currency.\n\n\n13\nNet Currency\nUnicode Text (3-character limit)\nThe three-character ISO currency code for the settlement currency.\n\n\n14\nNet Debit (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe debit amount of an advancement. For example when we have a cancellation of advancement in a particular installment minus the advancement fee.\n\n\n15\nNet Credit (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe net credit amount of an advancement. For example the amount you will receive for an advancement of a particular installment minus the advancement fee.\n\n\n16\nCommission (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nInforms the aggregated estimated commission amount for a particular installment.\n\n\n17\nMarkup (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe fee charged by the acquiring bank. However, since the events on this report are not related to settlement, this column will be empty.\n\n\n18\nScheme Fees (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe fee charged by the schemes (for example Visa, Mastercard). However, since the events on this report are not related to settlement, this column will be empty.\n\n\n19\nInterchange (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe fee charged by the issuing bank. However, since the events on this report are not related to settlement, this column will be empty.\n\n\n20\nSub Payment Variant\nUnicode Text (50-character)\nThe sub-brand of the payment method (if applicable). For example: visaclassic, visadebit, mccorporate.\n\n\n21\nBatch Number\nUnicode Text (50-character)\nThe code of the advancement batch.\n\n\n22\nAdvanced (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nThe requested advanced amount of an installment.\n\n\n23\nAdvancement Code\nUnicode Text (50-character)\nThe code of advancement.\n\n\n24\nAdvancement Batch\nUnicode Text (50-character)\nThe code of the advancement batch.\n\n\n25\nInstallments\nUnicode Text\nThis informs the installment sequence. For example 1\/12 (first installment of a 12 installment-plan).\n\n\n26\nAdvancement cost\nNumeric or String (only in .XLS and .XLSX report files)\nThe calculated fee for the advancement of an installment, in monetary value. Since this is a calculated value, rounding issues may arise. When the \u201cjournal type\u201d is \u201cAdvancement\u201d, this column will show the actual total cost amount of an advancement.\n\n\n27\nAdvancement fee (%)\nNumeric or String (only in .XLS and .XLSX report files)\nThe calculated fee for the advancement of an installment, in percentage.\n\n\n28\nRounding difference\nNumeric or String (only in .XLS and .XLSX report files)\nThis column will only be populated when the \u201cjournal type\u201d is \u201cAdvancement\u201d. It will show the value to correct the rounding issues that may have arise in the advancement cost for installment, and by consequence the net advanced amount.\n\n\n29\nModification Merchant Reference\nUnicode Text (50-character)\nThe optional modification reference sent in a capture or refund, if specified in the transaction.\n\n\n30\nAcquirer\nUnicode Text\nThe name of the acquirer that processed the original payment. For example: AdyenMasterCard_BR_Ins_23316.\n\n\n31\nJournal type\nUnicode Text\nThe event to which the row relates to.\n\n\n\n\n\n\nAdditional columns\nYou can configure report columns to add these to your report:\n\n    \n\n\n\n#\nColumn name\nData type\nDescription\n\n\n\n\n1\nPayment Method\nUnicode Text (80-character)\nThe name of your company account as registered in the Adyen payments platform.\n\n\n2\nBooking type\nUnicode Text\nIdentifies the type of an installment. Possible values:FIRST: original presentmentACCELL: acceleration of an installmentREPRESENTMENT: installment resubmittedRETRY: new presentation attempt of an installment\n\n\n3\nType\nUnicode Text\nThe event to which the row relates to concatenated with the installment booking type.\n\n\n4\nPreviously Advanced (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nIf an installment was partially advanced, this column will show the gross advanced amount before the current event.\n\n\n5\nRemaining Advanceable (NC)\nNumeric or String (only in .XLS and .XLSX report files)\nIf an installment was partially advanced, this column will show the gross amount still available to be advanced after the current event.\n\n\n\n\n\n\n\n\nConfigure report columns\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:\n\nLog in to your Customer Area, and switch to a merchant account.\nSelect Reports &gt; Advancements detail.\nSelect the Column configuration tab. If you don't see it your user may be missing some permissions.\nSelect checkboxes to indicate which columns you want to include in the report.\nDrag the columns into the order that you want them to appear.\nSelect Save configuration.\n\nJournal types\nThe journal types listed below correspond to the Type field in the report structure above.\n\n    \n\n\n\nJournal type\nDescription\n\n\n\n\nAdvancedInstallment\nThis journal indicates the amount of an installment that has been advanced. It informs the gross amount of the installment, the estimated fees regarding acquirer process (installment fees), the gross amount advanced, the advancement cost, the net amount advanced. In the event of a partial advancement, you can also see if any amount has been previously advanced and if any amount remains available to be advanced.\n\n\nAdvancedInstallmentCancelled\nThis journal indicates the amount that is no longer advanced from an installment. This can happen when an advancement contract has been cancelled, has its amount diminished or had its amount over registered. It will still inform the same information as the AdvancedInstallment, but it will only inform the gross\/net amount and the advancement cost for the portion that is no longer advanced. In the event of a partial advancement, you will also see any amount that is still advanced and the amount that is now available to be advanced.\n\n\nAdvancedBulk\nThis journal only appears when we cannot describe the total advanced amount in transaction level. This can happen for many reasons such as advancement of debit card transactions, advancement of installments no longer available to be advanced. It will indicate the amount advanced in a particular advancement batch that we could not identify the installments, and will show the gross, net and the advancement cost of that portion. Since we cannot identify the transactions, it won't have any estimated commission in the commission column.\n\n\nAdvancedBulkCancelled\nThis journal only appears when we cannot describe the amount that is no longer advanced in transaction level. It will indicate the cancelled amount in a particular advancement batch that we could not identify the installments, and will show the gross, net and the advancement cost of that portion. Since we cannot identify the transactions, it won't have any estimated commission in the commission column.\n\n\nAdvancement\nThis journal appears on the last line of the report and shows the total amounts for gross (in the Advanced (NC) column), net and advancement cost for a particular advancement code in a particular merchant account. This is where you will find the amount received in the bank account related to advancement.\n\n\n\n\n\n\nSee also\n\n\n                    Installments and advancements in Brazil\n                \n                    Transaction-level reconciliation\n                \n                    Check balance transfers\n                \n                    Check Dynamic Currency Conversion (DCC) transactions and fees\n                \n                    Dynamic sales day closing time\n                \n","type":"page","locale":"pt","boost":16,"hierarchy":{"lvl0":"Home","lvl1":"Reporting","lvl2":"Settlement reconciliation","lvl3":"Transaction-level reconciliation","lvl4":"Advancements detail report"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/pt","lvl1":"https:\/\/docs.adyen.com\/pt\/reporting","lvl2":"https:\/\/docs.adyen.com\/pt\/reporting\/settlement-reconciliation","lvl3":"https:\/\/docs.adyen.com\/pt\/reporting\/settlement-reconciliation\/transaction-level","lvl4":"\/pt\/reporting\/settlement-reconciliation\/transaction-level\/advancements-detail-report"},"levels":5,"category":"Reporting","category_color":"green","tags":["Advancements","detail","report"]},"articleFiles":{"advancements_detail_report_ADYEN-ADV_20250114-123456_1234_123_2025_01_15_2025_01_16_complete_columns-advancements_detail_report_ADYE.csv":"<p alt=\"\">advancements_detail_report_ADYEN-ADV_20250114-123456_1234_123_2025_01_15_2025_01_16_complete_columns-advancements_detail_report_ADYE.csv<\/p>"}}