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

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показана 21 промежуточная версия 6 участников)
Строка 1: Строка 1:
===Объект===
+
{{ДокументПродаж_-_API3_Объект}}
* ИдИС * - идентификатор документа в ИС (строка)
+
* Грузоотправитель - объект [[Контрагент_-_API3_Объект|Контрагент]]
* Номер - номер документа (строка)
+
* Грузополучатель - объект [[Контрагент_-_API3_Объект|Контрагент]]
* Дата - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
* <span style="color:#E70000">СуммаОплатыКартой</span> - сумма оплаты картой (для реализаций розницы по безналу)
* Стороны
+
* <span style="color:#E70000">СуммаОплатыКартойВозврат</span> - возвращенная сумма оплаты картой (для реализаций розницы по безналу)
** Поставщик* - объект [[Организация_-_API3_Объект|Организация]]
+
* СчетУчетаКонтрагент - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
** Покупатель * - объект [[Контрагент_-_API3_Объект|Контрагент]]
+
* СчетУчетаАванс - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
** Грузоотправитель
+
* <span style="color:#E70000">СкладСписания</span> – склад списания (объект склад [[Склад_-_API3_Объект|Склад]])
** Грузополучатель - объект [[Контрагент_-_API3_Объект|Контрагент]]
+
* ТаблДок - словарь таб.частей
* Склад - объект [[Склад_-_API3_Объект|Склад]]
+
** Товары
* ТаблДок - данные о номенклатуре документа
+
*** Номенклатура - объект [[Номенклатура_-_API3_Объект|Номенклатура]]
** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
+
*** Количество
** ЕдИзм - объект [[ЕдиницаИзмерения_-_API3_Объект|Единица измерения]]
+
*** Цена
** Количество - количество услуг
+
*** Сумма
** Цена - цена за 1 услугу
+
*** СуммаНДС
** Сумма - итоговая сумма
+
*** ЕдИзм - объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
+
*** СтавкаНДС - объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 +
*** НомСредИдентТов - массив маркировки
 +
**** НомУпак
 +
**** КИЗ
 +
*** СведПрослеж - массив прослеживаемости
 +
**** КолВЕдПрослеж
 +
**** НомТовПрослеж
 +
*** ГТД - словарь
 +
**** Номер
 +
**** Страна - объект [[Страна_-_API3_Объект|Страна]]
 +
*** Параметры
 +
**** Название
 +
**** Значение
 +
**** Тип
 +
*** <span style="color:#E70000">Показатель</span> - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
*** <span style="color:#E70000">СуммаБезНДС</span>
 +
*** <span style="color:#E70000">ЦенаБезНДС</span>
 +
*** <span style="color:#E70000">Состав</span> - массив
 +
**** Номенклатура - объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
**** Количество
 +
** Услуги
 +
*** Номенклатура - объект [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
*** Количество
 +
*** Цена
 +
*** Сумма
 +
*** СуммаНДС
 +
*** ЕдИзм - объект [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 +
*** СтавкаНДС - объект [[СтавкаНДС_-_API3_Объект|СтавкаНДС]]
 +
*** Показатель - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
*** Комментарий
 +
*** Параметры
 +
**** Название
 +
**** Значение
 +
**** Тип
 +
*** <span style="color:#E70000">Показатель</span> - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
*** <span style="color:#E70000">СуммаБезНДС</span>
 +
*** <span style="color:#E70000">ЦенаБезНДС</span>
 +
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
  
  
Строка 21: Строка 58:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
  "ИдИС": "7cf838b6-f9e6-11e7-ad08-3497f6377b7e",
+
'Дата': '01.08.2023',
  "Номер": "00000000001",
+
'Номер': '20230801-full-upd',
  "Дата": "15.01.2018",
+
'Название': 'Реализация копия №20230801-full-upd от 01.08.2023',
  "Стороны": {
+
'НашаОрганизация': {'ИдСБИС': '234'},
    "Покупатель": {"ИдИС": "56c61dec-e570-11e3-893a-005056c00008"},
+
'Контрагент': {'ИдСБИС': '244'},
    "Продавец": {"ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f"},
+
'Склад': {'ИдСБИС': '245'},
  },
+
'Грузоотправитель': {'ИдСБИС': '258'},
  "Склад": {"ИдИС": "56c61dee-e570-11e3-893a-005056c00008"},
+
'Грузополучатель': {'ИдСБИС': '248'},
  "ТаблДок": [
+
'Ответственный': {'ИдСБИС': '249'},
      {
+
'Валюта': {'ИдСБИС': 'RUB'},
        "Номенклатура": {"ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f"},
+
'СчетУчетаКонтрагент': {'Счет': '41-01'},
        "ЕдИзм": {"ИдИС": "05a33302-ec71-11e7-9153-3497f6377b7e"},
+
'СчетУчетаАванс': {'Счет': '62-02'},
        "Количество": "3.000",
+
'Регламент': 'Реализация копия',
        "Цена": 500,
+
'Сумма': '2500.00',
        "Сумма": "1500.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'},
 +
'Комментарий': 'текст комментарий',
 +
}
 +
]
 +
}
 
}
 
}
 
</source>
 
</source>
Строка 57: Строка 126:
 
* Склад
 
* Склад
 
* ЕдиницаИзмерения
 
* ЕдиницаИзмерения
 +
* СчетНаОплату
 +
* Договор
 +
* Валюта
 +
* ПоказательУчета
 +
* Страна
 +
* СтавкаНДС
 +
* ЗаказПокупателя
 +
* ЗаказПоставщику
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
 
* РеалИсх.Создать
 
* РеалИсх.Создать
* РеалИсх.DocNomCreate
+
* РеалИсх.Прочитать
 +
* РеалИсх.DocNomList
 +
* РеалИсх.DocNomDeleteAll
 +
* РеалИсх.NomCreateWithSaveBatch
 
* РеалИсх.Записать
 
* РеалИсх.Записать
 +
* Документ.ОтменитьПроведение
 +
* Документ.Провести
 +
* НашаОрганизация.Существует
 +
* Contractor.ReadOutLite
 +
* Документ.ПолучитьСвязанныеДокументыИТипы
 +
* СменаККМ.ПрочитатьДляУчастника
 +
* Warehouse.ReadCard
 +
* Классификаторы.ReadByFullCode
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

Текущая версия на 12:02, 27 декабря 2023

Объект

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

Легенда:

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


Структура:

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

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