Twitter
Google plus
Facebook
Vimeo
Pinterest

Fluid Edge Themes

Set Up and Configuration

Home  /  Set Up and Configuration

SET UP

The installation of the oBox in the machines is characterized by its ease and by the Plug&Play connection system, depending on the type of protocol (MDB or EXE) of the machine where the system will be connected.

Before installing

1. Make sure that the machine has the cashless systems enabled from the machine menu.

2. In Case of Executive, make sure that the Executive coin changer has the cashless systems enabled from the coin changer menú.

3. Make sure to power off machine before connection. Once connected, power it on.

Components Orain Box

Important:

  • The small connector must be always connected, either directly to the machine or directly to the coin changer. It’s the input connection.
  • The big output connector can be connected to other payment system, or can be free without connection.

MDB

Option 1:

To connect:

  • Cable 1 from small connector to machine through male MDB connector.
  • Cable 2 from big connector through male/female connectors to Coin changer/Bill reader.
  • Note: If behind the Orain box there is no coin changer/bill reader, it will be enough to connect the cable 1 from small connector to machine.

Option 2:

To connect:

  • Coin changer connected to machine
  • Cable 1 from small connector to coin changer through male MDB connector.
  • Cable 2 from big connector through male/female connector Bill reader.
  • Note: If behind the Orain box there is no bill reader, it will be enough to connect the cable 1 from small connector to machine.

Option 3:

To connect:

  • Connect the master device box or similar  (e.g. COGES Engine) in MDB with the vending machine
  • Join Cable 1, coming from the little connector of the right side Orain box, with the master box or similar through the male MBD connector.
  • The Cable 2 coming from the big connector of the Orain box goes free.
  • Link the bill reader with the master box in MBD connection.

Option 4:

To connect:

  • Link master in MBD with the vending machine.
  • Join Cable 1, coming from the little connector of the right side Orain box, with the master box or similar through the male MBD connector.
  • The Cable 2 coming from the big connector of the Orain box goes free.
  • Link the bill reader with the master box in MBD connection.

Option 5:

To connect:

  • Link master in MBD with the vending machine.
  • Join Cable 1, coming from the little connector of the right side Orain box, with the master box or similar through the male MBD connector.
  • Join the Cable 2, coming from the big connector from the left side Orain box, with the bill reader and the coins charger through the MBD connection.

EXE

Option 1:

To connect:

  • Join Cable 1, coming from the little connector of the right side, with the vending machine through the male EXE connector.
  • Join the Cable 2 of the Orain box, from the big connector on the left side, with the coins charger through the EXE connector

Option 2:

To connect:

  • Join coins charger with the machine in EXE connection
  • Join cable 1 of the Orain box, from the small connector on the right side, with the coins charger through the MBD connector
  • Cable 2 of the  Orain box, from the big connector on the left side, goes free
  • Join bill reader with coins charger through the MBD connector

Option 3:

To connect:

  • Join coins charger with the machine in EXE connection
  • Join cable 1 of the Orain box, from the small connector on the right side, with the coins charger through the MBD connector
  • Join cable 2 of the Orain box, from the big connector on the left side, with the coins charger through the MBD connector

Option 4:

To connect:

  • Join  master in EXE with the vending machine
  • Join Cable 1, coming from the right side small connector from the Orain box, with the master through the male MBD
  • Join Cable 2, coming from the left side big connector from the Orain box, with the coins charger and the bill reader  through the MBD connection

Option 5:

To connect:

  • Join the  master in Executive with the vending machine
  • Join Cable 1, coming from the small connector from the Orain box, with the master through the male MBD
  • Cable 2 of the  Orain box, from the big connector on the left side, goes free
  • Join bill reader with coins charger through the MBD connector

CONFIGURATION

Once you are an Orain customer you can organize your dashboard. Start by adding your machines to the dashboard, configuring your products and assigning technicians who can manage your machines.

Register/Create account 

To create an account in Orain it’s necessary to register first.

1. Click on “LOGIN” to register.

2. Click on “Create account” and create it.

 

3. Once you have your account created, the system will send you an email to confirm the direction. It’s compulsory to confirm it to keep on with the register process.

4. This will be the email that will be sent to your account in order to confirm it. Click here to confirm it and keep on with the register of the account.

5. Complete the information of the company.

6. Now you can access to your dashboard.

Add machines 

The option “Add machine” is used to register an Orain system (OBox) that is going to be installed in a machine. This process shall be made before making the installation of the system in the machine, because if you don’t do it, the user will be able to discover the machine through the app, but the result will be “Invalid Machine”.   

To add a machine, we have to follow the following steps:

1. Log in to your account and through the principal menu, access the pulled apart “Configuration” > “Machines”.

2. Click on “Add Machine”

3. Fill in the fields which are related to the configuration of the machine:

  • Activation code: Code provided by Orain corresponding to the oBox you wish to register on your machine.
  • Machine name: Write the name of the machine that will be written on the sticker that will be posted on the door of the machine for its identification. E.g: “Café Telefónica Ofi. Admin.”
  • Location label: Indicate the place to know where it will be located. E.g.: “Central Telefónica Madrid”
  • Type: Choose type: Snack, beverages or OCS
  • Machine identifier: Unique ID that you want this machine to have to be able to associate the use and sale telemetries.
  • Detailed location: If you wish, search for the place where the machine will be located on the map enlarging the scale and click on the exact point.
  • Image: If you wish, upload a square logo to be seen in the app on the left side of the machine’s name.

Common:

  • Currency: Choose currency.
  • Number of decimals: Choose the number of decimals, normally 2.
  • Currency factor (1-255): Choose currency, minimum coin accepted, normally 5 for 5 cents of euro.
  • Timeout (Seconds): Choose timeout, Maximum time allowed by the machine to accept a sale, normally from 12 to 20.
  • Multi-Sales and Activate coin recharge (Checkbox): Choose options “Multi-Sales” and “Activate coin recharge” if wished.

Executive:

  • Price Holding (Checkbox): Add the prices configured in the lane section to the configuration file.

MDB:

  • Coges MDB (Checkbox): Choose options when connected by MBD to “negative sales” in Reverse Vending, when it is a “MBD coges wallet”.
  • Choose Cashless 1 or Cashless 2. If there is not any other Cashless conncected, normally it will go with the 1.
  • Choose 32 bits when the machine communicates with it. E.g.: Máquina Azkoyen tabaco

4. Configure the number and capacity of rails of your machine.

5. Save

Orain Box Firmware update

1. Click on the Bluetooth icon, or on “Discover”

2. Click on the machine you want from the available ones to update

3. Machine chat opened

4. Click on “Configuration” > “Update FW”

5. Select the corresponding version (stable, last, specific):

  • Stable: Version tested and proven
  • Last: The previous phase of a version before it becomes stable. It is used to add new features to the stable version and to test that everything is working correctly.
  • Specific: Special version for specific machines. They will only appear if a specific need has been previously discussed between Orain and the operator.

If none of these versions are displayed, the firmware is already updated to the latest version and no versions are available.

6. Wait until 100% of the update process is completed

Add a role 

1. Login into the system, click on your profile and then on “management”
2. Go the the section “roles
3. Click on “add role”

4. To configure the role of the technician, select the fields that you want this technician to access, not only from the dashboard, but also form the machine.

Add a technician 

Through the Dashboard
1. Login in your account and click on your profile and, after, on “management”

2. Go to the section “technicians”


3. Click on “add technician”

4. Fill in the technician’s email and his/her role

  • Email:  It should coincide with the email used by the technician to register in the app. If you don’t have an account, you should register to be able to assign him/her as a technician.
  • Role: Select the desired role.If you don’t have any role or you wish to create a new one, go to “roles” > “add role”.

Through the App

1. Now open your Orain app in your mobile and click on the configuration icon

2. Close session and open again

3. Open session again

4. Now you will see the new “Configuration” option, which you as a technician might be requested to use for firmware upgrade. In next updates the technician APP functionalities will keep growing. Now you can also configure the machine in front of it.

Create a product 

1. Login into the system and go to the section “configuration” > “products”

2. Here you will find all the information about each product

  • Name
  • Image
  • Allergens
  • Sold units
  • Income
  • Machines

3. Click on “add product”

4. Fill in the information about the product. This information will be shown to the users of the machines that contain these products.

  • Product’s names
  • Warnings: allergens
  • Type of product
  • Image of the product

Add a product to a machine 

1. Go to “configuration” > “machines” to add the new products to the machine (to be able to add a product to a machine it has to be created first in the dashboard)

 

2. Select the machine in which you would like to add the products and click on “edit”

3. Go to the option “rails” and click on “+”

4. Click on “show lane”

5. Fill in the information and save

  • Lane number
  • Quantity of products
  • Product (it has to be added first in order to be selected)
  • Price of the product

Configure automated extraction 

This option is used to set up the automatic withdrawal of a specific amount from your balance each day, week or month (the operator can choose the periodicity).

1. Login into the system and go to “menu” > “invoicing”

2. Click on “configure automated extraction”

3. Select in which bank account you want the balance to be deposited, how much of your balance you want to withdraw and how often you want the withdrawal to be made (daily, weekly or monthly)

4. Click on “set up” to save

Extract balance 

1. Login into the system and go to “menu” > “invoicing”

2. Click on “extract balance”

3. Choose the bank account where you want the balance drawn to be deposited, the amount of balance you want to withdraw and click on “extract”

Integration with VEGA EVA-DTS

This process explains the operations to activate the SQS Amazon Service (message queue service) used to receive/send the data from the telemetry systems with the Vega SQS module.

The data that we need to obtain with these steps is:

  1. Access Key Id
  2. Secret Access Key
  3. Queues’ URL

 

Amazon Users Configuration

1. Access Amazon Web Services. If you do not have an account, you must create one.

1.1. Account creation at Amazon Web Services.

Note: A credit card number is required to create an account. Based on AWS pricing, all customers will be able to submit 1 million free requests from Amazon SQS per month (SQS Service Costs)

LINK a crear cuenta: https://portal.aws.amazon.com/billing/signup#/start

One of the required fields is to indicate a telephone number, it will be necessary to indicate a real telephone number, since there is a verification process. Verification is done by receiving a call from Amazon and typing the code that will appear on your computer screen into your phone. Once the code disappears from the screen you can hang up the call.

Once registration is complete, click on “sign in” and access the account you have just created.

2. The first step is to create the users who will use the service. To do this, select the IAM (Identity and Access Management) service by typing “IAM” in the page search engine.

3. Add users. Click on “users” > “add user”

Two users must be created, one used by the telemetry system, and the other used by the VegaSQS module.

Insert “User Name”, click on the “Programmatic Access” checkbox and go to the next step (Next Permission)

4. Configure the policy. Click on “Attach existing policies directly” and use the search engine to type “AmazonSQSFullAccess”, select the checkbox on the left and click on “Next Permission”

At the end of this process, the user will be generated with the access credentials “Access Key ID” (a) and “Secrete Access key” (b), codes that will be needed to add to the VEGA configuration fields.

The latter can be downloaded in a file by clicking on Download.csv.

This is an example of the content of the downloaded csv file:

User name,Password,Access key ID,Secret access key,Console login link CUSTOMER1,,AKIAJZYTSCCKMPFK4IJQ,xSDbfD/OeHgcxH/vi+XO+e9+LPXW94q5e5aVPVLu,https://674543845281.signin.aws.a mazon.com/console

NOTE: Remember that you must create two different users, the creation process is the same

 

Creating Data Submission Queues

The data is sent by the message queue service (Amazon SQS)

1. Click on “Services” and use the search engine to select “SQS”.

2. Click on “get started now”

3. Create queues. You have to create the following queues with the following names

  • “XXXXX_FROM_VEGA”. Used by the telemetry system to send the data to Vega  
  • “XXXXX_TO_VEGA”. Used by Vega to send the data to the telemetry system

Where “XXXXX” identifies the customer’s name, in our example we use “CUSTOMER1”.

4. Make sure you have selected EndPoint “Ireland” which identifies the server on which the queue will be created. To select it click on the current language in the top menu and select EU (Ireland). For technical problems at the moment it is not possible to select Endpoint di Francoforte.

5. Click on “Quick create queue” and create the other queue

6. Select the two created queues, click on “queue actions” > “queue configuration” and type “Receive Messagge Wait” = 20.

This value is represented in seconds and is the maximum waiting time before the system answers the call in the absence of data in the queue. When VegaSQS asks the service if there are messages to be processed in the absence of such, wait 20 seconds before generating a timeout. This allows for a considerable reduction in the use of resources.

7. Copy the URLs (c) obtained in the configuration process

Example of 2 URLs of the created queues:

https://sqs.eu-west- 1.amazonaws.com/674543845281/CUSTOMER1_TO_VEGA

https://sqs.eu- west-1.amazonaws.com/674543845281/CUSTOMER1_FROM_VEGA

Note: Always use the HTTPS protocol VegaSQS Configuration

 

Configuracion VegaSQS

The VegaSQS program has the function of sending data between the created queues and the Vega DB-Oracle.

Configuration: the access parameters to the DB-Vega and the SQS service must be configured in the popup menu. (right click on icon)

USER GUIDE

Through the dashboard you can analyze all your data, see how your income is evolving and stay in touch with your users, solving problems or having a simple conversation.

With the app, users can top up their balance, make purchases, report any errors or incidents, and claim refunds for failed purchases.

Register and first purchase

1. Download the app

2. Register

3. Discover the machines around you

4. Select the machine you wish to use and click on “Connect”

5. Top up your balance

6. Select the product on the machine

Edit my profile 

1. Enter to the system, go to the profile and click on “my profile”

2. Here you can change everything you wish (the profile picture, the user’s name, the e-mail and the password)

3. To change the profile picture, click on “review” and choose an image from your computer

4. Once we save, we will see how the profile image has changed

Modify my tax data 

1. Login into the system and go to “menu” > “invoicing”

2. Click on “add bank account”

3. Fill in all the information about the bank account

  • Account nickname: Name of the account
  • BIC (SWIFT): It is an alphanumeric series of 8 or 11 digits used to identify the receiving bank when making an international transfer.
  • IBAN: Account number

See conditions of my monthly plan 

1. Login into the system, click on the profile and, after, on “invoicing”

2. Click on SaaS

3. Here is the current plan directly displayed according to the number of machines you have registered in the dashboard

4. You can click on “SaaS service agreement” for more information

See the data of my machines

1. Login into the system and go to “data” > “machines”

2. Here you can see all the information about your machines, organizing the data according to the filter criteria and accessing the specific information of each of the purchases.

  • Filter by machine or location
  • Choose data date range
  • Filter by revenue or number of sales
  • Sort the results
  • Download the data (copy, CSV, excel, PDF)
  • View the specific information for each of the individual purchases

See the data of my users

1. Login into the system and go to “data” > “users”

2. Here you can see all the information about your users, organizing the data according to the filter criteria and accessing the specific information of each of the purchases.

  • Filter by user, machine or location
  • Choose data date range
  • Sort the results
  • Download the data (copy, CSV, excel, PDF)
  • View the specific information for each of the individual purchases

See the data of my products

1. Login into the system and go to “data” > “products”

2. Here you can see all the information about your products, organizing the data according to the filter criteria and accessing the specific information of each of the purchases.

  • Filter by product, machine or location
  • Choose data date range
  • Filter by units sold/day or income/day
  • Sort the results
  • Download the data (copy, CSV, excel, PDF)
  • View the specific information for each of the individual purchases

Create a promotion

1. Login into your account and, through the principal menu, access to the section “communication” > “promotions manager”

2. Click on “new promotion”

3. Fill in all the information about the promotion

  • Step 1: Promotion information
  • Promotion name: This name identifies the promotion and will help you maintain a specific follow up.
  • Promotion description: Promotion description. This field is optional and can be used to describe the promotion function.
  • Beginning date: Day in which the promotion will be enabled. Starting from the select date at 00:00:00 the promotion will be available for all the selected users.
  • End date: Day until which the promotion will be available. From that selected day at 23:59:59 the promotion will not work and will no longer be available to users.
  • Time slot: Time slots where the promotion will be active. Activate this option to make the promotion active only at certain time slots each day.
  • Step 2: Promotion conditions
  • Selection of machines by label: Machine labels selected for the promotion. The promotion you are creating will be applied only to machines with these labels.
  • Location selection: Location selected for the promotion. The promotion your are creating will be applied only on locations that interest you. You can apply the promotion in all locations where there are machines or on specific locations.
  • Machines selection: Machines selected for the promotion. The promotion you are creating will be applied only to the machines you want. You can apply the promotion to all your machines or to a selected group of machines.
  • Product selection: You can create a promotion that applies on all the products or select a few selected products.
  • Users’ selection: Users selected for the promotion. The selected users are those entitled to take advantage of the promotion. You can select all users or, if you want the promotion to be available only for a few users, you can select them manually.
  • Warning: To select keep in mind that the selected labels are placed on the right, while the unselected ones are on the left.
  • Step 3: Promotion actions
  • Promotion bonus: Here you can choose the bonus offered to the user you have selected. Either you want to apply a discount, or give a product for free after a certain number of sales, you can do it here.
  • Limits for each user: Here you can limit the number of times a user can benefit of the promotion. You can select not to fix a limit or define a specific number of uses.
  • Global limit (among all users): quí puedes limitar el número de veces que se utilizará la promoción entre todos tus usuarios.
  • Step 4: Confirmation (summary of all the previous fields)

Answer a user 

1. Log in to the system

2. Log in with your company’s account

3. Click on communication and, after that, on customer service

4. Choose your chat


5. Check the message type: Credit/ Technical problem/ Operational/ Demand/ only conversation

6. When you click on the client you can see your chat

7. You can chat with your clients

Solve an incident 

1. Login into the system and in the main page you will see the notifications, indicating that there are some messages unread

2. Click on “communication” > “customer service”

3. Select the wished chat

4. Select the incident option

5. Select the conversation with the desired user

6. Click on the wished option: “refund” (give the money back), “solved” (the incident has been solved) or “out of service”(the machine is not working now) to end the conversation

Mark a conversation as solved 

1. Login into the system and in the main page you will see the notifications, indicating that there are some messages unread
2. Clicar en “communication” > “customer service”

3. Select the wished chat

4. Select the simple conversation option

5. Select the conversation with the desired user

6. Click on “close” to end the conversation

Give balance back to a user 

Returning money to a user is an option used when the customer has had a problem using the machine and wants to be reimbursed for the amount spent. A refund can be requested, for example, when the machine has not dispensed the selected product and the user has already paid.

Option 1: Trough the chat

1. Login into the system and in the main page you will see the notifications, indicating that there are some messages unread

2. Click on “communication” > “customer service”

3. Select the wished chat

4. Select the option “refund” and the wished chat

5. Decide if you want to accept or reject

Option 2: Through “management” > “refund”

1. In the profile, click on “management”

2. Go to the option “refund”

3. Here we have two options: Activate the “automatic reimbursement” (all users who ask for a refund will be given their balance back), or select the user who you want to make the refund and write the amount of money that you want to give back to him/her (this reimbursement will be made only once)

Edit machine

1. Go to “configuration” > “machines”

2. Choose the machine you wish to edit and click on “edit”

3. Modify the field you wish to change

4. Click on “save”

Orain Box Firmware update

1. Click on the Bluetooth icon, or on “Discover”

2. Click on the machine you want from the available ones to update

3. Machine chat opened

4. Click on “Configuration” > “Update FW”

5. Select the corresponding version (stable, last, specific):

  • Stable: Version tested and proven
  • Last: The previous phase of a version before it becomes stable. It is used to add new features to the stable version and to test that everything is working correctly.
  • Specific: Special version for specific machines. They will only appear if a specific need has been previously discussed between Orain and the operator.

If none of these versions are displayed, the firmware is already updated to the latest version and no versions are available.

6. Wait until 100% of the update process is completed

Multiple sale

This option allows the user to make more than one purchase on the same machine without the application disconnecting it at the end of the purchase of the first product.

There are 2 options to configure the multiple sale, through the dashboard or through the app.

Option 1: Dashboard

1. Login and click on the section “machines”

2. Click on the option “add machine”

3. Select the option “multiple sale”

Option 2: App

1. Inside the chat of the machine wished to use, click on “configuration”

2. Select the option “multiple sales”

3. Click on “save”

Timeout

The timeout is the time from when the user selects the product until the sale is approved. For the proper functioning of the machine, it is recommended that the timeout of the application should always be lower than that of the machine.

There are 2 options to configure the timeout, through the dashboard or through the app.

Option 1: Dashboard

1. Login and click on the section “machines”

2. Click on the option “add machine”

3. Write the wished time in the option “timeout”

Option 2: App

1. Inside the chat of the machine you wish to use, click on “configuration”

2. Write the time wished in the option “timeout”

3. Click on “save”

Recharge coins

The option of topping up credit can be done through the app. Once registered, we have two options: recharge with card or coins. The first option is done only with the app and, in the second, it is necessary to insert the coins in the machine.

Option 1: With a credit card(Video)

1. Access to the chat of the machine you wish to use

2. Click on “wallet” > “top up”

3. Select the amount you wish to charge

4. Add a new card and then choose if you want to save it or to use it only once. If the card is saved, it will not be necessary to re-enter the data for the next reload.

5. Fill in the information about your card

Option 2: With coins (Video)

1. Access to the chat of the machine you wish to use

2. Click on “connect”

3. Insert the coins in the machine

Auto top up 

)
1. Click on “Wallet” and on “Auto top up

2. Configure you top up

Get your list of bills 

1. Click on the “Wallet” button and click on “Bills”

 

Ask for a refund 

A refund can be requested, for example, when the machine has not dispensed the selected product and the user has already paid.

1. Enter in the chat of the wished machine and click on “help”

2. Click on “request a refund” and choose what you want to be reimbursed for

3. Explain (minimum 5 words) why are you requesting a refund

4. Once, from the dashboard, the request has been accepted, the user will receive the following message

Notify mistakes and incidents

1. Click on “Help” and on “Report problem”

2. Select the type of problem and describe the incident

Do you need help?

If you have any problem and you can not solve it with the articles and videos, send us a message clicking on contact.