POS Terminal
Transaction Report
Specification
1
Contents
1. Report types, delivery formats, channels and abbreviations............................................................................3
2. Report features.................................................................................................................................................................3
2.1. Level of detail............................................................................................................................................................................3
2.2. Regularity...................................................................................................................................................................................3
2.3. Grouping.....................................................................................................................................................................................3
2.4. Report file formats.................................................................................................................................................................4
2.5. Delivery channels....................................................................................................................................................................4
2.6. Restrictions...............................................................................................................................................................................4
3. PDF and CSV report structure and field description.............................................................................................4
3.1. TDO (Transactions, daily, one outlet)..............................................................................................................................4
3.1.1. TDO report in PDF format.......................................................................................................................................4
3.1.2. TDO report in CSV format.......................................................................................................................................5
3.2. TMO (Transactions, monthly, one outlet)......................................................................................................................5
3.3. TDM (Transactions, daily, per merchant).......................................................................................................................5
3.4. TMM (Transactions, monthly, per merchant)...............................................................................................................5
3.5. PDO (Batch, daily, one outlet)............................................................................................................................................6
3.5.1. PDO report in CSV format.......................................................................................................................................6
3.5.2. PDO report in PDF format.......................................................................................................................................6
3.6. PMO (Batch, monthly, one outlet)....................................................................................................................................7
3.7. PDM (Batch, daily, per merchant)......................................................................................................................................7
3.7.1. PDM report in PDF format.......................................................................................................................................7
3.7.2. PDM report in CSV format.......................................................................................................................................7
3.8. PMM (Batch, monthly, per merchant).............................................................................................................................7
3.9. IFR..................................................................................................................................................................................................7
4. CSV format reports in column header.......................................................................................................................8
5. XML format report structure........................................................................................................................................8
6. Downloading reports from Swedbank Business Internet Banking..................................................................8
This document contains information for customers using Swedbank’s Card Acquiring service. The document
describes bank-generated reports about processed card transactions, their formats and delivery methods.
1. Report types, delivery formats, channels and
abbreviations
Formats and channels
Report
Swedbank
Business
Internet
Banking
Swedbank
Gateway
Abbreviation
1.
Transaction, day – Outlet
xml, csv, pdf
xml
TDO
2.
Transaction, month - Outlet
xml, csv, pdf
xml
TMO
3.
Transaction, day – Merchant
xml
xml
TDM
4.
Transaction, month – Merchant
xml
xml
TMM
5.
Batch, day – Outlet
xml, csv, pdf
xml
PDO
6.
Batch, month - Outlet
xml, csv, pdf
xml
PMO
7.
Batch, day – Merchant
xml, csv, pdf
xml
PDM
8.
Batch, month – Merchant
xml, csv, pdf
xml
PMM
9.
Transaction, month – Merchant
xml
xml
IFR
2. Report features
2.1. Level of detail
On the basis of each transaction. In these reports one transaction corresponds to one record in the closing
report. The report shows the last 4 numbers of the card, card type, the time and amount of the transaction,
and the commission fee charged.
On the basis of batch or transaction closing reports. These reports contain aggregated data. One record
of the report corresponds to one POS transaction closing report (which usually corresponds to 1 business
day of POS terminal). The report specifies the transaction amount, quantity, and the commission fee
charged.
2.2. Regularity
Daily reports: delivered every day and cover transactions processed during the previous business day.
Monthly reports: delivered on the first calendar day of each month and cover transactions processed
during the previous month.
2.3. Grouping
By retail outlet: the report contains data on all POS terminals in each retail outlet.
By merchant: the report contains data on all retail outlets and POS terminals in them. This report is
provided exclusively in xml format.
3
2.4. Report file formats
Reports are provided in the following formats:
pdf: Not modifiable, can be only printed or saved on the computer;
csv: suitable for importing to Microsoft Excel or similar data processing software applications;
xml: suitable for importing to databases.
2.5. Delivery channels
Business Internet Banking: the easiest access to all reports. Log on to Internet Banking, select the column
“POS reports” and download the desired reports.
Swedbank Gateway: reports available in xml format.
2.6. Restrictions
The maximum size of PDF files is 1 MB. The restriction applies to all PDF reports as PDF does not support
saving of large-sized files. Use the csv or xml format to open and download reports exceeding 1 MB in size.
3. PDF and CSV report structure and field description
3.1. TDO (Transactions, daily, one outlet)
3.1.1. TDO report in PDF format
Section
Header
Details
Field
Comments
Report name
Outlet name
Report period
Outlet address
Outlet country
Outlet ID
Account
Report created
Terminal ID
Batch number
Batch closing date
Payment date
Currency
Card number
Transaction date
Transaction time
Fixed text: “Transaction-based daily report: Outlet”
Transaction code
Gross amount
Fee
Footer
Net amount
Card group
Grand total of gross amount
Grand total of fees
Grand total of net amount
To which funds will be transferred
Date when report was created
Date when funds were transferred to account
Last 4 digits of card number
Date when card was authorised
Time when card was authorised
Transaction code (STAN - System Transaction Audit
Number) assigned by Swedbank’s authorisation system
Transaction amount
Commission fee that will be withheld from the
transaction amount
Amount that will be transferred to merchant’s account
Type of card authorised
4
3.1.2. TDO report in CSV format
Field
Format
Comments
company id
xsd:string
company name
xsd:string
outlet name
xsd:string
terminal id
xsd:string
batch_no
xsd:integer
value_date = payment_date
xsd:date
card_group organization
xsd:string
Maximum of 85 characters
card_group type
xsd:string
Maximum of 85 characters
card_group region
xsd:string
Maximum of 85 characters
transaction trans_type
xsd:string
Values “Terminal” or “Cash”
transaction hidden_pan
xsd:integer
Format “9999”
transaction stan
xsd:integer
Format “999999”
total trans_type
xsd:integer
transaction local_date
xsd:date
transaction local_time
xsd:time
transaction ret_ref_nr
xsd:string
transaction auth_code
xsd:string
transaction paym_currency
xsd:string
transaction orig_amount
xsd:decimal
transaction orig_currency
xsd:string
transaction paym_amount
xsd:decimal
transaction fee_amount
xsd:decimal
transaction net_amount
xsd:decimal
total gross_amount
xsd:decimal
total fee_amount
xsd:decimal
total net_amount
xsd:decimal
Format “999999”
Maximum of 6 characters
3.2. TMO (Transactions, monthly, one outlet)
Same as TDO report (section 3.1). Reports differ only by time period: TDO represents 1 day and TMO
represents 1 month.
3.3. TDM (Transactions, daily, per merchant)
Available only in xml format.
3.4. TMM (Transactions, monthly, per merchant)
Available only in xml format.
5
3.5. PDO (Batch, daily, one outlet)
3.5.1. PDO report in CSV format
Field
Format
Comments
company id
xsd:string
company name
xsd:string
outlet name
xsd:string
terminal id
xsd:string
batch_no
xsd:integer
value_date = payment_date
xsd:date
card_group organization
xsd:string
Maximum of 85 characters
card_group type
xsd:string
Maximum of 85 characters
card_group region
xsd:string
Maximum of 85 characters
total gross_amount
xsd:decimal
total fee_amount
xsd:decimal
total net_amount
xsd:decimal
Format “999999”
3.5.2. PDO report in PDF format
Section
Field
Comments
Report name
Fixed text: “Batch-based daily report: Outlet”
Outlet name
Report period
Header
Outlet address
Outlet country
Outlet ID
Account
To which funds will be transferred
Report created
Date when report was created
Terminal ID
Batch number
Batch closing date
Details
Payment date
Date when funds were transferred to account
Number of transactions
Number of transactions in batch
Gross amount
Amount of all transactions
Fee
Amount of fees paid
Net amount
Amount that will be transferred to account
Currency
Batch currency
Grand total of gross amount
Footer
Grand total of fees
Grand total of net amounts
6
3.6. PMO (Batch, monthly, one outlet)
Same as PDO report (section 3.5). Reports differ only by time period: PDO represents 1 day and PMO
represents 1 month.
3.7. PDM (Batch, daily, per merchant)
3.7.1. PDM report in PDF format
Section
Field
Comments
Report name
Fixed text: “Batch monthly report: Outlet”
Outlet name
Report period
Header
Outlet address
Outlet country
Report created
Date when report was created
Outlet ID
Outlet address
Terminal ID
Number of batches
Details
Gross amount
Amount of all transactions
Fee
Amount of fees paid
Net amount
Amount that will be transferred to account
Grand total of gross amount
Footer
Grand total of fees
Grand total of net amounts
3.7.2. PDM report in CSV format
Field
Format
outlet id
xsd:string
outlet_address
xsd:string
terminal id
xsd:string
Number of batches
xsd:integer
total gross_amount
xsd:decimal
total fee_amount
xsd:decimal
total net_amount
xsd:decimal
Comments
3.8. PMM (Batch, monthly, per merchant)
Same as PDM report (section 3.7). Reports differ only by time period: PDM represents 1 day and PMM
represents 1 month.
3.9. IFR
Pursuant to Article 12 of EU Regulation 2015/751, Swedbank provides merchants with a detailed
transaction report containing information about interchange fees and card scheme fees. The report is
generated once a month on transactions of the previous month. The report must be ordered individually.
Available only in xml format.
7
4. CSV format reports in column header
TDO and TMO reports
Headers TDO
HeadersTMO.csv
TDO TMO.csv
PDO and PMO reports
Headers PDO
Headers
PDO TMO.csv
PMO.csv
PDM and PMM reports
Headers PDM
HeadersPMM.csv
PDM PMM.csv
5. XML format report structure
All xml format reports, except IFR report, have one common structure. The structure and field explanation
is provided in the files below.
All reports except IFR
IFR
IFR.xml
MERCHANT_REPORT
_EXPLANATION.xml
IFR.xml
IFR.csv
6. Downloading reports from Swedbank Business
Internet Banking
After logging in to Internet Banking (in the company’s profile):
1. Select section “Payment collection”
2. Select section “POS reports”
3. All the reports generated will be shown in the “POS reports” window
8
Attention!
Reports in the Swedbank Business Internet Banking will be stored for a maximum of 2 months.
Should you have any question or require further information, please contact your company’s account
manager or call the business customer service line on 67 44 4 444.
9