Forms (#892)

* avance de punto de venta

* puno de venta

docs/.vuepress/config.js

@@ -71,6 +71,11 @@ module.exports = {
               collapsable: false,
               children: genComponentSidebar()
             },
+            {
+              title: 'Forms',
+              collapsable: false,
+              children: genFormsSidebar()
+            },
             {
               title: 'Other',
               collapsable: false,
@@ -129,6 +134,11 @@ module.exports = {
               collapsable: false,
               children: genComponentSidebar('/es')
             },
+            {
+              title: 'Formularios',
+              collapsable: false,
+              children: genFormsSidebar('/es')
+            },
             {
               title: 'Otro',
               collapsable: false,
@@ -195,6 +205,11 @@ module.exports = {
               collapsable: false,
               children: genComponentSidebar()
             },
+            {
+              title: '形式',
+              collapsable: false,
+              children: genFormsSidebar()
+            },
             {
               title: '其它',
               collapsable: false,
@@ -300,9 +315,17 @@ function genComponentSidebar(type = '') {
     '/guide/components/change-role.md',
     '/guide/components/hide-menu.md',
     '/guide/components/references.md',
-    '/guide/components/lock-unlock-records.md'
+    '/guide/components/lock-unlock-records.md',
+    '/guide/forms/point-of-sales.md'
   ]
   return mapArr.map(i => {
     return type + i
   })
 }
+
+function genFormsSidebar(type = '') {
+  const mapArr = ['/guide/forms/point-of-sales.md']
+  return mapArr.map(i => {
+    return type + i
+  })
+}

docs/es/guide/forms/point-of-sales.md

@@ -0,0 +1,109 @@
+# Punto de Venta
+
+El formulario del punto de venta le permite a los vendedores tomar los pedidos de los clientes de manera rápida y eficiente. Durante el proceso, se puede visualizar el monto total de la orden, convertido en las diferentes monedas con las que trabaje la organización, para ello debe existir obligatoriamente una tasa de cambio previamente creada.
+
+## Crear Nueva Orden
+
+Se puede crear un nuevo registro de orden de venta al agregar un producto al formulario.
+
+<img :src="$withBase('/images/forms/point-of-sales/create-new-order.gif')" />
+
+De igual manera, se puede crear un nuevo registro seleccionando la opción "**Nueva Orden**", ubicada del lado derecho del campo "**Socio del Negocio**". Dicha opción se habilita cuando el usuario se encuentra posicionado en un registro de orden de venta, en el formulario "**Punto de Venta**".
+
+<img :src="$withBase('/images/forms/point-of-sales/option-create-new-order.png')" alt="Opción Crear Nueva Orden" width="800px">
+
+## Agregar Cliente a una Orden
+
+Para agregar un cliente a una orden de venta, se debe ingresar los datos del mismo en el campo "**Socio del Negocio**".
+
+<img :src="$withBase('/images/forms/point-of-sales/add-business-partner.gif')" />
+
+Adicionalmente, se puede crear un nuevo registro de un socio del negocio cliente, seleccionando el icono "**+**", ubicado en la parte superior del campo "**Socio del Negocio**".
+
+<img :src="$withBase('/images/forms/point-of-sales/create-business-partner.png')" alt="Crear Socio del Negocio" width="800px">
+
+## Agregar Producto a una Orden
+
+Los productos de la orden de venta, se pueden agregar a la misma de la siguiente manera:
+
+- Ingresando el código o nombre del producto en el campo "**Código de Producto**". Al ingresar un valor en dicho campo, ADempiere realiza la búsqueda de manera automática, mostrando los resultados debajo del campo.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-or-name.gif')" />
+
+- Seleccionando los productos en el catálogo de productos que se visualiza al seleccionar el icono "**<**", ubicado en la parte central derecha de la ventana del formulario "**Punto de Venta**".
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-catalog.gif')" />
+
+- Adicional a ello, se pueden agregar los productos con ayuda del lector de código de barras.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-reader.gif')" />
+
+## Líneas de la Orden
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.png')" alt="Líneas de la Orden de Venta" width="800px">
+
+La sección de las líneas de la orden contiene las siguientes seis (6) columnas que representan los campos principales del producto:
+
+- **Producto**: Nombre del producto cargado a la orden de venta.
+
+- **Precio**: Precio unitario del producto cargado a la orden de venta.
+
+- **Cantidad**: La cantidad del producto cargado a la orden de venta.
+
+- **% Descuento**: El porcentaje de descuento aplicado al precio del producto cargado a la orden de venta.
+
+- **Total**: El total de la línea del producto, según la cantidad ingresa.
+
+- **Opciones**: La columna se compone de tres (3) opciones que permiten al usuario realizar ciertas acciones
+
+  - La primera opción de izquierda a derecha, permite visualizar la infomación del producto
+
+  - La segunda opción de izquierda a derecha, permite modificar la cantidad, el precio y el porcentaje de descuento del producto.
+
+  - La tercera opción de izquierda a derecha, permite eliminar el registro de la línea de la orden de venta.
+
+    <img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.gif')" />
+
+## Información de la Orden
+
+La información de la orden de venta se encuentra ubicada en la parte inferior derecha del formulario. La misma se compone de los siguientes campos:
+
+- **Orden**: Indica el número de documento de la orden de venta.
+
+- **Vendedor**: Indica el nombre del agente comercial (vendedor) que se encuentra realizando la orden de venta.
+
+- **Fecha**: Indica la fecha de la orden de venta.
+
+- **Sub-Total**: Indica el monto total de la orden sin impuestos.
+
+- **Tipo**: Indica el tipo de documento con el cual se esta generando la orden de venta.
+
+- **Descuento**: Indica el monto total del descuento aplicado a la orden.
+
+- **Cantidad de Árticulo**: Indica la cantidad total de los árticulos que posee la orden de venta.
+
+- **Impuesto**: Indica el monto total del impuesto aplicado a la orden.
+
+- **Cantidad de Líneas**: Indica la cantidad total de líneas de productos que posee la orden de venta.
+
+- **Total**: Indica el monto total de la orden con descuento e impuestos.
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-information.png')" alt="Información de la Orden de Venta" width="800px">
+
+## Opciones del Punto de Venta
+
+Para posicionarse en cualquier línea de producto de la orden que se encuentra realizando, puede hacer clic sobre la misma o seleccionar los iconos de "**Posicionamiento**" ubicados en la parte inferior izquierda del formulario "**Punto de Venta**". Donde el primer icono permite posicionarse en el "**Registro Anterior**", y el segundo icono permite posicionarse en el "**Registro Siguiente**".
+
+<img :src="$withBase('/images/forms/point-of-sales/position-yourself-on-the-order-lines.gif')" />
+
+De igual manera, puede eliminar el registro del producto donde se encuentra posicionado, seleccionando el icono "**Eliminar**" ubicado en la parte inferior izquierda del formulario "**Punto de Venta**".
+
+<img :src="$withBase('/images/forms/point-of-sales/remove-the-order-line.gif')" />
+
+Seleccione el icono "**Cobrar**", para realizar el cobro de la orden de venta que se encuentra realizando.
+
+<img :src="$withBase('/images/forms/point-of-sales/collect-the-order.gif')" />
+
+Para cambiar de terminal PDV en el formulario del punto de venta, seleccione la opción "**Punto de Venta**" ubicada en la parte inferior izquierda del formulario. Luego, seleccione el terminal PDV con el que requiere realizar las operaciones de venta.
+
+<img :src="$withBase('/images/forms/point-of-sales/change-point-of-sale-terminal.gif')" />

docs/guide/forms/point-of-sales.md

@@ -0,0 +1,109 @@
+# Point of sale
+
+The point of sale form allows salespeople to take customer orders quickly and efficiently. During the process, the total amount of the order can be viewed, converted into the different currencies with which the organization works, for this there must necessarily be a previously created exchange rate.
+
+## Create New Order
+
+A new sales order record can be created by adding a product to the form.
+
+<img :src="$withBase('/images/forms/point-of-sales/create-new-order.gif')" />
+
+Similarly, a new record can be created by selecting the option "**New Order**", located on the right side of the "**Business Partner**" field. This option is enabled when the user is positioned in a sales order record, in the form "**Point of Sale**".
+
+<img :src="$withBase('/images/forms/point-of-sales/option-create-new-order.png')" alt="Create New Order Option" width="800px">
+
+## Add Customer to an Order
+
+To add a customer to a sales order, the customer's data must be entered in the "**Business Partner**" field.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-business-partner.gif')" />
+
+Additionally, a new record of a client business partner can be created by selecting the "**+**" icon, located at the top of the "**Business Partner**" field.
+
+<img :src="$withBase('/images/forms/point-of-sales/create-business-partner.png')" alt="Create Business Partner" width="800px">
+
+## Add Product to an Order
+
+The products of the sales order can be added to it as follows:
+
+- Entering the code or name of the product in the field "**Product Code**". When entering a value in this field, ADempiere performs the search automatically, displaying the results below the field.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-or-name.gif')" />
+
+- Selecting the products in the product catalog that is displayed by selecting the "**<**" icon, located in the central right part of the "**Point of Sale**" form window.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-catalog.gif')" />
+
+- In addition to this, the products can be added with the help of the barcode reader.
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-reader.gif')" />
+
+## Order Lines
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.png')" alt="Sales Order Lines" width="800px">
+
+The order lines section contains the following six (6) columns that represent the main fields of the product:
+
+- **Product**: Name of the product loaded to the sales order.
+
+- **Price**: Unit price of the product charged to the sales order.
+
+- **Quantity**: The quantity of the product loaded to the sales order.
+
+- **% Discount**: The discount percentage applied to the price of the product charged to the sales order.
+
+- **Total**: The total of the product line, according to the amount entered.
+
+- **Options**: The column consists of three (3) options that allow the user to perform certain actions
+
+  - The first option from left to right, allows you to view the product information
+
+  - The second option from left to right, allows you to modify the quantity, price and discount percentage of the product.
+
+  - The third option from left to right, allows you to delete the record of the sales order line.
+
+    <img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.gif')" />
+
+## Order Information
+
+The information of the sales order is located in the lower right part of the form. It is made up of the following fields:
+
+- **Order**: Indicates the document number of the sales order.
+
+- **Seller**: Indicates the name of the commercial agent (seller) who is placing the sale order.
+
+- **Date**: Indicates the date of the sale order.
+
+- **Sub-Total**: Indicates the total amount of the order without taxes.
+
+- **Type**: Indicates the type of document with which the sales order is being generated.
+
+- **Discount**: Indicates the total amount of the discount applied to the order.
+
+- **Item Quantity**: Indicates the total quantity of items that the sales order has.
+
+- **Tax**: Indicates the total amount of tax applied to the order.
+
+- **Number of Lines**: Indicates the total number of product lines that the sales order has.
+
+- **Total**: Indicates the total amount of the order with discount and taxes.
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-information.png')" alt="Sales Order Information" width="800px">
+
+## Point of Sale Options
+
+To position yourself in any product line of the order you are placing, you can click on it or select the "**Positioning**" icons located at the bottom left of the "**Point of Sale**" form. . Where the first icon allows positioning in the "**Previous Record**", and the second icon allows positioning in the "**Next Record**".
+
+<img :src="$withBase('/images/forms/point-of-sales/position-yourself-on-the-order-lines.gif')" />
+
+In the same way, you can delete the product record where it is located, by selecting the "**Delete**" icon located at the bottom left of the "**Point of Sale**" form.
+
+<img :src="$withBase('/images/forms/point-of-sales/remove-the-order-line.gif')" />
+
+Select the icon "**Charge**", to collect the sales order that you are carrying out.
+
+<img :src="$withBase('/images/forms/point-of-sales/collect-the-order.gif')" />
+
+To change the POS terminal in the point of sale form, select the option "**Point of Sale**" located at the bottom left of the form. Then, select the POS terminal with which you need to carry out the sales operations.
+
+<img :src="$withBase('/images/forms/point-of-sales/change-point-of-sale-terminal.gif')" />

docs/zh/guide/forms/point-of-sales.md

@@ -0,0 +1,109 @@
+# 銷售點
+
+銷售點表單使銷售人員可以快速而有效地接管客戶訂單。在此過程中，可以查看訂單的總金額，並將其轉換為組織工作所用的不同貨幣，為此必須有一個預先創建的匯率。
+
+## 創建新訂單
+
+可以通過將產品添加到表單來創建新的銷售訂單記錄。
+
+<img :src="$withBase('/images/forms/point-of-sales/create-new-order.gif')" />
+
+同樣，可以通過選擇位於 "**業務夥伴**" 字段右側的選項 "**新訂單**" 來創建新記錄。當用戶以 "**銷售點**" 的形式位於銷售訂單記錄中時，將啟用此選項。
+
+<img :src="$withBase('/images/forms/point-of-sales/option-create-new-order.png')" alt="創建新訂單選項" width="800px">
+
+## 將客戶添加到訂單
+
+要將客戶添加到銷售訂單中，必須在 "**業務夥伴**" 字段中輸入客戶的數據。
+
+<img :src="$withBase('/images/forms/point-of-sales/add-business-partner.gif')" />
+
+此外，可以通過選擇位於 "**業務夥伴**" 字段頂部的 "**+**" 圖標來創建客戶業務夥伴的新記錄。
+
+<img :src="$withBase('/images/forms/point-of-sales/create-business-partner.png')" alt="創建業務夥伴" width =" 800px">
+
+## 將產品添加到訂單
+
+可以按以下方式將銷售訂單的產品添加到其中：
+
+- 在 "**產品代碼**" 字段中輸入產品的代碼或名稱。在此字段中輸入值時，ADempiere 會自動執行搜索，並在該字段下方顯示結果。
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-or-name.gif')" />
+
+- 在產品目錄中選擇 "**<**" 圖標，選擇位於 "**銷售點**" 窗體窗口右中角的產品。
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-catalog.gif')" />
+
+- 除此之外，可以在條形碼閱讀器的幫助下添加產品。
+
+<img :src="$withBase('/images/forms/point-of-sales/add-product-with-code-reader.gif')" />
+
+## 訂單行
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.png')" alt="銷售訂單行" width =" 800px">
+
+訂單行部分包含以下六（6）列，它們代表產品的主要字段：
+
+- **產品**：加載到銷售訂單中的產品的名稱。
+
+- **價格**：從銷售訂單中扣除的產品單價。
+
+- **數量**：加載到銷售訂單中的產品數量。
+
+- **％折扣**：折扣百分比應用於銷售訂單中收取的產品價格。
+
+- **總計**：根據輸入的數量，產品線的總計。
+
+- **選項**：該列由三（3）個選項組成，這些選項允許用戶執行某些操作
+
+  - 從左到右的第一個選項，可讓您查看產品信息
+
+  - 從左到右的第二個選項，允許您修改產品的數量，價格和折扣百分比。
+
+  - 第三個選項從左到右，可讓您刪除銷售訂單行的記錄。
+
+    <img :src="$withBase('/images/forms/point-of-sales/sales-order-lines.gif')" />
+
+## 訂單信息
+
+銷售訂單的信息位於表格的右下方。它由以下字段組成：
+
+- **訂單**：表示銷售訂單的憑證編號。
+
+- **賣方**：表示下達銷售訂單的商業代理商（賣方）的名稱。
+
+- **日期**：表示銷售訂單的日期。
+
+- **小計**：表示不含稅的訂單總額。
+
+- **類型**：指示用於生成銷售訂單的單據類型。
+
+- **折扣**：表示應用於訂單的折扣總額。
+
+- **項目數量**：表示銷售訂單具有的項目總數。
+
+- **稅**：表示應用於訂單的稅金總額。
+
+- **行數**：表示銷售訂單具有的產品線總數。
+
+- **總計**：表示包含折扣和稅金的訂單總額。
+
+<img :src="$withBase('/images/forms/point-of-sales/sales-order-information.png')" alt="銷售訂單信息" width =" 800px">
+
+## 銷售點選項
+
+要將您自己放置在所下訂單的任何產品系列中，您可以單擊它或選擇位於 "**銷售點**" 表格左下方的 "**定位**" 圖標。 。第一個圖標允許定位在 "**上一個記錄**" 中，第二個圖標允許定位在 "**下一個記錄**" 中。
+
+<img :src="$withBase('/images/forms/point-of-sales/position-yourself-on-the-order-lines.gif')" />
+
+同樣，您可以通過選擇位於 "**銷售點**" 表格左下方的 "**刪除**" 圖標來刪除其所在的產品記錄。
+
+<img :src="$withBase('/images/forms/point-of-sales/remove-the-order-line.gif')" />
+
+選擇圖標 "**收費**"，以收集您正在執行的銷售訂單。
+
+<img :src="$withBase('/images/forms/point-of-sales/collect-the-order.gif')" />
+
+要在銷售點表格中更改 POS 終端，請選擇位於表格左下方的 "**銷售點**" 選項。然後，選擇您需要用來執行銷售操作的 POS 終端。
+
+<img :src="$withBase('/images/forms/point-of-sales/change-point-of-sale-terminal.gif')" />