{"swagger":"2.0","info":{"version":"1.0.0","title":"1C API export"},"host":"192.168.18.30","basePath":"/InternetShopTest/hs/v1","schemes":["https"],"consumes":["application/json"],"produces":["application/json"],"security":[{"Bearer":[]}],"paths":{"/authentication/gettoken":{"post":{"tags":["Authentication"],"summary":"Создание токена","description":"Этот метод вызывается прежде, чем будет вызван любой другой. Полученный токен передаётся во все другие методы в заголовке. Метод получения токена защищён, в заголовке нужно передать: \"Autorization: 011049fa-0264-4749-ae2f-af85090b38f3\".","parameters":[],"responses":{"200":{"description":"Токен","schema":{"$ref":"#/definitions/Token"}},"401":{"description":"Не авторизован"},"500":{"description":"Ошибка сервиса"}},"security":[{"basicAuth":[]}]}},"/ExchangeOrder":{"post":{"tags":["Order"],"summary":"Отправка заказа в 1С","description":"Вызывается, когда обновился существующий заказ за исключением статусов: N, NN, NP, NW. Необходимо сохранить весь текущий функционал обработки заказов при отправке в 1С (local/php_interface/include/classes/OrdersXML.php). Создаётся таблица api_1c_sending_queue для формирования очереди отправки изменённых заказов в 1С. Столбцы таблицы: order_id (id заказа), data (json-данные для отправки), timestamp_processing, timestamp (устанавливается в значение равное текущему значению времени timestamp при добавлении в таблицу). После обновления заказа на сайте добавляется запись в таблицу api_1c_sending_queue. Перед началом обработки скриптом строки, установить значение поля timestamp_processing равное текущему значению timestamp. В обработку берутся строки с пустым полем timestamp_processing. Предусмотреть скрипт, который будет мониторить зависшие в обработке строки таблицы со значением поля timestamp_processing более 5-ти минут и перезапускать отправку данных. После успешной отправки обновлённого заказа в api 1с (статус ответа 200) строка из таблицы api_1c_sending_queue удаляется. При получении любого другого кода ответа, очищается значение поля timestamp_processing. Необходимо отправлять все заказы из таблицы api_1c_sending_queue в 1С. Обработку заказов необходимо покрыть логами. Логи сохранять /upload/tmp/log/api_1c/YYYY(год)/m(месяц)/order_id(id заказа)_d(день)_H.i.s(временная метка)_export.log, пример - /upload/tmp/log/api_1c/2021/06/44077_04_17.28.27_export.log Сохраняем переданные данные и код ответа.","parameters":[{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/OrderSendRequest"}}],"responses":{"200":{"description":"Заказ обновлён"},"401":{"description":"Не авторизован"},"500":{"description":"Ошибка сервиса"}}}},"/ExchangePrice":{"get":{"summary":"Получение актуальных цен товаров","description":"Вызывается с периодичностью в 30 минут. Создаётся таблица api_1c_price_processing_queue для формирования очереди обработки цен из 1С. Столбцы таблицы: json_link (ссылка на сервер с сохранённым json), timestamp_processing, timestamp (устанавливается в значение равное текущему значению времени timestamp при добавлении в таблицу). Скрипт запускается раз в 30 минут. При обращении к данному методу происходит добавление записи в таблицу api_1c_price_processing_queue и сохранением данных тела запроса в файл по пути /upload/tmp/log/api_1c/YYYY(год)/m(месяц)/d(день)/H(час)/price_H.i.s(временная метка)_import_json.log, пример - /upload/tmp/log/api_1c/2022/06/10/07/price_07.28.27_import.log На кроне висит скрипт, запускаемый раз в минуту. Данный скрипт отправляет запрос в таблицу api_1c_price_processing_queue на получение записи с незаполненным полем timestamp_processing. При получении записи, поле timestamp_processing устанавливается равное текущему. По значению поля json_link обрабатывается файл для корректировки цен товарных позиций. Обработка файла аналогична текущей реализации, которую нужно перенести в актуальный класс апи 1с. Так же сохраняем логирование изменения цен с корректировкой пути файла логов - /upload/tmp/log/api_1c/YYYY(год)/m(месяц)/d(день)/H(час)/price_H.i.s(временная метка)_import_processing.log","parameters":[{"name":"short","type":"boolean","in":"query","required":false}],"responses":{"200":{"description":"Список актуальных цен","schema":{"$ref":"#/definitions/PriceUpdateResponse"}},"401":{"description":"Не авторизован"},"500":{"description":"Ошибка сервиса"}},"tags":["Catalog"]}}},"securityDefinitions":{"basicAuth":{"type":"basic"},"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"definitions":{"Token":{"type":"object","required":["expires_in","access_token"],"properties":{"access_token":{"type":"string","description":"Токен","maxLength":1024},"expires_in":{"type":"integer","description":"Остаток срока действия токена в секундах"}}},"OrderSendRequest":{"type":"object","required":["ШапкаЗаказа","СтрокиЗаказа","positions","statusTime"],"properties":{"ШапкаЗаказа":{"type":"object","description":"Идентификатор заказа ИМ","$ref":"#/definitions/OrderProperties"},"СтрокиЗаказа":{"type":"array","description":"Состав заказа. Не содержит повторяющихся id.","items":{"$ref":"#/definitions/Position"}}},"description":"Запрос на обновление заказа"},"PriceUpdateResponse":{"type":"object","required":["prices"],"properties":{"prices":{"type":"array","description":"Массив цен.","items":{"$ref":"#/definitions/Price"}}},"description":"Получение актуальных цен каталога"},"Price":{"type":"object","description":"Стоимость товарной позиции","required":["code","price","oldPrice"],"properties":{"code":{"type":"string","description":"РН товара","example":"123456"},"price":{"type":"string","description":"Актуальная стоимость товара","example":"254.42"},"oldPrice":{"type":"string","description":"Старая стоимость товара, если не менялась - 0","example":"275.9"},"discount":{"type":"array","items":{"$ref":"#/definitions/ProductDiscount"},"description":"Список скидок"}}},"ProductDiscount":{"description":"Скидка на товарную позицию, имеет вид \"2 товара по цене 1\"","type":"object","required":["type","conditions","schedule","origin_ids"],"properties":{"type":{"type":"object","example":"product_discount","description":"Дискриминатор схемы обьекта, для Акции \"1+1\" равен \"product_discount\""},"conditions":{"type":"object","required":["discount_value","bundle"],"properties":{"discount_value":{"type":"float","description":"Значение скидки в процентах - сколько товаров пользователь получает в подарок","example":100},"bundle":{"type":"integer","description":"Количество товаров для срабатывания скидки","example":2}}},"schedule":{"type":"object","description":"Расписание действия скидки, пока поддерживаем только UTC время начала и конца в формате DD-MM-YYYY HH:MM:SS","properties":{"from":{"type":"string","example":"10-11-2021 00:00:00"},"to":{"type":"string","example":"11-11-2021 00:00:00"}}},"origin_ids":{"type":"array","description":"Список РН товаров, усчаствующих в акции","items":{"type":"string"},"example":["123456","234567"]}}},"OrderProperties":{"type":"object","required":["Сумма","Номер","Дата","СтатусЗаказа","ДатаДоставки","ТелефонДоставки","АдресДоставки","КоординатыАдресаДоставки","ВремяДоставки","КомментарииДляКурьера","Магазин","Комментарий","Partner","id_partner","maxtotalprice"],"properties":{"Сумма":{"type":"string","example":"1063,2"},"Номер":{"type":"string","example":"98480"},"Дата":{"type":"string","example":"08.07.2021 08:07:32","$ref":"#/definitions/DateWithTime"},"СтатусЗаказа":{"type":"string","example":"P"},"НомерКарты":{"type":"string","example":"123456789","description":"Номер карты лояльности"},"ДатаДоставки":{"type":"string","example":"09.07.2021","$ref":"#/definitions/Date"},"ТелефонДоставки":{"type":"string","example":"+79166175988"},"АдресДоставки":{"type":"string","example":"Россия, Московская область, Химки, улица Горшина, 9к1, Кв. или офис 133, Подъезд 2, Этаж 13"},"КоординатыАдресаДоставки":{"type":"string","example":"55.884721,37.43472"},"ВремяДоставки":{"type":"string","example":"17:00-18:00"},"КомментарииДляКурьера":{"type":"string","example":"Позвонить за 5 минут"},"Магазин":{"type":"string","example":"МГЗ №261"},"Комментарий":{"type":"string","example":"Комментарий к заказу"},"Partner":{"type":"string","example":"YE"},"id_partner":{"type":"string","example":"123456-456789"},"maxtotalprice":{"type":"string","example":"1170.41"}}},"Date":{"type":"string","example":"09.07.2021"},"DateWithTime":{"type":"string","example":"08.07.2021 08:07:32"},"Position":{"type":"object","required":["Код","СуммаСкидки","Цена","Количество","Наименование","Сумма"],"properties":{"Цена":{"type":"string","example":"169,9","description":"Цена товара"},"Код":{"type":"string","example":"000253","description":"РН товара"},"СуммаСкидки":{"type":"string","example":"10,2","description":"Сумма скидки"},"Наименование":{"type":"string","example":"Капуста цветная весовая","description":"Наименование товара"},"Количество":{"type":"string","example":"1","description":"Количество товара"},"Сумма":{"type":"string","example":"169,9","description":"Сумма"}},"description":"Позиция заказа"}}}