Различия

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

--- api_zakaz [2020/03/05 17:28] – timofeev
+++ api_zakaz [2025/08/06 10:20] (текущий) – timofeev
@@ Строка 3: / Строка 3: @@
 Пример: \\
 <code>
-ip-адрес Водяного:10400/api?token=qwerty12345&action=zakaz&param={nzak:123; opla4en:1; telefon:79991234567; email :info@test123.ru;  klient: Сидоров И.П.;  nomer_karty:322356; gorod:Ростов-на-Дону; ulica: Научная; dom:36; korpus:0; kv:20; dop_sv:2 эт.; comment: Оставить соседям;  vrem:после 12; datasob:04.02.2020; smena:1;frmrastxt:карта Visa,Mastercard,Мир;
+GET http://127.0.0.1:10400/api?action=zakaz&param={"nzak":"123", "opla4en":"1","telefon":"79991234567", "email" :"info@test123.ru", "klient": "Сидоров И.П.", "nomer_karty":"322356","gorod":"Ростов-на-Дону", "ulica": "Научная", "dom":"36", "korpus":"0", "kv":"20", "dop_sv":"2 эт.", "comment": "Оставить соседям", "vrem":"после 12", "datasob":"04.02.2020", "smena":"1","frmrastxt":"карта Visa,Mastercard,Мир", "polplatkart":650.00,  "bonusspis":"110.12",
-sostav={tovar:voda1; kolvo:5; tara:4; prdtkol:5}; {tovar:stakan; kolvo:100; tara:0}}}
+"prdtkol":10,
-</code>
+"sostav":[{"tovar":"АЛ19","kolvo":5, summa:500.00, "prdtkol":5},{"tovar":"stakan", "kolvo":100, "summa":150.00  ,"tara":0}]}</code>
+В версиях Водяного выше 530 возможно (и предопочтительнее) отправлять POST запрос со значением тега param, не указывая его в запросе.
+<code>
+POST http://127.0.0.1:10400/api?action=zakaz</code>
+Тело POST:\\
+<code>
+{"nzak":"123", "opla4en":"1","telefon":"79991234567", "email" :"info@test123.ru", "klient": "Сидоров И.П.", "nomer_karty":"322356","gorod":"Ростов-на-Дону", "ulica": "Научная", "dom":"36", "korpus":"0", "kv":"20", "dop_sv":"2 эт.", "comment": "Оставить соседям", "vrem":"после 12", "datasob":"04.02.2020", "smena":"1","frmrastxt":"карта Visa,Mastercard,Мир", "polplatkart":650.00,  "bonusspis":"110.12",
+"prdtkol":10,
+"sostav":[{"tovar":"АЛ19","kolvo":5, summa:500.00, "prdtkol":5},{"tovar":"stakan", "kolvo":100, "summa":150.00  ,"tara":0}]}</code>
 здесь
@@ Строка 25: / Строка 36: @@
 smena - номер смены, указанный в поле "код во внешней системе" в справочнике смен в Водяном. Поле не обязательно.\\
 frmrastxt - наименование формы расчетов, будет указано как текстовый реквизит в предзаявке. Как правило, должно совпадать с названием одной из форм расчетов в справочнике либо содержать ключевые слова (карта,картой, visa, mastercard, мир). Поле не обязательно.\\
+polplatkart- сумма платежа картой на сайте (обязательное поле, если требуется формирование документа "платеж картой" и чека на аванс). \\
+bonusspis - сумма платежа бонусными баллами (на указанную сумму будет сделана скидка в накладной).\\
 sostav – состав заказа, массив с элементами, имеющими нижеследующие поля:\\
 tovar – артикул товара во внешней системе/сайте (задается в справочнике товаров), например  voda1; при отсутствии артикулов в базе проводится поиск по коду товара в Водяном (последние 6 цифр).\\
+Примечание. Вместо товара можно передать код услуги в Водяном, добавив к нему USL впереди (например, "tovar":"USL1000000000001"). Другие варианты поиска для услуг недоступны.\\
 kolvo – количество товара;\\
+summa - общая стоимость товара;\\
 prdtkol – количество тары, покупаемой клиентом (для товаров в многооборотной таре);\\
 zalogtkol - количество тары, за которую уплачивается залог.\\
@@ Строка 36: / Строка 50: @@
   в случае приема заказа\\
 либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\
+ВАЖНО: Предусмотрите на стороне сервера веб-сервера контроль ответа с повторной отправкой заказа в случае, если по какой-то причине отсутствует связь с сервером Водяного. Дублироваться заказы не будут, т.к. при загрузке проверяется наличие по номеру во внешней системе.\\
+По команде будут формироваться документы [[предв_заявки|"предварительная заявка".]]\\
+Для работы с API должен быть "проброшен" во внешнюю сеть порт 10400 сервера, где установлена база данных + установлен на этом сервере Водяной в режиме службы.\\
+[[api_otmenaz|Отмена заказа]]
+[[api_statusz|Получение статуса заказа]]
 [[api|К списку команд API]]
+[[приложение_для_заказа|Приложение для заказа воды]]