мета-данные страницы
  •  

Различия

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

Ссылка на это сравнение

commands [24.10.2025 15:26] (текущий)
mr_megusto22 создано
Строка 1: Строка 1:
 +====== Описание команд ======
 +
 +
 +С нашей стороны были реализованы выполнения их команд \\
 +RoistatURL ​ = '​https://​cloud.roistat.com/​api/​v1/​project/';​
 +  LEADS = '​proxy-leads';​ - загрузка список лидов из roistat.
 +  SET_STATUSES = '​set-statuses';​ - выгрузка списка статусов заказов в roistat.
 +  ADD_ORDERS = '​add-orders';​ - добавление заказа ​ в roistat ​   ​
 +  UPDATE_ORDERS = '​integration/​order/​%orderId%/​status/​update';​ - обновление заказа ​ в roistat
 +  DELETE_ORDERS = '​integration/​order/​%orderId%/​delete';​ - удаление заказе ​ в roistat
 +  CLIENTS_IMPORT = '​clients/​import';​ - импорт клиентов в roistat
 +
 +===== Описание команд =====
 +
 +Выгрузка раз в 1 час.\\
 +Порядок выполнения запросов:​\\
 +1) Загрузка лидов из Roistat в Агбис.\\
 +2) Выгрузка клиентов из Агбис в Roistat.\\
 +3) Выгрузка новых заказов из Агбис в Roistat.\\
 +4) Выгрузка изменённых/​отменённых заказов из Агбис в Roistat.\\
 +Между выгрузками и запросами делаем паузу, чтобы не попасть под ограничение Riostat.\\
 +\\
 +**1) Загрузка лидов из Roistat в Агбис.**\\
 +выполняемый GET запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​proxy-leads?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63&​period=2019-05-28-2019-05-29\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +
 +Полученные данные:​ \\
 +<​code>​{"​ProxyLeads":​[{"​id":"​22","​title":"​Новая сделка 799","​text":"","​name":"​Ульяна 799","​phone":"​9166190383","​email":"","​roistat":"​799","​creation_date":"​2019-05-29 01:​31:​23","​order_id":​null,"​order_fields":​{"​message":"​Две шторы высотой 280см и шириной 150см \nНужно подшить до высоты 260см"​}},​{"​id":"​21","​title":"​Новая сделка 569","​text":"","​name":"​Татьяна 569","​phone":"​9255880672","​email":"","​roistat":"​569","​creation_date":"​2019-05-28 13:​36:​24","​order_id":​null,"​order_fields":​{"​message":"​1см высота"​}},​{"​id":"​20","​title":"​Новая сделка 333","​text":"","​name":"​ТЕСТ BIK 333","​phone":"​9503217398","​email":"","​roistat":"​333","​creation_date":"​2019-05-28 09:​11:​21","​order_id":​null,"​order_fields":​{"​message":"​тест"​}},​{"​id":"​18","​title":"​Новая сделка 373","​text":"","​name":"​Полина 373","​phone":"​9168242300","​email":"","​roistat":"​373","​creation_date":"​2019-05-28 08:​08:​14","​order_id":​null,"​order_fields":​{"​message":"​Нужно подшить американкой шёлковый платок 70х70"​}}],"​status":"​success"​}</​code>​\\
 +
 +**2) Выгрузка клиентов из Агбис в Roistat.**\\
 +Данные в теле запроса:​ \\
 +<​code>​[{"​id":​ "​10015944",​ "​name":​ "​Александров Григорий Викторович",​ "​phone":​ "​+79152210404",​ "​email":​ ""​},​{"​id":​ "​10014768",​ "​name":​ "​Конышев Константин Львович",​ "​phone":​ "​+79166531303",​ "​email":​ ""​},​{"​id":​ "​10015711",​ "​name":​ "​Рожкова Наталья Ивановна",​ "​phone":​ "​+79169643053",​ "​email":​ ""​},​{"​id":​ "​10216912",​ "​name":​ "​Коган Игорь Вячеславович",​ "​phone":​ "",​ "​email":​ ""​},​{"​id":​ "​10015800",​ "​name":​ "​Гурьева Наталья Леонтьевна",​ "​phone":​ "​+79269717594",​ "​email":​ ""​},​{"​id":​ "​10015920",​ "​name":​ "​Сафронова Светлана Михайловна",​ "​phone":​ "​+79163564600",​ "​email":​ ""​},​{"​id":​ "​10217922",​ "​name":​ "​Сушицкий Павел Владиславович",​ "​phone":​ "​+79166820767",​ "​email":​ ""​},​{"​id":​ "​10211340",​ "​name":​ "​Агбис",​ "​phone":​ "​+79990009900",​ "​email":​ ""​},​{"​id":​ "​1029804",​ "​name":​ "​Артемьева Варвара Александровна",​ "​phone":​ "​+79167991534",​ "​email":​ ""​},​{"​id":​ "​575",​ "​name":​ "​Костеж Татьяна Борисовна",​ "​phone":​ "​+79166193601",​ "​email":​ ""​},​{"​id":​ "​10015049",​ "​name":​ "​Кумратова Анжелика Владимировна",​ "​phone":​ "​+79055482844",​ "​email":​ ""​}] </​code>​\\
 +Выполняемый POST запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​clients/​import?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +
 +Получили данные:​ {"​status":"​success"​}
 +
 +**3) Выгрузка новых заказов из Агбис в Roistat.**\\
 +Данные в теле запроса:​ \\
 +<​code>​[{"​id":​ "​102120090",​ "​name":​ "​06299-2",​ "​date_create":​ "​2019-05-.ю29 12:​32:​43",​ "​status":​ "​1",​ "​client_id":​ "​10015049",​ "​price":​ "​2259",​ "​roistat":​ ""​},​{"​id":​ "​102120090",​ "​name":​ "​06299-2",​ "​date_create":​ "​2019-05-29 12:​32:​43",​ "​status":​ "​1",​ "​client_id":​ "​10015049",​ "​price":​ "​2259",​ "​roistat":​ ""​}]</​code>​
 +Выполняемый POST запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​add-orders?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +
 +Получили данные:​ <​code>​{"​processed":​2,"​skipped_by_status":​0,"​skipped_by_waiting_visit_info":​0,"​skipped_by_internal_error":​0,"​skipped_because_not_changed":​0,"​skipped_by_invalid_format":​0,"​skipped_fields_by_invalid_format":​0,"​saved":​2,"​comment":"","​uploaded":​2,"​status":"​success"​}</​code>​\\
 +
 +**4) Выгрузка изменённых/​отменённых заказов из Агбис в Roistat.**\\
 +Изменение заказа:​
 +Данные в теле запроса:​ \\
 +<​code>​{"​status_id":​ "​3"​}</​code>​
 +Выполняемый POST запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​integration/​order/​102120090/​status/​update?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +Получили данные:​ <​code>​{"​status":"​success"​}</​code>​\\
 +
 +Если заказ не успевал после выгрузки в 3п обновится на сайте (От специалиста Roistat, что обновление от получаса до часа проходит),​ то в ответ приходит "No order found for id: ...",
 +и в след раз агент будет пытаться снова отправить этот статус по заказу в Roistat
 +Данные в теле запроса:​ \\
 +{"​status_id":​ "​1"​}
 +Выполняемый POST запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​integration/​order/​102120091/​status/​update?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +Получили данные:​ \\
 +<​code>​{"​status":"​error","​error":"​request_data_validation_error","​description":"​No order found for id: 102120091"​}</​code>​\\
 +
 +Отменили заказ:
 +Выполняемый POST запрос URL = https://​cloud.roistat.com/​api/​v1/​project/​integration/​order/​102115584/​delete?​project=103761&​key=8264b240073cc3a335f2465cd1c04f63\\
 +Headers = '​Accept-Encoding:​ gzip,​deflate'​\\
 +MimeType = '​application/​json'​\\
 +Получили данные:​ <​code>​{"​status":"​success"​}</​code>​\\