Добавить документ складского учета

Активити (робот) "Добавить документ складского учета" предназначено для использования в роботах и может быть полезно в следующих сценариях:

Автоматическое создание документов складского учета при поступлении товаров на склад;
Создание документов оприходования товаров при приемке;
Автоматизация документооборота при перемещении товаров между складами;
Создание документов возврата товаров от поставщиков;
Автоматическое списание товаров со склада;
Создание документов с автоматическим добавлением товарных позиций;
Привязка документов к поставщикам (контактам или компаниям);
Автоматическое проведение документов после создания;
Интеграция складского учета с бизнес-процессами CRM;
Массовое создание документов складского учета через бизнес-процессы.

Как работает активити (робот):
- Активити (робот) создаёт новый документ складского учета через API catalog.document.add;
- Поддерживается создание документов различных типов: приход, оприходование, перемещение, возврат, списание;
- После создания документа автоматически добавляются поставщики (контакт или компания), если они указаны;
- Поддерживается автоматическое добавление товаров к документу с указанием количества, цены и складов;
- При указании нескольких товаров используется batch-запрос для оптимизации производительности;
- Поддерживается автоматическое проведение документа после создания, если указан параметр "Провести документ";
- Активити (робот) возвращает ID созданного документа для использования в дальнейших шагах бизнес-процесса;
- Активити (робот) работает через REST API Битрикс24 (catalog.document.add, catalog.documentcontractor.add, catalog.document.element.add, catalog.document.conduct).

Сценарий работы активити (робота) бизнес-процесса

Активити (робот) создаёт документ складского учета с указанными параметрами. После успешного создания документа автоматически добавляются поставщики (если указаны), затем товары (если указаны), и в конце документ проводится (если указан параметр "Провести документ"). Результатом работы является ID созданного документа, который можно использовать в последующих шагах бизнес-процесса.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
Тип документа	В данном поле указывается тип создаваемого документа складского учета. Это обязательный параметр. Выбирается из выпадающего списка. Варианты выбора: - Приход товара на склад (A) - для документов поступления товаров на склад; - Оприходование товара (S) - для документов оприходования товаров; - Перемещение товара между складами (M) - для документов перемещения товаров; - Возврат товара (R) - для документов возврата товаров; - Списание товара (D) - для документов списания товаров. Примеры: - Приход товара на склад (A) - создать документ прихода товаров; - Перемещение товара между складами (M) - создать документ перемещения; - Списание товара (D) - создать документ списания товаров. Когда использовать: - Для документирования различных операций складского учета; - Для автоматизации процессов приёмки и отгрузки товаров; - Для учета перемещений товаров между складами.
Заголовок документа	В данном поле указывается заголовок создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - Приход товара от поставщика №123; - Перемещение товаров со склада А на склад Б; - Списание товара {=Document:TITLE}; - Документ от {=System:NowLocal}; - ={{={=Variable:SUPPLIER_NAME} & " - Приход товара"}} - объединить переменную с текстом.
Номер документа	В данном поле указывается номер создаваемого документа. Это необязательный параметр типа "Строка". Примеры: - ПР-001; - ДОК-{=Document:ID}; - ={{=date('Ymd') & "-" & {=Variable:COUNTER}}}} - сгенерировать номер с датой и счётчиком; - {=Variable:DOC_NUMBER} - использовать номер из переменной предыдущего активити (робота).
Общая сумма товаров	В данном поле указывается общая сумма товаров в документе. Это необязательный параметр типа "Число". Примеры: - 150000 - указать сумму 150000; - {=Variable:TOTAL_AMOUNT} - использовать сумму из переменной предыдущего активити (робота); - ={{={=Variable:QUANTITY} * {=Variable:PRICE}}}} - рассчитать сумму из количества и цены.
Валюта	В данном поле указывается валюта документа. Это обязательный параметр. Выбирается из выпадающего списка доступных валют портала. Варианты выбора: - Рубль (RUB) - российский рубль; - Доллар (USD) - доллар США; - Евро (EUR) - евро; - Другие валюты, настроенные в вашем портале. Примеры: - Рубль (RUB) - использовать рубли; - Доллар (USD) - использовать доллары; - {=Variable:CURRENCY} - использовать валюту из переменной (если переменная содержит код валюты).
Комментарий	В данном поле указывается комментарий к документу. Это необязательный параметр типа "Строка". Примеры: - Документ создан автоматически; - Приход товара от поставщика {=Variable:SUPPLIER_NAME}; - ={{="Основание: " & {=Document:TITLE}}}} - добавить комментарий с информацией из документа.
Ответственный	В данном поле указывается ответственный за документ сотрудник. Это обязательный параметр типа "Пользователь". Примеры: - {=Document:ASSIGNED_BY_ID} - назначить ответственного из текущего документа; - {=User:ID} - назначить ответственным текущего пользователя; - [U1] - назначить ответственным пользователя с ID 1; - user_25 - назначить ответственным пользователя с ID 25; - {=Variable:RESPONSIBLE_ID} - использовать ID из переменной предыдущего активити (робота). Важно: При выборе сотрудника, в поле должен быть указан только его ID без лишних символов (или в формате user_ID). Если пользователь не найден по указанному ID, документ не будет создан.
Поставщик (контакт)	В данном поле указывается идентификатор контакта-поставщика, который будет привязан к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать контакты ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные контакты из раздела CRM не подойдут. Если указан ID обычного контакта (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 123 - привязать контакт-поставщик с ID 123 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_CONTACT_ID} - использовать ID контакта-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска контактов-поставщиков. Когда использовать: - Для привязки документа к контакту-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-контактами; - Если указан, контакт автоматически добавляется к документу после его создания.
Поставщик (компания)	В данном поле указывается идентификатор компании-поставщика, которая будет привязана к документу. Это необязательный параметр типа "Число". Важно: Необходимо выбирать компании ТОЛЬКО из раздела "Клиенты > Поставщики". Обычные компании из раздела CRM не подойдут. Если указан ID обычной компании (не из раздела поставщиков), операция завершится с ошибкой. Примеры: - 456 - привязать компанию-поставщик с ID 456 из раздела "Клиенты > Поставщики"; - {=Variable:SUPPLIER_COMPANY_ID} - использовать ID компании-поставщика из переменной предыдущего активити (робота); - {=A1988_22222_92566_99999:search_result_first_string} - использовать ID из результата поиска компаний-поставщиков. Когда использовать: - Для привязки документа к компании-поставщику из раздела "Клиенты > Поставщики"; - Для автоматизации документооборота с поставщиками-компаниями; - Если указана, компания автоматически добавляется к документу после его создания.
Товар	В данном поле указываются товары, которые будут добавлены к документу. Это необязательный параметр типа "Строка" с множественным значением. Каждый товар указывается в строгой последовательности через разделитель ## в формате: id товара##Количество##Цена##Склад источник##Склад получатель. Формат записи товара: - Первое значение (id товара) - идентификатор товара в каталоге (число); - Второе значение (Количество) - количество товара (число с плавающей точкой); - Третье значение (Цена) - цена за единицу товара (число с плавающей точкой); - Четвёртое значение (Склад источник) - идентификатор склада-источника (число); - Пятое значение (Склад получатель) - идентификатор склада-получателя (число). Примеры: - 312##15##1250.5##2##3 - добавить товар с ID 312, количеством 15, ценой 1250.5, со склада 2 на склад 3; - {=Variable:PRODUCT_ID}##{=Variable:QUANTITY}##{=Variable:PRICE}##1##2 - использовать значения из переменных; - 100##10##500##1##1 - добавить товар с ID 100, количеством 10, ценой 500, со склада 1 на склад 1 (для прихода); - Для добавления нескольких товаров укажите каждую строку отдельно в множественном поле. Важно: Формат записи товара должен строго соблюдаться. Все пять значений должны быть указаны через разделитель ##. Если формат не соблюдён (не указаны все 5 значений), активити (робот) завершится с ошибкой "Вы неправильно заполнили товар". Когда использовать: - Для автоматического добавления товаров к документу при его создании; - Для массового добавления товаров через множественное поле; - Для автоматизации заполнения документов товарными позициями.
Провести документ	В данном поле указывается, нужно ли автоматически провести документ после его создания. Это необязательный параметр типа "Да/Нет". Варианты выбора: - Да (Y) - провести документ автоматически после создания; - Нет (N) - оставить документ непроведённым. Примеры: - Да (Y) - автоматически провести документ после создания; - Нет (N) - создать документ без проведения (можно провести вручную позже). Когда использовать: - Для автоматического проведения документов при создании; - Для документов, которые не требуют дополнительной проверки перед проведением; - Если не указано, документ будет создан без проведения.

Важно: Для успешного создания документа необходимо указать обязательные параметры: "Тип документа", "Валюта" и "Ответственный". Если хотя бы один из обязательных параметров не указан, активити (робот) завершится с ошибкой.

Возвращаемые параметры

После успешного выполнения активити (робот) возвращает следующие параметры:

id_new_document - идентификатор созданного документа складского учета (число);
ok_ready - результат выполнения активити (робота) (Y - документ успешно создан, N - произошла ошибка).

Важно о возвращаемых параметрах: Если при создании документа произошла ошибка, параметр ok_ready будет равен "N", и активити (робот) завершится с сообщением об ошибке. Параметр id_new_document будет доступен только при успешном создании документа.

Примеры использования активити

Описание примера	Решение
Создать документ прихода товара на склад с указанием поставщика-контакта	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Заголовок документа — Приход товара от поставщика; Поставщик (контакт) — {=Document:CONTACT_ID}. Результат: id_new_document содержит ID созданного документа, к которому привязан контакт-поставщик.
Создать документ перемещения товаров между складами с добавлением товаров	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 312##15##1250.5##2##3 (товар ID 312, количество 15, цена 1250.5, со склада 2 на склад 3). Результат: id_new_document содержит ID созданного документа с добавленным товаром.
Создать документ оприходования товара с автоматическим проведением	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 100##10##500##1##1; Провести документ — Да (Y). Результат: id_new_document содержит ID созданного и проведённого документа.
Создать документ возврата товара с привязкой к компании-поставщику	Тип документа — Возврат товара (R); Валюта — Доллар (USD); Ответственный — {=Document:ASSIGNED_BY_ID}; Поставщик (компания) — {=Document:COMPANY_ID}; Заголовок документа — Возврат товара поставщику. Результат: id_new_document содержит ID созданного документа, к которому привязана компания-поставщик.
Создать документ списания товара с несколькими товарными позициями	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — 200##5##1000##1##0, 201##3##1500##1##0 (два товара: ID 200 и 201, со склада 1, получатель 0 для списания). Результат: id_new_document содержит ID созданного документа с двумя добавленными товарами через batch-запрос.
Создать документ прихода с использованием данных из переменных	Тип документа — Приход товара на склад (A); Валюта — {=Variable:CURRENCY}; Ответственный — {=Variable:RESPONSIBLE_ID}; Заголовок документа — {=Variable:DOC_TITLE}; Номер документа — {=Variable:DOC_NUMBER}; Общая сумма товаров — {=Variable:TOTAL_AMOUNT}. Результат: id_new_document содержит ID созданного документа с данными из переменных.
Создать документ перемещения с товаром из результата поиска	Тип документа — Перемещение товара между складами (M); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=A1988_22222_92566_99999:search_result_first_string}##10##500##1##2 (ID товара из результата поиска, количество 10, цена 500, со склада 1 на склад 2). Результат: id_new_document содержит ID созданного документа с товаром из поиска.
Создать документ прихода с товаром и автоматическим проведением	Тип документа — Приход товара на склад (A); Валюта — Рубль (RUB); Ответственный — {=Document:ASSIGNED_BY_ID}; Товар — 150##20##750##0##1 (товар ID 150, количество 20, цена 750, источник 0, получатель склад 1); Провести документ — Да (Y). Результат: id_new_document содержит ID созданного, заполненного товаром и проведённого документа.
Создать документ оприходования с комментарием из поля документа	Тип документа — Оприходование товара (S); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Комментарий — Оприходование товара по сделке {=Document:ID}. Результат: id_new_document содержит ID созданного документа с комментарием, содержащим ID сделки.
Создать документ списания с использованием ID документа в итераторе	Тип документа — Списание товара (D); Валюта — Рубль (RUB); Ответственный — {=User:ID}; Товар — {=Iterator:Value}##1##100##1##0 (ID товара из итератора, количество 1, цена 100, со склада 1, получатель 0). Результат: для каждого товара в итераторе создаётся документ списания с соответствующим товаром.

Пример возвращаемых данных

При успешном выполнении активити (робот) возвращает данные в следующем формате:

Пример данных при успешном создании документа:
id_new_document = 142
ok_ready = "Y"

Использование результата в следующем активити:
Для использования ID созданного документа в следующем активити (роботе) используйте:
{=A1988_22222_92566_99999:id_new_document}
где A1988_22222_92566_99999 - это код активити (робота) "Добавить документ складского учета".

Примечание: После создания документа автоматически выполняются следующие действия (если указаны соответствующие параметры): добавление поставщика (контакт или компания), добавление товаров, проведение документа. Все эти операции выполняются последовательно, и только после их успешного завершения активити (робот) возвращает результат.

Ваша корзина пуста

Добавить документ складского учета