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

Материал из Касса
Перейти к навигации Перейти к поиску

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

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)
 
  • adultsOnly: Возрастное ограничение товара
  • application: Заявка на какое приложение ссылаться Касса Розница или ЛК
  • barcode: Штрихкод
  • barcodes: Штрихкоды
  • blockedNomenclatureList: (Номенклатура, входящая в Стоп-лист)
    • created: Время создания номенклатуры
    • nomenclatureId: ID номенклатурной позиции
    • organizationId: ID организации
    • tradeObjectId: ID торгового объекта
  • changed: время изменения номенклатуры
  • code: ()
  • CompositeGood:
    • compositeType: Тип товара (Товар, Рецепт, Комплект, Шаблон)
    • extCode: Артикул
    • linkId: ()
    • nomenclatureId: ID номенклатуры
    • parentId: ID создаваемого товара
    • price: Цена
    • quantity: Количество
  • container: (Вопрос что это такое)
  • contractorActivityType: Признак агента (Агент, Комиссионер, Платежный агент, Платежный субагент и др.)
  • contractorId: ID агента
  • countryCode: Код страны
  • created: Время создание номенклатуры
  • custom: false ()
  • customsDeclaration: (Не понятно что это такое)
  • description: Описание номенклатуры
  • externalCode: Артикул
  • externalId: Внешний ID
  • focused: Фокусный товар
  • grouped: Принадлежность к группе
  • gtin: GTIN код
  • id: (Какой то ID)
  • markType: Тип маркировки номенклатуры (Алкоголь, Табак, Обувь, Парфюмерия, СИЗ, Другая)
  • name: Наименование номенклатуры
  • NomenclatureFeature (Характеристика номенклатуры)
    • created: время создания номенклатуры
    • featureId: ID особенности
    • id: Характеристики
    • nomenclatureId: ID номенклатуры
    • value: Цена
  • orgMemberPoints: Количество баллов KPI
  • organizationId: ID организации
  • parentId: ID создаваемого товара
  • paymentSubject: Предмет расчета (Товар, Платеж, Залог, Выигрыш лотереи и др.)
  • picture: Изображение номенклатуры
  • 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 организации
   
 adultsOnly: false,
 application: "KASSA",
 barcode: null,
 barcodes: [],
 blockedNomenclatureList: null,
 {
  created:	Время создания номенклатуры
  nomenclatureId: "ID номенклатурной позиции"
  organizationId: "ID организации"
  tradeObjectId:	ID торгового объекта
 }
  changed:	"1649688350781"
  code:	null
  [CompositeGood:
 {
  compositeType: "ANALOG",
  extCode:	 Артикул
  linkId: 21796190,
  nomenclatureId: "ID номенклатуры",
  parentId:	22528459,
  price: null,
  quantity:	1,
 }]
  container: true
  contractorActivityType: null,
  contractorId:	null,
  countryCode: null,
  created:	"1646123874461"
  custom: false,
  customsDeclaration: null,
  description: null,
  externalCode:	"null"
  externalId:	"null"
  focused: false
  grouped: false
  gtin:	null,
  id:	22528459,
  markType: "UNKNOWN"
  name: "Наименование номенклатуры"
  NomenclatureFeature (Характеристика номенклатуры)
 [{
   created: "Время создания номенклатуры в формате UNIX Time",
   featureId: "ID Характеристики",
   id: "ID Характеристики",
   nomenclatureId: 22528459,
   value: null,
 }]
  orgMemberPoints:	Количество баллов KPI
  organizationId: ID организации
  parentId:	null,
  paymentSubject: "PRODUCT"
  picture: null,
  picturesIds: [], 
  pluCode: null,
  purchasePrice: 8200,
  sellingPrice:	500,
  tradeObjectRelations:	null,
   [TradeObjectNomenclature (Номенклатура торгового объекта)
 {
   nomenclatureId:	ID номенклатуры
   orgMemberPoints: null,
   organizationId:	ID организации
   sellingPrice:	Цена продажи
   tradeObjectId:	ID торгового объекта
 }]
  type:	"RECIPE",
  unitCode:	"Единица измерения"
  vatId: "ID НДС"
  vatValue:	"20"
  vendorCode: null
  visible:	()
  volume: "null"
  weighted: false
 }
  organizationId:	ID организации
 }


Источник — http://kassa.bifit.com/wiki/index.php?title=API:Создание_номенклатуры_в_справочнике_товаров&oldid=16814