Back Office > Data Export > Data Portal > OzBiz
Description
This feature is used to export SwiftPOS Sales and purchases data to OzBiz QuickBooks/MYOB Data Portal interface. Sales data will only be available for export once Terminal Cash Offs have been saved and committed.
Expand the OzBiz menu to access the following:
- Settings - Select to access the Settings screen (see below).
- Export - Select to access the Export screen (see below).
To Be Considered
- Posting Data:
- The sales data is sourced from the SwiftPOS Back Office for the trading date selected. The data exported will include all sales from the start of trading to 1 second before the start of the next trading day.
- If any Tables/TABs are left open at the SwiftPOS Touch terminal, these will not be included in the export until they are closed. Once the Tables/TABs have been closed, the trading date will then appear again in the drop down list of dates the next time the export screen is opened. Note : Given the OzBiz export can handle this situation it is still recommended that all Tables/TABs be closed for the day with any balances charged off to Accounts. This will avoid date problems at the import side of things.
- Contact support@swiftpos.com.au for more information.
Pre-Requisites
- To make use of this feature, sites will need to be registered for the General Ledger Oz Biz interface. This may incur an additional charge. To confirm charges, email registrations@swiftpos.com.au.
- Ensure the Group Prefix field is set for each Location Group (Venue). This is used to distinguish site data where multiple versions of SwiftPOS data are being imported into a single MYOB/QuickBooks file.
- Cash and Cheque Media Types need to be configured as per the screenshot below. If the Cash and Cheque Media Types are not setup and their Banking Type NOT set to Summary then the data for those media will be incorrectly reported to OzBiz. All other Media Types that are to be included must have the Banking type set to Detailed.
- The Cash off declarations must be completed prior to exporting any sales data.
- All Tables/TABs must be closed for the day with any balances charged off to Accounts. Ensure the Allow committing with Open Tables/TABs settings are NOT selected to enforce this.
- All Held Sales must be finalised for the day. Ensure the Allow committing with Held Sales setting is NOT selected to enforce this.
OzBiz Settings
Data Location
- Sales Folder - Displays/Enter the folder where the sales CSV files will be created.
- Purchases Folder - Displays/Enter the folder where the purchases CSV files will be created.
Configuration Data
- Export Folder - Displays/Enter the folder where the Department and Media data required for mapping purposes will be exported to tab separated variable (TSV) files using this process.
- Export Configuration Data - Select to export. Configuration data is then exported and sent to OzBiz to enable the setup of MYOB/QuickBooks. 4 files are created: DepartmentNumbers.txt, Locations.txt, MediaTypes.txt and SiteIds.txt.
- Save Settings - Select to save the settings.
OzBiz Export
This screen is used to invoke the manual export of sales and Purchases data for OzBiz. This is done by selecting the appropriate Trading dates from the drop down lists for both sales and purchases. The drop down lists will only include those Trading dates that have NOT been exported. Once the export has completed the Trading dates selected will be removed from the drop down lists. Trading dates may be re-added to the drop down lists by select the appropriate Reset button.
Sales Export
- Sales Folder - Displays the Sales Folder selected in the Settings screen above.
- Sales Trading Date to Export - Select the date for which sales data is to be exported.
- Sales Export Reset - Select to reset the date so that is appears in the Sales Trading Date to Export drop down list again.
- Sales Export - Select to export sales data.
Purchases Export
- Sales Folder - Displays the Purchases Folder selected in the Settings screen above.
- Purchase Invoice Date to Export - Select the date for which purchasing data is to be exported.
- Purchase Export Reset - Select to reset the date so that is appears in the Purchase Trading Date to Export drop down list again.
- Purchase Export - Select to export purchasing data.
Data Required
The table below lists the sales data required to be transferred into the CDOL data warehouse.
Field Name |
Description |
Data Type |
Required |
transaction_id |
Unique identifier for the transaction. |
Text |
Optional (blank accepted) |
terminal |
The name of the terminal the transaction occurred. |
Text |
Mandatory |
terminal_Location |
The Location of the terminal, within the Business/Venue. |
Text |
Mandatory |
line |
Line number of the item. |
Integer |
Optional (blank accepted) |
transaction_timestamp |
The timestamp of the transaction. |
Date Time (yyyy-mm-dd hh:mm:ss) |
Mandatory |
stock_code |
The stock code of the purchased item. |
Text |
Mandatory |
product_description |
The name of the Product. |
Text |
Mandatory |
product_department |
The department that the Product belongs to. |
Text |
Mandatory |
product_unit_price |
The unit price of the Product purchased, before any discounts are applied. |
Currency |
Mandatory |
product_cost |
The cost of the item. |
Currency |
Mandatory |
price_level |
The price level the Product was sold at, e.g. Member or Visitor |
Text |
Optional (blank accepted) |
quantity |
The number of Products purchased on that line item. |
Integer |
Mandatory |
tax_amount |
The amount of tax paid on the Product item. |
Currency |
Mandatory |
sale_price |
The amount paid for the item. |
Currency |
Mandatory |
member_id |
The unique identifier of the member making the transaction. This should be 0 for visitors. |
Integer |
Mandatory |
Interface Overview
The integration model outlined in this document is based on the import of trading data, together with Supplier Invoices from the SwiftPOS Touch terminal to the client?s MYOB. This basic model can be varied to include/exclude additional sets of information as determined by the in depth discussion held to discuss this initial proposal.
File Naming Convention
Data is exported in 2 separate file types:
- Sales Data - Sales_SiteID_DateTime.txt - Separate files will be created for each trading date exported and written to the folder specified here.
- Purchase Data - Bills_SiteID_DateTime.txt - Separate files will be created for each trading date exported and written to the folder specified here.
Multiple files can be placed into a single folder for processing. These are differentiated by the following:
- Site ID - This is sourced from the Group Prefix field set against each Location Group (Venue).
- DateTime - Is set to the End of Day Finalisation time and not the export time.
Examples of File Names:
- Sales_01_20081115171521.txt
- Bills_01_20081115171521.txt
To streamline the processing of data, it is suggested that:
- The export process, flags days as ?already exported? and when opened each time, shows the next available day to export.
- That both the Sales and Stock Purchases are able to be re-exported individually for a selected date ? though with a warning that the data has already been exported.
File Formats
Sales
Header Line ? H
Field Name |
Mandatory |
What is it? |
Sourced From |
Balance ID |
Yes |
If the information was being supplied from a manual cash register, this would be the non-resettable grand total number. These are produced every time an end-of-day Z read is performed. It allows an owner to check that a register has not been used for a period and then read and zeroed. This provides us with a sequential numbering system so that can track any missed end-of-days. |
Generated by the end-of-day finalisation |
Date |
Yes |
This is the date of the End of Day reconciliation, not the date the report was printed. Again, using the example of the manual cash register, this would be the date on which the Z read was carried out. |
From the End of Day Report, Date |
Gross Sales Amount (Gross because it contains GST) |
Yes |
This is the Total Sales being reported, including GST. |
Normally obtained from the End of Day report ? Total Sales including GST |
Debtor Charges Amount |
Yes |
Sales that have been charged to Debtor accounts |
From the End of Day report, Debtor Sales |
Debtor Payments Amount |
Yes |
The total of debtor payments made to debtor accounts. |
From the End of Day report, Debtor Payments |
Takings |
Yes |
The sum of all payments made against Sales. This includes payments tendered and recorded as a Payment Method. Includes all payments methods tendered, including non-monetary considerations such as Vouchers. |
We anticipate that the actual values will be supplied by the user ? either within the POS or within OzBiz. If have an end-of-day declaration of actual cash ability, it will be the sum of the ACTUAL amounts for each Payment method. Otherwise will be the expected amount and the register discrepancy determined from a re-declaration in OzBiz. This total must balance with the reported breakdown by payment method in the C, and E lines. |
Total Payouts |
Yes |
The sum of all payments made from the Cash Register for goods and petty cash. It does not include EFTPOS cash outs or Safe Drops. |
From the End of Day report, Register Payouts taken for payment of expenses |
Internal Adjustments |
No |
This was developed for the Hotel industry, where the owner has goods rung up as sold, but then provides the goods free. The barman uses a Payment Method called ?Internal Adjustment? to indicate that the goods were not paid for. Can also be used for markdowns or damaged stock where the sale is recorded, but then expensed - though these are often better handled within the POS inventory management. Within the POS software these are not to be included as payments within the ?Takings. |
From the End of Day report, Internal Sales Adjustments |
Site ID |
No |
Where multiple sites are being entered into one accounting data file, users are able to have the Sites differentiated in reports by using either ?Category? or ?Job? in MYOB. While we are picking up from the file name, can also be included in the header of the file itself. |
If used, would simply be a field within the POS. Each Site would be given an identity. In many cases this would be a name that identifies the Location. |
Sales Line ? S
Each S Line represents a Cash Register with Departments.
Note : All items linked to a Department must be included. Also, ensure that there are no rounding issues between Gross Sales reported and Departmental Sales.
The first field is a Cost Centre ID and then the Departmental information is supplied in sets of three ? [Department_ID], [Department Sales including GST] and the [GST amount collected for that department].
Field Name |
Mandatory |
What is it? |
Sourced From |
Cost Centre ID |
No |
If used, would provide separate Sales line for each register. This may be an option ? most users will only require data for the site as a single S line. Should only provide Cost Centre ID if have multiple S lines A single Location may be split into ?Profit Centres? with this field. This is typically a Hotel where the Bar is split from the Bottle shop and the Bistro etc. The Cost Centre is attached to each Register within the Point of Sale report. |
This would come from a field that identifies the Location of each Cash Register. |
Department ID |
Yes |
An identifier supplied from the POS identifying the department. This field is used to link the Sales Department to a GL Code within the accounting programme through our configuration. Department ?Sales? may either be included in income, or be considered as not a part of Income (as in the case of Lotto or Poker Machine revenue). Within the accounting programme, multiple Sales Departments would normally be mapped to a broader Department GL Code. These Departments will include: Normal Income Sales Departments ? Eg. Cards, Papers, Confectionery Non-Income Sales Departments - Eg. Lotto, Bus Ticket Sales, Advance Deposits, Layby Receipts If have an end-of-day money declaration, include Register Discrepancies. |
From within the POS there will be a unique ID for each Department in the Departments Table. |
Department Sales Amount |
Yes |
The total sales for each department, including GST |
The Register Department Sales from the End of Day report. Register Variance from Cash Reconciliation Report Variance ? prepared from your SwiftPOS Back Office end-of-day reconciliation. |
GST Amount |
Yes |
The GST value included in the reported Department Sales Amount |
The GST amount for each Register Department Sales from the End of Day report The GST on the Variance will need to be calculated. This may require that it be based on the % of taxable sales to non-taxable sales for the day. |
Cash Line ? C
Field Name |
Mandatory |
What is it? |
Sourced From |
Cash Amount |
Yes |
The Cash value received for banking. |
From the SwiftPOS Back Office end-of-day reconciliation |
Cheques Amount |
Yes |
The Cheques value received for banking. |
From the SwiftPOS Back Office end-of-day reconciliation |
EFTPOS Line ? E
The E line contains all the non-cash/cheque payment types. These include EFTPOS, Amex, Diners Cub, Vouchers etc.
Note :The majority of payment types can be totalled as a single amount, though some payment types such as Direct Deposits may be better supplied as individual transactions.
Multiple E lines are acceptable.
Field Name |
Mandatory |
What is it? |
Sourced From |
Payment ID |
Yes |
The identifier for the payment type |
From the Payments Type table in the POS. The field is preferably the NAME of the payment type. |
Payment Amount |
Yes |
The amount for the particular payment type |
From the SwiftPOS Back Office end-of-day reconciliation |
Memo |
No |
As each EFTPOS terminal may need to be banked separately, there is a need to be able to identify within the bank deposits the terminal the deposit relates to. Where payment is a Direct Credit, the Customer Name assists in reconciling in MYOB |
From the SwiftPOS Back Office end-of-day reconciliation, and using the EFTPOS terminal reports, an attached ID for each EFTPOS terminal. For Direct Credits, the Customer Name either entered manually or picked up from the payment of their account. |
Banking Line ? B
Note : Mandatory if end of day re-declaration ? otherwise not used
If have end of day re-declaration of money, this should include the banking of the Cash and Cheques.
Field Name |
Mandatory |
What is it? |
Sourced From |
Bank_ID |
Yes |
When the SwiftPOS Back Office function is done, the cash & Cheques are deposited into bank accounts. |
From within the POS, there will need to be a screen into which a name is entered identifying the Bank account into which the deposit is made. The Bank ID is the unique ID from this table for each Bank Account. |
Banked Amount |
Yes |
The amount of cash & Cheques deposited to a Bank Account. |
From the SwiftPOS Back Office end-of-day reconciliation, and using the actual banking figures, the amount of Cash & Cheques being deposited into the Bank account. |
Payouts Line ? P
Payments for petty cash taken from the Cash Register
Field Name |
Mandatory |
What is it? |
Sourced From |
Payment ID |
Yes |
The identifier for the payout type from within the POS |
The Payment ID is the unique ID from the Payouts table for each Payout type. |
Payout Amount |
Yes |
The amount taken from the register to pay for an expense |
From the end-of-day reports |
Payout Memo |
No |
A free-text description of the payout |
Entered into the Cash Register at the time the Cash is taken. |
IntAdj_ID |
No |
The identifier for the Internal Adjustment type in the POS.
Expense Payouts from the register can either be posted to a generic ?Payouts? account, or to specific designated accounts. However, as many payouts will have an Input Tax Credit that can be reclaimed, either this information will have to be entered into the POS, or entered into the accounting programme at a later time. As it is unlikely that the GST input tax credit amount will always be available at the time of the Payout, it is easier to leave the GST off and allow them to make the changes in their accounting. |
From within the POS, there will need to be able to identify the type of Internal Adjustment being made. |
Internal Adjustment Amount |
No |
The identifier for the Internal Adjustment type in the POS |
The amount entered into the register as the adjustments |
Internal Adjustment Memo |
No |
A free-text description of the Adjustment |
Entered into the Cash Register at the time the Adjustment is made. |
Supplier Invoices
File is tab-delimited
Each line tab terminated
Data elements to be variable-length, trimmed. No leading or trailing spaces
Header line not to contain null amount fields ? empty amount fields to be written as 0
Site ID within the file may be blank.
If a line does not contain amounts, the line should not be written.
File to be placed in a folder to which we can have access.
Preferably able to bring to balance the Stock receipts against the total Invoice amount.
Can provide breakdown of:
- Purchases by Department
- Freight
- Other Expenses
- Balance Adjustment amount ? will require predefined ID
Header Line ? H
Mandatory
Field Name |
Mandatory |
What is it? |
Sourced From |
Vendor Ref |
Yes |
The Supplier Name as it appears in the POS. |
From Supplier Name in the POS Supplier table |
Date |
Yes |
The date on the Invoice being entered |
Entered by user into the POS, from info on Invoice |
Due Date |
No |
The Date the Bill is due to be paid. |
Entered by user into the POS, based on the trading terms for that Vendor |
Ref Number |
Yes |
The Invoice Number (or any other identifying information) |
Entered by User from the Invoice |
Memo (Optional) |
No |
A free text description that users may enter onto the Bill as a note for internal use |
Entered by the user |
Total Amount |
Yes |
The total amount of the Invoice to be paid |
Either entered by user of from the sum of the Items of the Invoice as they are entered into the POS |
Related Topics