{"swagger":"2.0","info":{"version":"1.0.0","title":"1C API import"},"host":"shop.miratorg.ru","basePath":"/api_1с","schemes":["https"],"consumes":["application/json"],"produces":["application/json"],"security":[{"Bearer":[]}],"paths":{"/authentication/token":{"post":{"tags":["Authentication"],"summary":"Создание токена","description":"Этот метод вызывается прежде, чем будет вызван любой другой. Полученный токен передаётся во все другие методы по схеме Bearer. Метод получения токена защищён авторизацией по схеме Basic, логин и пароль сообщается отдельно.","parameters":[],"responses":{"200":{"description":"Токен","schema":{"$ref":"#/definitions/Token"}},"400":{"description":"Ошибка запроса"},"401":{"description":"Не авторизован"},"500":{"description":"Ошибка сервиса"}},"security":[{"basicAuth":[]}]}},"/orders/{orderId}/update":{"put":{"summary":"Обновление заказа","description":"Вызывается, когда меняется статус заказа на стороне 1С. Необходимо сохранить весь текущий функционал обработки заказов из 1С (local/php_interface/include/classes/XMLImport.php). Создаётся таблица api_1c_processing_queue для формирования очереди обработки изменённых заказов из 1С. Столбцы таблицы: order_id (id заказа), data (json-данные из 1С), timestamp_processing, timestamp (устанавливается в значение равное текущему значению времени timestamp при добавлении в таблицу). При обращении к данному методу, данные сохраняются в таблицу api_1c_processing_queue с заполнением полей: order_id (id заказа), data (json-данные из 1С), timestamp (устанавливается в значение равное текущему значению времени timestamp). Далее скрипт обробатывает построчно записи из таблицы  api_1c_processing_queue. При обращении к каждой строке заполняется поле timestamp_processing в значение равное текущему timestamp. После успешной обработки данных заказа, строка из таблицы удаляется, в обратном случае - очищается поле timestamp_processing.  Предусмотреть скрипт, который будет мониторить зависшие в обработке строки таблицы со значением поля timestamp_processing более 5-ти минут и перезапускать обработку данных. Необходимо обрабатывать все заказы из таблицы api_1c_processing_queue. данные из 1С не обрабатываются, если: на сайте у заказа финальный статус (F, OT); данные по заказу из 1С пришли с предыдущим статусом. Обработку заказов необходимо покрыть логами. Логи сохранять /upload/tmp/log/api_1c/YYYY(год)/m(месяц)/order_id(id заказа)_d(день)_H.i.s(временная метка)_import.log, пример - /upload/tmp/log/api_1c/2021/06/44077_04_17.28.27_import.log Сохраняем полученные данные в файл лога.","parameters":[{"name":"orderId","in":"path","description":"Идентификатор заказа ИМ","required":true,"type":"number"},{"in":"body","name":"body","required":true,"schema":{"$ref":"#/definitions/OrderUpdateRequest"}}],"responses":{"200":{"description":"Заказ обновлён"},"400":{"description":"Ошибка запроса","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"Не авторизован"},"404":{"description":"Заказ не найден"},"500":{"description":"Ошибка сервиса"}},"tags":["Order"]}},"/orders/list":{"get":{"summary":"Список заказов","description":"Получение списка заказов за сегодня.","responses":{"200":{"description":"Список заказов","schema":{"$ref":"#/definitions/OrdersList"}},"400":{"description":"Ошибка запроса","schema":{"$ref":"#/definitions/Error"}},"401":{"description":"Не авторизован"},"500":{"description":"Ошибка сервиса"}},"tags":["Order"]}}},"securityDefinitions":{"basicAuth":{"type":"basic"},"Bearer":{"type":"apiKey","name":"Authorization","in":"header"}},"definitions":{"Token":{"type":"object","required":["expiresAt","token"],"properties":{"token":{"type":"string","description":"Токен","maxLength":1024},"expiresAt":{"description":"Дата и время когда истекает срок действия токена","$ref":"#/definitions/DateTimeWithZone"}}},"OrdersList":{"type":"object","required":["orders"],"properties":{"orders":{"type":"array","items":{"$ref":"#/definitions/OrderShot"}}},"description":"Заказы"},"OrderShot":{"type":"object","required":["id","status"],"properties":{"id":{"type":"integer","description":"Идентификатор заказа."},"status":{"type":"string","description":"Символьный код статуса заказа."}},"description":"Категория товаров"},"PriceUpdateRequest":{"type":"object","required":["prices","updateTime"],"properties":{"updateTime":{"description":"Время изменения цен","$ref":"#/definitions/DateTimeWithZone"},"prices":{"type":"array","description":"Массив цен.","items":{"$ref":"#/definitions/Price"}}},"description":"Запрос на обновление цен каталога"},"Position":{"type":"object","required":["price","code","discountSumm","discountPrice","id","quantity"],"properties":{"price":{"type":"string","description":"Цена товара","example":"169,9"},"code":{"type":"string","description":"РН товара","example":"000253"},"productName":{"type":"string","description":"Наименование товара","example":"Капуста цветная весовая"},"quantity":{"type":"string","description":"Количество товара","example":"1"},"totalPrice":{"type":"string","description":"Сумма","example":"169,9"}},"description":"Позиция заказа"},"DateTimeWithZone":{"type":"string","example":"2018-04-24T10:37:36.000+0000"},"Error":{"type":"object","required":["code","message"],"properties":{"message":{"type":"string","description":"Сообщение об ошибке"},"code":{"type":"integer","description":"Код ошибки"}},"description":"Описание ошибки"}}}