Добавить ak_notification.md

ak_notification.md

@@ -0,0 +1,70 @@
+## endpoint: 
+
+https://api.botboom.ru/shop/message/send
+
+пример на curl:
+
+```curl
+curl -X POST "https://api.botboom.ru/shop/message/send" \
+  -H "Authorization: {access_token}" \
+  -H "Content-Type: application/json" \
+  -d '{
+        {
+            "caption": "test",
+            "imgUrl": "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif",
+            "shop": ["987"],
+            "qr": "qrtext"
+        }
+    }'
+```
+
+* Версия 1
+
+передаётя json:
+
+```json
+{
+    {
+        "caption": "test",
+        "imgUrl": "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif",
+        "shop": ["987"],
+        "qr": "qrtext"
+    }
+}
+```
+где:
+caption - текст сообщения
+imgUrl - картинка к тексту
+shop - идентификатор магазина, устанавливается в чате командой /setshop 987
+qr - преобразуется в qr код заказа и отдаётся ссылкой
+
+* Версия 2
+передаётя json:
+
+```json
+{
+    orderNumber: "H19481743502", // номер заказа
+    source: "СберМаркет", // источник заказа - СберМаркет, Агрокомплекс, ПУД, Яндекс Еда
+    shop: ["267"], // массив номеров магазинов для оповещения. для пуд - с приставкой PUD
+    status: "новый", // статус заказа. новый, согласован, оплачен, отменён, передан в доставку, доставлен, переписка
+    orderDate: "25.05.2026, 09:32:34"
+    client: {
+        name: "Иванов Иван",
+        phone: "79204421996" // поле - уникальный идентификатор для информирования в боте
+    },
+    delivery: {
+        addr: "Сочи, Ленина 1",
+        timeslot: "10:12-" // таймслот через дефис, в этом примере, Доставка с 10:12
+    },
+    order: {
+        weight: "1.7кг",
+        items: "5", // число позиций или массив товаров в заказе. На будущее
+        total: 1234.00 // общая сумма заказа в р.
+    },
+    comment: "Позвонить. Если не удалось дозвониться, заменить на аналогичный товар.",
+    qr: "7cc8e74a-5803-11f1-ac94-00155d0a9b17",
+    caption: "", // если задан, будет передан простым текстом в конце сообщения
+    imgUrl: "https://api.botboom.ru/www/uploads/meatcultrubot/wzitrc9r9qzjzivfarulzba2.gif" // будет сообщение с картинкой
+}
+```
+