MatSmartShop
Log in Get started free

For bulk entry and paper records

Upload & Scan

Getting data in in bulk: spreadsheets for what you already have typed, the camera for what you don't.

14 min read · 10 screenshots

Everything in this guide lives under Upload Data in the sidebar. Six of the seven tiles take a spreadsheet; the seventh, Scan A Report, takes a photograph of a written or printed sheet and reads it for you. The camera route is covered in full from section 9 onward — it is the one with the most that can go wrong, and the most that can be checked before anything is saved.

The rule that governs all of it: nothing is written to your books until you have seen a preview and pressed a confirm button. Uploading a file or reading a photo changes nothing on its own. If you close the page at the preview stage, nothing happened.

1. Which upload do I need?

Most upload mistakes are really the wrong tile. This table is the whole decision.

You have…UseBecause
A list of products to add to your catalogueItemsCreates products with their rates and opening stock.
A list of people to add to your customer listCustomersCreates customer records — name, email, phone, address.
Sales already made, to be recordedSalesEach row is saved as its own invoice. For backdated or bulk entry, not for ringing up a live sale.
Stock you bought from a vendorPurchasesAdds stock and records the vendor and the cost, which is what feeds your weighted average cost.
A stock count, damages, expiry or shortagesStock AdjustmentsMoves stock up or down without a vendor or a payment.
New selling prices for products you already sellPricesChanges price only — never quantity, never anything else on the item.
A photo of a paper sheet, in any of the above shapesScan A ReportReads the sheet and hands you the same preview the spreadsheet route would.
Purchases and Stock Adjustments are not interchangeable. A purchase records who you bought from and what you paid, so it feeds costing. An adjustment just moves the number. Putting bought stock through the adjustment route loses the vendor and the cost — and an adjustment entered at zero cost drags your weighted average cost down. The Stock Adjustments screen says as much on the page.

2. The Upload Data hub

Upload Data screen showing seven tiles: Items, Customers, Sales, Purchases, Scan A Report, Prices and Stock Adjustments
Upload Data — seven tiles, one for each kind of bulk import.

Six spreadsheet tiles and the camera tile, all in one place. Items and Customers open as a pop-up over their own list screen; the rest are full pages.

3. How every spreadsheet upload works

All six follow the same four steps. Learn it once.

Upload Sales screen showing a drag-and-drop area, a Validate button and a download Sample file link
The standard shape — drop area, Validate, and a sample file to start from.
  1. Download the sample file. The link sits under the drop area. Do this even if you think you know the columns — the template also carries a guide sheet explaining each one.
  2. Fill it in. Keep the column names exactly as they are. Add your rows on the data sheet, not the guide sheet.
  3. Upload and Validate. Drag the file onto the box or click to browse, then press Validate. This reads the file and shows you every row — it saves nothing.
  4. Check the preview, then confirm. Only the confirm button writes to your books.
Validate is free and repeatable. If the preview looks wrong, fix the spreadsheet and upload it again. There is no cost and no trace until you confirm.

4. Items

Upload New Items dialog over the Items List, showing a download sample template link, a drag and drop area, a Validate Data button, a preview table with S/N, item name, item type, purchase rate, sales rate, reminder level and qty columns, and Close and Save buttons
Items uploads as a pop-up over your Item List, with the preview table built into the dialog.

Columns: Item Name, Item Type, Purchase Rate, Sales Rate, Reminder Level, Qty. Press Validate Data, check the table, then Save.

Reminder level is the re-order point — the stock figure at which the item starts appearing in your Low Stock alerts. Qty is opening stock, so use it only for products you are introducing; for stock arriving into products you already sell, use Purchases.

5. Customers

Reached the same way from the Customer Center — Upload from Excel. Columns are name, email, phone and address. The same validate-then-save pattern applies.

Phone numbers are worth getting right at this stage: they are what Customer Follow-Up texts and what the storefront uses to reach a buyer. A customer with no phone number is silently skipped by every reminder you ever send.

6. Sales and Purchases

Sales saves each row as its own invoice. It is meant for backdated or bulk entry — catching up a week of paper tickets, migrating from another system — rather than for recording a sale as it happens.

Purchases records stock bought in from a vendor, against that vendor, at the cost you paid. This is the route that keeps your costing honest, so prefer it over an adjustment whenever money changed hands.

7. Prices

A bulk price change for products you already sell. It touches the selling price and nothing else — not quantity, not cost, not the item's other settings. It cannot create a product: a row naming something you don't stock has nothing to update.

This is the safe way to push a price rise across a catalogue. Entering new prices through a purchase or an adjustment risks changing the wrong figure — selling price and cost are deliberately kept apart.
Several branches? This screen changes one store. To apply the same price list to several stores at once — from a spreadsheet or a photo — use Update Prices in the Consolidator (see the Consolidator article in the Knowledge Base).

8. Stock Adjustments

Upload Stock Adjustments screen explaining the Type column with ADD or REMOVE, the NEW flag for unknown items, and a pointer to Upload Purchases for bought stock
Stock Adjustments — the page tells you the two rules that matter before you upload anything.

Columns: Item_Name, Type, Date, Quantity, Purchase_Rate, Sales_Rate. The Type column carries the whole meaning of the row — ADD puts stock on, REMOVE takes it off.

8.1 The preview

Stock adjustment preview table with three rows, each with a CREATE tick box and a NEW badge, ADD and REMOVE type badges, date, quantity, stock now, stock after showing negative values in red, and unit cost
The preview — every row with its NEW flag, and a Stock After figure worked out before anything is saved.

Read the preview right to left:

  • Stock Now — what the system currently believes you hold.
  • Stock After — what it will hold once you confirm. This is the column to check. A negative figure in red means the row takes off more than you have; that is either a genuine shortage or a mistake in the sheet, and it's much easier to fix now than to unpick later.
  • CREATE and the NEW badge — see section 11.

When the numbers read correctly, press Confirm and Save List.

9. Scan A Report — what it is

Scan A Report photographs a written or printed sheet and reads the names and numbers off it, then hands you the same kind of preview a spreadsheet upload would. It exists for the paperwork that never made it into a spreadsheet: a counter book, a stock count on a clipboard, a supplier's delivery note.

Scan A Report screen with a document type dropdown, a Choose files control for photos, and a Read Document button, with explanatory text saying nothing is saved until you check it
The scan screen — a document type, one or more photos, and Read Document.

The page states its own contract plainly: Nothing is saved until you check it — every line can be corrected, re-matched or removed first.

Long sheets. Add several photos. Each is read separately and the lines are added together, so a three-page stock count is one scan of three images rather than three separate scans. Each photo uses one DocScan unit, so the cost scales with pages, not with lines.

10. Scanning step by step

10.1 Say what the document is

Document type dropdown open showing five options: Sales, Stock adjustment, Purchase, Prices and Items
Five document types — pick before you read, because it decides what the numbers mean.

This choice is not cosmetic. It decides which header fields you're asked for, how the numbers are interpreted, and what the confirm button does.

TypeWhat it doesConfirm button
Sales — items sold, saved as one invoiceSaved as one invoice. Prices come from your item list unless the document shows them.Confirm and Save Sale
Stock adjustment — a stock count, damages or shortagesMoves stock up or down. The only type that can create a product.Confirm and Save Adjustments
Purchase — stock bought from a vendorRecorded against a vendor. Costs come from your item list unless the document shows them.Confirm and Save Purchase
Prices — new selling prices for items I already haveChanges the selling price of items you already have. It never creates products.Confirm and Update Prices
Items — a list of products to add to my storeCreates products. Anything already in your store is flagged so you do not duplicate it.Confirm and Create Items

10.2 Photograph the sheet well

The reader is only as good as the photo. In practice:

  • Fill the frame with the sheet, square on, not at an angle.
  • Even light, no shadow from your own hand, no flash glare across the middle of the page.
  • Flatten creases — a fold running through a column is where digits get lost.
  • One page per photo. Add more photos for more pages.

10.3 Read the document

Press Read Document and wait — this is the step that calls the reader, and it takes a few seconds per photo. What comes back is a form, not a saved record.

Scan review showing Sale Details with date read from the document, an auto-generated invoice number, customer, sales class, payment type, a VAT checkbox showing a 7.5 percent rate, and optional cross-check fields for lines and total units on the document
The header the reader produced — the date came off the sheet; the rest is yours to set.

For a Sales document you get:

FieldNotes
DateMarked read from the document where the reader found one. Check it — a misread date backdates the whole invoice.
Invoice NoGenerated for you as SCAN-…. You can overwrite it, but it must end with a number.
CustomerDefaults to Cash. Pick the real customer if the sale was on credit, or the balance won't be tracked against anyone.
Sales Class / Payment TypeYour own categories, exactly as on a normal sale.
VATApply VAT on this sale, with your configured rate shown. If no rate is set the screen says so and links you to Shop Details.
Lines On The Document / Total Units On The DocumentOptional cross-checks — section 12.

A Stock adjustment swaps this header for What do the numbers mean?, with three answers: Counted stock — set my stock to these figures, Quantities to ADD to my stock, or Quantities to REMOVE from my stock. Get this wrong and a stock count becomes a huge delivery, so read it twice.

11. The lines table: matching, prices and quantities

Scan lines table headed Lines Read From The Document 3 of 4, with a notice that the numbers were taken as prices and a link to treat them as quantities, a red warning that one line matches nothing in the store and that only a stock adjustment can create a product, and four rows with tick boxes, the text read from the document, a matched item dropdown, quantity, unit price and total, the fourth row flagged no match and unticked
The heart of the scan — what was read, what it matched to, and what has been left out.

Each row shows the raw text read from the document beside the item in your store it was matched to. The heading counts how many rows are actually in play — 3 of 4 above.

ColumnWhat to do with it
USETicked rows are saved. Untick to drop a row without deleting anything.
READ FROM DOCUMENTThe reader's text. Compare it against the sheet — this is where a misread shows up.
ITEM IN YOUR STOREA dropdown. Change it if the match is wrong; a row that matched nothing shows no match and — choose an item —.
QTY / UNIT PRICE / TOTALAll editable. Correct them here rather than re-photographing.

11.1 Rows that match nothing

When the reader produces a name your catalogue doesn't contain, the row is flagged no match and left unticked, and a red notice explains the options: Pick the right item on those rows, or leave them unticked to drop them.

Only a stock adjustment can create a product from a scan. The reason is on screen: a mis-read name would become a duplicate. A sales, purchase, prices or items scan will never invent a product — so an unmatched row is either matched by hand or dropped. If the product genuinely is new, add it properly on the Item List first, then re-run the scan.

On a stock adjustment scan you additionally get a Create all n link. Products created that way arrive with no cost and no selling price — set both on the Item List afterwards, or they will sell at zero and drag your costing.

11.2 Prices or quantities?

Above the table sits a line worth reading every single time:

Read 4 line(s). The numbers on the document were taken as prices. Treat them as quantities instead

On a sheet with one number per line the reader has to guess which it is. If it guessed wrong, that link flips the whole table in one click. A stock count read as prices — or a price list read as quantities — is the single most damaging scan mistake, and it is also the easiest to spot: check the QTY column against the sheet before you go further.

11.3 Anything the reader missed

Add A Line at the foot of the table inserts a row by hand — for anything the reader missed. Faint handwriting and lines crossing a fold are the usual casualties, which is why the line count in section 12 matters.

12. Cross-checking before you save

Foot of the scan review showing the complete lines table with totals for total quantity and sales value, an amount received field, an Add A Line button, and the Confirm and Save Sale button
The foot of the review — totals, an Add A Line escape hatch, and the only button that saves anything.

Two optional boxes in the header, Lines On The Document and Total Units On The Document, are the safety net. Count them off the paper yourself and type them in. If the ticked rows don't agree, the screen says Does not match the document and tells you where the gap is.

Use them. A reader that silently drops one faint line produces a preview that looks entirely reasonable — every row on it is correct, and the mistake is invisible. Typing "4 lines, 11 units" off the sheet is the only thing that catches it. Two seconds of counting against a stock figure you'll otherwise chase for weeks.

Check the totals row (Total Qty and Sales Value), set Amount Received if this was a paid sale, and press the confirm button. That is the first and only moment anything is written.

13. What scanning will not do

  • It will not create products, except on a stock adjustment.
  • It will not fix a bad photo. A shadowed or angled shot loses lines, and lost lines are invisible unless you cross-check.
  • It will not always spell things as you did. The reader tidies names — expect "Basket ball" to come back as "Basket Ball". The matching handles that, but check the match rather than assuming.
  • It will not know whether a number is a price or a quantity. It guesses; you confirm.
  • It will not remember a correction. Fixing a match on one scan doesn't teach it for the next.
  • It is not free. Each photo spends a DocScan unit whether or not you go on to save.

14. Quick reference

I want to…Do this
Add many products at onceUpload Data → Items → template → Validate Data → Save
Record stock I boughtUpload Data → Purchases (not Stock Adjustments)
Fix stock after a countUpload Data → Stock Adjustments, Type = ADD or REMOVE
Raise prices across the catalogueUpload Data → Prices
Raise prices in every branch at onceConsolidator → Update Prices
Enter a book of paper salesScan A Report → Sales
Enter a paper stock countScan A Report → Stock adjustment → Counted stock
Scan a sheet longer than one pageAdd several photos to the same scan
Handle a scanned line that matched nothingPick the item by hand, or untick to drop it
Catch a line the reader missedFill in Lines / Total Units, then Add A Line
Undo an uploadYou can't — check the preview. Nothing saves until you confirm.

If something looks wrong

  • Stock After is negative. The row removes more than you hold. Either the count is wrong or stock was never received — fix before confirming.
  • Quantities came through as prices. Use the Treat them as quantities instead link above the table.
  • A product came out duplicated. Something was created from a scan under a slightly different spelling. Only stock adjustments can do this — match by hand next time instead of creating.
  • A created product sells at zero. Products created from a scan carry no cost and no selling price. Set both on the Item List.
  • The preview has fewer lines than the sheet. The reader dropped one. Re-photograph in better light, or use Add A Line.
  • "No VAT rate set." Set your rate on Shop Details, then reload the scan screen.
  • Invoice number rejected. It must end with a number.

More guides

All tutorials and videos

Still stuck? We answer questions too.

Check the FAQs, or email us directly.

Browse FAQs Email Support
MatSmartShop

Point of sale, inventory and bookkeeping for multi-store retailers — online or offline.

PRODUCT
LEGAL
CONTACT
2nd Floor Olajire House 3, Ilupeju Bypass Road, Lagos, Nigeria. info@matsmartshop.com +234-903 090 6660 +234-909 294 2048 (WhatsApp)
© 2026 Magnet Consulting Associates Limited. All rights reserved.