POS Transactions¶
The POS Transactions page is available at:
https://app.pixaro.ai/pos-transactions
Feature Overview¶
POS Transactions is used to import transaction files from Modisoft and review uploaded POS transaction batches.
This page is mainly used when Modisoft POS transaction data needs to be imported for transaction search, transaction-video review, and reporting workflows.
The page uses the store selected in the top toolbar for the list view.
Access and Navigation¶
Navigation path: Video Intelligence > POS Transactions
Required permissions: Transaction/POS transaction access for the selected user role.
POS Transaction List¶
The page title is POS Transactions.
The list shows uploaded Modisoft POS transaction batches.
Columns include:
| Column | Meaning |
|---|---|
| POS Type | POS system type. Currently Modisoft is used for this import flow. |
| Uploaded By | User who uploaded the POS files. |
| Uploaded Date | Date/time the POS files were uploaded. |
If there are no records, the table shows No POS Transactions Found.
The list uses pagination with page sizes of 5, 10, 25, and 100.
Filters¶
Available filters:
| Filter | Purpose |
|---|---|
| From Date | Start date for uploaded POS transaction batches. |
| To Date | End date for uploaded POS transaction batches. |
| POS Type | POS system type. Current import option: Modisoft. |
Use Search to apply filters.
Use Reset to clear filters and reload the default list.
Upload POS Data¶
Click Upload POS Data to open the upload dialog.
Required fields:
| Field | Required | Notes |
|---|---|---|
| Select Store | Yes | Store that owns the POS files. |
| POS Type | Yes | Select Modisoft for this import flow. |
| Upload mPos Transaction File | Yes | Source transaction file. |
| Upload Pos Transaction File | Yes | POS transaction metadata file. |
| Upload All Sales Live Items File | Yes | Item/detail file used to match transactions with items. |
To upload POS data:
- Open Video Intelligence > POS Transactions.
- Click Upload POS Data.
- Select the store.
- Select Modisoft as POS Type.
- Upload the mPos Transaction file.
- Upload the Pos Transaction file.
- Upload the All Sales Live Items file.
- Click Upload.
If any required field or file is missing, Pixaro shows:
Please fill in all required fields.
After a successful upload, the dialog closes and the list reloads.
What Happens After Upload¶
The API Server processes the uploaded Modisoft POS files.
The processing flow:
- Reads and validates the uploaded transaction files.
- Parses transaction rows.
- Parses transaction item rows.
- Matches transactions with item data.
- Saves processed transactions.
- Uploads source files to storage.
- Saves POS transaction upload metadata.
After processing, the imported Modisoft transactions can be used in the Transactions page.
Backend Notes¶
POS Transactions uses API Server routes under /transaction-api:
POST /pos-transactionsGET /pos-transactions/:storeId
The upload request is sent as multipart form data with:
storeIdposTypetransactionsFileposTransactionsFileallItemsFile
Troubleshooting¶
| Issue | What to Check |
|---|---|
| Upload button does not complete | Confirm all required fields and all three files are selected. |
| POS Type is missing | Select Modisoft as the POS Type. |
| Uploaded list is empty | Confirm the selected store and date filters. |
| Upload returns an error | Confirm the files match the expected Modisoft POS export format. |
| Transactions do not appear in Transactions page | Confirm processing completed and search the correct store/date range. |
| Uploaded Date appears wrong | Confirm store/user timezone expectations and upload timestamp. |
Best Practices¶
- Select the correct store before uploading files.
- Upload all files from the same POS export period.
- Do not mix files from different stores or dates.
- Use clear date filters when reviewing uploaded batches.
- After upload, verify imported data in Video Intelligence > Transactions.