Поступление - API3 Объект

Объект

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

Легенда:

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

Структура:

• Валюта — объект Валюта, валюта документа

развернуть

• Вложение — массив, массив с данными файлов, прилагаемых к документу

• Идентификатор — строка, идентификатор файла в хранилище СБИС Диск
• Тип - строка, название типа формализованного вложения
• ПодТип - строка, название подтипа формализованного вложения
• ВерсияФормата - строка, версия формата
• ПодверсияФормата - строка, подверсия формата
• Файл
  • Имя

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

развернуть

• Основание — массив, массив документов основания

• ВидСвязи — число строкой, код вида связи с документом-основания [1]
• Документ — объект документа-основания (любой объект с типом Документ)
• Сумма — число строкой, сумма связи в валюте учета
• СуммаВалютная — число строкой, сумма связи в валюте документа

• Ответственный — объект ЧастноеЛицо, ответственный за документ

развернуть

• Параметры — массив, массив именованных параметров ключ / значение

• Значение — строка, значение параметра
• Название — строка, название параметра
• Тип — строка, тип параметра [Текст, Многострочный текст, Число, Флаг, Логическое, Дата, Период, Время, Список, Группа флагов, Объект]

развернуть

• Пометки — словарь, пометки по документу

• Проведён — Признак проведения документа, булево
• Важный — отметка Флажок на документе СБИС, булево
• Плюс — отметка Плюс на документе СБИС, булево
• Срочно — отметка Красный круг на документе СБИС, булево
• НеТребуется — отметка Зеленый круг на документе СБИС, булево
• Просмотрен — отметка Синий круг на документе СБИС, булево
• Значительный — отметка Желтый круг на документе СБИС, булево
• ЗакрытоОтИзменений — отметка серая галка на документе СБИС, булево

• Проведён — булево, признак необходимости провести документ. Актуально только для документов с движениями
• Регламент — строка, название регламента
• Состояние — число строкой, код состояния документа
• Сумма — число строкой, сумма документа
• СчетУчетаКонтрагент — объект ПоказательУчета, счет учета с контрагентом
• СчетУчетаАванс — объект ПоказательУчета, счет учета авансов
• Удалён — булево, признак удаленности документа. По умолчанию считаем что документ не помечен на удаление

• Склад — объект Склад
• СуммаВключаетНДС — булево, признак того, что суммы переданы с учетом НДС

• Контрагент — объект Контрагент
• Грузоотправитель — объект Контрагент
• Грузополучатель — объект Контрагент
• ДатаПоставщика — дата поставщика, строка в формате "ДД.ММ.ГГГГ"
• ДокументыСписания — для поступления доп.расходов, документы на которые будет списание, массив
  • Документ — объект документа списания
• РаспределитьРасходыПоКоличеству — флаг необходимости распределения по количеству, булево
• СчетУчетаКонтрагент — объект ПоказательУчета
• СчетУчетаАванс — объект ПоказательУчета
• ТаблДок — словарь таб.частей
  • Товары
    • ГТД — словарь
      • Номер
      • Страна — объект Страна
    • ЕдИзм — объект ЕдиницаИзмерения
    • Количество
    • Номенклатура — объект Номенклатура
    • НомСредИдентТов — массив маркировки
      • КИЗ
      • НомУпак
    • Параметры
      • Значение
      • Название
      • Тип
    • Показатель — объект ПоказательУчета
    • СведПрослеж — массив прослеживаемости
      • КолВЕдПрослеж
      • НомТовПрослеж
    • Себест
    • СебестБезНДС
    • СебестСуммаНДС
    • СтавкаНДС — объект СтавкаНДС
    • Сумма
    • СуммаБезНДС
    • СуммаНДС
    • СуммаСебест
    • СуммаСебестБезНДС
    • Цена
    • ЦенаБезНДС
  • Услуги
    • ЕдИзм — объект ЕдиницаИзмерения
    • Количество
    • Номенклатура — объект Номенклатура
    • Параметры
      • Значение
      • Название
      • Тип
    • Себест
    • СебестБезНДС
    • СебестСуммаНДС
    • Содержание/Комментарий
    • СтавкаНДС — объект СтавкаНДС
    • СтатьяЗатрат — объект СтатьяЗатрат
    • Сумма
    • СуммаБезНДС
    • СуммаНДС
    • СуммаСебест
    • СуммаСебестБезНДС
    • СчетЗатрат/Показатель — объект ПоказательУчета
    • Цена
    • ЦенаБезНДС

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

Пример:

{
	'Дата': '02.08.2023',
	'Номер': '20230802-full-upd',
	'НашаОрганизация': {'ИдСБИС': '234'},
	'Контрагент': {'ИдСБИС': '244'},
	'Название': 'Поступление №20230802-full-upd от 02.08.2023',
	'Склад': {'ИдСБИС': '254'},
	'Грузоотправитель': {'ИдСБИС': '252'},
	'Грузополучатель': {'ИдСБИС': '258'},
	'Ответственный': {'ИдСБИС': '256'},
	'Валюта': {'ИдСБИС': 'RUB'},
	'СчетУчетаКонтрагент': {'Счет': '62-01'},
	'СчетУчетаАванс': {'Счет': '62-02'},
	'Регламент': 'Поступление',
	'Сумма': '1200.00',
	'Комментарий': 'комментарий нового документа',
	'СуммаВключаетНДС': True,
	'ТаблДок': {
		'Товары': [
			{
				'Количество': '1.0',
				'Цена': '1000.00',
				'Сумма': '1000.00',
				'СуммаНДС': '166.67',
				'Номенклатура': {'ИдСБИС': '3'},
				'ЕдИзм': {'ИдСБИС': '796'},
				'СтавкаНДС': {'ИдСБИС': '3'},
				'НомСредИдентТов': [{'НомУпак': '', 'КИЗ': ''}],
				'СведПрослеж': [{'НомТовПрослеж': '', 'КолВЕдПрослеж': ''}],
			}
		],
		'Услуги': [
			{
				'Количество': '1.0',
				'Цена': '200.00',
				'Сумма': '200.00',
				'СуммаНДС': '0.00',
				'Номенклатура': {'ИдСБИС': '2'},
				'ЕдИзм': {'ИдСБИС': '356'},
				'СтавкаНДС': {'ИдСБИС': '6'},
				'СтатьяЗатрат': {'ИдСБИС': '44'},
				'СчетЗатрат': {'Счет': '26-01'},
				'Показатель': {'Счет': '26-01'},
				'Содержание': 'оплата за услуги доставки'
			}
		]
	}
}

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

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

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

• Валюта
• Договор
• ЕдиницаИзмерения
• ЗаказПокупателя
• ЗаказПоставщику
• Контрагент
• НашаОрганизация
• Номенклатура
• ПоказательУчета
• Склад
• Страна
• СтавкаНДС
• СтатьяЗатрат
• ЧастноеЛицо

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

• РеалВх.Создать
• РеалВх.Прочитать
• РеалВх.DocNomList
• РеалВх.DocNomDeleteAll
• РеалВх.NomCreateWithSaveBatch
• РеалВх.Записать
• Документ.ОтменитьПроведение
• Документ.Провести
• НашаОрганизация.Существует
• Contractor.ReadOutLite
• Warehouse.ReadCard
• Классификаторы.ReadByFullCode