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

Материал из razgovorov.ru
Перейти к: навигация, поиск
 
(не показано 9 промежуточных версий 2 участников)
Строка 1: Строка 1:
===Объект===
+
{{ДокументПродаж_-_API3_Объект}}
Тип: Документ
+
* Грузоотправитель - объект [[Контрагент_-_API3_Объект|Контрагент]]
 
+
* Грузополучатель - объект [[Контрагент_-_API3_Объект|Контрагент]]
'''Структура:'''
+
* <span style="color:#077F0B">ДатаПоставщика</span> - дата поставщика
* Дата* - дата документа
+
* <span style="color:#077F0B">ДокументыСписания</span> - для поступления доп.расходов, документы на которые будет списание
* Номер* - номер документа
+
* <span style="color:#077F0B">РаспределитьРасходыПоКоличеству</span> - булевский флаг необходимости распределения по количеству
* НашаОрганизация* - объект [[НашаОрганизация_-_API3_Объект|НашаОрганизация]])
+
* СчетУчетаКонтрагент - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
* Контрагент - объект [[Контрагент_-_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_Объект|СтавкаНДС]]
 +
*** НомСредИдентТов - массив маркировки
 +
**** НомУпак
 +
**** КИЗ
 +
*** СведПрослеж - массив прослеживаемости
 +
**** КолВЕдПрослеж
 +
**** НомТовПрослеж
 +
*** ГТД - словарь
 
**** Номер
 
**** Номер
**** СтранаНазвание
+
**** Страна - объект [[Страна_-_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_Объект|СтавкаНДС]]
 +
*** СтатьяЗатрат - объект [[СтатьяЗатрат_-_API3_Объект|СтатьяЗатрат]]
 +
*** СчетЗатрат/Показатель - объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]]
 +
*** Содержание/Комментарий
 +
*** Параметры
 +
**** Название
 +
**** Значение
 +
**** Тип
  
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
 
'''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону'''
Строка 47: Строка 65:
 
<source lang="json">
 
<source lang="json">
 
{
 
{
  "ИдИС": "ИдИС",
+
'Дата': '02.08.2023',
  "Номер": "FOR_UPDATE1FOR_UPDATE1",
+
'Номер': '20230802-full-upd',
  "Дата": "15.11.2020",
+
'НашаОрганизация': {'ИдСБИС': '234'},
  "СуммаВключаетНДС": "Да",
+
'Контрагент': {'ИдСБИС': '244'},
  "НашаОрганизация": {
+
'Название': 'Поступление №20230802-full-upd от 02.08.2023',
    "ИдСБИС": "167"
+
'Склад': {'ИдСБИС': '254'},
  },
+
'Грузоотправитель': {'ИдСБИС': '252'},
  "Контрагент": {
+
'Грузополучатель': {'ИдСБИС': '258'},
    "ИдСБИС": "488"
+
'Ответственный': {'ИдСБИС': '256'},
  },
+
'Валюта': {'ИдСБИС': 'RUB'},
  "Грузоотправитель": {
+
'СчетУчетаКонтрагент': {'Счет': '62-01'},
    "ИдСБИС": "227"
+
'СчетУчетаАванс': {'Счет': '62-02'},
  },
+
'Регламент': 'Поступление',
  "Грузополучатель": {
+
'Сумма': '1200.00',
    "ИдСБИС": "252"
+
'Комментарий': 'комментарий нового документа',
  },
+
'СуммаВключаетНДС': True,
  "Склад": {
+
'ТаблДок': {
    "ИдСБИС": "3240"
+
'Товары': [
  },
+
{
  "Сумма": "500.00",
+
'Количество': '1.0',
  "Регламент": "для unittest",
+
'Цена': '1000.00',
  "Комментарий": "обновили",
+
'Сумма': '1000.00',
  "Параметры": [
+
'СуммаНДС': '166.67',
    {
+
'Номенклатура': {'ИдСБИС': '3'},
      "Название": "Параметр1",
+
'ЕдИзм': {'ИдСБИС': '796'},
      "Значение": "обновили"
+
'СтавкаНДС': {'ИдСБИС': '3'},
    }
+
'НомСредИдентТов': [{'НомУпак': '', 'КИЗ': ''}],
  ],
+
'СведПрослеж': [{'НомТовПрослеж': '', 'КолВЕдПрослеж': ''}],
  "ТаблДок": {
+
}
    "Товары": [
+
],
      {
+
'Услуги': [
        "Номенклатура": {
+
{
          "ИдСБИС": "61"
+
'Количество': '1.0',
        },
+
'Цена': '200.00',
        "СтавкаНДС": {
+
'Сумма': '200.00',
          "ИдСБИС": "1"
+
'СуммаНДС': '0.00',
        },
+
'Номенклатура': {'ИдСБИС': '2'},
        "Количество": "2.0",
+
'ЕдИзм': {'ИдСБИС': '356'},
        "Сумма": "200.00",
+
'СтавкаНДС': {'ИдСБИС': '6'},
        "СуммаНДС": "18.18",
+
'СтатьяЗатрат': {'ИдСБИС': '44'},
        "НомСредИдентТов": [
+
'СчетЗатрат': {'Счет': '26-01'},
          {
+
'Показатель': {'Счет': '26-01'},
            "КИЗ": "010290000024725321i=s8Z_&lt;K8X2At"
+
'Содержание': 'оплата за услуги доставки'
          },
+
}
          {
+
]
            "НомУпак": "66666666"
+
}
          }
 
        ],
 
        "ГТД": {
 
          "Номер": "10702030/260917/0080321",
 
          "СтранаНазвание": "Федеративная Республика Германия",
 
          "СтранаКод": "276"
 
        }
 
      }
 
    ],
 
    "Услуги": [
 
      {
 
        "Номенклатура": {
 
          "ИдСБИС": "321"
 
        },
 
        "Количество": "3.0",
 
        "Сумма": "300.00",
 
        "СуммаНДС": "50.00"
 
      }
 
    ]
 
  }
 
 
}
 
}
 
</source>
 
</source>
Строка 127: Строка 125:
 
===Зависит от объектов===
 
===Зависит от объектов===
 
* НашаОрганизация
 
* НашаОрганизация
 +
* Номенклатура
 
* Контрагент
 
* Контрагент
 +
* Склад
 +
* ЕдиницаИзмерения
 +
* Договор
 +
* Валюта
 +
* ПоказательУчета
 +
* Страна
 +
* СтавкаНДС
 +
* ЗаказПокупателя
 +
* ЗаказПоставщику
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
* Документ.Прочитать
+
* РеалВх.Создать
* Документ.Создать
+
* РеалВх.Прочитать
* Документ.Записать
+
* РеалВх.DocNomList
 +
* РеалВх.DocNomDeleteAll
 +
* РеалВх.NomCreateWithSaveBatch
 +
* РеалВх.Записать
 +
* Документ.ОтменитьПроведение
 +
* Документ.Провести
 +
* НашаОрганизация.Существует
 +
* Contractor.ReadOutLite
 +
* Warehouse.ReadCard
 +
* Классификаторы.ReadByFullCode
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

Текущая версия на 15:23, 8 августа 2023

Объект

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

Легенда:

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


Структура:

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

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