{"id":8345,"date":"2017-12-27T10:40:46","date_gmt":"2017-12-27T10:40:46","guid":{"rendered":"https:\/\/kb.sambapos.com\/?p=8345"},"modified":"2023-02-08T13:55:49","modified_gmt":"2023-02-08T13:55:49","slug":"8-1-android-mobile-client-v2-setup","status":"publish","type":"post","link":"https:\/\/kb.sambapos.com\/en\/8-1-android-mobile-client-v2-setup\/","title":{"rendered":"8.1. Android Mobile Client V2 Setup"},"content":{"rendered":"

Setup Document<\/b>
\nCheck List<\/strong><\/p>\n

1. Before Setup<\/p>\n

1.1. SambaPOS Setup
\n1.2. Mobile Client Android License
\n1.3. Activation
\n1.4. Reactivate Mobile Client License in a New Android Device<\/p>\n

2. Android Device Setup and Settings<\/p>\n

2.1 Android Device Features
\n2.2 Android Device Operating System Settings
\n2.3 Android Device Connection Settings
\n2.4 Installing the Mobile Client App<\/p>\n

3. Windows Server Settings<\/p>\n

3. Windows Settings<\/p>\n

3.1. Server Features
\n3.2. Database Features
\n3.3. Network Settings
\n3.4. Windows Firewall Settings
\n3.5. MSSQL TCP\/IP Ports<\/p>\n

4. SambaPOS Settings<\/p>\n

4.1. SambaPOS License Activation
\n4.2. SambaPOS Messaging Server Settings<\/p>\n

4.2.1. Messaging Server Service Tool Exe Settings
\n4.2.2. SambaPOS Management Messaging Server Settings<\/p>\n

4.3. User Settings<\/p>\n

4.3.1. Adding Role for Waiters
\n4.3.2. Adding User for pda
\n4.3.3. Adding Application for pda<\/p>\n

4.4. Entity Screen Settings
\n4.5. Ticket Tag Settings
\n4.6. Order Tag Settings<\/p>\n

5. Android Mobile Client Setup and Settings<\/p>\n

5.1. Message Server Check
\n5.2. Mobile Client Settings
\n5.3. Mobile Client Update
\n5.4. Mobile Client Manual<\/p>\n

1. Before Setup<\/strong><\/span><\/p>\n

NOTE: With the 5.2.24 version of SambaPOS V5 Pro and 2.0.52 version of Android Mobile Client, you can use Android Mobile Client App without internet connection. For that you need to Clear Key from your cp.sambapos.com account and reactivate your license.<\/span>
\n<\/strong><\/span><\/p>\n

You need to install L<\/strong>atest Version<\/b>\u00a0of SambaPOS to be able to use with Android Mobile Client.<\/strong><\/p>\n

Before you upgrade SambaPOS V5 Pro version, we recommend you to Take a Backup<\/strong> of current database.<\/p>\n

1.1. SambaPOS Setup
\n1.2. Mobile Client Android License
\n1.3. Activation
\n1.4. Reactivate Mobile Client License in a New Android Device<\/p>\n

1.1. SambaPOS Setup
\n<\/strong>Download and install Latest Version<\/strong> of SQL Server<\/strong>\u00a0Download Link\u00a0<\/a>\u00a0\u00a0SQL Server Setup Link<\/a>
\n<\/strong>Download and install SambaPOS Latest<\/strong>\u00a0Version<\/strong> then activate with your license.\u00a0Download<\/a><\/span><\/p>\n

1.2. Mobile Client Android License\u00a0<\/strong><\/span>
\nPurchase Mobile Client license for per Android device from cp.sambapos.com<\/p>\n

\"\"<\/p>\n

1.3. Activation
\n<\/strong>Mobile Client Licenses must be in same account with SambaPOS v5 license.
\n<\/span><\/p>\n

1.4. Reactivate Mobile Client License in a New Android Device<\/strong><\/span>
\nLogin cp.sambapos.com and click on Clear Key button<\/p>\n

\"\"<\/p>\n

2. Android Device Setup and Settings<\/strong><\/span><\/p>\n

2.1. Android Device Features
\n2.2. Android Device Operating System Settings
\n2.3. Android Device Connection Settings
\n2.4. Installing the Mobile Client App<\/div><\/p>\n

2.1. Android Device Features<\/strong><\/p>\n

– All of the Google Services must be installed on the mobile device.<\/span><\/strong>
\n– Android version must be 4.4 or higher.
\n– Minimum 2 GB of RAM<\/p>\n

2.2. Android Device Operating System Settings<\/strong>
\n– Update the version of Android.
\n– Check the system date of device or activate auto update.
\n– Close or delete all unnecessary applications.<\/p>\n

2.3. Android Device Connection Settings<\/strong>
\n– Android device and SambaPOS Server must be in the same network and IP group.
\n– You need to have internet for setup. You don’t need internet after setup.<\/p>\n

2.4. Installing the Mobile Client App<\/strong><\/p>\n

\"\"
\nYou can download the app from Play Store. You can find the app by searching “SambaPOS Mobile Client”
\nhttps:\/\/play.google.com\/store\/apps\/details?id=sambapos.com.mobilev2_android<\/p>\n

3. Windows Server Settings<\/strong><\/span><\/p>\n

<\/p>\n

3. Windows Settings<\/p>\n

3.1. Server Features
\n3.2 Database Features
\n3.3. Network Settings
\n3.4. Windows Firewall Settings
\n3.5. MSSQL TCP\/IP Ports<\/p>\n

<\/div><\/p>\n

3. Windows Settings<\/strong><\/p>\n

3.1. Server Features<\/strong>
\nServer Operating System:<\/strong> Windows 10 or above operating system and the latest version of Microsoft SQL Server
\nServer Hardware:<\/strong>\u00a0Minimum Intel Celeron J1900 CPU,\u00a04 GB of Ram, 64 GB SSD \u00a0Harddisk or higher<\/p>\n

3.2. Database Features<\/strong>
\nThe latest version of Microsoft MSSQL Express Server With Management
\nDownload Link
\n<\/a>Setup Document Link<\/a><\/p>\n

3.3. Network Settings<\/strong>
\nSambaPOS Server and Mobile Client must be in the same IP group.<\/p>\n

Server: Go to\u00a0 Control Panel > Network and Sharing Center > Change Adapter Settings > Local Area Connection > Internet Protocol Version 4 (TCP\/IPv4) > Properties > Write a static IP.<\/p>\n

3.4. Windows Firewall Settings
\n<\/strong><\/p>\n

Please deactivate all third party internet security and firewall services.<\/strong><\/span><\/p>\n

Note: If you don’t have MSSQL database,<\/strong><\/span> please visit the link to configure settings<\/strong><\/p>\n

https:\/\/kb.sambapos.com\/2-1-3-sql-express-server-setup\/?lang=en<\/span> <\/a><\/p>\n

Mobile Client doesn’t work without MSSQL database.<\/strong><\/p>\n

–\u00a0Please deactivate all third party internet security services and Windows Firewall.<\/strong><\/p>\n

Control Panel > System and Security > Windows Firewall > Turn Windows Firewall on or off > Turn off Windows Firewall for Private Network Settings and Public Network Settings<\/p>\n

Note: Do not have notification for reactivate of Windows Firewall, please follow the steps\u00a0<\/strong><\/span><\/p>\n

Control Panel > System and Security > Action Center > Change Action Center Settings > Network Firewall\u00a0(Unselected)<\/strong><\/span><\/p>\n

3.5. MSSQL TCP\/IP Ports<\/strong>
\nGo to SQL Server Configuration Manager and “Enable” TCP\/IP Sharing to connect MSSQL Database from clients.<\/p>\n

\u2013 Right Click My Computer > Manage > Services and Applications > SQL Server Configuration Manager > SQL Server Network Configuration > Protocol For MSSQLSERVER > TCPIP > Enabled<\/p>\n

4. SambaPOS Settings<\/strong><\/span><\/p>\n


\n4.1. SambaPOS License Activation
\n4.2. SambaPOS Messaging Server Settings
\n4.3. User Settings
\n4.4. Entity Screen Settings
\n4.5. Ticket Tag Settings
\n4.6. Order Tag Settings
\n<\/div><\/p>\n

4.1. SambaPOS License Activation<\/strong><\/p>\n

Check your SambaPOS V5 license. If you see “Unregistered Trial” you can not use Android Mobile Client App. You need to have SambaPOS V5 license.<\/p>\n

\"\"<\/p>\n

4.2. SambaPOS Messaging Server Settings<\/strong><\/p>\n

4.2.1. Messaging Server Service Tool Exe Settings<\/strong>
\nRun SambaPOS MessagingServer in SambaPOS Server PC.
\nC:\\Program Files (x86)\\SambaPOS5\\Samba.MessagingServerServiceTool.exe<\/em>
\nPort: 9000<\/span><\/strong>\u00a0<\/span> and install<\/p>\n

Attention!!! Please don’t forget to restart SambaPOS MessagingServer from Services, if you add a user to SambaPOS.<\/strong><\/span><\/p>\n

\"\"<\/p>\n

4.2.2. SambaPOS Management Message Server Settings<\/strong>
\nManage > Settings > Local Settings > Messaging Server
\nMessage Server Name<\/strong>: http:\/\/your server pc name or\u00a0http:\/\/your server pc ip (for example: 192.168.2.19)
\nMessage Server Port<\/strong>: 9000
\nAuto Start Message Client: [X]<\/strong>\u00a0 \u00a0 \u00a0(Selected)<\/p>\n

\"\"<\/p>\n

4.3. User Settings<\/strong><\/p>\n

4.3.1. Adding Role for Waiters<\/strong>
\n

Manage > Users> Role List >Add Role
\n<\/strong>Role Name:<\/strong>\u00a0Waiter
\nDepartmant: <\/strong>Restaurant
\nAdmin: [ ]\u00a0 \u00a0<\/strong>(unselected)<\/div><\/p>\n

\"\"<\/p>\n

4.3.2. Adding User for pda<\/strong><\/p>\n


\nManage > Users > Users List > Add User
\n<\/strong>User Name:<\/strong> pda
\nPin Code:<\/strong> 2520634\u00a0(Exactly this pin code has to be used)<\/span>
\nPassword:<\/strong> 2520634\u00a0(Exactly this password has to be used)<\/span>
\nRole: <\/strong>Admin
\nSave<\/strong><\/em><\/span><\/p>\n

Attention! : Pda user is created for Android Mobile Client connection. It\u00a0can not be used by staff. In order to perform user login from mobile application, in SambaPOS V5, you have to create new users in waiter role.<\/strong><\/em><\/span><\/p>\n

\"\"<\/p>\n

4.3.3. Adding Application for pda<\/strong><\/p>\n

Manage > Users > Applications > Add Application<\/strong><\/p>\n

<\/div>
\nApplicaiton Name:<\/strong> pda
\nIdentifier:<\/strong> pda
\nAuthentication Type: <\/strong>User Name & Password
\nAuthorization Type:<\/strong> All Functions in Local Network
\nLifetime:<\/strong> 365
\nAllowed Origin:<\/strong>\u00a0*
\nActive:<\/strong> Selected
\n<\/div><\/p>\n

\"\"<\/p>\n

4.4. Entity Screen Settings<\/strong>
\n<\/strong>Manage > Entities > Entity Screens > All Tables (Tables) > Mappings<\/p>\n

Add a new line for Waiter role. If you need to use more than one entity screen, you must repeat the same process for them too.
\n<\/strong><\/p>\n

\"\"<\/p>\n

4.5. Ticket Tag Settings<\/strong><\/p>\n

Note: If you don’t need this feature, you can skip this step.\u00a0<\/strong><\/span><\/p>\n

Manage > Tickets > Ticket Tags > Add Ticket Tag > Mappings\u00a0<\/strong><\/p>\n

Add a line for Waiter role.<\/p>\n

\"\"<\/p>\n

4.6. Order Tag Settings<\/strong><\/p>\n

Manage > Tickets > Order Tags > Add Order Tag Group
\n<\/strong>Create a tag by using lower case,<\/span>\u00a0<\/strong>name it as ”freetag”\u00a0<\/strong>and activate\u00a0Free Tagging <\/strong>box by selecting it.<\/p>\n

\"\"<\/p>\n

5. Android Mobile Client Setup and Settings<\/strong><\/span><\/p>\n


\n5.1. Message Server Check
\n5.2. Mobile Client Settings
\n5.3. Mobile Client Update
\n5.4. Mobile Client Manual<\/div><\/p>\n

5.1. Message Server Check<\/strong>
\nGo to Services and restart SambaPOS Messaging Server<\/em><\/span><\/p>\n

\"\"<\/p>\n

5.2. Mobile Client Settings<\/strong><\/p>\n

Mobile Client Main Screen > Settings
\nPassword: 2122520634<\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

Message Server IP<\/strong>: Server IP. (for example: 192.168.2.19)
\nFind Settings:<\/strong>\u00a0Finds the settings automatically by connecting to server pc.
\nTicket Type:<\/strong> Andriod Client ticket type.
\nTerminal Name:<\/strong> Android Client Terminal name.
\nDepartment:<\/strong> Android Client Department name.
\nTable Entity Type:<\/strong> Android Client table entity type.
\nCustomer Entity Type:<\/strong> Android Client customer entity type.
\nMenu:<\/strong> Android Client\u00a0 Menu.
\nTicket Printing:<\/strong>\u00a0Selects the printers. You can select more than one.<\/strong>
\nLanguage:<\/strong>\u00a0Select language.
\nSave<\/b><\/p>\n

\"\"<\/p>\n

\"\"<\/p>\n

5.3. Mobile Client Update<\/strong><\/p>\n

Click on Update button and wait.
\nIf you change anything in SambaPOS, you need to click on Update button again.<\/p>\n

Updated Services:
\nProduct List<\/strong>
\nMenu List<\/strong>
\nOrder Tags<\/strong>
\nTicket Tags<\/strong><\/p>\n

\"\"<\/p>\n

5.4. Mobile Client Manual<\/strong><\/p>\n

\"\"<\/p>\n

Andorid Mobile Client User Manual<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"

Setup Document Check List 1. Before Setup 1.1. SambaPOS Setup 1.2. Mobile Client Android License 1.3. Activation 1.4. Reactivate Mobile Client License in a New Android Device 2. Android Device Setup and Settings 2.1 Android Device Features 2.2 Android Device Operating System Settings 2.3 Android Device Connection Settings 2.4 Installing the Mobile Client App 3. […]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[],"class_list":["post-8345","post","type-post","status-publish","format-standard","hentry","category-additional-modules"],"_links":{"self":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/8345","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/comments?post=8345"}],"version-history":[{"count":51,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/8345\/revisions"}],"predecessor-version":[{"id":27863,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/posts\/8345\/revisions\/27863"}],"wp:attachment":[{"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/media?parent=8345"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/categories?post=8345"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kb.sambapos.com\/en\/wp-json\/wp\/v2\/tags?post=8345"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}