Documentation.

Auction Import.

Importing an auction will include asset and auction data, tax, and optionally, image(s) & attachment(s) data.

Embedded HTML is not allowed in any field.

Each FieldName must have a corresponding XML entity.

    Example:
    <?xml version='1.0' encoding='UTF-8'?>
    <Auctions>
       <Row>
          <field_1>data</field_1>
          <field_2>data</field_2>
          <field_3>data</field_3>
       </Row>
    </Auctions>

Required Values

 Order   Name   Value Type 
1 asset_qty_unit string (Required EA|LT)
(2 character max)
2 asset_short_desc string (Required)
(120 character max)
3 asset_long_desc string (Required)
(3900 character max)
4 asset_condition_cd string (Required - (N|S|SD))
(2 character max)
5 asset_status_cd string (Required - (HFR|RFA|RFR))
(3 character max)
6 asset_category string (Required)
(3 character max) (See Categories)
7 locationid integer (Required - (Location ID))
(Location ID)
8 willship bit (Required)
0 = false, 1 = true
9 asset_auction_start_dt string (Required)
(YYYY-MM-DD HH:MM)
10 asset_auction_end_dt string (Required)
(YYYY-MM-DD HH:MM)
11 asset_strike_price decimal (Required | set to 0.00 if reserve_price is set)
9.2 decimal max
12 asset_bid_price decimal (Required)
9.2 decimal max
13 asset_bid_increment decimal (Required)
9.2 decimal max
14 reserve_price decimal (Required | set to 0.00 if asset_strike_price is set)
9.2 decimal max
15 tax_type string (Required - (USA|CAN))*
(3 character max)
16 tax_rate numeric (Required - 0.00)*
10.4
17 compounded bit (Required)*
0 = false, 1 = true
18 special_tax bit (Required)*
0 = false, 1 = true
19 asset_poc bit (Required)
0=Default (Client POC) or AssetPOC ID which must be valid entry for that client.
20 asset_give_away string (Required - (Y|N))
(1 character max)

Optional Values

 Order   Name   Value Type 
1 makebrand string (Optional - Client)
(50 character max)
2 model string (Optional - Client)
(50 character max)
3 vinserial string (Optional - Client)
(40 character max)
4 special_instructions string (Optional)
(3900 character max)
5 inventoryid string (Optional - Client)
(50 character max)
6 department integer (Optional but default to value of zero - (Department ID))
(Department ID)
7 model_year string (Optional - Client)
(4 digit year)
8 title_restriction string (Optional - (Y|N|A|B|C))
(1 character max)
9 meter string (Optional - Client - (Hours|Miles|Kilometers))
(18 character max)
10 metercount numeric (Optional - Client)
(18 character max)
11 meteraccurate string (Optional - Client - (Yes|No|Unknown))
(10 character max)
12 inspectioninstructions string (Optional)
(3900 character max)
13 paymentinstructions string (Optional)
(3900 character max)
14 removalinstructions string (Optional)
(3900 character max)
15 secondary_inventoryid string (Optional - Client)
(500 character max)
16 canada_pst_exempt string (Optional - (Y|N) - Canadian Accounts Only)
(1 character max)
Y = Yes, N = No
17 canada_tax_exempt string (Optional - (Y|N) - Canadian Accounts Only)
(1 character max)
Y = Yes, N = No
18 auctionType integer (Default - 3) – Only use assigned auction types allowed for the client. Valid auction types are Online Auction (3); Buy Now (4), Sealed Bid (1), and Make Offer (5).
19 NSN string (20 character max).
20 ASIN string (15 character max).
21 EAN string (15 character max).
22 SKU string (32 character max).
23 tier string (Default is GNP) - Account must belong to a Tier.
24 ApproveSale bit (Optional)
0 = false, 1 = true
25 Weight integer (Optional)
26 WeightType string (Optional)- Use Abbreviation (g, kg, mt, oz, lb, t)
27 isDOWarehouse bit (Optional)
0 = false, 1 = true
*Note: Canadian clients will have the value of this field computed for them based on their province.
Example XML
Additional rows can be included - RowCount in <Auctions> must be correct
images and attachments are optional. Multiple images and attachments may be included with any asset.
** Note ** img, image and imagefile are not included in the fieldnames parameter.

    Single Asset, Single image:
    <?xml version="1.0" encoding="UTF-8"?>
    <Auctions>
    <Row>
      <asset_qty_unit> </asset_qty_unit>
      <asset_short_desc> </asset_short_desc>
      <asset_long_desc> </asset_long_desc>
      <makebrand> </makebrand>
      <model> </model>
      <vinserial> </vinserial>
      <asset_condition_cd> </asset_condition_cd>
      <asset_status_cd> </asset_status_cd>
      <asset_category> </asset_category>
      <special_instructions> </special_instructions>
      <inventoryid> </inventoryid>
      <department> </department>
      <model_year> </model_year>
      <title_restriction> </title_restriction>
      <meter> </meter>
      <metercount> </metercount>
      <meteraccurate> </meteraccurate>
      <locationid> </locationid>
      <inspectioninstructions> </inspectioninstructions>
      <paymentinstructions> </paymentinstructions>
      <removalinstructions> </removalinstructions>
      <willship> </willship>
      <asset_auction_start_dt> </asset_auction_start_dt>
      <asset_auction_end_dt> </asset_auction_end_dt>
      <asset_strike_price> </asset_strike_price>
      <asset_bid_price> </asset_bid_price>
      <asset_bid_increment> </asset_bid_increment>
      <reserve_price> </reserve_price>
      <tax_type> </tax_type>
      <tax_rate> </tax_rate>
      <compounded> </compounded>
      <special_tax> </special_tax>
      <asset_poc> </asset_poc>
      <asset_give_away> </asset_give_away>
      <secondary_inventoryid> </secondary_inventoryid>
      <media>
        <image>Base64 Encoded image Data</image>
      </media>
      <attachments>
        <document fileName="file.txt">Base64 Encoded text Data</document>
      </attachments>
      <auctionType> </auctionType>
      <NSN> </NSN>
      <ASIN> </ASIN>
      <EAN> </EAN>
      <SKU> </SKU>
      <tier> </tier>
      <ApproveSale> </ApproveSale>
      <Weight> </Weight>
      <WeightType> </WeightType>
      <isDOWarehouse> </isDOWarehouse>
    </Row>
    </Auctions>

    Single Asset, Multiple images, Multiple attachments:
    <?xml version="1.0" encoding="UTF-8"?>
    <Auctions>
    <Row>
      <asset_qty_unit> </asset_qty_unit>
      <asset_short_desc> </asset_short_desc>
      <asset_long_desc> </asset_long_desc>
      <makebrand> </makebrand>
      <model> </model>
      <vinserial> </vinserial>
      <asset_condition_cd> </asset_condition_cd>
      <asset_status_cd> </asset_status_cd>
      <asset_category> </asset_category>
      <special_instructions> </special_instructions>
      <inventoryid> </inventoryid>
      <department> </department>
      <model_year> </model_year>
      <title_restriction> </title_restriction>
      <meter> </meter>
      <metercount> </metercount>
      <meteraccurate> </meteraccurate>
      <locationid> </locationid>
      <inspectioninstructions> </inspectioninstructions>
      <paymentinstructions> </paymentinstructions>
      <removalinstructions> </removalinstructions>
      <willship> </willship>
      <asset_auction_start_dt> </asset_auction_start_dt>
      <asset_auction_end_dt> </asset_auction_end_dt>
      <asset_strike_price> </asset_strike_price>
      <asset_bid_price> </asset_bid_price>
      <asset_bid_increment> </asset_bid_increment>
      <reserve_price> </reserve_price>
      <tax_type> </tax_type>
      <tax_rate> </tax_rate>
      <compounded> </compounded>
      <special_tax> </special_tax>
      <asset_poc> </asset_poc>
      <asset_give_away> </asset_give_away>
      <secondary_inventoryid> </secondary_inventoryid>
      <media>
         <image>Base64 Encoded image Data</image>
         <image>Base64 Encoded image Data</image>
         <image>Base64 Encoded image Data</image>
      </media>
      <attachments>
        <document fileName="file.txt">Base64 Encoded text Data</document>
        <document fileName="file2.pdf">Base64 Encoded pdf Data</document>
        <document fileName="file3.docx">Base64 Encoded word Data</document>
        <document fileName="file4.doc">Base64 Encoded word Data</document>
        <document fileName="file5.xlsx">Base64 Encoded excel Data</document>
        <document fileName="file6.xls">Base64 Encoded excel Data</document>
      </attachments>
      <auctionType> </auctionType>
      <NSN> </NSN>
      <ASIN> </ASIN>
      <EAN> </EAN>
      <SKU> </SKU>
      <tier> </tier>
      <ApproveSale> </ApproveSale>
      <Weight> </Weight>
      <WeightType> </WeightType>
      <isDOWarehouse> </isDOWarehouse>
    </Row>
    </Auctions>