From c895763579d41f8d4fbd9eb6d5720da41b58c5d9 Mon Sep 17 00:00:00 2001 From: Francois Kawala Date: Thu, 30 Jan 2020 10:14:40 +0100 Subject: [PATCH] Fix readme. --- pos_barcode_tare/README.rst | 27 +++++++++---- pos_barcode_tare/readme/CONTRIBUTORS.rst | 2 + pos_barcode_tare/readme/USAGE.rst | 2 +- .../static/description/index.html | 39 ++++++++++--------- 4 files changed, 43 insertions(+), 27 deletions(-) diff --git a/pos_barcode_tare/README.rst b/pos_barcode_tare/README.rst index d9ab94eb..735327ca 100644 --- a/pos_barcode_tare/README.rst +++ b/pos_barcode_tare/README.rst @@ -25,29 +25,35 @@ Point of Sale - Tare barecode labels for loose goods |badge1| |badge2| |badge3| |badge4| |badge5| -This add-on enables POS to read and print tare barcodes. We print a barcode tare label to sell loose goods in a Bring Your Own Container (BYOC) scheme. +This add-on enables POS to read and print tare barcodes. We print a barcode tare label to sell loose goods in a Bring Your Own pot (BYOC) scheme. -The BYOC scheme has four steps: - 1. The cashier weighs the container and sticks the tare bar code onto the customer's pot. - 2. The customer takes the desired quantity of the goods s-he wants to buy. - 3. The cashier weighs the filled container and goods, and POS gives the corresponding price. - 4. The cashier scans the tare bar code, and POS removes the container's weight from the latest product of the order. +The BYOC scheme has five steps: + 1. The cashier weighs the pot and sticks the tare barcode onto the customer's pot. + 2. The customer go and put loose goods into the labeled pot. + 3. The cashier weighs the pot with loose goods inside. POS computes the price including the pot. + 4. The cashier scans the tare barcode. POS get the pot weight from the barcode. POS subtracts the pot weight from the weight of the latest product. POS sets the billable price for the loose goods. + 5. The customer pays. This add-on adds a news screen to POS to print (web) the tare barcode labels. This add-on enables POS to read a tare barcode. Reading a barcode makes POS adjust the weight of the latest article in the order list. The new weight is equal to the total weight minus the tare weight. The price is updated accordingly to the weight change. POS home screen is now: + .. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/POS_with_button.png The label screen is: + .. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/null_weight.png When we read a weight the impression button is enabled + .. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/ready_to_print.png A barcode label looks like: + .. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/label.png Zoom on the action widget: + .. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/zoom_action_widget.png **Table of contents** @@ -58,12 +64,15 @@ Zoom on the action widget: Usage ===== -Install this add-on and configure the point of sale where you want to be able to use the tare barecode. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome). +Install this add-on and configure the point of sale where you want to be able to use the tare barecode. Setup the default barcode sequence ID according to your barcode nomenclature. The barcode pattern should be ``XX.....NNDDD`` where XX is the barcode prefix. In the default barcode nomenclature, the weight barcode pattern sequence id is 36 and its prefix is 21. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome). + +The command line to start a chrome base browser in kiosk mode with silent printing looks like: + +``chromium-browser --use-system-default-printer --kiosk --kiosk-printing http://localhost:8069/`` Known issues / Roadmap ====================== -- Use barcode nomenclature instead of hardcoded barcode prefix 21. - Add french translation. Bug Tracker @@ -88,7 +97,9 @@ Contributors ~~~~~~~~~~~~ - Le Nid +- Sylvain LE GAL - CoopITEasy + Maintainers ~~~~~~~~~~~ diff --git a/pos_barcode_tare/readme/CONTRIBUTORS.rst b/pos_barcode_tare/readme/CONTRIBUTORS.rst index 250f9dd1..2c281d6d 100644 --- a/pos_barcode_tare/readme/CONTRIBUTORS.rst +++ b/pos_barcode_tare/readme/CONTRIBUTORS.rst @@ -1,2 +1,4 @@ - Le Nid +- Sylvain LE GAL - CoopITEasy + diff --git a/pos_barcode_tare/readme/USAGE.rst b/pos_barcode_tare/readme/USAGE.rst index 3708b1f3..a57f2807 100644 --- a/pos_barcode_tare/readme/USAGE.rst +++ b/pos_barcode_tare/readme/USAGE.rst @@ -1,4 +1,4 @@ -Install this add-on and configure the point of sale where you want to be able to use the tare barecode. Setup the default barcode sequence ID according to your barcode nomenclature. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome). +Install this add-on and configure the point of sale where you want to be able to use the tare barecode. Setup the default barcode sequence ID according to your barcode nomenclature. The barcode pattern should be ``XX.....NNDDD`` where XX is the barcode prefix. In the default barcode nomenclature, the weight barcode pattern sequence id is 36 and its prefix is 21. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome). The command line to start a chrome base browser in kiosk mode with silent printing looks like: diff --git a/pos_barcode_tare/static/description/index.html b/pos_barcode_tare/static/description/index.html index 47401109..39d7aeee 100644 --- a/pos_barcode_tare/static/description/index.html +++ b/pos_barcode_tare/static/description/index.html @@ -368,28 +368,29 @@ ul.auto-toc { !! changes will be overwritten. !! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! -->

Beta License: AGPL-3 OCA/pos Translate me on Weblate Try me on Runbot

-

This add-on enables POS to read and print tare barcodes. We print a barcode tare label to sell loose goods in a Bring Your Own Container (BYOC) scheme.

+

This add-on enables POS to read and print tare barcodes. We print a barcode tare label to sell loose goods in a Bring Your Own pot (BYOC) scheme.

-
The BYOC scheme has four steps:
+
The BYOC scheme has five steps:
    -
  1. The cashier weighs the container and sticks the tare bar code onto the customer’s pot.
    2. -
  2. The customer takes the desired quantity of the goods s-he wants to buy.
    3. -
  3. The cashier weighs the filled container and goods, and POS gives the corresponding price.
    4. -
  4. The cashier scans the tare bar code, and POS removes the container’s weight from the latest product of the order.
    5. +
  5. The cashier weighs the pot and sticks the tare barcode onto the customer’s pot.
    6. +
  6. The customer go and put loose goods into the labeled pot.
    7. +
  7. The cashier weighs the pot with loose goods inside. POS computes the price including the pot.
    8. +
  8. The cashier scans the tare barcode. POS get the pot weight from the barcode. POS subtracts the pot weight from the weight of the latest product. POS sets the billable price for the loose goods.
    9. +
  9. The customer pays.

This add-on adds a news screen to POS to print (web) the tare barcode labels. This add-on enables POS to read a tare barcode. Reading a barcode makes POS adjust the weight of the latest article in the order list. The new weight is equal to the total weight minus the tare weight. The price is updated accordingly to the weight change.

-

POS home screen is now: -.. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/POS_with_button.png

-

The label screen is: -.. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/null_weight.png

-

When we read a weight the impression button is enabled -.. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/ready_to_print.png

-

A barcode label looks like: -.. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/label.png

-

Zoom on the action widget: -.. image:: https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/zoom_action_widget.png

+

POS home screen is now:

+https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/POS_with_button.png +

The label screen is:

+https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/null_weight.png +

When we read a weight the impression button is enabled

+https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/ready_to_print.png +

A barcode label looks like:

+https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/label.png +

Zoom on the action widget:

+https://raw.githubusercontent.com/OCA/pos/9.0/pos_barcode_tare/static/description/zoom_action_widget.png

Table of contents

Usage

-

Install this add-on and configure the point of sale where you want to be able to use the tare barecode. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome).

+

Install this add-on and configure the point of sale where you want to be able to use the tare barecode. Setup the default barcode sequence ID according to your barcode nomenclature. The barcode pattern should be XX.....NNDDD where XX is the barcode prefix. In the default barcode nomenclature, the weight barcode pattern sequence id is 36 and its prefix is 21. The label printing is done using web print. To streamline the label printing it is advised to use the silent printing mode (firefox) or the kiosk printing (chrome).

+

The command line to start a chrome base browser in kiosk mode with silent printing looks like:

+

chromium-browser --use-system-default-printer --kiosk --kiosk-printing http://localhost:8069/

Known issues / Roadmap

@@ -435,6 +437,7 @@ If you spotted it first, help us smashing it by providing a detailed and welcome

Contributors