Differences

This shows you the differences between two versions of the page.

--- en:serialnum [2023/10/24 21:30]
support created
+++ en:serialnum [2023/11/17 09:46] (current)
simon
@@ Line 1: / Line 1: @@
 ====== Serial Numbers ======
->Serial numbers for products are an additional feature that provides the ability for more in-depth tracking and control of specific items. Entering serial numbers is not mandatory for all products; it is applied only to items that have specified serial numbers. This feature enables precise tracking of product movement, which is particularly useful for high-value, technically complex, or unique items. If necessary, serial numbers can be added during the product receiving stage, allowing easy identification during order consolidation and enhancing overall inventory management transparency.
+> Serial numbers for products are an additional feature available as part of the **report** and **API** subscription that provides the ability to track and control specific products in more detail. It is important to note that the entry of serial numbers is not mandatory for all products, but only for products where the customer has specified mandatory serial number tracking in the product card. This feature enables accurate tracking of product movements, which is particularly useful in accounting for high value, technically complex or unique products. If required, serial numbers can be added at goods receipt, making them easy to identify during order consolidation and increasing the overall transparency of inventory management.
-====== Как указать, что на товар необходимо добавить серийный номер? ======
->Перейдите на карточку товара. В разделе **Others** укажите атрибут **Yes** в строке **Serial Number**. Таким образом, вы сообщите системе, что при постановке товара на хранение складом необходимо будет внести уникальный серийный номер для каждой единицы товара.
+====== How can you indicate that a product requires a serial number? ======
+>Go to the product card. In the **Others** section, set the attribute **Yes** for the **Serial Number** field. In this way, you instruct the system that each unit of the product must be assigned a unique serial number when the product is stored in the warehouse.
 >>{{:ru:serialnumbers_1.png?800|}} {{:ru:serialnumbers_2.png?372|}}
 ----
->Для проверки наличия товара с определенными серийными номерами, перейдите в раздел **Warehouse** на странице карточки товара. В колонке **Serial number** будут перечислены все доступные серийные номера данного товара. Здесь вы сможете легко убедиться в наличии именно тех товаров, которые вам нужны.
+> To check the availability of products with specific serial numbers, go to the **Warehouse** section on the product card page. All available serial numbers for this product are listed in the "Serial number" column. Here you can easily check the availability of the items you need.
 >>{{:ru:serialnum_3.png?600|}} {{:ru:serialnum_4.png?600|}}
-====== Указание серийного номера товара к отправке в заказе ======
+----
->Ysell.pro предоставляет возможность назначать конкретные серийные номера товаров при отправке заказов. Это позволяет контролировать что каждый отправленный товар соответствует запрошенному серийному номеру. Таким образом, мы гарантируем высокий уровень точности в процессе выполнения заказов.
+> The serial numbers are also displayed in the general list of products in the system. Navigate to the **Warehouse** section, then go to the **Warehouse Products** tab and perform a search by product attribute or specific stock. The **Serial Num** column displays the serial number of the product that is in the Prep Center warehouse.
+>>{{:ru:serialwh_1.png?600|}} {{:ru:serialwh_2.png?600|}}
+====== Assignment of serial numbers to articles in orders ======
+> Ysell.pro allows you to assign specific serial numbers to items during order processing. This feature ensures that each item shipped matches the requested serial number and guarantees a high degree of accuracy in order processing.
 ----
->Чтобы указать определенный серийный номер товара для отправки в заказе, перейдите в соответствующий заказ и добавьте товар, кликнув на кнопку **Add product** в разделе **Order Content**. Затем, в открывшемся окне выполните поиск необходимого товара. В поле **Serial Number** выберите нужный для отправки серийный номер из выпадающего списка. Этот шаг обеспечивает точность и уверенность в том, что каждый товар в заказе будет отправлен с требуемым серийным номером.
+>To specify a particular serial number for a product in your order, go to the relevant order and add the item by clicking the **Add Product** button in the **Order Contents** section. Then search for the desired product in the pop-up window. In the **Serial Number** field, select the serial number you wish to use for shipping from the drop-down list. This step ensures that each item in the order is shipped with the required serial number.
 >>{{:ru:serialnumber_5.png?800|}} {{:ru:serialnum_7.png?400|}}
+====== Working with serial numbers via API ======
+> Working with serial numbers via API ensures automation, accuracy and data security management. This enables improved efficiency in business processes and ensures reliable tracking of goods.
+===== Specification of a serial number when adding/changing an item in the order =====
+>Use the following cURL command to create an order item and specify a serial number..:
+<WRAP CEnTER box 60%>
+curl -X 'POST' \
+  'https://Address of your website ysell.pro/api/v1/order-item' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer Authorization_Token' \
+  -d '{
+    "order_id": "ORDER_ID",
+    "product_id": "PRODUCT_ID",
+    "quantity": PRODUCT_QTY,
+    "serial_num": "SERIAL_NUMBER"
+  }'
+</WRAP>
+> **POST** indicates that you are creating a new object (in this case, a new order item).
+> **Headers** include accept and **Content-Type** to specify the data format, and **Authorization** for authentication using your token.
+> **Body** contains the data you send in the request. In this case, you specify the **order_id** (order ID), **product_id** (product ID), **quantity** (quantity of the product), and **serial_num** (serial number of the product).
+> This request will create a new order item with the specified serial number for the product.
+===== Request product serial numbers via API =====
+> Use the API to retrieve serial numbers that are currently in stock for a specific product to ensure accurate inventory tracking and control and fulfill customer orders with the desired item.
+> This cURL request is a GET request used to retrieve data from the specified endpoint.
+> This command sends a GET request to the specified API endpoint and retrieves product serial number data: https://yourwebsiteaddress.ysell.pro/api/v1/product/ExtID/serial-numbers.