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

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 7 промежуточных версий 2 участников)
Строка 1: Строка 1:
 
{{ДокументПродаж_-_API3_Объект}}
 
{{ДокументПродаж_-_API3_Объект}}
* Грузоотправитель - объект [[Контрагент_-_API3_Объект|Контрагент]]
+
* Грузоотправитель объект [[Контрагент_-_API3_Объект|Контрагент]]
* Грузополучатель - объект [[Контрагент_-_API3_Объект|Контрагент]]
+
* Грузополучатель объект [[Контрагент_-_API3_Объект|Контрагент]]
* <span style="color:#077F0B">ДатаПоставщика</span> - дата поставщика
+
* <span style="color:#077F0B">ДатаПоставщика</span> дата поставщика, строка в формате "ДД.ММ.ГГГГ"
* <span style="color:#077F0B">ДокументыСписания</span> - для поступления доп.расходов, документы на которые будет списание
+
* <span style="color:#077F0B">ДокументыСписания</span> для поступления доп.расходов, документы на которые будет списание, массив
* <span style="color:#077F0B">РаспределитьРасходыПоКоличеству</span> - булевский флаг необходимости распределения по количеству
+
** Документ — объект документа списания
* ТаблДок - словарь таб.частей
+
* <span style="color:#077F0B">РаспределитьРасходыПоКоличеству</span> флаг необходимости распределения по количеству, булево
 +
* СчетУчетаКонтрагент — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
* СчетУчетаАванс — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
* ТаблДок словарь таб.частей
 
** Товары
 
** Товары
*** Номенклатура - объект [[Номенклатура_-_API3_Объект|Номенклатура]]
+
*** ГТД — словарь
 +
**** Номер
 +
**** Страна — объект [[Страна_-_API3_Объект|Страна]]
 +
*** ЕдИзм — объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
*** Количество
 
*** Количество
*** Цена
+
*** Номенклатура — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
*** Сумма
+
*** НомСредИдентТов — массив маркировки
*** СуммаНДС
+
**** КИЗ
** <span style="color:#E70000">Себест</span>
 
** <span style="color:#E70000">СебестБезНДС</span>
 
** <span style="color:#E70000">СебестСуммаНДС</span>
 
** <span style="color:#E70000">СуммаБезНДС</span>
 
** <span style="color:#E70000">СуммаСебест</span>
 
** <span style="color:#E70000">СуммаСебестБезНДС</span>
 
** <span style="color:#E70000">ЦенаБезНДС</span>
 
*** ЕдИзм - объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
*** СтавкаНДС - объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 
*** НомСредИдентТов - массив маркировки
 
 
**** НомУпак
 
**** НомУпак
**** КИЗ
+
*** Параметры
*** СведПрослеж - массив прослеживаемости
+
**** Значение
 +
**** Название
 +
**** Тип
 +
*** <span style="color:#E70000">Показатель</span> — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
*** СведПрослеж массив прослеживаемости
 
**** КолВЕдПрослеж
 
**** КолВЕдПрослеж
 
**** НомТовПрослеж
 
**** НомТовПрослеж
*** ГТД - словарь
+
*** <span style="color:#E70000">Себест</span>
**** Номер
+
*** <span style="color:#E70000">СебестБезНДС</span>
**** Страна - объект [[Страна_-_API3_Объект|Страна]]
+
*** <span style="color:#E70000">СебестСуммаНДС</span>
** Параметры
+
*** СтавкаНДС — объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
*** Название
+
*** Сумма
*** Значение
+
*** <span style="color:#E70000">СуммаБезНДС</span>
*** Тип
+
*** СуммаНДС
 
+
*** <span style="color:#E70000">СуммаСебест</span>
 +
*** <span style="color:#E70000">СуммаСебестБезНДС</span>
 +
*** Цена
 +
*** <span style="color:#E70000">ЦенаБезНДС</span>
 
** Услуги
 
** Услуги
*** Номенклатура - объект [[Номенклатура_-_API3_Объект|Номенклатура]]
+
*** ЕдИзм — объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
*** Количество
 
*** Количество
*** Цена
+
*** Номенклатура — объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
*** Параметры
 +
**** Значение
 +
**** Название
 +
**** Тип
 +
*** <span style="color:#E70000">Себест</span>
 +
*** <span style="color:#E70000">СебестБезНДС</span>
 +
*** <span style="color:#E70000">СебестСуммаНДС</span>
 +
*** Содержание/Комментарий
 +
*** СтавкаНДС — объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 +
*** СтатьяЗатрат — объект [[СтатьяЗатрат_-_API3_Объект|СтатьяЗатрат]]
 
*** Сумма
 
*** Сумма
 +
*** <span style="color:#E70000">СуммаБезНДС</span>
 
*** СуммаНДС
 
*** СуммаНДС
** <span style="color:#E70000">Себест</span>
+
*** <span style="color:#E70000">СуммаСебест</span>
** <span style="color:#E70000">СебестБезНДС</span>
+
*** <span style="color:#E70000">СуммаСебестБезНДС</span>
** <span style="color:#E70000">СебестСуммаНДС</span>
+
*** СчетЗатрат/Показатель — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
** <span style="color:#E70000">СуммаБезНДС</span>
+
*** Цена
** <span style="color:#E70000">СуммаСебест</span>
+
*** <span style="color:#E70000">ЦенаБезНДС</span>
** <span style="color:#E70000">СуммаСебестБезНДС</span>
 
** <span style="color:#E70000">ЦенаБезНДС</span>
 
*** ЕдИзм - объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
*** СтавкаНДС - объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 
*** СтатьяЗатрат - объект [[СтатьяЗатрат_-_API3_Объект|СтатьяЗатрат]]
 
*** СчетЗатрат/Показатель - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 
*** Содержание/Комментарий
 
 
 
  
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
Строка 111: Строка 117:
  
 
===Естественные ключи===
 
===Естественные ключи===
* Ключ1 - номер документа + дата документа + организация + контрагент(вес = 3)
+
* Ключ1 номер документа + дата документа + организация + контрагент(вес = 3)
** Ключ1_1 - номер документа
+
** Ключ1_1 номер документа
** Ключ1_2 - дата документа
+
** Ключ1_2 дата документа
** Ключ1_3 - идентификатор организации в ИС
+
** Ключ1_3 идентификатор организации в ИС
** Ключ1_4 - идентификатор контрагента в ИС
+
** Ключ1_4 идентификатор контрагента в ИС
* Ключ2 - не используется
+
* Ключ2 не используется
* Ключ3 - не используется
+
* Ключ3 не используется
  
 
===Зависит от объектов===
 
===Зависит от объектов===
 +
* Валюта
 +
* Договор
 +
* ЕдиницаИзмерения
 +
* ЗаказПокупателя
 +
* ЗаказПоставщику
 +
* Контрагент
 
* НашаОрганизация
 
* НашаОрганизация
 
* Номенклатура
 
* Номенклатура
* Контрагент
+
* ПоказательУчета
 
* Склад
 
* Склад
* ЕдиницаИзмерения
 
* Договор
 
* Валюта
 
* ПоказательУчета
 
 
* Страна
 
* Страна
 
* СтавкаНДС
 
* СтавкаНДС
* ЗаказПокупателя
+
* СтатьяЗатрат
* ЗаказПоставщику
+
* ЧастноеЛицо
 +
 
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===

Текущая версия на 18:30, 19 июля 2024

Объект

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

Легенда:

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


Структура:

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

Объем данных возвращаемых методом 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