DatabaseID {GUID – 16 byte}
The unique identifier of the database being used.
MediaType {8 bit Integer}
The type of media this item belongs to
0 Book
1 Comic
2 Magazine
3 Newspaper
4-99 Reserved for use by Human Computing
100-255 User customizable.
Note that currently, only media types 0-3 can be used for inventory management in ComicBase.
ItemID {Optional} {32 bit integer}
The record ID of this item in the database. If specified, will allow the system to deduct available quantity for the exact item. If not, an attempt to match by Title, Item Number, and Condition will be made. Note that the latter method will be unable to differentiate between, say, two VF copies of Action Comics #654, so including ItemID is preferred for inventory management when issues of similar grade should not be treated as interchangeable.
Title {Optional*} {string, 255 characters max}
*Required if ItemID is not specified. The title/series this item belongs to, e.g. “Action Comics”. Will be disregarded if ItemID is specified, for purposes of matching the internal ComicBase inventory record, in favor of the official title derived from the ItemID.
ItemNumber {string, 20 characters max}
*Required if ItemID is not specified. The item number, as it exists in ComicBase, for the sold item. E.g. “3” for issue #3, “Anl 2020/A-2” for Annual 2020, variation “A”, 2nd printing. Will be disregarded if ItemID is specified, for purposes of matching the internal ComicBase inventory record, in favor of the official title derived from the ItemID.
Condition {string, 20 characters max}
*Required if ItemID is not specified. The condition of the item sold. Must match its abbreviated name in ComicBase (e.g. “NM” for Near Mint). Will be disregarded if ItemID is specified, for purposes of matching the internal ComicBase inventory record, in favor of the official title derived from the ItemID.
Qty {16 bit integer}
The number of copies sold
Price {money}
The sale price, per copy, of the item sold. e.g., if the total sale was $10 for 2 copies of a comic, Qty should be “2”, and Price should be “5.00” in the API call.