Import: Lot data

Modified on Mon, 15 Jan at 9:17 AM


Here is an explanation of the steps required to import lots into Snoofa. To learn how to import clients, read more here.


Please note, parts of this documentation can change and introduce backwards incompatible changes.


Contents

How to import Lots

Hover over the plus icon in the top right corner and click Import


1. Hover over the plus icon in the top right corner and click Import


2. Select the Lots import type, select an unlocked auction, select a CSV file (details below), and click Upload


image-20200925-092451.png

3. Check that number of rows matches expectations and hit Start import


image-20200925-090813.png

4. The import can run for many minutes (depending on the number of rows). Once the import status changes from IN PROGRESS to FINISHED (refresh the page to check the status) the import is done.


image-20200925-091036.png

5. Now you can check the errors log (if there are any) and optionally you can Erase Data created by the import.



CSV template


This CSV file contains all the header columns. You can use it as a template when preparing your import. Below is an explanation of what each column represents.



Explanation of columns

Column

Example value

Notes

vendor_id

ABC1234

A unique identifier of the client. In case that the Client Import had happened and made use of the id column, then this id will be used to reference the client entity. All the other vendor details can be empty.

vendor_email

some@email.com

Must be unique for each client. When a duplicate is detected the import shows an error:

Client with email xxx@xxx.xxx already exists.

When not filled in a unique email for the client gets generated. See What if a client doesn't have an email address? for more details.

vendor_title

Mr

vendor_firstname

Archie

Mandatory field)

vendor_lastname

Harrison

vendor_phone

+44 7911 123456

Include the country code.

vendor_vat_number

GB 123 4567 89

vendor_company_name

Company Limited

vendor_preferred_language

en

Supported options: en, de, ja, es, zh, sv, it, fr, ko
Default: en

vendor_registration_date

1601023031

UNIX timestamp
Default: date and time of the import

vendor_address_first_line

123 Elm House

vendor_address_second_line

Llancayo Court

vendor_address_third_line

Appartment n. 3

vendor_address_city

Usk

vendor_address_unit

Monmouthshire

Unit or region. When filled in it must be one of available options: see the full list.

vendor_address_zip_code

NP15 1HY

vendor_address_country

United Kingdom

When filled in it must be one of available options: see the full list.

ca_number

AB1000

Must be filled in for all rows

ca_line

12

All cells must be empty (in that case line numbers are assigned automatically) or all must be filled in.

item_title

A violin

item_subtitle

19th centrury

item_description

Made by…

item_category_id

4

Mandatory. Categories must be first created in System Settings > Item Categories.

item_low_estimate

10000

item_high_estimate

50000

item_starting_bid

6000

item_reserve_price

8000

item_is_antique

1

1 = item is antique, 0 = item is not antique

item_vat_schema

MS

Mandatory. MS for Margin Schema or SS for Standard Schema.

lot_number

123

lot_hammer_price

25000

lot_buyer_commission_id

3

Item Charges must be first created in System Settings > Item Charges.

lot_vendor_commission_id

5

Item Charges must be first created in System Settings > Item Charges.

lot_vendor_commission_value

2500

buyer_id

ABC1234

All of these columns behave the same way as the vendor_... columns.

buyer_email

some@email.com

buyer_title

Mr

buyer_firstname

Archie

buyer_lastname

Harrison

buyer_phone

+44 7911 123456

buyer_vat_number

GB 123 4567 89

buyer_company_name

Company Limited

buyer_preferred_language

en

buyer_registration_date

1601023031

buyer_address_first_line

123 Elm House

buyer_address_second_line

Llancayo Court

buyer_address_third_line

Appartment n. 3

buyer_address_city

Usk

buyer_address_unit

Monmouthshire

buyer_address_zip_code

NP15 1HY

buyer_address_country

United Kingdom

registration_paddle_number

ONL12345

registration_type

1

1 = Room, 2 = Absentee, 3 = Phone, 4 = Online

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article