Реализация - API3 Объект

Материал из razgovorov.ru
Перейти к: навигация, поиск

Объект

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

Легенда:

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


Структура:

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

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


Пример: 

{
	'Дата': '01.08.2023',
	'Номер': '20230801-full-upd',
	'Название': 'Реализация копия №20230801-full-upd от 01.08.2023',
	'НашаОрганизация': {'ИдСБИС': '234'},
	'Контрагент': {'ИдСБИС': '244'},
	'Склад': {'ИдСБИС': '245'},
	'Грузоотправитель': {'ИдСБИС': '258'},
	'Грузополучатель': {'ИдСБИС': '248'},
	'Ответственный': {'ИдСБИС': '249'},
	'Валюта': {'ИдСБИС': 'RUB'},
	'СчетУчетаКонтрагент': {'Счет': '41-01'},
	'СчетУчетаАванс': {'Счет': '62-02'},
	'Регламент': 'Реализация копия',
	'Сумма': '2500.00',
	'Комментарий': 'комментарий документа',
	'СуммаВключаетНДС': True,
	'Параметры': [{'Название': 'ПараметрШапки', 'Значение': 'значение1'}],
	'ТаблДок': {
		'Товары': [
			{
				'Количество': '5.0',
				'Цена': '500.00',
				'Сумма': '2500.00',
				'СуммаНДС': '500.00',
				'Номенклатура': {'ИдСБИС': '1'},
				'ЕдИзм': {'ИдСБИС': '796'},
				'СтавкаНДС': {'ИдСБИС': '3'},
				'ГТД': {'Номер': '10216100/050318/0001564',
						'Страна': {'ИдСБИС': '112'}},
				'Параметры': [{'Название': 'ПараметрТабЧасти', 'Значение': 'значение1'}],
				'НомСредИдентТов': [{'НомУпак': '', 'КИЗ': ''}],
				'СведПрослеж': [{'НомТовПрослеж': '', 'КолВЕдПрослеж': ''}],
				
			}
		],
		'Услуги': [
			{
				'Количество': '5.0',
				'Цена': '500.00',
				'Сумма': '2500.00',
				'СуммаНДС': '500.00',
				'Номенклатура': {'ИдСБИС': '1'},
				'ЕдИзм': {'ИдСБИС': '796'},
				'СтавкаНДС': {'ИдСБИС': '3'},
				'Параметры': [{'Название': 'ПараметрТабЧасти', 'Значение': 'значение1'}],
				'Показатель': {'Счет': '41-01'},
				'Комментарий': 'текст комментарий',
			}
		]
	}
}

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

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

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

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

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

  • РеалИсх.Создать
  • РеалИсх.Прочитать
  • РеалИсх.DocNomList
  • РеалИсх.DocNomDeleteAll
  • РеалИсх.NomCreateWithSaveBatch
  • РеалИсх.Записать
  • Документ.ОтменитьПроведение
  • Документ.Провести
  • НашаОрганизация.Существует
  • Contractor.ReadOutLite
  • Документ.ПолучитьСвязанныеДокументыИТипы
  • СменаККМ.ПрочитатьДляУчастника
  • Warehouse.ReadCard
  • Классификаторы.ReadByFullCode
Источник — «http://wiki.razgovorov.ru/index.php?title=Реализация_-_API3_Объект&oldid=7071»