===Прием заказа===
Команда zakaz\\
Пример: \\
GET http://127.0.0.1:10400/api?action=zakaz¶m={"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}]}
В версиях Водяного выше 530 возможно (и предопочтительнее) отправлять POST запрос со значением тега param, не указывая его в запросе.
POST http://127.0.0.1:10400/api?action=zakaz
Тело POST:\\
{"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}]}
здесь
nzak - номер заказа на сайте/во внешней системе;\\
opla4en – признак предоплаты заказа во внешней системе (1 — предоплачен картой; 0 — оплата при поставке)\\
telefon– телефон клиента, например, 79991234567\\
email — эл. почта клиента, например, test@test.ru. Поле не обязательно.\\
nomer_karty - номер карты клиента (поле «Карта (или код) клиента»), обычно совпадает с последними значащими цифрами кода; Поле не обязательно;\\
klient – ФИО/наименование клиента. Поле не обязательно, в случае отсутствия будет составлено из названия улицы, номера дома и квартиры;\\
gorod - наименование города; Поле не обязательно, в случае отсутствия будет использован город по умолчанию;\\
ulica – наименование улицы;\\
dom – номер дома;\\
korpus – корпус, 0 в случае отсутствия;\\
kv – номер квартиры, 0 в случае отсутствия номера.\\
dop_sv — дополнительная информация;\\
comment - комментарий (попадет в соответствующее поле заявки и накладной);\\
vrem - желаемое время доставки (строка). Поле не обязательно.\\
datasob - дата, на которую клиент делает заказ (в формате дд.мм.гггг). Поле не обязательно.\\
smena - номер смены, указанный в поле "код во внешней системе" в справочнике смен в Водяном. Поле не обязательно.\\
frmrastxt - наименование формы расчетов, будет указано как текстовый реквизит в предзаявке. Как правило, должно совпадать с названием одной из форм расчетов в справочнике либо содержать ключевые слова (карта,картой, visa, mastercard, мир). Поле не обязательно.\\
polplatkart- сумма платежа картой на сайте (обязательное поле, если требуется формирование документа "платеж картой" и чека на аванс). \\
bonusspis - сумма платежа бонусными баллами (на указанную сумму будет сделана скидка в накладной).\\
sostav – состав заказа, массив с элементами, имеющими нижеследующие поля:\\
tovar – артикул товара во внешней системе/сайте (задается в справочнике товаров), например voda1; при отсутствии артикулов в базе проводится поиск по коду товара в Водяном (последние 6 цифр).\\
Примечание. Вместо товара можно передать код услуги в Водяном, добавив к нему USL впереди (например, "tovar":"USL1000000000001"). Другие варианты поиска для услуг недоступны.\\
kolvo – количество товара;\\
summa - общая стоимость товара;\\
prdtkol – количество тары, покупаемой клиентом (для товаров в многооборотной таре);\\
zalogtkol - количество тары, за которую уплачивается залог.\\
Примечание. Поля prdtkol,zalogtkol должны быть заполнены в строке того товара, к таре которого они относятся.\\
Возможные ответы Водяного\\
1 в случае приема заказа\\
либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\
ВАЖНО: Предусмотрите на стороне сервера веб-сервера контроль ответа с повторной отправкой заказа в случае, если по какой-то причине отсутствует связь с сервером Водяного. Дублироваться заказы не будут, т.к. при загрузке проверяется наличие по номеру во внешней системе.\\
По команде будут формироваться документы [[предв_заявки|"предварительная заявка".]]\\
Для работы с API должен быть "проброшен" во внешнюю сеть порт 10400 сервера, где установлена база данных + установлен на этом сервере Водяной в режиме службы.\\
[[api_otmenaz|Отмена заказа]]
[[api_statusz|Получение статуса заказа]]
[[api|К списку команд API]]
[[приложение_для_заказа|Приложение для заказа воды]]