Transactions XML import

Naming the files

Files sent to the FTP server should follow this naming convention:

[Timestamp]_[sequence number OR store id] _transactions.xml

[Timestamp] should be formatted as: “YYYYMMDDHHmmss”.

The sequence or store id is only needed if there’s a risk that several applications might send XML files at the same time, although it is never wrong to include it.

A correct filename has this form: 20220808134729_471_transactions.xml

Scheme and field definitions

You can download the basic XSD scheme used for the XML import on the example files page.

Find the complete list of Field definitions here.

Spare fields are handled differently in API and file-based XML imports. In file-based XML imports, item spare fields must be sent as explicit XML elements such as spare1, spare2, and datespare1.For example: <spare1>true</spare1>Do not send item spare fields using extraData item names in XML, even if the same fields are sent that way in the API.

Read more about registering a purchase here.

XML example

<?xml version="1.0" encoding="utf-8"?>
<transactions xmlns="http://voyado.Schemas.ImportReceipts">
  <transaction>
    <contact>
      <matchKey>90154424</matchKey>
      <matchKeyType>memberNumber</matchKeyType>
      <contactType>Member</contactType>
    </contact>
    <uniqueReceiptId>14534304434293</uniqueReceiptId>
    <receiptNumber>87684684684</receiptNumber>
    <createdDate>2019-07-23T09:02:01+02:00</createdDate>
    <storeExternalId>12313</storeExternalId>
    <currency>SEK</currency>
    <exchangeRateToGroupCurrency>1.1</exchangeRateToGroupCurrency>
    <totalGrossPrice>200.00</totalGrossPrice>
    <paymentMethods>
      <paymentMethod>
        <type>bonuscheck</type>
        <description>25kr bonuscheck</description>
        <value>25.00</value>
      </paymentMethod>
      <paymentMethod>
        <type>creditcard</type>
        <description>Mastecard</description>
        <value>175.00</value>
        <extraData>
          <item name="cardNumber">489456*</item>
          <item name="cardIssuer">ICA Banken</item>
        </extraData>
      </paymentMethod>
    </paymentMethods>
    <usedBonusChecks>
      <usedBonusCheck>
        <checkNumber>45343</checkNumber>
      </usedBonusCheck>
    </usedBonusChecks>
    <usedPromotions>
      <usedPromotion>
        <couponId>625bafb8-00ee-44c1-aacc-aa9400a77cbb</couponId>
      </usedPromotion>
    </usedPromotions>
    <items>
      <item>
        <type>PURCHASE</type>
        <quantity>2</quantity>
        <grossPaidPrice>200.00</grossPaidPrice>
        <taxAmount>40.00</taxAmount>
        <taxPercent>25.00</taxPercent>
        <sku>23424123456</sku>
        <articleNumber>123456</articleNumber>
        <articleName>Stickad tröja V-neck</articleName>
        <articleGroup>Tröjor</articleGroup>
        <marginPercent>25.00</marginPercent>
        <awardsBonus>false</awardsBonus>
		<spare1>true</spare1>
        <spare2>ABC123</spare2>
        <datespare1>2026-07-23T09:02:01+02:00</datespare1>
        <discounts>
          <discount>
            <type>325</type>
            <description>50% rabatt nedsatt vara</description>
            <value>-200.00</value>
          </discount>
        </discounts>
      </item>
    </items>
  </transaction>
</transactions>

Read about registering a return here.

Importing historical data

Data import by file

Data export by file

Transactions XML import

Naming the files

FTP location

Scheme and field definitions

Register a purchase

Register a return

​Naming the files

​FTP location

​Scheme and field definitions

​Register a purchase

​Register a return

Naming the files

FTP location

Scheme and field definitions

Register a purchase

Register a return