ПользовательскийДокумент - API3 Объект — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
Строка 1: Строка 1:
 +
{{Документ!_-_API3_Объект}}
 +
* <span style="color:#077F0B">ПодТипДокумента*</span> - подтип пользовательского документа
  
===Объект===
 
Тип: Документ
 
 
{{Легенда_-_API3_Объект}}
 
 
 
'''Структура:'''
 
* ИдИС  - идентификатор документа в ИС (строка)
 
* ИдСБИС - идентификатор документа в СБИС (строка)
 
* ИмяСБИС - имя api3 объекта
 
* Название - представление объекта
 
* Номер* - номер документа (строка)
 
* Дата* - дата документа (строка в формате "ДД.ММ.ГГГГ")
 
* НашаОрганизация* - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]]
 
* Комментарий - строка
 
* <span style="color:#077F0B">ПодТипДокумента*</span> - подтип пользовательского документа
 
<div class="mw-collapsible mw-collapsed">
 
* Вложение - массив с данными файлов, прилагаемых к документу
 
<div class="mw-collapsible-content">
 
:* Идентификатор - идентификатор файла в хранилище СБИС Диск
 
:* Файл
 
:** Имя
 
</div></div>
 
 
'''Пример:'''
 
'''Пример:'''
 
<source lang="json">
 
<source lang="json">

Версия 10:30, 25 июня 2024

Объект

Тип: Документ

Легенда:

  • Реквизиты черного цвета поддерживаются синхронизацией в обоих направлениях
  • Реквизиты зеленого цвета поддерживаются синхронизацией только в СБИС
  • Реквизиты красного цвета поддерживаются синхронизацией только из СБИС


Структура:

  • Валюта — объект Валюта, валюта документа
  • Вложение — массив, массив с данными файлов, прилагаемых к документу
  • Идентификатор — строка, идентификатор файла в хранилище СБИС Диск
  • Тип - строка, название типа формализованного вложения
  • ПодТип - строка, название подтипа формализованного вложения
  • ВерсияФормата - строка, версия формата
  • ПодверсияФормата - строка, подверсия формата
  • Файл
    • Имя
  • ВнешнийИдентификатор — строка, внешний идентификатор документа в СБИС. Если передан является ключом поиска документа без учета типа (в СБИС это уникальное поле в разрезе всех типов документов). При создании будет записан и в последующем документ может быть найден по нему, даже при условии изменившихся других ключей
  • Дата* — строка в формате "ДД.ММ.ГГГГ", дата документа
  • ЗапуститьЭДО — булево, признак необходимости запустить документ в ДО. Документооборот по умолчанию не запускается. Запускается при условии, что передан флаг, создается новый документ, действие на этапе не требует выбора ответственного или подписания. Актуально только для документов с фазами ЭДО
  • ИдентификаторВИ — ПОЛЕ УСТАРЕЛО, использовать поле ВнешнийИдентификатор
  • ИдентификаторДокумента — строка, идентификатор ЭДО
  • Комментарий — строка, комментарий к документу
  • Курс — число строкой, курс документа
  • Название — строка, представление документа
  • НашаОрганизация* — объект НашаОрганизация, организация документа
  • Номер* — строка, номер документа
  • Основание — массив, массив документов основания
  • ВидСвязи — число строкой, код вида связи с документом-основания [1]
  • Документ — объект документа-основания (любой объект с типом Документ)
  • Сумма — число строкой, сумма связи в валюте учета
  • СуммаВалютная — число строкой, сумма связи в валюте документа
  • Ответственный — объект ЧастноеЛицо, ответственный за документ
  • Параметры — массив, массив именованных параметров ключ / значение
  • Значение — строка или объект, значение параметра
  • Название — строка, название параметра
  • Тип — строка, тип параметра [Текст, Многострочный текст, Число, Флаг, Логическое, Дата, Период, Время, Список, Группа флагов, Объект]
  • Пометки — словарь, пометки по документу
  • Проведён — Признак проведения документа, булево
  • Важный — отметка Флажок на документе СБИС, булево
  • Плюс — отметка Плюс на документе СБИС, булево
  • Срочно — отметка Красный круг на документе СБИС, булево
  • НеТребуется — отметка Зеленый круг на документе СБИС, булево
  • Просмотрен — отметка Синий круг на документе СБИС, булево
  • Значительный — отметка Желтый круг на документе СБИС, булево
  • ЗакрытоОтИзменений — отметка серая галка на документе СБИС, булево
  • Проведён — булево, признак необходимости провести документ. Актуально только для документов с движениями
  • Регламент — строка, название регламента
  • Состояние — число строкой, код состояния документа
  • Сумма — число строкой, сумма документа
  • СчетУчетаКонтрагент — объект ПоказательУчета, счет учета с контрагентом
  • СчетУчетаАванс — объект ПоказательУчета, счет учета авансов
  • Удалён — булево, признак удаленности документа. По умолчанию считаем что документ не помечен на удаление
  • ПодТипДокумента* - подтип пользовательского документа

Пример:

{
  "ИдИС": "7cf838b6-f9e6-11e7-ad08-3497f6377b7e",
  "ИдСБИС": "54565",
  "Номер": "00000000001",
  "Дата": "15.01.2018",
  "Комментарий": "Текст комментария",
  "НашаОрганизация": {
    "ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f",
    "ИмяСБИС": "НашаОрганизация"
  },
  "Контрагент": {
    "ИдИС": "b9321b88-2648-11e6-ab23-080027358f3f",
    "ИмяСБИС": "Контрагент"
  }
}

Естественные ключи

  • Ключ1 - номер документа + дата документа + организация + контрагент(вес = 3)
    • Ключ1_1 - номер документа
    • Ключ1_2 - дата документа
    • Ключ1_3 - идентификатор организации в ИС
    • Ключ1_4 - идентификатор контрагента в ИС
  • Ключ2 - не используется
  • Ключ3 - не используется

Зависит от объектов

  • НашаОрганизация
  • Контрагент

Используемые методы БЛ