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

Материал из razgovorov.ru
Перейти к: навигация, поиск
м (Разговоров Михаил переименовал страницу ДоговорыКонтрагентов - API3 Объект в Договор - API3 Объект без оставления перенаправления)
(не показано 9 промежуточных версий 3 участников)
Строка 1: Строка 1:
===Объект===
+
{{Документ!_-_API3_Объект}}
* ИдИС - идентификатор документа в ИС (строка)
+
* <span style="color:#E70000">ГруппаРегламентов</span> - строка, группа регламентов к которой относится регламент договора
* ИдСБИС - идентификатор документа в СБИС (строка)
+
* Контрагент* - объект [[Контрагент_-_API3_Объект|Контрагент]]
* Номер - номер документа (строка)
+
* ОплатаВВалюте - булево, флаг проведения оплаты в валюте
* Дата - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
 
* Название - название документа
+
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
* Стороны
 
** Организация* - объект [[Организация_-_API3_Объект|Организация]]
 
** Контрагент * - объект [[Контрагент_-_API3_Объект|Контрагент]]
 
  
 
'''Пример:'''
 
'''Пример:'''
 
<source lang="json">
 
<source lang="json">
 
{
 
{
  "ИдИС": "3f63c7a1-0e00-11e7-adce-080027358f3f",
+
    "Валюта": {"ИдСБИС": "RUB"},
  "Номер": "12121",
+
    "ВнешнийИдентификатор": "3f63c7a1-0e00-11e7-adce-080027358f3f",
  "Дата": "21.03.2017",
+
    "Дата": "01.01.2025",
  "Название": "Договор поставки",
+
    "Комментарий": "full_case, версия 1",
  "Стороны": {
+
    "НашаОрганизация": {"ИдСБИС": "258"},
    "Контрагент": {"ИдИС": "b9321b88-2648-11e6-ab23-080027358f3f"},
+
    "Номер": "full_case1",
    "НашаОрганизация": {"ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f"}
+
    "Регламент": "Договор",
  },
+
    "Удалён": false,
 +
    "Контрагент": {"ИдСБИС": "398"},
 +
    "ОплатаВВалюте": false
 
}
 
}
 
</source>
 
</source>
Строка 25: Строка 24:
 
===Естественные ключи===
 
===Естественные ключи===
 
* Ключ1 - номер документа + дата документа + контрагент + организация(вес = 3)
 
* Ключ1 - номер документа + дата документа + контрагент + организация(вес = 3)
** Ключ1_1 - номер документа
+
** Ключ1_1 - строка, номер документа
** Ключ1_2 - дата документа
+
** Ключ1_2 - строка в формате "ДД.ММ.ГГГГ", дата документа
** Ключ1_3 - идентификатор контрагента в ИС
+
** Ключ1_3 - строка, идентификатор организации
** Ключ1_4 - идентификатор организации в ИС
+
** Ключ1_4 - строка, идентификатор контрагента
* Ключ2 - идентификатор документа в ИС
+
* Ключ2 - не используется
* Ключ3 - не используется
+
* Ключ3 - строка, идентификатор внешней системы
  
 
===Зависит от объектов===
 
===Зависит от объектов===

Версия 16:23, 29 апреля 2025

Объект

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

Легенда:

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


Структура:

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

Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону

Пример:

{
    "Валюта": {"ИдСБИС": "RUB"},
    "ВнешнийИдентификатор": "3f63c7a1-0e00-11e7-adce-080027358f3f",
    "Дата": "01.01.2025",
    "Комментарий": "full_case, версия 1",
    "НашаОрганизация": {"ИдСБИС": "258"},
    "Номер": "full_case1",
    "Регламент": "Договор",
    "Удалён": false,
    "Контрагент": {"ИдСБИС": "398"},
    "ОплатаВВалюте": false
}

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

  • Ключ1 - номер документа + дата документа + контрагент + организация(вес = 3)
    • Ключ1_1 - строка, номер документа
    • Ключ1_2 - строка в формате "ДД.ММ.ГГГГ", дата документа
    • Ключ1_3 - строка, идентификатор организации
    • Ключ1_4 - строка, идентификатор контрагента
  • Ключ2 - не используется
  • Ключ3 - строка, идентификатор внешней системы

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

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

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

  • ДоговорДок.Прочитать
  • ДоговорДок.Записать
  • ДоговорДок.Создать
  • ДоговорДок.СписокХраним