Recent changes to ayuda

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:55:41 -0000

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:55:03 -0000

--- v7
+++ v8
@@ -1,4 +1,4 @@
 Guía PosXP
-En construcción
 [Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)
+En construcción
 [Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:53:51 -0000

--- v6
+++ v7
@@ -1,5 +1,4 @@
 Guía PosXP
-En construcción
-[Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)
+En construcción
 [Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:53:29 -0000

--- v5
+++ v6
@@ -1,3 +1,4 @@
+Guía PosXP
 En construcción
 [Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:23:06 -0000

--- v4
+++ v5
@@ -1,3 +1,4 @@
 En construcción
-[ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)
+[Ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)
 

+

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:21:54 -0000

--- v3
+++ v4
@@ -1,343 +1,3 @@
-PosXP app help
-
-[TOC]
-
-#What's New
-
-- **bug fix:** fixed the app to work with every keyboard layout (e.g. French)
-- **bug fix:** product in-stock quantity is not updated after a sale, but only when the app is restarted
-- use press and hold to select products like it is for speed buttons
-- reorganized [keypad](#keypad)
-- Added receipt [logos and header](#posxp)
-- Added [cash drawer](#drawer) support
-
-#Getting Started
-From inside any page swipe down from the top edge of the screen (or right-click the screen) to open the top app bar and switch between the main pages of the app.
-Swipe in from the right edge of the screen (or put the pointer to the upper- or lower-right corner) to display the [**charm bar**](http://windows.microsoft.com/en-us/windows-8/charms-tutorial). Tap or click **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the charm bar to set **Options** and access **Help** information.
-Start by adding some products from the [stock page](#stock).
-
-#Checkout
-[[img src=checkout.png alt=checkout]]
-
-
-##Keypad
-
-Refer to the figure above for the numbers in parentheses.
-On the right side of the screen there is a keypad (1), a display (2) and a receipt preview box (3).
-
-You can scroll the receipt preview box by sliding your finger (or with the mouse wheel).
-
-Drag a transaction with your finger (or mouse) off the right side of the screen to remove it from the current receipt.
-
-To clear the current sale pinch with two or more fingers the receipt preview box. If you're using mouse and keyboard move the mouse pointer over the receipt preview box and click on the **Clear** button that shows up. In both cases an animation will give you a visual feedback that the operation is taking place.
-
-**C:** delete the last inserted value. Press it repeatedly to delete previously inserted values up to the reset state.
-
-**SHIFT (arrow):** press the shift/arrow button to access more functions (still to be implemented) and other payment buttons (bitcoin support will be enabled any time soon).
-
-**NS:** Registers a no sale transaction. Basically it opens the drawer and saves the transaction in the journal (in the current release this button opens the drawer but does not register the event in the journal).
-
-**RA:** Received on account. Registers that some money that is not part of a sale has been received. For example the initial cash deposit.
-
-**PO:** Paid out. Registers that some money that is not part of a sale was spent. For example to pay suppliers.
-
-**REFUND**: Enter refund mode. You can also refund a speed button with more than 1 transaction.
-
-**PRINT**: print the current sale without finalizing it.
-
-##Speed Buttons
-
-Refer to the figure above for the numbers in parentheses.
-On the left side of the screen there is a grid of buttons (4); we will call these buttons **Speed Buttons**. The buttons (5) on top of the speed buttons show the page number and the page title of 5 consecutive pages of speed buttons. We will call these buttons **Page Buttons**.
-
-The green page button indicates the current page. To turn pages slide your finger right or left (or rotate the mouse wheel) or press a page button to go straight to that page. The maximum number of pages is set to 20.
-The page title can be useful to categorize pages (e.g. groceries, bar, breakfast, lunch or anything meaningful to your scenario). Perform the following steps to change a page's title:
-
-**1.** Tap and hold (or right-click) a page button
-**2.** Enter the new title for the page through the touch (or physical) keyboard
-**3.** Tap the screen (or press Enter on the physical keyboard)
-
-The title text is limited to 22 characters. On an average screen (7" to 19") only about 10 characters will fit.
-
-Tap and hold (or right-click) a speed button to select it and bring up the bottom app bar (tap the screen again to deselect it).
-The **Remove Speed** and **Remove Page** buttons on the bottom app bar need no explanation.
-Press **Edit Speed** [[img src=basic-icon-edit_InvariantCulture_Default.png alt=edit_icon]] to modify the selected speed button through the page that shows up:
-
-Enter a text for the speed button (mandatory).
-
-Press [[img src=basic-icon-plus_InvariantCulture_Default.png alt=plus_icon]] and [[img src=basic-icon-minus_InvariantCulture_Default.png alt=minus_icon]] to add and remove transactions that will be added when you'll press this speed button.
-
-- The **Quantity** field specifies the quantity for the transaction.
+En construcción
+[ir a la versión Inglés](https://sourceforge.net/p/posxp/wiki/)
 

-- The **Type** field specifies the transaction type:
-

-    - **SALE** sale transaction
-    - **DIS$** amount discount on a single item
-    - **DIS%** percentage discount on a single item
-    - **TOT$** amount discount on total receipt value
-    - **TOT%** percentage discount on total receipt value
-    - **SUR$** amount surcharge on a single item
-    - **SUR%** percentage surcharge on a single item
-
-- The **Description** field contains a list of products to choose from (if this is a sale transaction).
-

-- The **Amount** field works in this way: if you choose **AUTO** (that is zero) the price for the product is taken from the inventory when the transaction will be added at sell time. For your reference, this price is shown next to the product name. Alternatively you can set a price for a single item by entering it in the price field (in cents), overriding the inventory price.
-

-- Optionally choose a color and/or an icon. There are **12 colors** and **200 icons** to choose from.
-
-Tap **Save** [[img src=basic-icon-save_InvariantCulture_Default.png alt=diskette_icon]] to save the speed button or **Cancel** [[img src=basic-icon-x_InvariantCulture_Default.png alt=cancel_icon]] to discard everything.
-
-
-##Selling Operations
-
-Press a speed button to add the transactions you've chosen for that speed button to the current sale.
-
-**Example:** A Coffee speed button created with 1 coffee transaction and an AUTO price will insert a coffee for the price taken from the inventory. Let's say 3.00 USD.
-
-Enter a number and press a speed button to add items at a given price.
-
-**Example:** Type 200 on the keypad and press the Coffee speed button to sell 1 coffee for 2.00 USD.
-
-200 -> COFFEE
-
-
-Enter a number, press the X button and then a speed button to sell more units of the same item.
-
-**Example:** Type 2 on the keypad, press the X button and then the Coffee speed button to sell 2 coffees for 3.00 USD.
-
-2 -> X -> COFFEE
-
-
-You can combine the previous steps to sell more items at a given price. You can read the display to remember where you are.
-
-**Example:** Type 2 on the keypad and press the X button, the display updates accordingly. Type 200 on the keypad and then press the Coffee speed button to sell 2 coffees for 2.00 USD (each).
-
-2 -> X -> 200 -> COFFEE
-
-
-When you perform a multiply sequence on the keypad (i.e. enter a number and press the X button) followed by a speed button, every transaction added by the speed button is multiplied.
-Similarly, if you type a price value on the keypad and then press a speed button, the price you entered is set for every sale transaction added by the speed button (but not for discount or surcharge transactions).
-
-Type a barcode number on the keypad and press the BARCODE button to sell the product with that barcode number (if exists) at the inventory price. This is exactly the same as scanning a barcode with a [barcode scanner](#scanner).
-
-**Example:** Type 40111315 on the keypad and press the BARCODE button to sell a Twix (if you have it on stock).
-
-40111315 -> BARCODE
-
-
-You can also perform the following sequences to enter more units of a product with its barcode number:
-
-3 -> X -> 40111315 -> BARCODE
-3 -> X -> Scan code with a Barcode Scanner
-
-
-##Transaction Modifiers
-
-Enter a number and press the - button (+ button) to apply a discount (surcharge) to the last item of the current sale. The discount must be less or equal to the last item's amount.
-
-**Example:** Type 100 on the keypad and press the - (+) button to add a 1.00 USD discount (surcharge).
-
-100 -> -
-100 -> +
-
-
-Enter a number (between 1 and 100) and press the % button to apply a percentage discount to the last item of the current sale.
-
-**Example:** Type 10 on the keypad and press the % button to add a 10% discount.
-
-10 -> %
-
-
-If you press the SUB button and perform one of the previous sequences, you can apply discounts and surcharges to the total amount of the current sale. This is mostly used for percentage discounts, but it also makes sense for value discounts since you can discount on the total amount (i.e. more than the last item's amount. So this is not a redundant operation).
-
-SUB -> 100 -> -
-SUB -> 100 -> +
-SUB -> 10 -> %
-
-
-##Payment
-
-To add a payment and finalize a sale, enter the amount tendered on the keypad and press one of the payment button to choose the type of payment received.
-
-**Example:** To pay for our 3.00 USD coffee from the previous examples with a 5 dollars bill, type 500 on the keypad and press the CASH button.
-
-500 -> CASH
-
-
-The display will show the amount and type of payment received.
-If the amount tendered is more than the receipt total the display will also show the change due amount. At the same time the receipt preview box will be cleared, the cash drawer will open and the receipt will be printed and saved in the [journal](#journal).
-If the amount tendered is less than the receipt total the display will show what remains to be paid to close the sale. At this stage you can still edit any item if you need.
-
-To finalize a sale by entering the exact amount due, just press one of the payment button to choose the type of payment received.
-
-**Example:** To pay for our 3.00 USD coffee from the previous example in cash press the CASH button.
-
-CASH
-
-
-You can multiply payments as you do with products.
-
-**Example:** To enter a 3.00 USD payment made with 3 one-dollar bills, type 3 on the keypad, press the X button, type 100 and then press the CASH button.
-
-3 -> X -> 100 -> CASH
-
-
-##Receipt
-
-[[img src=receipt.png alt=receipt]]
-
-The picture above shows how a printed receipt looks like. The bottom logo with advertising is present only in the FREE version of the app.
-To set the header logo, footer logo and header lines go to the [posxp page](#posxp).
-The following currencies were tested and print correctly: **dollar, euro, pound, yen/yuan**. Other currencies may print correctly or not depending on their symbol. If the currency you're using is not printed correctly post a message in the [forum](https://sourceforge.net/p/posxp/forum/windows8/) as this could be fixed.
-
-
-##Customers
-
-Optionally you can associate a customer with a sale.
-Tap **Choose Contact** [[img src=basic-icon-addfriend_InvariantCulture_Default.png alt=customer_icon]] on the right end of the bottom app bar to select a contact from your contacts network in the [People app](http://windows.microsoft.com/en-us/windows-8/people-app-faq?ocid=w8_apps_people). You can add all kinds of accounts to the People app: Hotmail, Outlook, Exchange, Google, LinkedIn, etc...
-Tap **Remove Contact** [[img src=basic-icon-removefriend_InvariantCulture_Default.png alt=removecustomer_icon]] or [**clear**](#keypad) the current sale to unlink a customer.
-
-At the moment the only way to create a new customer is through the [People app](http://windows.microsoft.com/en-us/windows-8/people-app-faq?ocid=w8_apps_people).
-The procedure for creating a new customer and the overall customers management experience will be more integrated in future releases.
-In fact you can't do much with it right now other than associating a contact with a sale and [viewing it later](#docreport) (customer reports are coming soon). 
-However when [exporting data](#export) the **customer's id** is exported along with the other data. You can use the exported data to extract various statistics about customers. The only downside is that you get a user id on these statistics and nothing else (name, address,...).
-
-##Options
-
-Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the checkout page and then tap **Options**.
-The **Beep** toggle switch controls whether a sound is emitted when a button is pressed.
-The **Print Coupon** toggle switch is not used in the current release.
-
-
-#Stock
-
-When you first enter the stock page you can see a list of products grouped by department. Tap **Department** [[img src=basic-icon-sort_InvariantCulture_Default.png alt=diskette_icon]] on the right end of the bottom app bar, to switch between **Group by Letter** and **Group by Department** order. The label of the button will change appropriately to reflect the current order.
-Pinch or stretch (or rotate the mouse wheel while holding Ctrl) to switch to the Departments (resp. Letters) zoomed out view. Tap on a department (letter) in the zoomed out view to scroll the product list to that department (letter). You can use this view to look up a product by clicking on his initial letter.
-
-Drag a product off the left side of the screen to add it to the current sale.
-
-Press and hold (or right-click) a product to select it and bring up the command bar.
-
-Scanning a barcode while on the stock page will open the product page of the product with the barcode you scanned (if exists) or an empty product with only the barcode field filled so you can insert a new product with that barcode. 
-
-##Product Page
-
-The product page is shown when inserting or editing a product/department:
-
-- Leave the **Department** field empty if you want to create a department or select a department from the list if you want to create a product in the selected department.
-

-- Enter a **Name** for the product/department (mandatory). This is limited to 36 characters because of the limit in the receipt printer's line width. This constraint will be removed in the next releases as the text will be truncated or wrapped on a new line.
-

-- Enter a **Price** in cents for the product/department or leave zero if you want to [set a price for it at sell time](#sell) (this is usually done with departments).
-

-- Enter a **Tax** rate for the product/department as an integer or a decimal number. When you select a department in the department list, the tax rate for the product is automatically filled for you with the selected department's tax rate, but you can change it as needed.
-

-- The **Print** check box controls whether this product/department will be printed on receipts or not. This is useful in countries where tobacco products are not printed on the receipt, but it might turn out handy in other scenarios as well.
-

-- Enter a **Barcode** and set a **Quantity** as appropriate.
-
-Tap **Save** [[img src=basic-icon-save_InvariantCulture_Default.png alt=diskette_icon]] to save the product/department or **Cancel** [[img src=basic-icon-x_InvariantCulture_Default.png alt=cancel_icon]] to discard everything.
-
-If a product/department with the same name exists already, a message will popup to let you choose what to do:
-
-- **save the product anyway** (for example if it has a different price or tax rate)
-- **view the other product** (once you're done with the old product you'll be brought back to the product you were inserting)
-- **cancel** (to continue editing the product)
-
-This check is done to avoid duplicates and keep the product list slim and clean.
-
-
-#Journal
-
-Swipe up from the bottom edge of the screen (or right-click the screen) to bring up the bottom app bar which contains the buttons to view reports.
-Slide the view left or right to switch between daily reports and total reports.
-
-## Payments Report
-
-The payments report shows the net amount of money grouped by payment type. 
-
-## Products, Tax, Departments Report
-
-These reports are pretty much self-explanatory. They show various numbers for the products sold grouped by product, tax rate or department respectively. These reports don't include total discounts (this will be fixed in the next release).
-
-
-## Documents Report
-
-The documents report shows all the documents created since the last [Daily Reset](#journalreset) (which is usually done at the end of the day, but not necessarily). You can tap a document in the list to view its content and eventually reprint it.
-If the document you opened has a customer associated with it, a button will appear next to the document box so you can view the contact card of the customer and perform various actions like call, email, etc...(this will be improved in future releases and you'll also be able to email an invoice to the customer among other things).
-The maximum number of documents that can be stored is set to **10,000**. If this limit is reached a message will pop up to inform you about that and to ask you to reset the daily reports. If you omit to do so any other document created won't be saved but you can continue (if you resist the pop up after each sale).
-
-
-## Reset
-
-Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the journal page and then tap **Options**.
-Press the **Reset Daily** button to clear daily reports. This will also delete the documents report and the ability to view and print any old document.
-Press the **Reset Total** button to clear total reports. This will delete everything.
-
-
-#Posxp
-
-You can see the list of attached devices in the **Devices** box.
-Type on the header text boxes to set the header lines to be printed on the receipt. There are 3 lines and each line can contain up to 36 characters. The number of lines/characters could be increased in the future.
-Tap or click on the header or footer logo to add and remove receipt logos. The top logo is 200x200 pixels max, the bottom logo is 500x500 pixels max. Larger images will be automatically resized, smaller images will be left untouched. So just pick an image without worrying, **.png** and **.jpg** files are supported. If you don't want to use a logo leave it blank.
-You can't edit logos on the FREE version of the app.
-
-##Background
-Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the posxp page and then tap **Options**.
-Set your preferred background:
-The **Light** background is better for use under strong daylight, while the **Dark** background is best suited for low light conditions. Also the dark background consumes much less power, so if your device is running on battery this is preferred.
-
-
-##Export
-Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the posxp page and then tap **Options**.
-Press the **Export** button to export data to file. After picking a destination folder, a folder named **Posxp** will be created inside the destination folder containing several excel files. Double-click a file to open it with Excel so you can manage data (order, filter, merge, etc...) and print reports.
-
-#Supported Hardware
-
-
-##Barcode Scanner
-The app supports any barcode scanner that works in **USB HID POS** mode.
-The following models are known to work:
-
-* **Honeywell Hyperion 1300G**
-* **Honeywell Voyager 1200G**
-* **Honeywell Xenon 1900**
-
-To enable the **USB HID POS** mode on these scanners, you have to scan the following barcode:
-[[img src=usbhidposhoneywell.jpg alt=usbhidposhoneywell]]
-To do this you have to print in Actual Size page 21 of the following document:
-[https://www.honeywellaidc.com/CatalogDocuments/HP1300-UG.pdf](https://www.honeywellaidc.com/CatalogDocuments/HP1300-UG.pdf)
-
-For other brands/models refer to this [thread](https://sourceforge.net/p/posxp/forum/windows8/thread/389d12fc/).
-
-
-##Printer
-
-You can connect the following Epson printers:
-
-* **TM-T20**, **TM-T20II**
-* **TM-T88IV**, **TM-T88V**
-
-They all have a USB port and a second interface which is a serial port for the cheaper models.
-The **TM-T20II** is the recommended printer because it is premium Epson quality for an [extremely low price](http://www.amazon.com/ReadyPrint-T20-Direct-Thermal-Printer/dp/B005X11CS0/ref=sr_1_1?ie=UTF8&qid=1427979559&sr=8-1&keywords=epson+tm+t20). It's the best value for money receipt printer you can get. Models with a Wired LAN, Wireless LAN or Bluetooth interface are not supported yet because they cost more (a lot more [in some cases](http://www.amazon.com/Epson-BLUETOOTH-THERMAL-RECEIPT-SUPPLY/dp/B00LNLY54C/ref=sr_1_1?ie=UTF8&qid=1427979661&sr=8-1&keywords=epson+tm+t88v+bluetooth)) and setup it's not straightforward for some interfaces (e.g. Wired LAN).
-
-Follow these steps to setup the printer:
-
-1. [Ensure the printer USB Interface Class is set to Vendor](https://sourceforge.net/p/posxp/wiki/epsonusbconfig).
-2. If not already attached, attach the printer and wait for Windows to finish installing it.
-3. Download **zadig_2.1.1.exe** [here](http://posxp.sourceforge.net/zadig_2.1.1.exe) or from its [website](http://zadig.akeo.ie/):
-

-    - Double-click **zadig_2.1.1.exe** and click Yes to allow the program to run
-    - On the Zadig menu click on **Options -> List all devices**
-    - Select **TM-T20II** from the drop down list
-    - Click on **Install Driver**
-
-4. Launch the app and you should see the printer name in the [Devices box](#posxp).
-
-
-##Cash Drawer
-
-You can use almost any model of cash drawer because they are all quite standardized.
-If you're not sure look for an [**Epson Compatible drawer**](http://www.amazon.com/s/ref=nb_sb_noss?url=search-alias%3Daps&field-keywords=epson+compatible+drawer).
-Attach the cash drawer to the back of the receipt printer through the provided cable.
-

ayuda modified by alberto

alberto — Wed, 20 May 2015 17:17:37 -0000

--- v2
+++ v3
@@ -0,0 +1,343 @@
+PosXP app help
+
+[TOC]
+
+#What's New
+
+- **bug fix:** fixed the app to work with every keyboard layout (e.g. French)
+- **bug fix:** product in-stock quantity is not updated after a sale, but only when the app is restarted
+- use press and hold to select products like it is for speed buttons
+- reorganized [keypad](#keypad)
+- Added receipt [logos and header](#posxp)
+- Added [cash drawer](#drawer) support
+
+#Getting Started
+From inside any page swipe down from the top edge of the screen (or right-click the screen) to open the top app bar and switch between the main pages of the app.
+Swipe in from the right edge of the screen (or put the pointer to the upper- or lower-right corner) to display the [**charm bar**](http://windows.microsoft.com/en-us/windows-8/charms-tutorial). Tap or click **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the charm bar to set **Options** and access **Help** information.
+Start by adding some products from the [stock page](#stock).
+
+#Checkout
+[[img src=checkout.png alt=checkout]]
+
+
+##Keypad
+
+Refer to the figure above for the numbers in parentheses.
+On the right side of the screen there is a keypad (1), a display (2) and a receipt preview box (3).
+
+You can scroll the receipt preview box by sliding your finger (or with the mouse wheel).
+
+Drag a transaction with your finger (or mouse) off the right side of the screen to remove it from the current receipt.
+
+To clear the current sale pinch with two or more fingers the receipt preview box. If you're using mouse and keyboard move the mouse pointer over the receipt preview box and click on the **Clear** button that shows up. In both cases an animation will give you a visual feedback that the operation is taking place.
+
+**C:** delete the last inserted value. Press it repeatedly to delete previously inserted values up to the reset state.
+
+**SHIFT (arrow):** press the shift/arrow button to access more functions (still to be implemented) and other payment buttons (bitcoin support will be enabled any time soon).
+
+**NS:** Registers a no sale transaction. Basically it opens the drawer and saves the transaction in the journal (in the current release this button opens the drawer but does not register the event in the journal).
+
+**RA:** Received on account. Registers that some money that is not part of a sale has been received. For example the initial cash deposit.
+
+**PO:** Paid out. Registers that some money that is not part of a sale was spent. For example to pay suppliers.
+
+**REFUND**: Enter refund mode. You can also refund a speed button with more than 1 transaction.
+
+**PRINT**: print the current sale without finalizing it.
+
+##Speed Buttons
+
+Refer to the figure above for the numbers in parentheses.
+On the left side of the screen there is a grid of buttons (4); we will call these buttons **Speed Buttons**. The buttons (5) on top of the speed buttons show the page number and the page title of 5 consecutive pages of speed buttons. We will call these buttons **Page Buttons**.
+
+The green page button indicates the current page. To turn pages slide your finger right or left (or rotate the mouse wheel) or press a page button to go straight to that page. The maximum number of pages is set to 20.
+The page title can be useful to categorize pages (e.g. groceries, bar, breakfast, lunch or anything meaningful to your scenario). Perform the following steps to change a page's title:
+
+**1.** Tap and hold (or right-click) a page button
+**2.** Enter the new title for the page through the touch (or physical) keyboard
+**3.** Tap the screen (or press Enter on the physical keyboard)
+
+The title text is limited to 22 characters. On an average screen (7" to 19") only about 10 characters will fit.
+
+Tap and hold (or right-click) a speed button to select it and bring up the bottom app bar (tap the screen again to deselect it).
+The **Remove Speed** and **Remove Page** buttons on the bottom app bar need no explanation.
+Press **Edit Speed** [[img src=basic-icon-edit_InvariantCulture_Default.png alt=edit_icon]] to modify the selected speed button through the page that shows up:
+
+Enter a text for the speed button (mandatory).
+
+Press [[img src=basic-icon-plus_InvariantCulture_Default.png alt=plus_icon]] and [[img src=basic-icon-minus_InvariantCulture_Default.png alt=minus_icon]] to add and remove transactions that will be added when you'll press this speed button.
+
+- The **Quantity** field specifies the quantity for the transaction.
+

+- The **Type** field specifies the transaction type:
+

+    - **SALE** sale transaction
+    - **DIS$** amount discount on a single item
+    - **DIS%** percentage discount on a single item
+    - **TOT$** amount discount on total receipt value
+    - **TOT%** percentage discount on total receipt value
+    - **SUR$** amount surcharge on a single item
+    - **SUR%** percentage surcharge on a single item
+
+- The **Description** field contains a list of products to choose from (if this is a sale transaction).
+

+- The **Amount** field works in this way: if you choose **AUTO** (that is zero) the price for the product is taken from the inventory when the transaction will be added at sell time. For your reference, this price is shown next to the product name. Alternatively you can set a price for a single item by entering it in the price field (in cents), overriding the inventory price.
+

+- Optionally choose a color and/or an icon. There are **12 colors** and **200 icons** to choose from.
+
+Tap **Save** [[img src=basic-icon-save_InvariantCulture_Default.png alt=diskette_icon]] to save the speed button or **Cancel** [[img src=basic-icon-x_InvariantCulture_Default.png alt=cancel_icon]] to discard everything.
+
+
+##Selling Operations
+
+Press a speed button to add the transactions you've chosen for that speed button to the current sale.
+
+**Example:** A Coffee speed button created with 1 coffee transaction and an AUTO price will insert a coffee for the price taken from the inventory. Let's say 3.00 USD.
+
+Enter a number and press a speed button to add items at a given price.
+
+**Example:** Type 200 on the keypad and press the Coffee speed button to sell 1 coffee for 2.00 USD.
+
+200 -> COFFEE
+
+
+Enter a number, press the X button and then a speed button to sell more units of the same item.
+
+**Example:** Type 2 on the keypad, press the X button and then the Coffee speed button to sell 2 coffees for 3.00 USD.
+
+2 -> X -> COFFEE
+
+
+You can combine the previous steps to sell more items at a given price. You can read the display to remember where you are.
+
+**Example:** Type 2 on the keypad and press the X button, the display updates accordingly. Type 200 on the keypad and then press the Coffee speed button to sell 2 coffees for 2.00 USD (each).
+
+2 -> X -> 200 -> COFFEE
+
+
+When you perform a multiply sequence on the keypad (i.e. enter a number and press the X button) followed by a speed button, every transaction added by the speed button is multiplied.
+Similarly, if you type a price value on the keypad and then press a speed button, the price you entered is set for every sale transaction added by the speed button (but not for discount or surcharge transactions).
+
+Type a barcode number on the keypad and press the BARCODE button to sell the product with that barcode number (if exists) at the inventory price. This is exactly the same as scanning a barcode with a [barcode scanner](#scanner).
+
+**Example:** Type 40111315 on the keypad and press the BARCODE button to sell a Twix (if you have it on stock).
+
+40111315 -> BARCODE
+
+
+You can also perform the following sequences to enter more units of a product with its barcode number:
+
+3 -> X -> 40111315 -> BARCODE
+3 -> X -> Scan code with a Barcode Scanner
+
+
+##Transaction Modifiers
+
+Enter a number and press the - button (+ button) to apply a discount (surcharge) to the last item of the current sale. The discount must be less or equal to the last item's amount.
+
+**Example:** Type 100 on the keypad and press the - (+) button to add a 1.00 USD discount (surcharge).
+
+100 -> -
+100 -> +
+
+
+Enter a number (between 1 and 100) and press the % button to apply a percentage discount to the last item of the current sale.
+
+**Example:** Type 10 on the keypad and press the % button to add a 10% discount.
+
+10 -> %
+
+
+If you press the SUB button and perform one of the previous sequences, you can apply discounts and surcharges to the total amount of the current sale. This is mostly used for percentage discounts, but it also makes sense for value discounts since you can discount on the total amount (i.e. more than the last item's amount. So this is not a redundant operation).
+
+SUB -> 100 -> -
+SUB -> 100 -> +
+SUB -> 10 -> %
+
+
+##Payment
+
+To add a payment and finalize a sale, enter the amount tendered on the keypad and press one of the payment button to choose the type of payment received.
+
+**Example:** To pay for our 3.00 USD coffee from the previous examples with a 5 dollars bill, type 500 on the keypad and press the CASH button.
+
+500 -> CASH
+
+
+The display will show the amount and type of payment received.
+If the amount tendered is more than the receipt total the display will also show the change due amount. At the same time the receipt preview box will be cleared, the cash drawer will open and the receipt will be printed and saved in the [journal](#journal).
+If the amount tendered is less than the receipt total the display will show what remains to be paid to close the sale. At this stage you can still edit any item if you need.
+
+To finalize a sale by entering the exact amount due, just press one of the payment button to choose the type of payment received.
+
+**Example:** To pay for our 3.00 USD coffee from the previous example in cash press the CASH button.
+
+CASH
+
+
+You can multiply payments as you do with products.
+
+**Example:** To enter a 3.00 USD payment made with 3 one-dollar bills, type 3 on the keypad, press the X button, type 100 and then press the CASH button.
+
+3 -> X -> 100 -> CASH
+
+
+##Receipt
+
+[[img src=receipt.png alt=receipt]]
+
+The picture above shows how a printed receipt looks like. The bottom logo with advertising is present only in the FREE version of the app.
+To set the header logo, footer logo and header lines go to the [posxp page](#posxp).
+The following currencies were tested and print correctly: **dollar, euro, pound, yen/yuan**. Other currencies may print correctly or not depending on their symbol. If the currency you're using is not printed correctly post a message in the [forum](https://sourceforge.net/p/posxp/forum/windows8/) as this could be fixed.
+
+
+##Customers
+
+Optionally you can associate a customer with a sale.
+Tap **Choose Contact** [[img src=basic-icon-addfriend_InvariantCulture_Default.png alt=customer_icon]] on the right end of the bottom app bar to select a contact from your contacts network in the [People app](http://windows.microsoft.com/en-us/windows-8/people-app-faq?ocid=w8_apps_people). You can add all kinds of accounts to the People app: Hotmail, Outlook, Exchange, Google, LinkedIn, etc...
+Tap **Remove Contact** [[img src=basic-icon-removefriend_InvariantCulture_Default.png alt=removecustomer_icon]] or [**clear**](#keypad) the current sale to unlink a customer.
+
+At the moment the only way to create a new customer is through the [People app](http://windows.microsoft.com/en-us/windows-8/people-app-faq?ocid=w8_apps_people).
+The procedure for creating a new customer and the overall customers management experience will be more integrated in future releases.
+In fact you can't do much with it right now other than associating a contact with a sale and [viewing it later](#docreport) (customer reports are coming soon). 
+However when [exporting data](#export) the **customer's id** is exported along with the other data. You can use the exported data to extract various statistics about customers. The only downside is that you get a user id on these statistics and nothing else (name, address,...).
+
+##Options
+
+Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the checkout page and then tap **Options**.
+The **Beep** toggle switch controls whether a sound is emitted when a button is pressed.
+The **Print Coupon** toggle switch is not used in the current release.
+
+
+#Stock
+
+When you first enter the stock page you can see a list of products grouped by department. Tap **Department** [[img src=basic-icon-sort_InvariantCulture_Default.png alt=diskette_icon]] on the right end of the bottom app bar, to switch between **Group by Letter** and **Group by Department** order. The label of the button will change appropriately to reflect the current order.
+Pinch or stretch (or rotate the mouse wheel while holding Ctrl) to switch to the Departments (resp. Letters) zoomed out view. Tap on a department (letter) in the zoomed out view to scroll the product list to that department (letter). You can use this view to look up a product by clicking on his initial letter.
+
+Drag a product off the left side of the screen to add it to the current sale.
+
+Press and hold (or right-click) a product to select it and bring up the command bar.
+
+Scanning a barcode while on the stock page will open the product page of the product with the barcode you scanned (if exists) or an empty product with only the barcode field filled so you can insert a new product with that barcode. 
+
+##Product Page
+
+The product page is shown when inserting or editing a product/department:
+
+- Leave the **Department** field empty if you want to create a department or select a department from the list if you want to create a product in the selected department.
+

+- Enter a **Name** for the product/department (mandatory). This is limited to 36 characters because of the limit in the receipt printer's line width. This constraint will be removed in the next releases as the text will be truncated or wrapped on a new line.
+

+- Enter a **Price** in cents for the product/department or leave zero if you want to [set a price for it at sell time](#sell) (this is usually done with departments).
+

+- Enter a **Tax** rate for the product/department as an integer or a decimal number. When you select a department in the department list, the tax rate for the product is automatically filled for you with the selected department's tax rate, but you can change it as needed.
+

+- The **Print** check box controls whether this product/department will be printed on receipts or not. This is useful in countries where tobacco products are not printed on the receipt, but it might turn out handy in other scenarios as well.
+

+- Enter a **Barcode** and set a **Quantity** as appropriate.
+
+Tap **Save** [[img src=basic-icon-save_InvariantCulture_Default.png alt=diskette_icon]] to save the product/department or **Cancel** [[img src=basic-icon-x_InvariantCulture_Default.png alt=cancel_icon]] to discard everything.
+
+If a product/department with the same name exists already, a message will popup to let you choose what to do:
+
+- **save the product anyway** (for example if it has a different price or tax rate)
+- **view the other product** (once you're done with the old product you'll be brought back to the product you were inserting)
+- **cancel** (to continue editing the product)
+
+This check is done to avoid duplicates and keep the product list slim and clean.
+
+
+#Journal
+
+Swipe up from the bottom edge of the screen (or right-click the screen) to bring up the bottom app bar which contains the buttons to view reports.
+Slide the view left or right to switch between daily reports and total reports.
+
+## Payments Report
+
+The payments report shows the net amount of money grouped by payment type. 
+
+## Products, Tax, Departments Report
+
+These reports are pretty much self-explanatory. They show various numbers for the products sold grouped by product, tax rate or department respectively. These reports don't include total discounts (this will be fixed in the next release).
+
+
+## Documents Report
+
+The documents report shows all the documents created since the last [Daily Reset](#journalreset) (which is usually done at the end of the day, but not necessarily). You can tap a document in the list to view its content and eventually reprint it.
+If the document you opened has a customer associated with it, a button will appear next to the document box so you can view the contact card of the customer and perform various actions like call, email, etc...(this will be improved in future releases and you'll also be able to email an invoice to the customer among other things).
+The maximum number of documents that can be stored is set to **10,000**. If this limit is reached a message will pop up to inform you about that and to ask you to reset the daily reports. If you omit to do so any other document created won't be saved but you can continue (if you resist the pop up after each sale).
+
+
+## Reset
+
+Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the journal page and then tap **Options**.
+Press the **Reset Daily** button to clear daily reports. This will also delete the documents report and the ability to view and print any old document.
+Press the **Reset Total** button to clear total reports. This will delete everything.
+
+
+#Posxp
+
+You can see the list of attached devices in the **Devices** box.
+Type on the header text boxes to set the header lines to be printed on the receipt. There are 3 lines and each line can contain up to 36 characters. The number of lines/characters could be increased in the future.
+Tap or click on the header or footer logo to add and remove receipt logos. The top logo is 200x200 pixels max, the bottom logo is 500x500 pixels max. Larger images will be automatically resized, smaller images will be left untouched. So just pick an image without worrying, **.png** and **.jpg** files are supported. If you don't want to use a logo leave it blank.
+You can't edit logos on the FREE version of the app.
+
+##Background
+Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the posxp page and then tap **Options**.
+Set your preferred background:
+The **Light** background is better for use under strong daylight, while the **Dark** background is best suited for low light conditions. Also the dark background consumes much less power, so if your device is running on battery this is preferred.
+
+
+##Export
+Tap **Settings** [[img src=start-icon-settings_InvariantCulture_Default.png alt=settings_icon]] on the [charm bar](http://windows.microsoft.com/en-us/windows-8/charms-tutorial) while on the posxp page and then tap **Options**.
+Press the **Export** button to export data to file. After picking a destination folder, a folder named **Posxp** will be created inside the destination folder containing several excel files. Double-click a file to open it with Excel so you can manage data (order, filter, merge, etc...) and print reports.
+
+#Supported Hardware
+
+
+##Barcode Scanner
+The app supports any barcode scanner that works in **USB HID POS** mode.
+The following models are known to work:
+
+* **Honeywell Hyperion 1300G**
+* **Honeywell Voyager 1200G**
+* **Honeywell Xenon 1900**
+
+To enable the **USB HID POS** mode on these scanners, you have to scan the following barcode:
+[[img src=usbhidposhoneywell.jpg alt=usbhidposhoneywell]]
+To do this you have to print in Actual Size page 21 of the following document:
+[https://www.honeywellaidc.com/CatalogDocuments/HP1300-UG.pdf](https://www.honeywellaidc.com/CatalogDocuments/HP1300-UG.pdf)
+
+For other brands/models refer to this [thread](https://sourceforge.net/p/posxp/forum/windows8/thread/389d12fc/).
+
+
+##Printer
+
+You can connect the following Epson printers:
+
+* **TM-T20**, **TM-T20II**
+* **TM-T88IV**, **TM-T88V**
+
+They all have a USB port and a second interface which is a serial port for the cheaper models.
+The **TM-T20II** is the recommended printer because it is premium Epson quality for an [extremely low price](http://www.amazon.com/ReadyPrint-T20-Direct-Thermal-Printer/dp/B005X11CS0/ref=sr_1_1?ie=UTF8&qid=1427979559&sr=8-1&keywords=epson+tm+t20). It's the best value for money receipt printer you can get. Models with a Wired LAN, Wireless LAN or Bluetooth interface are not supported yet because they cost more (a lot more [in some cases](http://www.amazon.com/Epson-BLUETOOTH-THERMAL-RECEIPT-SUPPLY/dp/B00LNLY54C/ref=sr_1_1?ie=UTF8&qid=1427979661&sr=8-1&keywords=epson+tm+t88v+bluetooth)) and setup it's not straightforward for some interfaces (e.g. Wired LAN).
+
+Follow these steps to setup the printer:
+
+1. [Ensure the printer USB Interface Class is set to Vendor](https://sourceforge.net/p/posxp/wiki/epsonusbconfig).
+2. If not already attached, attach the printer and wait for Windows to finish installing it.
+3. Download **zadig_2.1.1.exe** [here](http://posxp.sourceforge.net/zadig_2.1.1.exe) or from its [website](http://zadig.akeo.ie/):
+

+    - Double-click **zadig_2.1.1.exe** and click Yes to allow the program to run
+    - On the Zadig menu click on **Options -> List all devices**
+    - Select **TM-T20II** from the drop down list
+    - Click on **Install Driver**
+
+4. Launch the app and you should see the printer name in the [Devices box](#posxp).
+
+
+##Cash Drawer
+
+You can use almost any model of cash drawer because they are all quite standardized.
+If you're not sure look for an [**Epson Compatible drawer**](http://www.amazon.com/s/ref=nb_sb_noss?url=search-alias%3Daps&field-keywords=epson+compatible+drawer).
+Attach the cash drawer to the back of the receipt printer through the provided cable.
+

ayuda modified by alberto

alberto — Thu, 14 May 2015 11:56:53 -0000

--- v1
+++ v2
@@ -1,8 +0,0 @@
-Welcome to your wiki!
-
-This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].
-
-The wiki uses [Markdown](/p/posxp/es/markdown_syntax/) syntax.
-
-[[members limit=20]]
-[[download_button]]

Home modified by alberto

alberto — Thu, 14 May 2015 11:54:18 -0000

Welcome to your wiki!

This is the default page, edit it as you see fit. To add a new page simply reference it within brackets, e.g.: [SamplePage].

The wiki uses Markdown syntax.

Project Members:

alberto (admin)