Documentation
Back

Uploading a BSX file

Add a part-out or a large batch from BrickStore in three steps. Nothing is saved until you confirm the last one.

Early access
This is in early access. It comes to every account in the coming months.

Large batches and part-outs are easiest to prepare in BrickStore or a similar program. Save the inventory there as a BSX file and choose Upload BSX above the list on Inventory. The button shows while the sync runs or is in its trial. The upload works in three steps, like BrickLink's own: the file and its options, a check of every line, and adding it to your stock. Nothing is saved or sent to your stores until you confirm the third step.

Table of Contents

  • First check the file
  • 1. File and options
  • 2. Check
  • 3. Add
  • What the upload cannot add

First check the file

Before you put a part-out away, you can let BrickInvoice check the file against your inventory. Choose the file and click Check against my inventory. Nothing is saved and nothing goes to your stores.

Every line you already have exactly one lot of (same item, color and condition, and for a set also the same completeness) gets that lot's location in My Remarks, its price and, when the lot has one, its description. Only lots you have stock of count: a sold-out lot is skipped, so the line keeps the location from the file. Tick off Locations, Prices or Descriptions to leave that field as the file has it. A value that is already in the file is replaced. A lot without a location or description leaves that field alone.

The rest of the file stays exactly as it was. Lines you have no lot of, lines with more than one lot of the same color, and lines of an item you have only in another color stay unchanged: we never pick a lot for you.

Download the checked file, open it in BrickStore, sort and put everything away, and then upload the same file here with Merge with lots you already have on. A location that comes back unchanged stays as it is, also with Combine the locations on.

The prices in the checked file are those of the moment you checked. If a price round runs before you upload, and you upload with From file for the price when merging, those older prices go back onto your lots.

1. File and options

Choose a .bsx file of at most 10 MB and 10,000 lots, saved by BrickStore, BrickStock or BrickFreedom. A larger file has to be split in BrickStore and uploaded in parts. Only one upload can be open at a time: finish or cancel the open one first. The prices in the file must be in the currency of your inventory. Change the currency of the file in BrickStore if they are not. Lots you marked Exclude in BrickStore are left out.

  • Merge with lots you already have. A line joins a lot you already have with the same item, color and condition (for a set: the same completeness). The quantity adds up. When you have more than one such lot, you choose in the next step: we never choose for you. Only lots you have stock of count: a line for an item whose only lot is sold out becomes a new lot, at the location in the file. The sold-out lot stays as it is. To fill up a sold-out lot in its old place, use Add lot in Inventory instead (see Adding stock).
  • When merging, keep. Per field (price and tiered prices, bulk, sale, description, stockroom, retain, location) whether the lot keeps its current value or takes the one from the file. A field the file does not fill in keeps the current value.
  • Combine the locations. Keeps both locations, the current one first, like A-01-03 P-12. Off: the Location row under When merging, keep decides.
  • Prices. Use the prices in the file, or calculate them with your price rules. The prices in the file go to new lots. A merged lot keeps its current price unless you choose From file for the price when merging. Your price rules price new and merged lots alike. For a merged lot the rules give no price for (no matching rule, no market data, or a line you unticked), the choice for the price when merging decides. A lot whose price you locked keeps it either way. When a merged lot gets another price, its tiered prices change with it: each keeps its ratio to the new price, and a tier that would end up at or above the price is left out. With your rules, the check waits until the prices are ready, and you hear when it is done. Prices BrickInvoice fetched in the last 14 days are there at once. The rest comes from BrickLink, within part of your daily BrickLink budget so your orders keep syncing. When that budget is used up, fetching waits and goes on by itself the next day (see A round). A large upload with many new items can take a few days. Pricing with your rules is not possible while a price round is open: finish or cancel it on the Pricing page, or upload with the prices from the file.
  • Tiered prices for the whole upload. Up to three tiers, "from X pieces, Y% off", for every line that has no tiers of its own.
  • Put everything in the stockroom and Keep lots on BrickLink when they sell out apply to every lot in the file.

2. Check

A row of totals shows the new lots, the merged lines, the lines not on Brick Owl, the lines that need your choice and those that can't be added. The tabs All, New, Merged, Choose and Problems filter the list. Every line of the file shows what happens to it: a new lot, merged with which lot (with the quantity before and after), a lot you still have to choose, or a line that cannot be added and why. A lot Brick Owl does not know is added on BrickLink only. That is normal. Choose a lot for every line that has several. Add stays off until you have.

When the file has a sale on some lines and you do not sync the sale (Settings → Inventory), a note says that sale stays in BrickInvoice only: a new lot goes to your stores without a sale.

Cancel ends the upload. Nothing was saved.

A line that becomes a new part, minifigure or set gets a warning in amber when the BrickLink catalog does not know the item number, or does not list the item in that color. The line is still added, but a store may refuse it: check the number and color in BrickStore. Lines that merge with a lot you already have get no warning, and neither do gear, books, catalogs and instructions.

With price rules, the rules' price shows next to the file's, and a merged line shows the price the lot gets from them. A line without a price in the file that the rules give none either (no matching rule, no market data, a line you unticked, or a price calculation that stopped) shows Can't add: no price and is not counted in Add. You can also add the lots now with the prices from the file. The price calculation is then stopped, and lines without a price in the file are left out.

3. Add

Add N lines opens a confirmation in the middle of the screen. It says how many new lots and merged lines the upload adds, how many pieces, and which prices they get. Not yet takes you back to the list. Add to stock starts. This confirmation also counts for the safety brake: the changes go to your stores without being held.

After that the lots are added in the background, and the page shows how many changes went to each store. You can leave the page. The upload is one entry in your Activity (See it in Activity). When it is done, every line that was not added is listed with its number in the file, the item and the reason. Upload another file starts over, Back to inventory returns to the list. If adding takes longer than it should, Start again picks it up: nothing is booked twice.

What the upload cannot add

  • A line of an item type BrickLink lots cannot have (an original box, an unsorted lot).
  • A line with a color we do not know, a quantity that is not a whole number above zero, or a value that is not valid (the check names the field).
  • A new lot without a price in the file, when you use the file's prices, or when your price rules give it none.

Correct the line in BrickStore and upload it again.