ProductService: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Список методов сервиса=>Список операций)
 
(не показано 11 промежуточных версий 2 участников)
Строка 1: Строка 1:
==Описание сервиса==
==Общие сведения==
 
Сервис '''ProductService''' используется для получения данных о продукции через API. Описание всей подконтрольной продукции разделено на четыре уровня, три из который заполняются централизовано в Россельхознадзоре, а четвёртый доступен для заполнения хозяйствующим субъектом.
 
Указание продукции обязательно при оформлении [[ProductionOperation|производственных сертификатов]], при [[IncomingOperation|гашении входных сертификатов]], при [[MergeOperation|объединении записей складского журнала]], а также при [[ResolveDiscrepancyOperation|инвентаризации]].


Данный веб-сервис предоставляет доступ к следующим справочникам через API:
Данный веб-сервис предоставляет доступ к следующим справочникам через API:
Строка 7: Строка 11:
* справочник наименований продукции предприятий-производителей.
* справочник наименований продукции предприятий-производителей.


 
==Список операций==
==Список методов сервиса==


Список предоставляемых операций:
Список предоставляемых операций:
Строка 19: Строка 22:
# [[GetSubProductByProductList]] — получение списка видов продукции по указанному продукту;
# [[GetSubProductByProductList]] — получение списка видов продукции по указанному продукту;
# [[GetSubProductChangesList]] — получение истории изменений по справочнику видов продукции;
# [[GetSubProductChangesList]] — получение истории изменений по справочнику видов продукции;
# GetProductItemByGuid — получение актуальной версии наименования продукции по глобальному идентификатору;
# [[GetProductItemByGuid]] — получение актуальной версии наименования продукции по глобальному идентификатору;
# GeProductItemByUuid — получение наименования продукции по идентификатору;
# [[GetProductItemByUuid]] — получение наименования продукции по идентификатору;
# GetProductItemByProductList — получение списка наименований продукции по указанному виду продукции и идентификатору предприятия-производителя;
# [[GetProductItemList]] — получение списка наименований продукции по указанному виду продукции и идентификатору предприятия-производителя;
# GetProductItemChangesList — получение истории изменений по справочнику наименований продукции для предприятия-производителя.
# [[GetProductItemChangesList]] — получение истории изменений по справочнику наименований продукции для предприятия-производителя.
 
==Уровни продукции==
* Тип продукции - первый уровень иерархии справочника продукции. На данный момент введено всего 8 типов продукции:
# Мясо и мясопродукты;
# Корма и кормовые добавки;
# Живые животные;
# Лекарственные средства;
# Пищевые продукты;
# Непищевые продукты;
# Рыба и морепродукты;
# Продукция, не требующая разрешения.
 
* Продукция - второй уровень иерархии справочника продукции. К каждому типу отнесено множество продукции, приводить каждый здесь не имеет смысла.
* Вид продукции - третий уровень иерархии справочника продукции. У каждой продукции существует множество видов, которые представлены в справочнике.
 
* Номенклатура производителя. Этот уровень может быть заполнен самим хозяйствующим субъектом с помощью метода [[ModifyProducerStockListOperation|ModifyProducerStockList]]. На данный момент заполнение этого уровня справочника для предприятия является не обязательным, но желательным.

Текущая версия на 13:50, 5 декабря 2016

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

Сервис ProductService используется для получения данных о продукции через API. Описание всей подконтрольной продукции разделено на четыре уровня, три из который заполняются централизовано в Россельхознадзоре, а четвёртый доступен для заполнения хозяйствующим субъектом.

Указание продукции обязательно при оформлении производственных сертификатов, при гашении входных сертификатов, при объединении записей складского журнала, а также при инвентаризации.

Данный веб-сервис предоставляет доступ к следующим справочникам через API:

  • справочник продукции;
  • справочник видов продукции;
  • справочник типов продукции;
  • справочник наименований продукции предприятий-производителей.

Список операций

Список предоставляемых операций:

  1. GetProductByGuid — получение актуальной версии продукции по глобальному идентификатору;
  2. GetProductByUuid — получение продукции по идентификатору;
  3. GetProductByTypeList — получение списка продукции по указанному типу;
  4. GetProductChangesList — получение истории изменений для справочника продукции;
  5. GetSubProductByGuid — получение актуальной версии вида продукции по глобальному идентификатору;
  6. GetSubProductByUuid — получение вида продукции по идентификатору;
  7. GetSubProductByProductList — получение списка видов продукции по указанному продукту;
  8. GetSubProductChangesList — получение истории изменений по справочнику видов продукции;
  9. GetProductItemByGuid — получение актуальной версии наименования продукции по глобальному идентификатору;
  10. GetProductItemByUuid — получение наименования продукции по идентификатору;
  11. GetProductItemList — получение списка наименований продукции по указанному виду продукции и идентификатору предприятия-производителя;
  12. GetProductItemChangesList — получение истории изменений по справочнику наименований продукции для предприятия-производителя.

Уровни продукции

  • Тип продукции - первый уровень иерархии справочника продукции. На данный момент введено всего 8 типов продукции:
  1. Мясо и мясопродукты;
  2. Корма и кормовые добавки;
  3. Живые животные;
  4. Лекарственные средства;
  5. Пищевые продукты;
  6. Непищевые продукты;
  7. Рыба и морепродукты;
  8. Продукция, не требующая разрешения.
  • Продукция - второй уровень иерархии справочника продукции. К каждому типу отнесено множество продукции, приводить каждый здесь не имеет смысла.
  • Вид продукции - третий уровень иерархии справочника продукции. У каждой продукции существует множество видов, которые представлены в справочнике.
  • Номенклатура производителя. Этот уровень может быть заполнен самим хозяйствующим субъектом с помощью метода ModifyProducerStockList. На данный момент заполнение этого уровня справочника для предприятия является не обязательным, но желательным.