6. Request

Requests consist of multiple lines. The first line is a single BillingInfo object.

Following this are 0 or more tracedata entries. Servers typically have a limit on the number of entries that can be processed in a single request (linelimit). Requests with more than this number of tracedata entries may be processed, however clients should respect this limit. “Request next request” should be used when there are more entries to process that allowable in a single request.

6.1 `BillingInfo`

{
    "keychipid": "",
    "functype": "",
    "gameid": "",
    "gamever": "",
    "boardid": "",
    "tenpoip": "",
    "libalibver": "",
    "datamax": "",
    "billingtype": "",
    "protocolver": "",
    "operatingfix": "",
    "traceleft": "",
    "requestno": "",
    "datesync": "",
    "timezone": "",
    "date": "",
    "crcerrcnt": "",
    "memrepair": "",
    "playcnt": "",
    "playlimit": "",
    "nearfull": ""
}

Parameter	CHN name	Optional	Data type	Comment
`keychipid`	`keychipid`	No	`string[11]`	Keychip serial (no dash)
`functype`	`functype`	No	`int 0-99`	Keychip function classification
`gameid`	`titleid`	No	`string[4]`	Game ID
`gamever`	`titlever`	No	`float5`	Game version
`boardid`	`board`	No	`string[11]`	Mainboard serial (no dash)
`tenpoip`	`ip`	No	IP string	Store IP
`libalibver`	`libver`	No	`float5`	Billing library version
`datamax`	`datamax`	No	`int 0-999999`
`billingtype`	`billingclass`	No	`int 0-1`	Billing mode
`protocolver`	`protocolver`	No	`float5`	Protocol version
`operatingfix`	`operatingfix`	No	`int 0-1`	Intra-day closing processing flag
`traceleft`	`datarest`	No	`int 0-999999`
`requestno`	`requestno`	No	`int`	Sequential number within the shime request
`datesync`	`timesync`	No	`int 0-1`
`timezone`	`timezone`	No	`timezone`
`date`	`datetime`	No	`datetime`
`crcerrcnt`	`crcerrcnt`	No	`int 0-999999`
`memrepair`	`memrepair`	No	`int 0-1`
`playcnt`	`count`	No	`int 0-UINT_MAX`
`playlimit`	`limit`	No	`int 0-UINT_MAX`
`nearfull`	`nearfull`	No	`int 0-USHORT_MAX`	Nearfull value, not including flags

6.1.1 Alterations for AllnetLite (CHN)

titlever is an arbitrary ascii string (up to 5 characters)

6.2 `TraceData`

{
    "cs": "",
    "rn": "",
    "sn": "",
    "tt": "",
    "ds": "",
    "dt": "",
    "kn": "",
    "alib": "",
    ...
}

Parameter	CHN name	Optional	Data type	Name	Description
`cs`	`cs`	No	`int 0-1`	CRC error flag	CRC status when retrieving trace data from keychip. 0: Normal 1: Abnormal
`rn`	`rn`	No	`int 0-999999`	Record number	Memory managed serial number on PCB
`sn`	`rs`	No	`int 0-999999`	Record sequence number	Trace data sequential number. Initialised to 0 every power-on.
`tt`	`td`	No	`int 0-2`	Trace type	Indicates the type of log
`ds`	`ts`	No	`int 0-1`	Date synchronous flag	0: Not synced 1: Synced
`dt`	`dt`	No	`datetime`	System datetime	Date and time when logging to the keychip
`kn`	`ks`	No	`string[11]`	Keychip serial	Keychip serial number at time of logging
`alib`	`lib`	No	`float5`	ALL.Net Lib Version	Billing library (ALib) version

All tracedata entries share a number of fields, listed here, with the remaining fields differentiated based on the trace type.

6.3 Trace type 0 (charges)

{
    ...
    "gi": "",
    "gv": "",
    "bn": "",
    "ti": "",
    "pc": "",
    "pl": "",
    "ic": "",
    "in": "",
    "kk": "",
    "playerno": ""
}

Parameter	CHN name	Optional	Data type	Name	Description
`gi`	`ti`	No	`string[4]`	Game/title ID	Game ID at the time of logging
`gv`	`tv`	No	`float5`	Game/title version	Game version at the time of logging
`bn`	`bs`	No	`string[11]`	Mainboard serial	Mainboard serial at the time of logging
`ti`	`pi`	No	IP string	Store/place IP	Store router IP at the time of logging
`pc`	`pc`	No	`int 0-UINT_MAX`	Play count	Play count during logging
`pl`	`pl`	No	`int 0-UINT_MAX`	Play limit	Play limit for logging
`ic`	`ic`	No	`int 0-UINT_MAX`	Product code	Product code; the last two digits are a status indicator
`in`	`ni`	No	`int 0-255`	Product count	Number of products
`kk`	`ft`	No	`int 0-99`	Function type	Functional classification during logging
`playerno`	`playerno`	No	`int 0-255`	Player number	Player identification number during gameplay

6.4 Trace type 1 (event)

{
    ...
    "me": ""
}

Parameter	Optional	Data type	Name	Description
`me`	No	`string[33]`	Message	Tracedata message, backslash escaped

6.5 Trace type 2 (credit)

{
    ...
    "cct": "",
    "cst": "",
    "cop": "",
    "cr0": "",
    "cr1": "",
    "cba": "",
    "ccr": "",
    "cc0": "",
    "cc1": "",
    "cc2": "",
    "cc3": "",
    "cc4": "",
    "cc5": "",
    "cc6": "",
    "cc7": ""
}

Parameter	CHN name	Optional	Data type	Name	Description
`cct`	`cct`	No	`int 0-255`	Coin chute type	0: Common 1: Individual 2+: Undefined
`cst`	`st`	No	`int 0-255`	Service type	0: Common 1: Individual 2+: Undefined
`cop`	`op`	No	`int 0-255`	Operation type	0: Coin 1: Freeplay 2+: Undefined
`cr0`	`cr0`	No	`int 0-255`	Coin rate 0	How many physical coins is one coin for chute 0
`cr1`	`cr1`	No	`int 0-255`	Coin rate 1	How many physical coins is one coin for chute 1
`cba`	`ba`	No	`int 0-255`	Bonus adder	Number of coins at which a bonus 1 coin is added
`ccr`	`cr`	No	`int 0-255`	Credit rate	How many coins is needed for one credit
`cc0`	`cc0`	No	`int 0-255`	Credit 0	Number of credits consumed in play, continue play, etc.
`cc1`	`cc1`	No	`int 0-255`	Credit 1	Number of credits consumed in play, continue play, etc.
`cc2`	`cc2`	No	`int 0-255`	Credit 2	Number of credits consumed in play, continue play, etc.
`cc3`	`cc3`	No	`int 0-255`	Credit 3	Number of credits consumed in play, continue play, etc.
`cc4`	`cc4`	No	`int 0-255`	Credit 4	Number of credits consumed in play, continue play, etc.
`cc5`	`cc5`	No	`int 0-255`	Credit 5	Number of credits consumed in play, continue play, etc.
`cc6`	`cc6`	No	`int 0-255`	Credit 6	Number of credits consumed in play, continue play, etc.
`cc7`	`cc7`	No	`int 0-255`	Credit 7	Number of credits consumed in play, continue play, etc.