Перейти к основному содержимому

Договор

Договор хранит условия работы с контрагентом и используется в заказах покупателей, спецификациях, счетах на оплату и печатных документах. В системе договор всегда создается в карточке контрагента и связывается с конкретным контрагентом, нашей организацией, банковскими реквизитами, почтами, подписантами и документом договора.

Страница актуальна для пользовательской работы в интерфейсе и для фиксации договоренностей по реализации.

Где открыть​

Договоры доступны в карточке контрагента на вкладке Договора:

  • карточка контрагента: /partners/:id/edit?sideTab=contracts;
  • открыть конкретный договор: /partners/:id/edit?sideTab=contracts&ti_contractId=:contractId;
  • открыть создание договора: /partners/:id/edit?sideTab=contracts&ti_addContract;
  • открыть создание договора с заранее выбранной нашей организацией: /partners/:id/edit?sideTab=contracts&ti_addContract&ti_ourOrganizationId=:ourOrganizationId.

На договор также ведут ссылки из заказа покупателя, задач по спецификации и формы счета на оплату.

Что показывает таблица​

Вкладка Договора показывает договоры выбранного контрагента.

Колонки таблицы:

  • Номер;
  • Тип (С покупателем / Счёт-договор);
  • Покупатель;
  • Наша организация;
  • Типовой;
  • Дата;
  • Архивный;
  • Автор;
  • Действия.

В таблице доступны фильтры, сортировка, пагинация и сброс настроек таблицы.

В колонке действий доступны:

  • Просмотр - открыть договор без редактирования;
  • Редактировать - открыть форму редактирования;
  • Заархивировать - архивировать договор.

Если договор архивный, действия редактирования и архивирования скрываются. Двойной клик по неархивному договору открывает редактирование.

Создание договора​

Договор создается кнопкой Добавить договор к контрагенту на вкладке Договора. Кнопка доступна, если у пользователя есть право редактировать текущего контрагента.

Порядок работы:

  1. Откройте карточку контрагента.
  2. Перейдите на вкладку Договора.
  3. Нажмите Добавить договор к контрагенту.
  4. Выберите нашу организацию.
  5. Проверьте дату, дату окончания срока действия, признак пролонгации и при необходимости признак многостороннего договора.
  6. Выберите подписанта, банковские реквизиты и почту для нашей организации.
  7. Выберите подписанта, банковские реквизиты и почту для контрагента.
  8. Нажмите Создать.

Если у выбранной стороны есть ровно один подписант, один email или одни банковские реквизиты, форма может подставить это значение автоматически. Для подписанта нашей организации при создании сначала выбирается основной подписант, если он задан.

Если у контрагента нет подписантов, банковских реквизитов или почты, форма показывает подсказку со ссылкой на нужный раздел карточки контрагента.

Номер договора​

При создании поле Номер договора необходимо оставить пустым. Тогда система сформирует номер автоматически. Заполнять только если уже созданный договор добавляется в систему.

Формат автоматического номера:

код нашей организации + дата договора в формате yyMMdd + порядковый номер

Пример: ОМ250609-11.

Порядковый номер считается по уже существующим договорам выбранной нашей организации. При изменении даты договора после создания номер не пересчитывается.

Если пользователь вручную указывает номер при создании, жёсткой проверки «шаблона» номера нет: достаточно уникальности среди неархивных договоров (см. многосторонние ниже). После создания номер в форме редактирования не меняется.

Многосторонний договор​

Признак «Многосторонний» доступен для обычного договора с покупателем (не для счёт-договора). В форме создания и редактирования — флажок; в просмотре видно состояние признака.

Одинаковый номер у нескольких неархивных договоров допустим только если все они многосторонние и относятся к одной нашей организации. Иначе сохранение отклоняется. Если договор не многосторонний, номер должен быть уникален среди неархивных.

Редактирование договора​

В режиме редактирования можно изменить:

  • дату договора;
  • дату окончания срока действия;
  • признак пролонгации;
  • признак многостороннего договора;
  • подписанта нашей организации;
  • банковские реквизиты нашей организации в пределах той же нашей организации;
  • почту нашей организации;
  • подписанта контрагента;
  • банковские реквизиты контрагента;
  • почту контрагента.

Нельзя изменить:

  • номер договора;
  • контрагента договора;
  • тип договора;
  • нашу организацию, если это требует сменить организацию, а не только банковские реквизиты внутри той же организации;
  • архивный договор.

Если в форме редактирования нет изменений, сохранение не проходит с сообщением Нет изменений.

Просмотр договора​

В режиме просмотра отображаются:

  • ссылка на документ договора, если она есть;
  • дата архивирования, если договор архивный;
  • дата договора;
  • окончание срока действия;
  • признак пролонгации;
  • признак многостороннего договора;
  • наша организация;
  • подписант нашей организации;
  • банковские реквизиты нашей организации;
  • почта нашей организации;
  • контрагент;
  • подписант контрагента;
  • банковские реквизиты контрагента;
  • почта контрагента.

Поля в режиме просмотра доступны только для чтения.

Документ договора​

После создания договора в режиме редактирования появляется поле документа. Через него можно:

  • указать или изменить ссылку на файл договора;
  • открыть файл по ссылке;
  • скачать файл по ссылке;
  • сгенерировать docx по шаблону;
  • отметить документ как типовой или нетиповой;
  • отметить согласование;
  • отметить подписание руководством;
  • отметить отправку;
  • отметить подписание клиентом;
  • указать даты для статусов документа.

Ссылка на файл и статусы документа сохраняются отдельной кнопкой в поле документа. Это отдельное сохранение от кнопки Обновить в форме договора.

PDF сейчас не поддерживается. Если запросить PDF через API, система вернет сообщение, что нужно использовать docx.

Формирование docx​

Docx формируется по шаблону договора (ContractTemplate.docx). Для типа Счёт-договор используется шаблон ContractInvoice.docx: в файл дополнительно попадают товары и условия оплаты заказа. В обоих случаях endpoint генерации один и тот же.

В обычный файл договора попадают:

  • номер и дата договора;
  • год договора;
  • дата окончания срока действия;
  • город нашей организации, если его удалось извлечь из юридического адреса;
  • полные наименования сторон;
  • юридические адреса сторон;
  • ИНН и КПП сторон;
  • банковские реквизиты сторон;
  • email сторон;
  • должности, ФИО и текст полномочий подписантов.

Файл не будет сформирован, если:

  • у пользователя нет доступа к договору;
  • договор не найден;
  • не указаны банковские реквизиты покупателя;
  • не указана почта покупателя;
  • не указан подписант покупателя;
  • не указаны наши банковские реквизиты;
  • не указана наша почта;
  • не указан наш подписант;
  • покупатель не найден или архивирован;
  • контрагент не является покупателем;
  • контрагент является самозанятым;
  • у подписанта покупателя не заполнен текст в договоре;
  • у подписанта покупателя не заполнена должность;
  • ФИО подписанта покупателя не состоит из двух или трех частей;
  • не найден шаблон ContractTemplate.docx;
  • запрошен формат, отличный от docx.

Архивирование​

Договор не удаляется физически, а архивируется. После архивирования у него заполняется дата архивирования.

Архивный договор:

  • остается видимым в таблице;
  • открывается на просмотр;
  • не редактируется;
  • не архивируется повторно;
  • не попадает в список договоров для выбора в новых заказах и задачах, потому что список строится только по неархивным договорам.

Автозаполнение и расчеты​

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

ДанныеКак заполняется
Дата договоратекущая дата
Окончание срока действиядата договора + 1 год
Пролонгациявключена
Наша организациявыбирается пользователем или подставляется из параметра ti_ourOrganizationId
Наш подписантосновной подписант выбранной нашей организации или единственный подписант
Наши банковские реквизитыединственные банковские реквизиты выбранной нашей организации, если они одни
Наша почтаединственная почта выбранной нашей организации, если она одна
Подписант контрагентаединственный подписант контрагента, если он один
Банковские реквизиты контрагентаединственные банковские реквизиты контрагента, если они одни
Почта контрагентаединственная почта контрагента, если она одна
Номеравтоматически, если пользователь не ввел номер вручную

При изменении даты договора в форме дата окончания срока действия автоматически пересчитывается как дата договора + 1 год. Пользователь может затем изменить дату окончания вручную.

Проверки при сохранении​

Договор не будет создан или обновлен, если:

  • у пользователя нет доступа к редактированию договоров текущего контрагента;
  • банковские реквизиты контрагента не найдены или относятся к другому контрагенту;
  • подписант контрагента не найден или относится к другому контрагенту;
  • почта контрагента не найдена и не относится к самому контрагенту или его контактному лицу;
  • наши банковские реквизиты не найдены или относятся не к нашей организации;
  • наш подписант не найден или относится не к нашей организации;
  • наша почта не найдена и не относится к нашей организации или ее контактному лицу;
  • при создании или обновлении номер конфликтует с другим неархивным договором (для обычных — любой дубль; для многосторонних — дубль с не-многосторонним или с другой нашей организацией);
  • при обновлении договор не найден;
  • при обновлении договор уже архивный;
  • при обновлении меняются банковские реквизиты так, что фактически меняется наша организация.

Эти проверки выполняются на сервере, поэтому они срабатывают независимо от того, из какого места интерфейса или API пользователь пытается изменить договор.

Типы договоров​

В справочнике есть типы:

  • С покупателем — основной сценарий;
  • С поставщиком (пока не используется);
  • Счёт-договор — один документ вместо договора + спецификации + счёта на предоплату; создаётся только для конкретного заказа покупателя (см. ниже).

При создании через вкладку контрагента тип для ролей продаж — С покупателем. Тип Счёт-договор создаётся из задач процесса / заказа (с buyerOrderId), не через обычную кнопку «Добавить договор» на вкладке.

Важно для разработки: в сервисе есть логика для договоров С поставщиком, но текущий ContractController разрешает операции с договорами ролям продаж и администратору для просмотра. Роль снабженца в атрибутах доступа этого контроллера сейчас не указана.

Счёт-договор​

Путь для заказа покупателя, когда вместо отдельной спецификации и счёта на предоплату используется один печатный документ (шаблон ContractInvoice.docx). Подробности и критерии: эпик счёт-договор.

Ключевые правила для пользователя:

  • создаётся для текущего заказа; чужой счёт-договор к заказу привязать нельзя;
  • недоступен при отсрочке; сумма предоплаты + оплаты перед отгрузкой = 100%;
  • нумерация общая с обычными договорами нашей организации;
  • в модалке договора — баннер со ссылкой на заказ («Счёт-договор привязан к заказу…»);
  • генерация файла договора на этом пути даёт docx счёт-договора (фиксированный шаблон, без выбора шаблона договора); в файл попадают товары и суммы; после генерации файл сохраняется в облако и скачивается;
  • счёт на предоплату появляется автоматически при появлении плана оплат и связан с этим договором; обычный docx предоплаты на этом пути не создают и не скачивают — печать через файл счёт-договора;
  • этап перед отгрузкой — обычный отдельный счёт со своим docx;
  • в задачах спецификации / запуска файл спецификации на этом пути не обязателен.

Связь с заказами и процессами​

Договор выбирается в заказе покупателя и используется дальше в процессе работы с заказом.

Где договор участвует:

  • в заказе покупателя отображается номер договора со ссылкой на карточку договора;
  • в задачах создания и согласования спецификации / начале заказа можно выбрать существующий договор или создать счёт-договор для этого заказа;
  • из задачи можно сгенерировать docx договора (для счёт-договора — шаблон счёт-договора);
  • в задаче запуска отображаются ссылка на договор и даты подписания/отправки; при счёт-договоре согласование идёт по его файлу;
  • в счете на оплату договор подставляет основание и может фиксировать наши банковские реквизиты;
  • при формировании документов отгрузки договор может передавать банковские реквизиты и подписантов.

Если в заказе выбран договор с банковскими реквизитами нашей организации, счет на оплату использует эти реквизиты как фиксированные.

Права доступа​

ДействиеРоли
Смотреть таблицу договоров контрагентаначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам; API также разрешает администратору
Смотреть форму договораначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам; API также разрешает администратору
Смотреть список договоров для выбора в заказе или задаченачальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам; API также разрешает администратору, но сервис дополнительно проверяет бизнес-доступ
Создать договорначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам
Редактировать договорначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам
Архивировать договорначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам
Сгенерировать docxначальник менеджеров по продажам, менеджер по продажам, помощник менеджера по продажам; API также разрешает администратору
Сгенерировать PDFendpoint есть, но PDF не поддерживается

Для менеджера по продажам и помощника менеджера по продажам доступ к покупателю зависит от группы доступа контрагента. Если контрагент является покупателем и у пользователя нет доступа к его группе, договоры этого контрагента недоступны.

Данные​

Договор хранит:

  • номер;
  • дату договора;
  • дату окончания срока действия;
  • признак пролонгации;
  • автора;
  • тип договора;
  • документ договора;
  • банковские реквизиты контрагента;
  • банковские реквизиты нашей организации;
  • почту контрагента;
  • почту нашей организации;
  • подписанта контрагента;
  • подписанта нашей организации;
  • дату архивирования;
  • признак импортированного договора.

В таблицу дополнительно выводятся покупатель, наша организация, автор, признак архивного договора и признак типового документа.

API​

Основные операции:

МетодАдресНазначение
GET/Order/Partner/:partnerId/Contract/tableполучить договоры контрагента для таблицы
GET/Order/Partner/:partnerId/Contract/:contractIdполучить договор для просмотра или редактирования
GET/Order/Partner/:partnerId/Contract/listполучить список неархивных договоров для выбора, можно передать ourPartnerId
POST/Order/Partner/:partnerId/Contractсоздать договор
PUT/Order/Partner/:partnerId/Contract/:contractIdобновить договор
GET/Order/Partner/:partnerId/Contract/:contractId/docxсформировать docx
GET/Order/Partner/:partnerId/Contract/:contractId/pdfPDF сейчас не поддерживается, возвращается ошибка
DELETE/Order/Partner/:partnerId/Contract/:contractIdархивировать договор

Документ договора редактируется отдельными endpoints документа, потому что ссылка на файл и статусы документа относятся к общей сущности Документ.

Связанные страницы​