XML slip printer integration

Printer application could be reconfigured to store all purchased, cancelled or paid-out betting slips as XML files in a local directory.

To enable this integration printer application must have XML2FS integration enabled and configured.

Integration configuration can be changed here

Version	Changes
1.2	Added `PayoutCode` field, `PayoutCode` will be included in the checksum data. Removed double tournament occurrence in `EventName` field
1.1	Moved `Product` field from `Ticket` to `Leg` object, field `Product` no longer included in the checksum data
1.0	Initial release

All XML files produced with this integration have the same structure. XML documents contain only one root element Ticket. This element have an attribute version, this documentation is for version 1.0.

Element	Type	Example	Description
`Platform`	string	Aardvark	Name of the platform, always `Aardvark`
`UUID`	string	155ea541-8b74-ff05-5292-3239d4eb817a	Unique ticket ID (used only internally)
`ID`	string	47165941	Numeric ticket ID that should be printed on a ticket
`Barcode`	string	%As+x9Q%mBs	Ticket barcode, should be printed in using Code 128 encoding, not empty only for tickets in `SOLD` state
`PayoutCode`	integer	341591	Numeric ticket `PayoutCode` that should be printed on a ticket. Empty if payout codes are disabled through organisation settings
`State`	string	SOLD	Ticket status, one of `SOLD`, `RETURNED`, `PAIDOUT`
`Currency`	string	EUR	Currency code for all cash operations as defined inISO 4217
`IssueTime`	date-time	2018-10-18T07:29:53Z	Time when ticket was issued in RFC3999 format
`TotalPayin`	integer	400	Total amount staked/paid for this ticket in cents, 400 → 4.00 EUR
`TotalWin`	integer	0	Total amount of money won for this ticket in cents, empty for tickets in `SOLD` state
`MaxWin`	integer	3600	Estimated maximum amount of money that could be won by this ticket in cents, 3600 → 36.00 EUR
`PayoutTime`	date-time	2018-10-18T07:29:53Z	Time when ticket was paid out in RFC3999 format, empty for tickets in `SOLD` state
`TotalPayout`	integer	0	Total amount of money paid out for this ticket, empty for tickets in `SOLD` state
`Bets`	array of `Bet`		Element for grouping all bets on this ticket
`Bets`→`Bet`	object		A representation of a single bet, bet can be a multi-leg accumulator or simple bet
`Bets`→`Bet`→`Legs`	array of `Leg`		Element for grouping all bet legs for a single bet
`Bets`→`Bet`→`Legs`→`Leg`	object		A representation of a single simple bet
`Bets`→`Bet`→`Legs`→`Leg`→`Product`	string	live	Event product name, examples: `live`, `prematch`
`Bets`→`Bet`→`Legs`→`Leg`→`EventName`	string	Pro League\nPadideh Khorasan FC - Foolad Khuzestan FC	Event description this bet is placed on
`Bets`→`Bet`→`Legs`→`Leg`→`EventCode`	string	1053	Short (non unique) event ID this bet is placed on
`Bets`→`Bet`→`Legs`→`Leg`→`EventStartTime`	date-time	2018-10-18T07:30:40Z	Time when event this bet is placed on should start in RFC3999 format
`Bets`→`Bet`→`Legs`→`Leg`→`BetText`	string	Who Wins (Full-Time): 1	Bet description
`Bets`→`Bet`→`Legs`→`Leg`→`Odds`	integer	200	Decimal odds (multiplied by 100) for this bet leg, 200 → 2.00
`Bets`→`Bet`→`Odds`	integer	200	Decimal odds for whole bet (multiplied by 100) for this event, 200 → 2.00
`Bets`→`Bet`→`Stake`	integer	100	Amount of money in cents staked on this bet, 100 → 1.00 EUR
`Bets`→`Bet`→`MaxWin`	integer	200	Estimated maximum amount of money that could be won by this bet in cents, 200 → 2.00 EUR
`Bets`→`Bet`→`RealWin`	integer	0	Actual amount of money won by this bet in cents
`CheckSum`	string	b94ff77ed87597f615253f0e3bfaeaaa	MD5 sum of critical ticket elements, computed as `MD5(Platform + UUID + ID + State + Currency + IssueTime + TotalPayin + TotalPayout + PayoutCode + _SALT_)`

New betting slip:

<?xml version="1.0" encoding="utf-8"?>
<Ticket version="1.2">
    <Platform>Aardvark</Platform>
    <UUID>15612666-9db5-f2f6-5aa9-6d4df7a1853c</UUID>
    <ID>90726906</ID>
    <Barcode>%BWhh+g%</Barcode>
    <PayoutCode>341591</PayoutCode>
    <State>SOLD</State>
    <Currency>EUR</Currency>
    <IssueTime>2018-10-26T11:53:28Z</IssueTime>
    <TotalPayin>200</TotalPayin>
    <TotalWin>0</TotalWin>
    <MaxWin>2308</MaxWin>
    <PayoutTime />
    <TotalPayout>0</TotalPayout>
    <Bets>
        <Bet>
            <Legs>
                <Leg>
                    <Product>prematch</Product>
                    <EventName>Soccer Arabian Gulf League
 Fujairah FC - Dibba
Arabian Gulf League</EventName>
                    <EventCode>10530</EventCode>
                    <EventStartTime>2018-10-26T12:55:00Z</EventStartTime>
                    <BetText>Winner (Regular Time): 1</BetText>
                    <Odds>235</Odds>
                </Leg>
                <Leg>
                    <Product>prematch</Product>
                    <EventName>Soccer 2. HNL
 NK Hrvatski Dragovoljac - Kustosija
2. HNL</EventName>
                    <EventCode>10324</EventCode>
                    <EventStartTime>2018-10-26T13:00:00Z</EventStartTime>
                    <BetText>Winner (Regular Time): X</BetText>
                    <Odds>334</Odds>
                </Leg>
                <Leg>
                    <Product>prematch</Product>
                    <EventName>Soccer Arabian Gulf League
 Ajman - Al Ain
Arabian Gulf League</EventName>
                    <EventCode>10952</EventCode>
                    <EventStartTime>2018-10-26T13:00:00Z</EventStartTime>
                    <BetText>Winner (Regular Time): 2</BetText>
                    <Odds>147</Odds>
                </Leg>
            </Legs>
            <Odds>1154</Odds>
            <Stake>200</Stake>
            <MaxWin>2308</MaxWin>
            <RealWin>0</RealWin>
        </Bet>
    </Bets>
    <CheckSum>f130b4cddf8b630c3abe27ec74481457</CheckSum>
</Ticket>

Paid-out winner slip:

<?xml version="1.0" encoding="utf-8"?>
<Ticket version="1.2">
    <Platform>Aardvark</Platform>
    <UUID>156126ba-6fc3-c255-5f9b-1be11ad61e2e</UUID>
    <ID>90727217</ID>
    <Barcode />
    <PayoutCode>341591</PayoutCode>
    <State>PAIDOUT</State>
    <Currency>EUR</Currency>
    <IssueTime>2018-10-26T11:59:37Z</IssueTime>
    <TotalPayin>1000</TotalPayin>
    <TotalWin>950</TotalWin>
    <MaxWin>1900</MaxWin>
    <PayoutTime>2018-10-26T12:05:38Z</PayoutTime>
    <TotalPayout>950</TotalPayout>
    <Bets>
        <Bet>
            <Legs>
                <Leg>
                    <Product>betgames-lucky5</Product>
                    <EventName>Betgames lucky5</EventName>
                    <EventCode>51810260145</EventCode>
                    <EventStartTime>2018-10-26T12:03:20Z</EventStartTime>
                    <BetText>506 | More ODD</BetText>
                    <Odds>190</Odds>
                </Leg>
            </Legs>
            <Odds>190</Odds>
            <Stake>500</Stake>
            <MaxWin>950</MaxWin>
            <RealWin>0</RealWin>
        </Bet>
        <Bet>
            <Legs>
                <Leg>
                    <Product>betgames-lucky5</Product>
                    <EventName>Betgames lucky5</EventName>
                    <EventCode>51810260145</EventCode>
                    <EventStartTime>2018-10-26T12:03:20Z</EventStartTime>
                    <BetText>507 | More EVEN</BetText>
                    <Odds>190</Odds>
                </Leg>
            </Legs>
            <Odds>190</Odds>
            <Stake>500</Stake>
            <MaxWin>950</MaxWin>
            <RealWin>950</RealWin>
        </Bet>
    </Bets>
    <CheckSum>0e72c1d130255ddf8bdcddfdf93ce3f6</CheckSum>
</Ticket>

Cancelled (revoked) slip:

<?xml version="1.0" encoding="utf-8"?>
<Ticket version="1.2">
    <Platform>Aardvark</Platform>
    <UUID>15612682-b92f-8a93-592e-7eff38e583d7</UUID>
    <ID>90727005</ID>
    <Barcode />
    <PayoutCode>341591</PayoutCode>
    <State>RETURNED</State>
    <Currency>EUR</Currency>
    <IssueTime>2018-10-26T11:55:28Z</IssueTime>
    <TotalPayin>1000</TotalPayin>
    <TotalWin>0</TotalWin>
    <MaxWin>1900</MaxWin>
    <PayoutTime>2018-10-26T11:56:14Z</PayoutTime>
    <TotalPayout>1000</TotalPayout>
    <Bets>
        <Bet>
            <Legs>
                <Leg>
                    <Product>betgames-lucky5</Product>
                    <EventName>Betgames lucky5</EventName>
                    <EventCode>51810260144</EventCode>
                    <EventStartTime>2018-10-26T11:58:20Z</EventStartTime>
                    <BetText>508 | SUM ODD</BetText>
                    <Odds>190</Odds>
                </Leg>
            </Legs>
            <Odds>190</Odds>
            <Stake>500</Stake>
            <MaxWin>950</MaxWin>
            <RealWin>0</RealWin>
        </Bet>
        <Bet>
            <Legs>
                <Leg>
                    <Product>betgames-lucky5</Product>
                    <EventName>Betgames lucky5</EventName>
                    <EventCode>51810260144</EventCode>
                    <EventStartTime>2018-10-26T11:58:20Z</EventStartTime>
                    <BetText>509 | SUM EVEN</BetText>
                    <Odds>190</Odds>
                </Leg>
            </Legs>
            <Odds>190</Odds>
            <Stake>500</Stake>
            <MaxWin>950</MaxWin>
            <RealWin>0</RealWin>
        </Bet>
    </Bets>
    <CheckSum>1189653be8336339f4613c5cb532ae15</CheckSum>
</Ticket>

XML slip printer integration

XML files

Change log

Schema documentation

XML file examples

Aardvark Technologies Wiki