Metcash/IBA E-Commerce Marketplace

2 | IBA E-Commerce Marketplace - Schedule Job Setup Guide

This article covers the setups required to configure the Schedule Job for implementing the Bepoz integration with the IBA E-Commerce Marketplace. This facilitates our integration with Metcash's online ordering platform for their bottle shop banner groups.

This article covers the setups required to configure the Schedule Job for implementing the Bepoz integration with the IBA E-Commerce Marketplace.

This facilitates our integration with Metcash's online ordering platform for their bottle shop banner groups.

Prerequisites
  • Minimum Bepoz version of 4.7.0.4 is required for this functionality
  • To access and setup Schedule job for IBA E-Commerce, the following Operator privileges need to be enabled
    • Operator Maintenance 'General' Tab
      • System Setup: "Access Venue, Stores & Tills" flag
      • System Setup: "Maintain Scheduled Job" flag

 

Setting up Schedule Job
  • Prior to adding and configuring the required Scheduled Job, it's recommended to create several Default records/items to be used with this integration
  • If the Defaults are not created, other records/items from the database may be used, however, that is not recommended
  • Details for each of the default items'  are as detailed below
    • Default Operator; e.g. "E-Commerce Operator"
    • Default Account Group; e.g. "E-Commerce Accounts"
    • Default Product; e.g. "E-Commerce Default" or "No Match" (this is used as the default product when there is not a match between the E-Commerce Marketplace product and the local Bepoz database products)
    • Default Delivery product; e.g. "Ecommerce Delivery Product"
    • Default Till; e.g. "Marketplace Orders Workstation" (not necessary to add a new Till for this; if not then determine which Till will be used to handle E-Commerce orders)
    • E-Commerce Table Group
    • E-Commerce External Payment
    • E-Commerce Discount Totalizer
    • A Product custom flag to be assigned to any products to be sold via the E-Commerce platform
IBA E-Commerce Order Schedule Job
  • This scheduled job, once configured allows the SmartController to communicate with the IBA E-Commerce platform; that, in turn, will send current pricing as well as live inventory from the local database to the E-Commerce platform
  • This ensures that all stock movements and price changes will be updated in near real-time so that the E-Commerce platform has accurate quantity on hand (QOH) and pricing data

Job Setup Instructions

  • To set up the BackOffice schedule job, log into the BackOffice and complete the following steps:
    • Navigate to System Setup and select Scheduled Jobs
    • Select Add Job button and the Job Maintenance window will open
    • There are a number of credentials that need to be input and they include
      • Job Name: Give the job a relevant name
      • Job Type: External DLL
      • DLL Name: Jobscandata.Dll
      • Class Name: IBA E-Commerce Orders
    • Set any other required configurations such as "Run Missed Jobs", "Run as", etc.
    • Configure the required schedule(s)
    • To access all the Job Options, save the job and then re-open it, and then click on the "Extended Setup" button at the bottom of the window

Extended Setup

  • Service Settings - These will be supplied by IBA and must be unique per Venue
 
Feild                               Description
API URL This is the base URL used to connect to the IBA E-Commerce platform
StoreID This is provided by Metcash / IBA; this will be the ID used for the E-Commerce marketplace store
Application Key This is provided by Metcash / IBA
Subscription Key This is provided by Metcash / IBA
Auth Key This is provided by Metcash / IBA
Site ID This is provided by Metcash / IBA
Version Enter 'v5.1' as the version number 
 
  • General Settings 
 
Field                Description
Custom Field           Set as the Product Custom flag that was created for this purpose; this is used as an identifier and the scheduled job will then only send info for the products that have the custom flag turned ON
Invoice Polling Mode Seconds  This is the time interval in seconds of how often to connect to the IBA E-Commerce platform to retrieve marketplace orders onto Bepoz SmartPOS
Product Update Interval Seconds This is the time interval in seconds of how often to connect to the IBA E-Commerce platform to update Product stock and price data
Default Product This is the product that will be sold if there is no match to a Bepoz
It is recommended to set up a product called "No Match" or similar so it can be identified by the Operator whilst processing the IBA E-Commerce order on SmartPOS
Default Deliver Product This is the product to sell that will match to the Delivery charges when an order is processed
Default Operator This is the Operator that all IBA E-Commerce orders will be attributed to
It is recommended to set up an Operator called "Marketplace Operator" or similar so the IBA E-Commerce online orders can be attributed to that Operator
Exact GTIN Match To be checked on if exact GTIN match is required

 

  •  Venue Specific Settings
 
Field Description
Venue This is the Venue that this job's 'Venue Specific Settings' will apply to
Order Discount Totalizer This is the Order discount totalizer that will be used for IBA E-Commerce Orders when an invoice discount is applied to the order
Default Till This is the Till that all IBA E-Commerce Orders will be attributed to in this Venue
It is recommended to set up an individual Till called "Marketplace Orders" so the online orders can be attributed to that Till for reporting
Table Group This is the table Group to which orders retrieved from the E-Commerce platform will be attributed to
A Table is automatically created when an E-Commerce transaction is retrieved in SmartPOS - this is the Table Group that will be created for
Account Group This is the Account Group that will be used for adding and updating E-Commerce Customers in the Bepoz database
External Payment Since E-Commerce orders are paid for via the external platform, this is the External payment that will be attributed to E-Commerce orders
 

 

 


Related Reading

  • IBA E-Commerce Marketplace - BackOffice Extension Device Setup Guide
  • IBA E-Commerce Marketplace - Till Function Button Setup Guide