Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
api_zakaz [2020/03/05 20:28] timofeev |
api_zakaz [2024/09/26 17:19] (текущий) timofeev |
||
---|---|---|---|
Строка 3: | Строка 3: | ||
Пример: \\ | Пример: \\ | ||
<code> | <code> | ||
- | ip-адрес Водяного:10400/api?token=qwerty12345&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,Мир; | + | 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":"500", "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, "prdtkol":5},{"tovar":"stakan", "kolvo":100, "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":"500", "bonusspis":"110.12", | ||
+ | "prdtkol":10, | ||
+ | "sostav":[{"tovar":"АЛ19","kolvo":5, "prdtkol":5},{"tovar":"stakan", "kolvo":100, "tara":0}]}</code> | ||
здесь | здесь | ||
Строка 25: | Строка 36: | ||
smena - номер смены, указанный в поле "код во внешней системе" в справочнике смен в Водяном. Поле не обязательно.\\ | smena - номер смены, указанный в поле "код во внешней системе" в справочнике смен в Водяном. Поле не обязательно.\\ | ||
frmrastxt - наименование формы расчетов, будет указано как текстовый реквизит в предзаявке. Как правило, должно совпадать с названием одной из форм расчетов в справочнике либо содержать ключевые слова (карта,картой, visa, mastercard, мир). Поле не обязательно.\\ | frmrastxt - наименование формы расчетов, будет указано как текстовый реквизит в предзаявке. Как правило, должно совпадать с названием одной из форм расчетов в справочнике либо содержать ключевые слова (карта,картой, visa, mastercard, мир). Поле не обязательно.\\ | ||
+ | polplatkart- сумма платежа картой на сайте (обязательное поле, если требуется формирование документа "платеж картой" и чека на аванс). \\ | ||
+ | bonusspis - сумма платежа бонусными баллами (на указанную сумму будет сделана скидка в накладной).\\ | ||
sostav – состав заказа, массив с элементами, имеющими нижеследующие поля:\\ | sostav – состав заказа, массив с элементами, имеющими нижеследующие поля:\\ | ||
tovar – артикул товара во внешней системе/сайте (задается в справочнике товаров), например voda1; при отсутствии артикулов в базе проводится поиск по коду товара в Водяном (последние 6 цифр).\\ | tovar – артикул товара во внешней системе/сайте (задается в справочнике товаров), например voda1; при отсутствии артикулов в базе проводится поиск по коду товара в Водяном (последние 6 цифр).\\ | ||
+ | Примечание. Вместо товара можно передать код услуги в Водяном, добавив к нему USL впереди (например, "tovar":"USL1000000000001"). Другие варианты поиска для услуг недоступны.\\ | ||
kolvo – количество товара;\\ | kolvo – количество товара;\\ | ||
prdtkol – количество тары, покупаемой клиентом (для товаров в многооборотной таре);\\ | prdtkol – количество тары, покупаемой клиентом (для товаров в многооборотной таре);\\ | ||
Строка 36: | Строка 49: | ||
1 в случае приема заказа\\ | 1 в случае приема заказа\\ | ||
либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\ | либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\ | ||
+ | |||
+ | ВАЖНО: Предусмотрите на стороне сервера веб-сервера контроль ответа с повторной отправкой заказа в случае, если по какой-то причине отсутствует связь с сервером Водяного. Дублироваться заказы не будут, т.к. при загрузке проверяется наличие по номеру во внешней системе.\\ | ||
+ | |||
+ | По команде будут формироваться документы [[предв_заявки|"предварительная заявка".]]\\ | ||
+ | |||
+ | Для работы с API должен быть "проброшен" во внешнюю сеть порт 10400 сервера, где установлена база данных + установлен на этом сервере Водяной в режиме службы.\\ | ||
+ | |||
+ | [[api_otmenaz|Отмена заказа]] | ||
+ | |||
+ | [[api_statusz|Получение статуса заказа]] | ||
+ | |||
[[api|К списку команд API]] | [[api|К списку команд API]] | ||
+ | |||