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.