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

Материал из razgovorov.ru
Перейти к: навигация, поиск
(Отмена правки 3988, сделанной Власов Илья (обсуждение))
(Метка: отмена)
Строка 1: Строка 1:
 
===Объект===
 
===Объект===
 
{{Документ_-_API3_Объект}}
 
{{Документ_-_API3_Объект}}
{{СкладскойДокумент_-_API3_Объект}}
+
* Покупатель * - объект [[Контрагент_-_API3_Объект|Контрагент]]
 
* ИмяСБИС = "Поступление"
 
* ИмяСБИС = "Поступление"
* ТаблДок - Табличная часть документа
+
* мТаблДок - данные о номенклатуре документа
** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
+
** Товары
** Количество - количество
+
*** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
** Цена - цена
+
*** Количество - количество услуг
 +
*** Цена - цена за 1 товар
 +
** Услуги
 +
*** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
 +
*** Количество - количество услуг
 +
*** Цена - цена за 1 услугу
  
  
Строка 16: Строка 21:
 
   "Дата": "15.01.2018",
 
   "Дата": "15.01.2018",
 
   "Сумма": "1560.00",
 
   "Сумма": "1560.00",
   "НашаОрганизация": {
+
   "Покупатель": {
 
     "ИдИС": "56c61dec-e570-11e3-893a-005056c00008"
 
     "ИдИС": "56c61dec-e570-11e3-893a-005056c00008"
 
   },
 
   },
   "Контрагент": {
+
   "Поставщик": {
 
     "ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f"
 
     "ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f"
 
   },
 
   },
 
   "ИмяСБИС": "Поступление",
 
   "ИмяСБИС": "Поступление",
   "ТаблДок": [
+
   "мТаблДок": {
    {
+
    "Товары": [
      "Номенклатура": {
+
      {
        "ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f",
+
        "Номенклатура": {
        "ИмяСБИС": "Номенклатура"
+
          "ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f",
       },
+
          "ИмяСБИС": "Номенклатура"
       "Количество": "3.000",
+
        },
      "Цена": 500
+
        "Количество": "3.000",
     }
+
        "Цена": 500
   ]
+
       }
 +
    ],
 +
    "Услуги": [
 +
       {
 +
        "Номенклатура": {
 +
          "ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f",
 +
          "ИмяСБИС": "Номенклатура"
 +
        },
 +
        "Количество": "3.000",
 +
        "Цена": 500
 +
      }
 +
     ]
 +
   }
 
}
 
}
 
</source>
 
</source>

Версия 11:17, 28 августа 2020

Объект

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

Опции загрузки документа в СБИС.

  • Провести — Документы проводятся в СБИС по умолчанию. При выполнении следующего условия документ проведен не будет:

Значение узла не равно "Истина", "True" или "Да" (регистронезависимо).

  • ЗапуститьЭДО — Признак необходимости запуска документооборота по документу с выбором первого действия из списка возможных, после загрузки в СБИ. Документооборот запускается при выполнении следующих условий:

1) Значение узла "Истина", "True" или "Да" (регистронезависимо).

2) В результате выполнения UpdateSbisObject создается новый документ.

3) Действие на этапе не требует выбора ответственного или подписания.

  • ПрерватьЭДО — Признак необходимости прерывания документооборота по документу перед обновлением в СБИС. Документооборот будет прерван и будет создана новая редакция документа при выполнении следующих условий:

1) Значение узла "Истина", "True" или "Да" (регистронезависимо).

2) Обновляемый документ имеется в СБИС и по нему запущен документооборот.

  • Покупатель * - объект Контрагент
  • ИмяСБИС = "Поступление"
  • мТаблДок - данные о номенклатуре документа
    • Товары
      • Номенклатура - Номенклатура
      • Количество - количество услуг
      • Цена - цена за 1 товар
    • Услуги
      • Номенклатура - Номенклатура
      • Количество - количество услуг
      • Цена - цена за 1 услугу


Пример:

{
  "ИдИС": "7cf838b6-f9e6-11e7-ad08-3497f6377b7e",
  "Номер": "00000000001",
  "Дата": "15.01.2018",
  "Сумма": "1560.00",
  "Покупатель": {
    "ИдИС": "56c61dec-e570-11e3-893a-005056c00008"
  },
  "Поставщик": {
    "ИдИС": "b9321b89-2648-11e6-ab23-080027358f3f"
  },
  "ИмяСБИС": "Поступление",
  "мТаблДок": {
    "Товары": [
      {
        "Номенклатура": {
          "ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f",
          "ИмяСБИС": "Номенклатура"
        },
        "Количество": "3.000",
        "Цена": 500
      }
    ],
    "Услуги": [
      {
        "Номенклатура": {
          "ИдИС": "db3311b2-0a23-11e7-adce-080027358f3f",
          "ИмяСБИС": "Номенклатура"
        },
        "Количество": "3.000",
        "Цена": 500
      }
    ]
  }
}

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

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

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

  • НашаОрганизация
  • Контрагент

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

  • Документ.Прочитать
  • Документ.Создать
  • Документ.Записать