Различия

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

--- ru:serialnum [2023/10/24 21:20]
support создано
+++ ru:serialnum [2023/10/25 21:54]
support
@@ Строка 5: / Строка 5: @@
 ====== Как указать, что на товар необходимо добавить серийный номер? ======
->Перейдите на карточку товара. В разделе 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|}}
@@ Строка 19: / Строка 19: @@
 ----
->Чтобы указать определенный серийный номер товара для отправки в заказе, перейдите в соответствующий заказ и добавьте товар, кликнув на кнопку "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