Запрос информации об остатках через API JSON API

Комментарии

Комментариев: 3

  • Добрый день!

    Не совсем понятно, что именно необходимо. Получить остатки от нас можно с помощью get запроса на report/stocks/all. 

    Если я правильно понял, то достичь желаемого результата можно через два шага. Первым запрашивать остатки у нас, второй - это post запрос с остатками в адрес Беру. Но между шагами скорее всего будет еще один, где нужно будет привести наш вид к виду, который необходим стороннему сервису. 

     

    0
    Действия с комментариями Постоянная ссылка
  • Игорь

    Нужно подключить интеграцию с Беру по API, через протокол

    JSON API

    алгоритм работы. 

    Описание

    POST /stocks
    Внимание. Запрос выполняется маркетплейсом Беру и поддерживает обмен данными только в формате JSON.

    Запрашивает актуальную информацию по остаткам товаров.

    Запрос отправляется каждые 15 минут.

    URL ресурса:

    https://<URL_запроса>/stocks
    Таймаут на получение ответа: 5,5 секунд.

    Передаваемые магазину данные

    Структура данных в теле запроса приведена ниже. Порядок следования параметров не гарантируется.

    {
      "warehouseId": {int64},
      "skus":
      [
        "{string}",
        ...
      ]
    }

    Описание параметров:

     

    Параметр

    Тип

    Значение

    warehouseId Int64

    Идентификатор склада, указанный магазином в личном кабинете.

    skus String[]

    Список ваших SKU товаров.

    Ответные данные от магазина

    В ответе магазин должен передать актуальные данные для переданных товаров.

    Структура ответных данных:

    {
      "skus":
      [
        {
          "sku": "{string}",
          "warehouseId": "{string}",
          "items":
          [
            {
              "type": "{enum}",
              "count": "{string}",
              "updatedAt": "{date}"
            },
            ...
          ]
        },
        ...
      ]
    }

    Описание параметров:

     

    Параметр

    Тип

    Значение

    skus  

    Информация об остатках товаров, указанных в запросе Беру.

    Обязательный параметр.

    Параметры, вложенные в skus

    sku String

    Ваш SKU товара.

    Обязательный параметр.

    warehouseId String

    Идентификатор склада, на котором хранится товар.

    Обязательный параметр.

    items  

    Информация об остатках товара.

    Представлена в виде массива объектов, каждый из которых соответствует одному типу доступности единиц товаров (вложенный параметр type).

    Обязательный параметр. Должен содержать информацию о количестве доступных единиц товара и единиц, зарезервированных под заказы (тип FIT). Информацию об остальных типах доступности товара передавать необязательно.

    Параметры, вложенные в items

    type Enum

    Тип доступности единиц товара:

    •  
      FIT — доступные и зарезервированные под заказы единицы.
    •  
      AVAILABLE — доступные единицы.
    •  
      QUARANTINE — единицы, не найденные при инвентаризации или перемещающиеся по складу.
    •  
      DEFECT — бракованные единицы.

    Ответ магазина должен содержать информацию о количестве доступных единиц товара и единиц, зарезервированных под заказы (тип FIT). Информацию об остальных типах доступности товара передавать необязательно.

    Обязательный параметр.

    count String

    Количество единиц товара указанного типа.

    Обязательный параметр.

    updatedAt Date

    Дата и время последнего обновления информации об остатках указанного типа.

    Формат даты: ISO 8601 со смещением относительно UTC. Например, 2017-11-21T00:42:42+03:00.

    Обязательный параметр.

    Описание ошибок

    Магазин может вернуть следующие статусы ответов:

     

    Описание

    Пояснение

    Ошибка 400 Bad Request

    Если магазин считает запрос, поступающий от маркетплейса Беру, некорректным, магазин должен вернуть статус ответа 400 с описанием причины ошибки в теле ответа. Такие ответы будут анализироваться на предмет нарушений и недоработок API со стороны маркетплейса Беру.

    Ошибка 500 Internal Server Error

    В случае технической ошибки на стороне магазина он должен вернуть статус ответа 500. Магазины с большим количеством таких ответов могут быть отключены от маркетплейса Беру.

    Примеры

    Запрос от Беру:

    POST /stocks

    Тело запроса:

    {
      "warehouseId": 2,
      "skus":
      [
        "A200.190",
        "A287.14"
      ]
    }

    Ответ магазина:

    HTTP/1.1 200 OK
    ...
    
    {
      "skus":
      [
        {
          "sku": "A200.190",
          "warehouseId": "2",
          "items":
          [
            {
              "type": "FIT",
              "count": "15",
              "updatedAt": "2019-03-14T12:26:14+03:00"
            },
            {
              "type": "AVAILABLE",
              "count": "11",
              "updatedAt": "2019-03-14T12:26:14+03:00"
            },
            {
              "type": "DEFECT",
              "count": "1",
              "updatedAt": "2019-03-14T12:26:17+03:00"
            }
          ]
        },
        {
          "sku": "A287.14",
          "warehouseId": "2",
          "items":
          [
            {
              "type": "FIT",
              "count": "7",
              "updatedAt": "2019-03-14T12:26:11+03:00"
            },
            {
              "type": "AVAILABLE",
              "count": "7",
              "updatedAt": "2019-03-14T12:26:12+03:00"
            },
            {
              "type": "QUARANTINE",
              "count": "2",
              "updatedAt": "2019-03-14T12:26:14+03:00"
            }
          ]
        }
      ]
    }
     
    0
    Действия с комментариями Постоянная ссылка
  • Для разработки алгоритма вы можете обратиться к нашим партнерам. Их контакты есть по ссылке

    0
    Действия с комментариями Постоянная ссылка

Войдите в службу, чтобы оставить комментарий.