на главную страницу программы "Водяной"

Инструменты пользователя

Инструменты сайта


api_zakaz

Прием заказа

Команда zakaz
Пример:

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":"500",  "bonusspis":"110.12",
"prdtkol":10,
"sostav":[{"tovar":"АЛ19","kolvo":5,  "prdtkol":5},{"tovar":"stakan", "kolvo":100, "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 – количество товара;
prdtkol – количество тары, покупаемой клиентом (для товаров в многооборотной таре);
zalogtkol - количество тары, за которую уплачивается залог.
Примечание. Поля prdtkol,zalogtkol должны быть заполнены в строке того товара, к таре которого они относятся.

Возможные ответы Водяного
1 в случае приема заказа
либо сообщение об ошибке, например: ERROR. There is no tag «sostav»

ВАЖНО: Предусмотрите на стороне сервера веб-сервера контроль ответа с повторной отправкой заказа в случае, если по какой-то причине отсутствует связь с сервером Водяного. Дублироваться заказы не будут, т.к. при загрузке проверяется наличие по номеру во внешней системе.

По команде будут формироваться документы "предварительная заявка".

Для работы с API должен быть «проброшен» во внешнюю сеть порт 10400 сервера, где установлена база данных + установлен на этом сервере Водяной в режиме службы.

Отмена заказа

Получение статуса заказа

К списку команд API

api_zakaz.txt · Последние изменения: 2023/06/29 10:36 — timofeev