cash.transaction.bulkCreate

Добавляет несколько операций.

Параметры

• POST

  Список операциях в виде массива, закодированного в формате JSON. Каждый элемент списка — массив со следующими ключами:
  - amount (float): Сумма операции.
  - date (date): Дата операции в формате «гггг-мм-дд».
  - account_id (int): ID счёта.
  - category_id (int): ID статьи доходов или расходов.
  - contractor_contact_id (int): ID контакта, с которым должна быть связана операция. Необязательно.
  - contractor (string): Имя нового контакта, который нужно создать, чтобы связать с ним созданную операцию. Необязательно. Используется, только если не заполнено значение ключа 'contractor_contact_id'.
  - description (string): Комментарий к операции. Необязательно.
  - is_repeating (bool): Флаг, обозначающий, что операция должна повторяться. Необязательно.
  - repeating_frequency (int): Периодичность повторения операции, выраженная количеством отрезков времени, указанных в ключе 'repeating_interval', по истечении которых нужно повторить операцию. Используется для повторяющихся операций. Если не указано, по умолчанию используется значение '1'.
  - repeating_interval (string): Обозначение отрезка времени для вычисления периодичности повторения операции: 'day' (день), 'week' (неделя), 'month' (месяц), 'year' (год). Используется для повторяющихся операций. Если не указано, по умолчанию используется значение 'month'.
  - repeating_end_type (string): Обозначение длительности повторения операции: 'never' (повторять всегда), 'after' (повторять заданное количество раз), 'ondate' (повторять до указанной даты). Используется для повторяющихся операций. Если не указано, по умолчанию используется значение 'never'. Если используется значение 'never', то, кроме данной операции, будет также создано несколько дополнительных операций в качестве её повторения; их количество зависит от значения в ключе 'repeating_interval': 'day' — операции будут созданы на следующие 3 года; 'week' — операции будут созданы на следующие 16 недель; 'month' — операции будут созданы на следующие 36 месяцев; 'year' — операции будут созданы на следующие 10 лет.
  - repeating_end_after (int): Количество повторений для повторяющейся операции. Необязательно. Используется для повторяющихся операций, если в ключе 'repeating_end_type' указано значение 'after'.
  - transfer_account_id (int): ID счёта, с которого нужно выполнить операцию-перевод. Необязательно.
  - transfer_incoming_amount (int): ID счёта, на который нужно зачислить средства в рамках операции-перевода. Необязательно.
  - is_onbadge (bool): Флаг, обозначающий незавершённую операцию, которую нужно провести вручную. Необязательно.
  - is_self_destruct_when_due (bool): Флаг автоматического удаления повторяющейся операции, когда наступает её день. Необязательно.

• format GET Необязательно

  Устанавливает формат ответа. Возможные значения: json (по умолчанию), xml.

Возвращаемое значение

Список созданных операций. Каждый элемент списка — массив со следующими ключами:

• []['id'] int ID операции.
• []['account_id'] int ID счёта.
• []['affected_transaction_ids'] array Список ID созданных операций с учётом повторения.
• []['affected_transactions'] int Количество созданных операций.
• []['amount'] float Сумма операции.
• []['amountShorten'] string Сокращённое локализованное обозначение суммы операции.
• []['category_id'] int ID статьи доходов или расходов, к которой относится операция.
• []['contractor_contact'] array|null Свойства контакта, связанного с операцией, в виде массива со следующими ключами:
• []['contractor_contact']['firstname'] string Имя.
• []['contractor_contact']['lastname'] string Фамилия.
• []['contractor_contact']['name'] string Полное имя.
• []['contractor_contact']['userpic'] string URL изображения контакта размером 96х96 пикселей.
• []['contractor_contact_id'] int ID контакта, связанного с операцией.
• []['create_contact'] array|null Свойства пользователя, добавившего операцию, в виде массива со следующими ключами:
• []['create_contact']['firstname'] string Имя.
• []['create_contact']['lastname'] string Фамилия.
• []['create_contact']['name'] string Полное имя.
• []['create_contact']['userpic'] string URL изображения пользователя размером 96х96 пикселей.
• []['create_contact_id'] int ID пользователя, добавившего операцию.
• []['create_datetime'] datetime Дата и время добавления операции.
• []['date'] date Текущая дата.
• []['datetime'] datetime Время начала текущих суток.
• []['description'] string Комментарий к операции.
• []['is_onbadge'] bool Флаг, обозначающий незавершённую операцию, которую нужно провести вручную.
• []['is_self_destruct_when_due'] bool Флаг автоматического удаления повторяющейся операции, когда наступает её день.
• []['repeating_data'] array Свойства повторяющейся операции в виде массива со следующими ключами:
• []['repeating_data']['frequency'] int Периодичность повторения операции, выраженная количеством отрезков времени, указанных в ключе interval, по истечении которых нужно повторить операцию.
• []['repeating_data']['interval'] string Обозначение отрезка времени для вычисления периодичности повторения операции: 'day' (день), 'week' (неделя), 'month' (месяц), 'year' (год).
• []['repeating_id'] int|null Порядковый номер повторяющейся операции.