АктВыпуска - API3 Объект — различия между версиями

Материал из razgovorov.ru
Перейти к: навигация, поиск
(не показано 18 промежуточных версий 3 участников)
Строка 1: Строка 1:
===Объект===
+
{{Документ!_-_API3_Объект}}
* ИдИС - идентификатор документа в ИС
+
* <span style="color:#077F0B">СкладСписания</span> — объект склад [[Склад_-_API3_Объект|Склад]], склад списания
* ИдСБИС - идентификатор документа в СБИС
+
* <span style="color:#077F0B">СкладГотовойПродукции</span> — объект склад [[Склад_-_API3_Объект|Склад]], склад готовой продукции
* Номер - номер документа (строка)
+
* ТаблДок — данные о номенклатуре документа
* Дата - дата документа (строка в формате "ДД.ММ.ГГГГ")
+
** Товары
* НашаОрганизация - объект НашаОрганизация
+
*** [[Шаблон:ТабличнаяЧасть_-_API3_Объект|Стандартные реквизиты табличной части]]
* СкладСписания – склад списания (объект склад [[Склад_-_API3_Объект|Склад]])
+
*** <span style="color:#077F0B">Состав</span> — массив
* СкладГотовойПродукции – склад готовой продукции (объект склад [[Склад_-_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> — число строкой, себестоимость без учета НДС
** НомерСтроки - номер строки
+
 
** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
+
 
** ЕдИзм - [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
** Количество - списываемое со склада количество
 
** Себестоимость - себестоимость за единицу списываемой позиции с НДС
 
** СебестоимостьСумма - сумма себестоимости по списываемой позиции с НДС
 
** Параметры - массив именованных параметров ключ/значение
 
*** Название
 
*** Значение
 
* ТаблДетал - данные о составляющих
 
** Раздел - НомерСтроки связанной записи в таблице "ТаблДок"
 
** Номенклатура - [[Номенклатура_-_API3_Объект|Номенклатура]]
 
** ЕдИзм - [[ЕдиницаИзмерения_-_API3_Объект|ЕдиницаИзмерения]]
 
** Количество - списываемое со склада количество
 
  
<br>
 
При синхронизации номенклатура в табличной части переносится линейным списком. За рамками функционала синхронизации логика самого документа автоматически может разместить номенклатуру в иерархической структуре.
 
<br>
 
<br>
 
 
'''Пример:'''
 
'''Пример:'''
 
<source lang="json">
 
<source lang="json">
Строка 38: Строка 22:
 
   "Номер": "1",
 
   "Номер": "1",
 
   "Дата": "08.01.2015",
 
   "Дата": "08.01.2015",
   "Регламент": "a93d1b7e-adfa-11e4-9bb0-a36ffb479090",
+
   "Регламент": "Акт выпуска",
 
   "Комментарий": "Текст комментария к документу",
 
   "Комментарий": "Текст комментария к документу",
 
   "НашаОрганизация": {
 
   "НашаОрганизация": {
Строка 52: Строка 36:
 
     "ИмяСБИС": "СкладГотовойПродукции"
 
     "ИмяСБИС": "СкладГотовойПродукции"
 
   },
 
   },
   "ТаблДок": [
+
   "ТаблДок": {
    {
+
    "Товары": [
      "Номенклатура": {
+
      {
        "ИдИС": "7c8ef907-a824-4dde-a36d-870177b5af04",
+
        "Номенклатура": {
        "ИмяСБИС": "Номенклатура"
+
          "ИдИС": "7c8ef907-a824-4dde-a36d-870177b5af04",
      },
+
          "ИмяСБИС": "Номенклатура"
      "Количество": "50"
+
        },
    },
+
        "Количество": "50"
    {
 
      "Номенклатура": {
 
        "ИдИС": "01c72140-8f3e-45d2-9ecd-f66802c0db58",
 
        "ИмяСБИС": "Номенклатура"
 
 
       },
 
       },
       "Количество": "32"
+
       {
     }
+
        "Номенклатура": {
   ]
+
          "ИдИС": "01c72140-8f3e-45d2-9ecd-f66802c0db58",
 +
          "ИмяСБИС": "Номенклатура"
 +
        },
 +
        "Количество": "32",
 +
        "Состав": [
 +
          {
 +
            "Номенклатура": {
 +
              "ИдИС": "01c72140-8f3e-45d2-9ecd-f6680259842",
 +
              "ИмяСБИС": "Номенклатура"
 +
            },
 +
            "Количество": "10"
 +
          },
 +
          {
 +
            "Номенклатура": {
 +
              "ИдИС": "01c72140-8f3e-45d2-9ecd-f6as4847",
 +
              "ИмяСБИС": "Номенклатура"
 +
            },
 +
            "Количество": "20"
 +
          }
 +
        ]
 +
      }
 +
     ]
 +
   }
 
}
 
}
 
</source>
 
</source>
  
 
===Естественные ключи===
 
===Естественные ключи===
* Ключ1 - номер документа + дата документа + организация(вес = 3)
+
* Ключ1 номер документа + дата документа + организация(вес = 3)
* Ключ1_1 - номер документа
+
* Ключ1_1 номер документа
* Ключ1_2 - дата документа
+
* Ключ1_2 дата документа
* Ключ1_3 - идентификатор организации в ИС
+
* Ключ1_3 идентификатор организации в ИС
  
 
===Зависит от объектов===
 
===Зависит от объектов===
Строка 81: Строка 83:
 
* Номенклатура
 
* Номенклатура
 
* Склад
 
* Склад
* Единица измерения
+
 
  
 
===Используемые методы БЛ===
 
===Используемые методы БЛ===
* АктСписания.Прочитать
+
* АктВыпуска.Прочитать
 +
* АктВыпуска.Создать
 +
* АктВыпуска.Записать
 +
* АктВыпуска.DocNomDeleteAll
 +
* АктВыпуска.NomCreateWithSaveBatch
 +
* Контрагент.НайтиГоловуПоЛицу
 +
* Документ.ОтменитьПроведение
 +
* Документ.Провести
  
 
[[Категория:SBIS API3 Объект]]
 
[[Категория:SBIS API3 Объект]]

Версия 10:38, 23 апреля 2025

Объект

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

Легенда:

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


Структура:

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


Пример:

{
  "ИдИС": " 6ace2a84-4c23-4b72-8b9d-8652c9f91383",
  "Номер": "1",
  "Дата": "08.01.2015",
  "Регламент": "Акт выпуска",
  "Комментарий": "Текст комментария к документу",
  "НашаОрганизация": {
    "ИдИС": " bfe71153-e7dd-485d-bc3a-0aa619f144eb",
    "ИмяСБИС": "НашаОрганизация"
  },
  "СкладСписания": {
    "ИдИС": "0c02d590-4d88-4ca7-976c-bc4655442471",
    "ИмяСБИС": "СкладСписания"
  },
  "СкладГотовойПродукции": {
    "ИдИС": "0c02d590-4d88-4ca7-976c-bc4655442471",
    "ИмяСБИС": "СкладГотовойПродукции"
  },
  "ТаблДок": {
    "Товары": [
      {
        "Номенклатура": {
          "ИдИС": "7c8ef907-a824-4dde-a36d-870177b5af04",
          "ИмяСБИС": "Номенклатура"
        },
        "Количество": "50"
      },
      {
        "Номенклатура": {
          "ИдИС": "01c72140-8f3e-45d2-9ecd-f66802c0db58",
          "ИмяСБИС": "Номенклатура"
        },
        "Количество": "32",
        "Состав": [
          {
            "Номенклатура": {
              "ИдИС": "01c72140-8f3e-45d2-9ecd-f6680259842",
              "ИмяСБИС": "Номенклатура"
            },
            "Количество": "10"
          },
          {
            "Номенклатура": {
              "ИдИС": "01c72140-8f3e-45d2-9ecd-f6as4847",
              "ИмяСБИС": "Номенклатура"
            },
            "Количество": "20"
          }
        ]
      }
    ]
  }
}

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

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

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

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


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

  • АктВыпуска.Прочитать
  • АктВыпуска.Создать
  • АктВыпуска.Записать
  • АктВыпуска.DocNomDeleteAll
  • АктВыпуска.NomCreateWithSaveBatch
  • Контрагент.НайтиГоловуПоЛицу
  • Документ.ОтменитьПроведение
  • Документ.Провести