Благовещенск
Аэропорт, Белогорье, Верхнеблаговещенское...

TU.Market API

краткое обобщение

Оглавление:

Авторизация

Для авторизации используется Basic Access Authentication
HTTP заголовок: Authorization

Значение: Basic {credentials}
где {credentials} - логин:пароль через двоеточие, закодированные в base64.

Логин – телефон или почта, как и при входе на сайт.
  • Пример:
  • Логин: user123@tu.market Пароль: user123pass
  • Заголовок для авторизации:
  • Authorization: Basic dXNlcjEyM0B0dS5tYXJrZXQ6dXNlcjEyM3Bhc3M=
Аккаунт должен обладать правом "доступ к API":  развернуть
— Его назначает «Главный представитель» вашей организации в своем Личном Кабинете.

— Либо менеджер tu.market, по разрешению руководителя вашей организации.
 Для тестирования при настройке — используйте «режим проверки» (переключатель или параметр), см. «Тестирование обновлений»
 развернуть
 Обязательное поле при использовании API — идентификатор: «Артикул» (в формате json или excel поле называется «crmID»)

Варианты импорта

  1. импорт JSON запросом по адресу tu.market/api/import, данные в формате json Пример: см.ниже
  2. импорт из файла FORM-DATA запросом по адресу tu.market/api/importFile, данные в формате json, xml, yml, commerceML, xlsx Пример: см.ниже
  3. импорт из файла по ссылке. Ссылка указывается в настройках импорта интерфейса «Прайс организации», по заданной периодичности Интерфейс  см.Автоматическое обновление
    Данные в формате:  json, xml, yml, commerceML, xlsx.
    Для commerceML поддерживается несколько ссылок или ссылка на архив.
  4. импорт файлов картинок FORM-DATA запросом по адресу tu.market/api/uploadImportPhotos, в случае их указания для товара|услуги в namePhoto (json, xlsx). Пример: см.ниже
    При указании картинок к товару|услуге ссылками (в linkPhoto) - поддерживается их скачивание (json, xml, yml, commerceML, xlsx).
  5. Используйте Принудительное обновление из файла или по ссылке — если требуется протестировать ваш импорт до или в процессе настройки Автоматического обновления. Интерфейс  см.Принудительное обновление
    В Принудительном обновлении поддерживаются те же форматы (xml, yml, commerceML, xlsx, json)
  6. Еще один способ автоматизировать импорт - с помощью программы Клиент API
Если у вас возникают трудности с настройкой обмена по API — обратитесь к своим специалистам, или к нашим менеджерам.
Технический специалист сможет настроить выгрузку из вашей 1с или другой программы в наиболее подходящем для вас формате (yml, xml, xls, json, commerceML), и ее автозагрузку одним из предлагаемых и наиболее подходящим для вас способов.
Это настраивается однажды, общепринятыми стандартными методами, занимает от нескольких минут до несколько часов работы специалиста.

Импорт

URL для запроса: https://tu.market/api/import
Тип запроса: POST
Content-Type: application/json
Пример запроса (JSON)
{
  "firmID": "16763",
  "testMode": true,
  "offers": [
    {
      "ctuID": "473",
      "crmCtuID": "10",
      "crmCtuName": "Мебель",
      "crmID": "t0002",
      "idTU": "17110",
      "nameTU": "Офисный стул",
      "annotationShort": "Офисный стул, цвет серый",
      "annotation": "Офисный стул, цвет серый",
      "prefPrice": "от",
      "priceBase": "500",
      "price2": "400",
      "si": "шт",
      "priceDesc": "примечание к цене",
      "dopSiUse": "после примечания",
      "dopPrice": "50",
      "dopSi": "шт",
      "quantity": "1",
      "wait": "0",
      "status": "(-) заблокировать [КА]",
      "ordInCTU": "11",
      "characteristics": [ { "name": "Высота", "unit": "m", "values": [ "1" ] } ],
      "namePhoto": [ "photo1.jpg", "photo2.png" ],
      "linkPhoto": [ "https://company.com/photo1.jpg", "https://company.com/photo2.png" ]
    }
  ]
}
Поля запроса
  1. firmID
    тип: int
    id фирмы
  2. strFromKA
    тип: string
    произвольный текст с дополнительной информацией. Будет сохранен в отчете об операции.
  3. testMode
    тип: bool
    режим проверки. При значении true данные не будут обновлены.
  4. offers
    список товаров
См. Детали полей запроса
Пример ответа
{ "reportID": 2962, "responseStatus": { "code": 200, "description": "Успешно, обновлено 1, без предупреждений. Детали в Отчете: tu.market/client/importReports/2962" } }
reportID - id отчета.
code – код результата.
description – описание результата.

Импорт из файла

URL для запроса: https://tu.market/api/importFile
Тип запроса: POST
Content-Type: multipart/form-data
Поля запроса
  1. importFile
    тип: файл
    Прикрепленный файл для импорта. Поддерживаемые форматы:
    • JSON (*.json)
    • Excel (*.xlsx, *.xls)
    • YML (*.yml, *.xml)
    • CommerceML - выгрузка из 1с (*.xml). В случае с CommerceML файлов может быть несколько
    • Zip архив (*.zip)
      Архив можно использовать, чтобы загрузить несколько CommerceML файлов за раз, включая фото к товарам. Аналогично и файлы Excel и JSON - их также можно загружать в архиве вместе с приложенными фотографиями (это актуально, если для загрузки фото используется поле namePhoto)
    Поля и их значение, описание и ограничения для указанных форматов файлов - см.по ссылкам внизу.
  2. firmID
    тип: int
    id фирмы
  3. strFromKA
    тип: string
    произвольный текст с дополнительной информацией. Будет сохранен в отчете об операции.
  4. testMode
    тип: bool
    режим проверки. При значении true данные не будут обновлены.
Пример ответа
{ "reportID": 2962, "responseStatus": { "code": 200, "description": "Успешно, обновлено 1, без предупреждений. Детали в Отчете: tu.market/client/importReports/2962" } }
reportID - id отчета по импорту.
code – код результата.
description – описание результата.

Коды ответов при импорте

  • "сode": 200, "description": "Успешно, обновлено 6500, без предупреждений. Детали в Отчете: tu.market/client/importReports/2 "
  • "сode": 201, "description": "Частично успешно. Из 6500 обновлено 5900, не обновлено 600. Детали в Отчете: tu.market/client/importReports/2"
  • "сode": 400, "description": "Неуспешно. Данные не обновлены. Детали в Отчете: tu.market/client/importReports/2"
  • "сode": 500, "description": "Неуспешно. Нет прав доступа или ошибка данных. Детали в Отчете: tu.market/client/importReports/2"

Загрузка фото (json, xlsx)

Используется в случае указания Названий фото в поле namePhoto при импорте товаров|услуг в форматах Excel, JSON, а также commerceML.

Если вы загружаете файлы импорта в составе zip-архива, который уже содержит фото, они будут прикреплены сразу при запросе к /api/importFile, дополнительных запросов делать не нужно.
При формате xml (yml) - фото для товаров можно указывать только в виде ссылок на картинки в интернет (в поле linkPhoto).
URL для запроса: https://tu.market/api/uploadImportPhotos
Тип запроса: POST
Content-Type: multipart/form-data
Поля запроса
  1. firmID
    тип: int
    id фирмы, для которой делается импорт
  2. reportID
    тип: int
    id отчета сессии импорта, для которой загружаются фото. Будут использованы только те имена файлов, которые были указаны при импорте товаров
  3. произвольное количество прикрепленных файлов с изображениями формата jpg или png
    или один zip файл с изображениями. Файлы неподдерживаемых форматов внутри архива будут проигнорированы, названия полей, содержащих файлы, не имеют значения
Пример ответа
{ "result": { "сode": 200, "description": "Success" } }
При неуспешной загрузке фото (файл не обнаружен, неверное расширение, и т.д.) - код 503 и сводка с причинами.
Вопросы, Ответы, Комментарии
Показать еще ↓
Вы можете оставить свой комментарий после Авторизации

Продолжая использовать наш сайт, вы даете согласие на обработку файлов cookie, которые обеспечивают правильную работу сайта...

Подробнее

Временно не доступно: функционал дорабатывается

Наличие и Цену - пожалуйста, уточните у Продавца