КорректировкаПоступления - API3 Объект

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

Объект

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

Легенда:

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


Структура:

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

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


Пример:

{
  "ИдИС": "ИдИС",
  "Номер": "FOR_UPDATE1FOR_UPDATE1",
  "Дата": "12.07.2019",
  "НашаОрганизация": {
    "ИдСБИС": "167"
  },
  "Контрагент": {
    "ИдСБИС": "488"
  },
  "Склад": {
    "ИдСБИС": "3240"
  },
  "КорректируемыйДокумент": {
    "ИдСБИС": "535"
  },
  "Сумма": "800.00",
  "Регламент": "для unittest",
  "Комментарий": "ОБНОВИЛИ",
  "ТаблДок": {
    "Товары": [
      {
        "Номенклатура": {
          "ИдСБИС": "61"
        },
        "КоличествоПосле": "10.0",
        "ЦенаПосле": "100.00",
        "СуммаПосле": "1000.00"
      }
    ],
    "Услуги": [
      {
        "Номенклатура": {
          "ИдСБИС": "321"
        },
        "КоличествоПосле": "2.0",
        "ЦенаПосле": "100.00",
        "СуммаПосле": "200.00"
      }
    ]
  }
}

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

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

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

  • НашаОрганизация
  • Номенклатура
  • Склад
  • Контрагент

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