Различия

Показаны различия между двумя версиями страницы.

--- ru:serialnum [2023/10/24 21:20]
support создано
+++ ru:serialnum [2023/11/15 08:53] (текущий)
artem
@@ Строка 1: / Строка 1: @@
 ====== Серийные номера товара ======
->Серийные номера товаров – это дополнительная функция, предоставляющая возможность более глубокого учета и контроля за определенными продуктами. Внесение серийных номеров не является обязательным для всех товаров. Оно применяется только к товарам, на которых указано наличие серийных номеров. Эта функция обеспечивает возможность точного отслеживания движения товаров, что особенно полезно при учете высокоценных, технически сложных или уникальных товаров. При необходимости можно внести серийные номера на этапе приема товара, что позволяет легко идентифицировать их при консолидации заказов и повышает общую прозрачность управления запасами.
+>Серийные номера товаров – это дополнительная функция, доступная подписочном плане **Report и API**, предоставляющая возможность более глубокого учета и контроля за определенными продуктами. Важно отметить, что внесение серийных номеров не является обязательным для всех товаров, а применяется только к товарам, в карточке товаров которых клиент отметил обязательный учет серийных номеров. Эта функция обеспечивает возможность точного отслеживания движения товаров, что особенно полезно при учете высокоценных, технически сложных или уникальных товаров. При необходимости можно внести серийные номера на этапе приема товара, что позволяет легко идентифицировать их при консолидации заказов и повышает общую прозрачность управления запасами.
 ====== Как указать, что на товар необходимо добавить серийный номер? ======
->Перейдите на карточку товара. В разделе Others укажите атрибут Yes в строке Serial Number. Таким образом, вы сообщите системе, что при постановке товара на хранение складом необходимо будет внести уникальный серийный номер для каждой единицы товара.
+>Перейдите на карточку товара. В разделе **Others** укажите атрибут **Yes** в строке **Serial Number**. Таким образом, вы сообщите системе, что при постановке товара на хранение складом необходимо будет внести уникальный серийный номер для каждой единицы товара.
 >>{{:ru:serialnumbers_1.png?800|}} {{:ru:serialnumbers_2.png?372|}}
 ----
->Для того чтобы проверить информацию по находящимся серийным номерам товара в наличии, перейдите в раздел **Warehouse** на карточке товара. В колонке **Serial number** будут отображены серийные номера товара.
+>Для проверки наличия товара с определенными серийными номерами, перейдите в раздел **Warehouse** на странице карточки товара. В колонке **Serial number** будут перечислены все доступные серийные номера данного товара. Здесь вы сможете легко убедиться в наличии именно тех товаров, которые вам нужны.
 >>{{:ru:serialnum_3.png?600|}} {{:ru:serialnum_4.png?600|}}
+----
+>>Серийные номера также отображаются в общем списке продуктов в системе. Перейдите в раздел меню **Warehouse** на вкладку **Warehouse Products** и произведите поиск по атрибутам товаров, либо по конкретному складу. В столбце **Serial Num** будет отображается серийный номер товара, находящегося на складе Преп центре.
+>>{{:ru:serialwh_1.png?600|}} {{:ru:serialwh_2.png?600|}}
 ====== Указание серийного номера товара к отправке в заказе ======
@@ Строка 19: / Строка 24: @@
 ----
->Чтобы указать определенный серийный номер товара для отправки в заказе, перейдите в соответствующий заказ и добавьте товар, кликнув на кнопку "Add" в разделе "Order Content". Затем, в открывшемся окне выполните поиск необходимого товара. В поле "Serial Number" выберите нужный для отправки серийный номер из выпадающего списка. Этот шаг обеспечивает точность и уверенность в том, что каждый товар в заказе будет отправлен с требуемым серийным номером.
+>Чтобы указать определенный серийный номер товара для отправки в заказе, перейдите в соответствующий заказ и добавьте товар, кликнув на кнопку **Add product** в разделе **Order Content**. Затем, в открывшемся окне выполните поиск необходимого товара. В поле **Serial Number** выберите нужный для отправки серийный номер из выпадающего списка. Этот шаг обеспечивает точность и уверенность в том, что каждый товар в заказе будет отправлен с требуемым серийным номером.
->>{{:ru:serialnumber_5.png?600|}} {{:ru:serialnumber_6.png?600|}}
+>>{{:ru:serialnumber_5.png?800|}} {{:ru:serialnum_7.png?400|}}
+----
+====== Работа с серийными номерами через API ======
+>Работа с серийными номерами через API обеспечивает автоматизацию, точность и безопасность управления данными. Это позволяет улучшить эффективность бизнес-процессов и обеспечить надежное отслеживание товаров.
+===== Указание серийного номера при добавлении/изменении позиции в заказе =====
+>Используйте следующую команду cURL для создания позиции в заказе и указания серийного номера:
+<WRAP CEnTER box 60%>
+curl -X 'POST' \
+  'https://адрес вашего сайта ysell.pro/api/v1/order-item' \
+  -H 'accept: application/json' \
+  -H 'Content-Type: application/json' \
+  -H 'Authorization: Bearer ВАШ_ТОКЕН_АВТОРИЗАЦИИ' \
+  -d '{
+    "order_id": "ID_ЗАКАЗА",
+    "product_id": "ID_ПРОДУКТА",
+    "quantity": КОЛИЧЕСТВО_ТОВАРА,
+    "serial_num": "СЕРИЙНЫЙ_НОМЕР_ТОВАРА"
+  }'
+</WRAP>
+>**POST** указывает на то, что вы создаете новый объект (в данном случае, новую позицию в заказе).
+>**Headers** включают accept и **Content-Type** для указания формата данных и **Authorization** для авторизации с использованием вашего токена.
+>**Body** содержит данные, которые вы отправляете в запросе. В данном случае вы указываете //order_id// (ID заказа), **product_id** (ID продукта), **quantity** (количество товара) и **serial_num** (серийный номер товара).
+>Этот запрос создаст новую позицию в заказе с указанным серийным номером товара.
+===== Получение серийных номеров товара через API =====
+>Через API можно вернуть серийные номера, находящиеся на складе для конкретного продукта, чтобы точно отслеживать инвентаризацию, контролировать запасы, и обеспечивать клиентов нужными товарами.
+>Этот запрос cURL является GET запросом, используемым для получения данных из указанной конечной точки.
+>Эта команда отправит GET-запрос на указанную конечную точку API и извлечет данные, связанные с серийными номерами продукта https://адрес вашего сайта ysell.pro/api/v1/product/ExtID товара/serial-numbers