Поступление - API3 Объект — различия между версиями
(→Объект) |
|||
(не показано 26 промежуточных версий 6 участников) | |||
Строка 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_Объект|Номенклатура]] | ||
+ | *** НомСредИдентТов — массив маркировки | ||
+ | **** КИЗ | ||
+ | **** НомУпак | ||
+ | *** Параметры | ||
+ | **** Значение | ||
+ | **** Название | ||
+ | **** Тип | ||
+ | *** <span style="color:#E70000">Показатель</span> — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]] | ||
+ | *** СведПрослеж — массив прослеживаемости | ||
+ | **** КолВЕдПрослеж | ||
+ | **** НомТовПрослеж | ||
+ | *** <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> | ||
+ | ** Услуги | ||
+ | *** ЕдИзм — объект [[ЕдиницаИзмерения_-_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> | ||
+ | *** СчетЗатрат/Показатель — объект [[ПоказательУчета_-_API3_Объект|ПоказательУчета]] | ||
+ | *** Цена | ||
+ | *** <span style="color:#E70000">ЦенаБезНДС</span> | ||
+ | |||
+ | '''Объем данных возвращаемых методом API3.GetSbisObject может отличаться в бóльшую сторону''' | ||
Строка 14: | Строка 67: | ||
<source lang="json"> | <source lang="json"> | ||
{ | { | ||
− | + | 'Дата': '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'}, | ||
+ | 'Содержание': 'оплата за услуги доставки' | ||
+ | } | ||
+ | ] | ||
+ | } | ||
} | } | ||
</source> | </source> | ||
===Естественные ключи=== | ===Естественные ключи=== | ||
− | * Ключ1 | + | * Ключ1 — номер документа + дата документа + организация + контрагент(вес = 3) |
− | ** Ключ1_1 | + | ** Ключ1_1 — номер документа |
− | ** Ключ1_2 | + | ** Ключ1_2 — дата документа |
− | ** Ключ1_3 | + | ** Ключ1_3 — идентификатор организации в ИС |
− | ** Ключ1_4 | + | ** Ключ1_4 — идентификатор контрагента в ИС |
− | * Ключ2 | + | * Ключ2 — не используется |
− | * Ключ3 | + | * Ключ3 — не используется |
===Зависит от объектов=== | ===Зависит от объектов=== | ||
+ | * Валюта | ||
+ | * Договор | ||
+ | * ЕдиницаИзмерения | ||
+ | * ЗаказПокупателя | ||
+ | * ЗаказПоставщику | ||
+ | * Контрагент | ||
* НашаОрганизация | * НашаОрганизация | ||
− | * | + | * Номенклатура |
+ | * ПоказательУчета | ||
+ | * Склад | ||
+ | * Страна | ||
+ | * СтавкаНДС | ||
+ | * СтатьяЗатрат | ||
+ | * ЧастноеЛицо | ||
+ | |||
===Используемые методы БЛ=== | ===Используемые методы БЛ=== | ||
− | * | + | * РеалВх.Создать |
− | * Документ. | + | * РеалВх.Прочитать |
− | * Документ. | + | * РеалВх.DocNomList |
+ | * РеалВх.DocNomDeleteAll | ||
+ | * РеалВх.NomCreateWithSaveBatch | ||
+ | * РеалВх.Записать | ||
+ | * Документ.ОтменитьПроведение | ||
+ | * Документ.Провести | ||
+ | * НашаОрганизация.Существует | ||
+ | * Contractor.ReadOutLite | ||
+ | * Warehouse.ReadCard | ||
+ | * Классификаторы.ReadByFullCode | ||
[[Категория:SBIS API3 Объект]] | [[Категория:SBIS API3 Объект]] |
Текущая версия на 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