Различия

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

--- evotor:billonline:rest [2017/08/30 13:12] – [Получение информации об оплате] kuld
+++ evotor:billonline:rest [2021/04/16 10:09] (текущий) – [Получение информации об оплате] kuld
@@ Строка 5: / Строка 5: @@
 Используется для проверки соединения, получения наименования учетной системы и версии протокола.
-^ Метод ^ Путь ^ Параметры ^ Ответ ^
+^Метод^Путь^Параметры^Ответ|
-| GET | /hello | Нет | JSON |
+|GET|/hello|Нет|JSON|
 Возвращает JSON объект вида
 <code JavaScript>
-{
+ { "system" : "1С:Бухгалтерия", "protocol" : "0.1.0" }
-"system" : "1С:Бухгалтерия",
-"version" : "0.1.0"
-}
 </code>
 ===== Запрос списка счетов =====
@@ Строка 33: / Строка 31: @@
 <code JavaScript>
 [
-	{
+    {
-		"number": "УТ-27",
+        "number": "4",
-		"date": "31.01.2017",
+        "date": "07.04.2021",
-		"id": "a5b3b78d-e78b-11e6-80c9-00259032bcdb",
+        "id": "82f7ca8c-9777-11eb-1a9f-40b076d9cfed",
-		"customername": "ООО \"КЛИН-ЛАЙФ\"",
+        "customername": "МП \"ЯМАЛЬСКИЕ ОЛЕНИ\"",
-		"summ": 24941.73
+        "summ": 6
-	},
+    },
-	{
+    {
-		"number": "УТ-30",
+        "number": "5",
-		"date": "02.02.2017",
+        "date": "07.04.2021",
-		"id": "71d9bc6b-e940-11e6-80c9-00259032bcdb",
+        "id": "6f7b76c4-97b4-11eb-1a9f-40b076d9cfed",
-		"customername": "ООО \"КЛИН-ЛАЙФ\"",
+        "customername": "МП \"ЯМАЛЬСКИЕ ОЛЕНИ\"",
-		"summ": 1567.98
+        "summ": 1
-	},
+    },
-	{
+    {
-		"number": "1",
+        "number": "3",
-		"date": "09.08.2017",
+        "date": "20.08.2020",
-		"id": "6cd4b353-7d39-11e7-bed6-5453ed3ab335",
+        "id": "6b1d384a-e2c1-11ea-8c9b-40b076d9cfed",
-		"customername": "ООО \"ЛИНЕРИС\"",
+        "customername": "МП \"ЯМАЛЬСКИЕ ОЛЕНИ\"",
-		"summ": 1359.28
+        "summ": 840
-	}
+    }
 ]
 </code>
@@ Строка 66: / Строка 64: @@
 | GET | /bill/byid/<ID> | Нет | JSON |
-Ищет счет по ''<ID>'', ранее полученному из списка счетов. Возвращает объект JSON с данными счета или пустой объект JSON.
+Возвращает объект JSON с данными счета по указанному ''<ID>'', или пустой объект JSON, если счета с таким ''<ID>'' не найдено.
 <code JavaScript>
 {
-	"number": "1",
+    "number": "5",
-	"date": "09.08.2017",
+    "date": "07.04.2021",
-	"id": "6cd4b353-7d39-11e7-bed6-5453ed3ab335",
+    "id": "6f7b76c4-97b4-11eb-1a9f-40b076d9cfed",
-	"customer": {
+    "customer": {
-		"name": "ЛИНЕРИС ООО",
+        "name": "ЯМАЛЬСКИЕ ОЛЕНИ МП",
-		"id": "898ca024-afaa-11e6-80c4-00259032bcdb"
+        "fullname": "МП \"ЯМАЛЬСКИЕ ОЛЕНИ\"",
-	},
+        "id": "6b1bc03a-e2c3-11ea-8c9b-40b076d9cfed",
-	"products": [
+        "inn": "8909001750",
-		{
+        "kpp": "890901001",
-			"prodname": "Палочки для еды \"Кибори Яманами\"  22,5 см",
+        "okpo": "",
-			"id": "97b0a2a0-8bae-11e6-80c1-00259032bcdb",
+        "reg": "1028900507459",
-			"unitname": "шт",
+        "legalentity": true,
-			"taxrare": 18,
+        "email": "olen@bk.ru",
-			"price": 65,
+        "phone": "79568452648"
-			"quantity": 15
+    },
-		},
+    "products": [
-		{
+        {
-			"prodname": "Mushiyoke Освежитель воздуха гелевый с ароматом лесных трав, 250 г",
+            "prodname": "Оленина",
-			"id": "97b0a1cf-8bae-11e6-80c1-00259032bcdb",
+            "id": "0b26f80e-df9c-11ea-2895-40b076d9cfed",
-			"unitname": "шт",
+            "unitname": "кг",
-			"taxrare": 18,
+            "taxrate": "Без НДС",
-			"price": 123,
+            "price": 1,
-			"quantity": 1
+            "quantity": 1,
-		},
+            "itemType": 1
-		{
+        }
-			"prodname": "Антибактериалный спрей для стульчака унитаза, 12 мл",
+    ],
-			"id": "97b0a295-8bae-11e6-80c1-00259032bcdb",
+    "summ": 0,
-			"unitname": "шт",
+    "prepayment": 1,
-			"taxrare": 18,
+    "prepaymentEnable": false,
-			"price": 122,
+    "creditEnable": false
-			"quantity": 2
-		}
-	],
-	"summ": 1342
 }
 </code>
@@ Строка 112: / Строка 106: @@
 Используется для передачи информации по оплаченным счетам от приложения к учетной системе.
-^ Метод ^ Путь ^ Параметры ^ Ответ ^
+^ Метод ^ Путь ^ Тело JSON ^ Ответ ^
-| POST | /pay | billId, acquiring, summ, paymentId | JSON |
+| POST | /pay/{billId} | acquiring, summ, paymentId | JSON |
 ^ Параметр ^ Тип ^ Описание ^
@@ Строка 120: / Строка 114: @@
 | summ | Число | Сумма оплаты, может отличаться от суммы счета в случае, если кассир при оплате применил скидку/наценку |
 | paymentId | Строка | UUID оплаты в облаке Эвотор |
+| receipt | Строка | Номер чека оплаты в облаке Эвотор |
 <note>Смарт-терминал Эвотор на текущий момент не поддерживает смешанную оплату чека, оплата полностью или наличными или эквайринг.</note>
@@ Строка 134: / Строка 129: @@
 <note>Обратите внимание, что возможна частичная оплата счета, используйте параметр message JSON объекта для информирования покупателя.</note>
+===== Уведомление о полном расчете =====
+Используется для оповещения учетной системы о полном расчете [для формирования документа "Реализация"].
+^ Метод ^ Путь ^ Тело JSON ^ Ответ ^
+| POST | /full_settlement/{billId} | receipt, paymentId | Нет |
+^ Параметр ^ Тип ^ Описание ^
+| billId | Строка | Идентификатор счета в системе учета, полученный приложением через запрос списка счетов |
+| paymentId | Строка | UUID оплаты в облаке Эвотор |
+| receipt | Строка | Номер чека оплаты в облаке Эвотор |
+В ответ учетная система должна вернуть статус 200 OK. Тело ответа не обрабатывается.