api_zakaz
Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
api_zakaz [2020/03/05 20:23] 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 – количество тары, покупаемой клиентом (для товаров в многооборотной таре);\\ | ||
| - | zalogt - сумма залога;\\ | ||
| zalogtkol - количество тары, за которую уплачивается залог.\\ | zalogtkol - количество тары, за которую уплачивается залог.\\ | ||
| - | Примечание. Поля prdtkol,zalogt,zalogtkol должны быть заполнены в строке того товара, к таре которого они относятся.\\ | + | Примечание. Поля prdtkol,zalogtkol должны быть заполнены в строке того товара, к таре которого они относятся.\\ |
| Возможные ответы Водяного\\ | Возможные ответы Водяного\\ | ||
| 1 в случае приема заказа\\ | 1 в случае приема заказа\\ | ||
| либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\ | либо сообщение об ошибке, например: ERROR. There is no tag "sostav"\\ | ||
| + | |||
| + | ВАЖНО: Предусмотрите на стороне сервера веб-сервера контроль ответа с повторной отправкой заказа в случае, если по какой-то причине отсутствует связь с сервером Водяного. Дублироваться заказы не будут, т.к. при загрузке проверяется наличие по номеру во внешней системе.\\ | ||
| + | |||
| + | По команде будут формироваться документы [[предв_заявки|"предварительная заявка".]]\\ | ||
| + | |||
| + | Для работы с API должен быть "проброшен" во внешнюю сеть порт 10400 сервера, где установлена база данных + установлен на этом сервере Водяной в режиме службы.\\ | ||
| + | |||
| + | [[api_otmenaz|Отмена заказа]] | ||
| + | |||
| + | [[api_statusz|Получение статуса заказа]] | ||
| + | |||
| [[api|К списку команд API]] | [[api|К списку команд API]] | ||
| + | |||
api_zakaz.1583429028.txt.gz · Последние изменения: 2020/03/05 20:23 — timofeev
Инструменты страницы
