Загрузка остатков товаров с помощью API

Общая информация

API позволяет автоматизировать загрузку и обновление остатков товаров. Для взаимодействия с API используется авторизация по APIKey, который вы можете получить в личном кабинете, в разделе «Мои остатки товаров» .

Получение API-ключа

1. Перейдите в раздел «Мои остатки товаров» в личном кабинете.
2. Активируйте способ загрузки «API». Способ загрузки «XML-фид» будет деактивирован автоматически.
3. Нажмите кнопку «Сгенерировать API-ключ».
4. Скопируйте «API-ключ» и используйте его при выполнении запросов.

Авторизация

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

POST /api/v1/external/stocks HTTP/1.1
Host: https://лд.рф
Content-Type: application/json
Accept: application/json
Authorization: ApiKey <ВАШ_СГЕНЕРИРОВАННЫЙ_API_КЛЮЧ>

Пример ответа API

{
  "result": [
    {
      "productSku": "LD 47.300.15",
      "pointId": "А001",
      "updated": true,
      "errors": []
    },
    {
      "productSku": "11110509402MULD000000000",
      "pointId": "А002",
      "updated": false,
      "errors": [
        { "code": "SKU_NOT_FOUND", "message": "Товар с указанным productSku не найден." },
        { "code": "POINT_NOT_FOUND", "message": "Указанная Вами точка продаж не найдена." },
        { "code": "EMPTY_QUANTITY", "message": "Количество товара на складе не указано или равно нулю." },
        { "code": "EMPTY_PRICE", "message": "Цена товара не указана или равна нулю." }
      ]
    }
  ]
}

Пример ответа при ошибках аутентификации

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "code": "INVALID_APIKEY_FORMAT",
  "message": "Неверный формат API-ключа (ожидается GUID)"
}

Обязательные поля запроса

Каждый элемент в массиве "stocks" должен содержать следующие обязательные поля. Отсутствие любого из них приведёт к ошибке валидации и возврату статуса 400 Bad Request.

Возможные статусы ошибок

Ограничения

• Не более 5 запросов в минуту. В случае превышения, доступ может быть временно заблокирован.
• Максимальное время ожидания ответа от API - 5 минут. Если за это время сервер не ответит, запрос будет завершён с ошибкой таймаута. Пожалуйста, учитывайте это в своих интеграциях.

Список возможных ошибок валидации

Ошибки аутентификации

При ошибках в заголовке авторизации сервис вернёт HTTP 401 Unauthorized и один из следующих кодов.

Получение списка товаров

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

POST /api/v1/external/export/products HTTP/1.1
Host: https://лд.рф
Content-Type: application/json
Accept: application/json
Authorization: ApiKey <ВАШ_СГЕНЕРИРОВАННЫЙ_API_КЛЮЧ>

POST Получение списка товаров

URL: /api/v1/external/export/products

Данный эндпоинт позволяет получить данные о всех товарах на сайте лд.рф и их связанные атрибуты.

Можно запросить: идентификаторы товаров, цены РРЦ, артикулы, наименования, свойства, связанные файлы и изображения.
Для оптимизации объёма данных укажите только необходимые поля в массиве SELECT.

Если выполнить запрос без тела запроса, в ответе будет возвращён только один параметр - "productSku" для каждого товара.

Тело запроса (опционально):

{
  "SELECT": [
    "id",
    "price",
    "productSku",
    "name",
    "properties",
    "files",
    "pictures"
  ]
}

• id - идентификатор товара
• price - цена РРЦ
• productSku - артикул товара
• name - наименование товара
• properties - свойства товара
• files - файлы
• pictures - изображения

В ответе будут только те поля, которые вы указали в "SELECT".

Пример ответа:

{
  "products": [
    {
      "id": 1,
      "price": 196378,
      "productSku": "11111509251RGLD000000000",
      "name": "Кран шаровый LD КШЦФР Gas 150/125.025.Н/П.01. из стали 12Х18Н10Т Ду150/125 Ру2,5МПа с редуктором",
      "properties": [
        {
          "name":"Тип продукта",
          "value":"Кран шаровой"
        },
        {
          "name":"Серия",
          "value":"LD"
        },
        {
          "name":"Рабочая среда",
          "value":"Газ"
        }
      ],
      "files": [
        "https://xn--d1an.xn--p1ai/api/v1/document/8d1f7e80-997b-11ee-89ce-005056a4b6de.pdf",
        "https://xn--d1an.xn--p1ai/api/v1/document/3182b3ac-c18b-11ed-b250-005056a4b6de.pdf",
      ],
      "pictures": [
        "https://xn--d1an.xn--p1ai/upload/products/images/bbe/bbe018b25a032512e1a03985cb2f0ec8.png"
      ]
    }
  ]
}

Возможные ошибки: