API:Создание номенклатуры в справочнике товаров: различия между версиями

Версия 18:46, 25 апреля 2022

Общие сведения

API (Application Programming Interface или интерфейс программирования приложений) — совокупность инструментов и функций в виде интерфейса для создания новых приложений и интеграции с ИС. Все запросы к сервису БИФИТ Бизнес осуществляются при помощи авторотационного токена - access_token. Для генерации токена, необходимо пройти процедуру авторизации OAuth2. Для этого необходимо использовать логин/пароль зарегистрированной учетной записи.

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

Запрос	POST
URL: https://kassa.bifit.com/cashdesk-api/v1/protected/nomenclatures	https://kassa.bifit.com/cashdesk-api/v1/protected/nomenclatures

Request Body

type: raw (JSON)

organizationId": "ID организации",
barcode": null,
vendorCode": null,
name": "Наименование номенклатуры",
vatId": 5,
vatValue": 20,
unitCode": 796,
volume": null,
purchasePrice": null,
sellingPrice": 60,
weighted": false,
grouped": false,
focused": false,
container": true,
paymentSubject": "PRODUCT",
adultsOnly": false,
code": null,
markType": "UNKNOWN",
gtin": null,
pluCode": null,
template": null,
visible": true,
contractorActivityType": null,
contractorId": null,
custom": false,
type": "DEFAULT",
compositeGoods": ,
barcodes": ,
countryCode": null,
customsDeclaration": null,
description": null,
picturesIds": ,
application": "KASSA",

nomenclatureFeatures":

- id": null,
- nomenclatureId": "ID номенклатуры",
- featureId": "Идентификатор номенклатуры",
- value": null
- organizationId" : "ID организации",

tradeObjectRelations":

- nomenclatureId": "ID номенклатуры",
- organizationId": "ID организации",
- sellingPrice":0,
- tradeObjectId": ""ID торгового объекта""
orgMemberPoints": null,
blockedNomenclatureList": null

 { "item":{
    "organizationId": "ID организации",
    "barcode": null,
    "vendorCode": null,
    "name": "Наименование номенклатуры",
    "vatId": 5,
    "vatValue": 20,
    "unitCode": 796,
    "volume": null,
    "purchasePrice": null,
    "sellingPrice": 60,
    "weighted": false,
    "grouped": false,
    "focused": false,
    "container": true,
    "paymentSubject": "PRODUCT",
    "adultsOnly": false,
    "code": null,
    "markType": "UNKNOWN",
    "gtin": null,
    "pluCode": null,
    "template": null,
    "visible": true,
    "contractorActivityType": null,
    "contractorId": null,
    "custom": false,
    "type": "DEFAULT",
    "compositeGoods": [],
    "barcodes": [],
    "countryCode": null,
    "customsDeclaration": null,
    "description": null,
    "picturesIds": [],
    "application": "KASSA"},
    "nomenclatureFeatures": [
        {
            "id": null,
            "nomenclatureId":  "ID номенклатуры",
            "featureId": "Идентификатор номенклатуры",
            "value": null
        }
    ],
    "organizationId" : "ID организации",
    "tradeObjectRelations": [
 {
  "nomenclatureId": "ID номенклатуры",
  "organizationId": "ID организации",
  "sellingPrice":0,
  "tradeObjectId": ""ID торгового объекта""
  }],
    "orgMemberPoints": null,
    "blockedNomenclatureList": null
 }

@@ Строка 20: / Строка 20: @@
 |title-right= type: '''raw''' (JSON)
 |content-left=&nbsp;
-* '''adultsOnly''':	Возрастное ограничение товара
+* organizationId": "ID организации",
-* '''application''':	Заявка на какое приложение ссылаться Касса Розница или ЛК
+* barcode": null,
-* '''barcode''':	Штрихкод
+* vendorCode": null,
-* '''barcodes''': Штрихкоды
+* name": "Наименование номенклатуры",
-* '''blockedNomenclatureList''':  (Номенклатура, входящая в Стоп-лист)
+* vatId": 5,
-** '''created''':	Время создания номенклатуры
+* vatValue": 20,
-** '''nomenclatureId''':	ID номенклатурной позиции
+* unitCode": 796,
-** '''organizationId''':	ID организации
+* volume": null,
-** '''tradeObjectId''':	ID торгового объекта
+* purchasePrice": null,
-* '''changed''':	время изменения номенклатуры
+* sellingPrice": 60,
-* '''code''':	()
+* weighted": false,
-* '''CompositeGood''':
+* grouped": false,
-** '''compositeType''':	Тип товара (Товар, Рецепт, Комплект, Шаблон)
+* focused": false,
-** '''extCode''':	 Артикул
+* container": true,
-** '''linkId''':	()
+* paymentSubject": "PRODUCT",
-** '''nomenclatureId''':	ID номенклатуры
+* adultsOnly": false,
-** '''parentId''':	ID создаваемого товара
+* code": null,
-** '''price''':	Цена
+* markType": "UNKNOWN",
-** '''quantity''':	Количество
+* gtin": null,
-* '''container''':	(Вопрос что это такое)
+* pluCode": null,
-* '''contractorActivityType''':	Признак агента (Агент, Комиссионер, Платежный агент, Платежный субагент и др.)
+* template": null,
-* '''contractorId''':	ID агента
+* visible": true,
-* '''countryCode''':	Код страны
+* contractorActivityType": null,
-* '''created''':	Время создание номенклатуры
+* contractorId": null,
-* '''custom''':	false ()
+* custom": false,
-* '''customsDeclaration''':	(Не понятно что это такое)
+* type": "DEFAULT",
-* '''description''':	Описание номенклатуры
+* compositeGoods": ,
-* '''externalCode''':	Артикул
+* barcodes": ,
-* '''externalId''':	Внешний ID
+* countryCode": null,
-* '''focused''':	Фокусный товар
+* customsDeclaration": null,
-* '''grouped''':	Принадлежность к группе
+* description": null,
-* '''gtin''':	GTIN код
+* picturesIds": ,
-* '''id''':	(Какой то ID)
+* application": "KASSA",
-* '''markType''': Тип маркировки номенклатуры (Алкоголь, Табак, Обувь, Парфюмерия, СИЗ, Другая)
+nomenclatureFeatures":
-* '''name''':	Наименование номенклатуры
+** id": null,
-* '''NomenclatureFeature''' (Характеристика номенклатуры)
+** nomenclatureId":  "ID номенклатуры",
-** '''created''':	время создания номенклатуры
+** featureId": "Идентификатор номенклатуры",
-** '''featureId''':	ID особенности
+** value": null
-** '''id''':	Характеристики
+** organizationId" : "ID организации",
-** '''nomenclatureId''':	ID номенклатуры
+tradeObjectRelations":
-** '''value''':	Цена
+** nomenclatureId": "ID номенклатуры",
-* '''orgMemberPoints''':	Количество баллов KPI
+** organizationId": "ID организации",
-* '''organizationId''': ID организации
+** sellingPrice":0,
-* '''parentId''':	ID создаваемого товара
+** tradeObjectId": ""ID торгового объекта""
-* '''paymentSubject''':	Предмет расчета (Товар, Платеж, Залог, Выигрыш лотереи и др.)
+* orgMemberPoints": null,
-* '''picture''':	Изображение номенклатуры
+* blockedNomenclatureList": null
-* '''picturesIds''':	ID изображения
-* '''pluCode''':  Код PLU
-* '''purchasePrice''':	Цена закупки
-* '''sellingPrice''':	Цена продажи
-* '''tradeObjectRelations''':	(Принадлежность к определенному торговому объекту)
-** '''TradeObjectNomenclature''' (Номенклатура торгового объекта)
-** '''nomenclatureId''':	ID номенклатуры
-** '''orgMemberPoints''':	Количество баллов KPI
-** '''organizationId''':	ID организации
-** '''sellingPrice''':	Цена продажи
-** '''tradeObjectId''':	ID торгового объекта
-* '''type''':	Тип номенклатурной позиции( Товар, Рецепт, Комплект, Шаблон)
-* '''unitCode''':	Единица измерения
-* '''vatId''':	НДС ID
-* '''vatValue''':	НДС
-* '''vendorCode''':	Код Поставщика
-* '''visible''':	()
-* '''volume''':	()
-* '''weighted''': ()
-* '''organizationId''':	ID организации
 |content-right=&nbsp;
 <syntaxhighlight lang="JSON">
   { "item":{
-     "organizationId": "1579776541385873338810",
+     "organizationId": "ID организации",
      "barcode": null,
      "vendorCode": null,
-     "name": "Карандаш",
+     "name": "Наименование номенклатуры",
      "vatId": 5,
      "vatValue": 20,
@@ Строка 124: / Строка 104: @@
      "nomenclatureFeatures": [
          {
-             "id": 4499,
+             "id": null,
-             "nomenclatureId":  18445421,
+             "nomenclatureId":  "ID номенклатуры",
-             "featureId": 75,
+             "featureId": "Идентификатор номенклатуры",
              "value": null
          }
      ],
-     "organizationId" : "1579776541385873338810",
+     "organizationId" : "ID организации",
      "tradeObjectRelations": [
   {
-   "nomenclatureId": 18445421,
+   "nomenclatureId": "ID номенклатуры",
-   "organizationId": "1579776541385873338810",
+   "organizationId": "ID организации",
    "sellingPrice":0,
-   "tradeObjectId": "1579776541389-605245476"
+   "tradeObjectId": ""ID торгового объекта""
    }],
      "orgMemberPoints": null,

API:Создание номенклатуры в справочнике товаров: различия между версиями

Версия 18:46, 25 апреля 2022

Общие сведения

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

Навигация

Поиск