Skip to main content

CVGo POS Data Validation

Manual Validation

Navigation: Shell18 > CVGo > XML Day Data > select a record in Draft status

  1. Open a CVGo POS Data record with status Draft
  2. Click the Validate button in the header
  3. The system extracts and parses the ZIP file

What happens during validation

StepDescription
1. Extract ZIPUnzips the file to a temporary directory
2. Parse XMLReads both XML files and identifies their type
3. Create PeriodsCreates POS Period records (shift info, cashier, timestamps)
4. Create Site PeriodsCreates site-level summary records (fuel/shop totals)
5. Import MOPsCreates Mode of Payment records; auto-creates MOP Accounts if new
6. Import Hose DataCreates closing hose period data (meter readings per pump/hose)
7. Import TransactionsCreates transaction records with all line items
8. Auto-create ProductsCreates products and categories for any new items found

After validation, you can review

TabContents
PeriodsShift periods with cashier names, open/close times
MOPMode of Payment summary with net quantities and values
Closing Hose PeriodPump/hose meter readings (electronic totals)
Site PeriodSite-level fuel and shop summaries
MasterAll transactions with receipt numbers, amounts, tax
TransactionsAll line items (products, discounts, MOPs) with full detail

Auto-created MOP accounts

When validation encounters a Mode of Payment that doesn't yet have an MOP account for the current branch, it auto-creates one and emits a warning to the Logs tab. Auto-created MOP accounts are flagged as Configured = False and block posting until reviewed and marked configured.

Configure the new MOP — see MOP Accounts — then mark it Configured before posting.

Automatic Validation (Cron)

A cron job runs every minute and automatically validates the oldest Draft record. Uploaded files are validated even without manual intervention. See Cron Jobs.

Next step

Once validated, the record moves to Validated status. The posting cron picks it up next, or post manually — see CVGo POS Data Posting.