Склад

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

GET https://api.ytimes.ru/ex/goods/references/group/list

Поля группы товаров: guid - уникальный идентификатор (32 символа) name - название

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

200: OK Список групп

{
  "success":true,
  "count":2,
  "rows":[{
    "guid":"e95c0a32-3b0f-4de4-a62b-413656acc24d",
    "name":"Ингредиенты"
  },{
    "guid":"d5c98e3e-75fe-4dc7-8316-8f2d8209772d",
    "name":"Расходники"
  }]
}

Создание или изменение группы товаров

POST https://api.ytimes.ru/ex/goods/references/group/save

Поля группы товаров: guid - уникальный идентификатор (32 символа) name - название

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

Request Body

Name	Type	Description
json body*	JSON	{ "guid": "234235-346546-45747-474563-456", "name": "Расходники" } guid - идентификатор группы

200: OK Идентификатор группы

{
  "success":true,
  "count":1,
  "rows":[
     //идентификатор созданной группы
     "e95c0a32-3b0f-4de4-a62b-413656acc24d"
  ]
}

Получение списка единиц измерения

GET https://api.ytimes.ru/ex/goods/references/unit/list

Поля единицы измерения: guid - уникальный идентификатор единицы (32 символа) name - название type - тип единицы (WEIGHT - вес,VOLUME - объем или COUNT - штучный) value - значение единицы в граммах/мл или штуках Например "Пачка 970мл" указывается как VOLUME и value = 970.

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

200: OK

{
  "success":true,
  "count":2,
  "rows":[{
    "guid":"d1452330-a6f5-11ed-92ba-c9917bb31341",
    "name":"шт",
    "type":"COUNT",
    "value":1
  },{
    "guid":"d1995112-a6f5-11ed-92ba-c9917bb31341",
    "name":"Пачка 10шт",
    "type":"COUNT",
    "value":10
  }
}

Создание единицы измерения

POST https://api.ytimes.ru/ex/goods/references/unit/save

Поля единицы измерения

guid - уникальный идентификатор единицы (32 символа) name - название type - тип единицы (WEIGHT - вес,VOLUME - объем или COUNT - штучный) value - значение единицы в граммах/мл или штуках Например "Пачка 970мл" указывается как VOLUME и value = 970.

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

Request Body

Name	Type	Description
json body	String	данные единицы измерения. Например: { "guid": "ключ 32 сисвола", "name": "Кега 30л", "type": "VOLUME", "value": 30000 }

200: OK Идентификатор единицы

{
  "success":true,
  "count":1,
  "rows":[
    //идентификатор созданной единицы измерения
    "234235-346546-457a62b-413656acc24d"
  ],
  "error":null
}

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

GET https://api.ytimes.ru/ex/goods/references/supplier/list

Поля единицы измерения: guid - уникальный идентификатор поставщика (32 символа) name - название fullName - полное название поставщика phone - телефон поставщика (10 цифр без 8 в начале. Например 9001112233) email - почта поставщика inn - ИНН поставщика kpp - KPP поставщика address - адрес поставщика description - описание условий заказа comment - комментарий egaisRegId - идентификатор в ЕГАИС, если есть

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

200: OK список поставщиков

{
  "success":true,
  "count":2,
  "rows":[{
    "guid":"142b434c-a786-11ed-92ba-c9917bb31341",
    "name":"Метро",
    "fullName":null,
    "isCashPayment":true,
    "phone":null,
    "email":null,
    "inn":null,
    "kpp":null,
    "address":null,
    "description":null,
    "comment":null,
    "egaisRegId":null
  },{
    "guid":"142b4400-a786-11ed-92ba-c9917bb31341",
    "name":"Пепси",
    "fullName":null,
    "isCashPayment":false,
    "phone":null,
    "email":null,
    "inn":null,
    "kpp":null,
    "address":null,
    "description":null,
    "comment":null,
    "egaisRegId":null
  }]
}

Создание или изменение поставщика

POST https://api.ytimes.ru/ex/goods/references/supplier/save

Пример JSON: { "guid":"142b434c-a786-11ed-92ba-c9917bb31341", "name":"Метро", "fullName":null, "phone":null, "email":null, "inn":null, "kpp":null, "address":null, "description":null, "comment":null, "egaisRegId":null }

Headers

Name	Type	Description
Authorization*	String	Клюс авторизациии

200: OK

{
  "success":true,
  "count":1,
  "rows":[
    //идентификатор созданного поставщика
    "234235-346546-457a62b-413656acc33d"
  ],
  "error":null
}

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

GET https://api.ytimes.ru/ex/goods/item/list

Поля товара: guid - уникальный идентификатор товара (32 символа) name - название type - тип товара (может быть NORMAL, MARK, ALCO_MARK, PACK, ..) packType - тип заготовки, если type = PACK comment - комментарий к товару barCodes - список штрих-кодов через запятую (не более 5) wastePercent - процент потерь при использовании в блюдах (например при очистке овощей/фруктов) mainUnitGuid - идентификатор единицы измерения товара mainUnitName - название единицы измерения товара additionalUnitGuidList - список идентификаторов единиц дополнительных вариантов фасовки groupGuid - идентификатор группы товаров groupName - название группы товаров supplierGuid - идентификатор основного поставщика supplierName - название основного поставщика

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

200: OK

{
  "success":true,
  "count":163,
  "rows":[{
    "guid":"c1be8e47-4b07-4684-a3d5-8da2d67c9a39",
    "name":"Кофе",
    "type":"NORMAL",
    "packType":null,
    "comment":null,
    "barCodes":"2000000589220",
    "wastePercent":2.0,
    "mainUnitGuid":"d135c43a-a6f5-11ed-92ba-c9917bb31341",
    "mainUnitName":"кг",
    "additionalUnitGuidList":[
      "d1436b80-a6f5-11ed-92ba-c9917bb31341"
    ],
    "groupGuid":"e95c0a32-3b0f-4de4-a62b-413656acc24d",
    "groupName":"Ингредиенты",
    "supplierGuid":"144116d6-a786-11ed-92ba-c9917bb31341",
    "supplierName":"YT Coffee"
  }, {
    "guid":"2bd26ce4-787f-47b2-9306-3ddcf34cd4f8",
    "name":"Какао",
    "type":"NORMAL",
    "packType":null,
    "comment":null,
    "barCodes":null,
    "wastePercent":0.0,
    "mainUnitGuid":"d135c43a-a6f5-11ed-92ba-c9917bb31341",
    "mainUnitName":"кг",
    "additionalUnitGuidList":[],
    "groupGuid":"e95c0a32-3b0f-4de4-a62b-413656acc24d",
    "groupName":"Ингредиенты",
    "supplierGuid":"142b434c-a786-11ed-92ba-c9917bb31341",
    "supplierName":"Метро"
  }, 
  ....
}

Создание или изменение карточки товара на складе

POST https://api.ytimes.ru/ex/goods/item/save

Пример JSON товара: { guid: "c1be8e47-4b07-4684-a3d5-8da2d67c9a39", // уникальный идентификатор товара (32 символа) name: "Сахар", // название type: "NORMAL", // тип товара (может быть NORMAL, MARK, ALCO_MARK, PACK, ..) barCodes: null, // список штрих-кодов через запятую (не более 5) mainUnitGuid: "d135c43a-a6f5-11ed-92ba-c9917bb31341", // идентификатор единицы измерения товара groupGuid: "e95c0a32-3b0f-4de4-a62b-413656acc24d", // идентификатор группы товаров supplierGuid: "142b434c-a786-11ed-92ba-c9917bb31341", // идентификатор основного поставщика }

Headers

Name	Type	Description
Authorization*	String

Request Body

Name	Type	Description
json body*	String	JSON карточки товара

200: OK

{
  "success":true,
  "count":1,
  "rows":[
    //идентификатор созданного товара
    "c1be8e47-4b07-4684-a3d5-8da2d67c9a39"
  ],
  "error":null
}

Создание или изменение накладной закупки на складе

POST https://api.ytimes.ru/ex/goods/changes/save

Пример JSON запроса: { //Уникальный идентификатор накладной "guid": "820b3c8a-03ff-4889-a20e-2266176cca", //Идентификатор торговой точки "shopGuid": "820b3c8a-03ff-4889-a20e-2266176cca0e", //Дата и время, в которое поступление должно встать на остаток, фактически время доставки товара на точку "date": "12.02.2023", "time": "12:25", //тип движения товара. INCOME для поступления "type": "INCOME", //Идентификатор поставщика если есть "incomeSupplierGuid": "142b4400-a786-11ed-92ba-c9917bb31341", //Дата накладной (документа) "incomeDocDate": "11.02.2023", //Номер накладной (документа) "incomeDocNumber": "1234-3344" //Список позиций накладной "itemList": [{ //Идентификатор товара "goodsGuid": "1dd69a8e-c154-476c-8237-81a7f1b9ede0", //Идентификатор единицы поступления "unitGuid": "d135c3ae-a6f5-11ed-92ba-c9917bb31341", //Количество товара "value": 12.2, //Цена за 1 единицу товара "itemPrice": 100.5, //Итоговая цена за товар "totalPrice": 1226.1 }, { //Идентификатор второго товара "goodsGuid": "b6fa55f6-c9f8-4583-adef-124c56b9a932", //Идентификатор единицы поступления "unitGuid": "d1452330-a6f5-11ed-92ba-c9917bb31341", //Количество товара "value": "50", //Цена за 1 единицу товара "itemPrice": 10, //Итоговая цена за товар "totalPrice": 500 }] }

Headers

Name	Type	Description
Authorization*	String	Ключ авторизации

Request Body

Name	Type	Description
json body	String	JSON накладной

200: OK

{
  "success":true,
  "count":1,
  "rows":[
    //идентификатор созданной накладной
    "c1be8e47-4684-a3d5-4b07-8da2d67c9a39"
  ],
  "error":null
}