18-02-2021 16:22

Создание нового ДДС

POST   /bs-core/main/fund-transactions

В методе для создания нового ДДС, есть два необязательных булиновых параметра - autoaccept (Запускать автоакцепт после создания ДДС) и wait-for-execution (Ждать полного выполнения автоакцепта). Параметр wait-for-execution имеет смысл передавать только если значение параметра autoaccept равно true. Если эти параметры не переданы на ядро, то используются значения по умолчанию. Значение по умолчанию для параметра autoaccept равно true, это означает, что после сохранения ДДС будет автоматически запущен автоакцепт по этому ДДС. Значение по умолчанию для параметра wait-for-execution равно false. Это означает, что после запуска автоакцепта ядро сразу возвращает ответ, не дожидаясь полного выполнения автоакцепта.

Запрос

POST /bs-core/main/fund-transactions

или 

POST /bs-core/main/fund-transactions?autoaccept=true&wait-for-execution=true

{
    "orderId": "0",
    "amountMovingDirectionId": 101781,
    "amount": {
      "local": 3000,
      "foreign": 0
    },
    "date": "2016-05-11",
    "contractId": 1013430,
    "paymentTypeId": 101172,
    "settlementAccountId": null,
    "cashOfficeId": 101801,
    "comment": "",
    "externalAction": false,
    "accountId": null,
    "clientId": null,
    "linkedCashOfficeId": null
  }
Описание параметров
Параметр Обязателен Тип данных Описание
amountMovingDirectionId R [int][20]

Идентификатор типа движения денежных средств:

101781    -    Приход
101782    -    Расход
settlementAccountId О [int][20]

Номер счета из справочника банки, по которому происходит движение денежных средств.Если через кассу (наличный расчет), то не обязателен.
orderId О [string][50]

Номер платежного поручения, номер транзакции в рамках платежной системы. При создании нового ДДС заполняется автоматически, если не передовать значение. 
amount R [object]

Сумма. Указывается в локальной и иностраной валюте. Если погашение произошло только в одной валюте (в локальной) - amount.foreign указывается = 0
amount.foreign М [float]

Сумма погашение в иностранной валюте. Этот параметр является условно обязательным. Заполняется в том случае, если расчёты производятся в иностранной или смешанной валюте.
amount.local М [float]

Сумма погашения в локальной валюте. Этот параметр является условно обязательным. Заполняется в том случае, если расчёты производятся в национальной или смешанной валюте.
date О [string]

Дата погашение в формате ГГГГ-ММ-ДД. Это поле оставлено для обратной совместимости. Рекомендуеться использовать поле dateTime.

Если при создании ДДС будет указано только поле date, то ДДС сохранится без времени. Если будут указаны оба поля, то приоритет будет у поля dateTime. Так как используются дата и время. Поле date в этом случае будет проигнорировано.

Эти изменения важны. Эти изменения касаются автоакцепта. Если ДДС сохранён со временем, то при автоакцепте для создания операций будет использоваться время ДДС. Если ДДС было сохранено без времени, то при автоакцепте будет подставляться текущее системное время.
dateTime R [string]

Дата и время ДДС в формате unix timestamp в миллисекундах. Смотрите также описание параметра date. 
contractId R [int][20]

Идектификатор контракта.
paymentTypeId R [int][20]

Способ платежа. Возможные значения: 

101171 - безналичные платеж,
101172 - наличные,
101173 - другой
cashOfficeId R [int][20]

Касса, по которой произошло движение денежных средств. Поле является условно обязательным, так как передается только при наличных расчетах.
comment О [string][255]

Комментарий. 
externalAction R [bool]

Признак "внешнего" ДДС. Внешнее ДДС - это движение денег, не касающееся кредитной деятельности организации. Поле является условно обязательным.
accountId R [int][20]

Номер счета и справочника счета. Является обязательным для внешних ДДС (при наличии флага externalAction). Для внутренних ДДС значение параметра берётся из справочника автоматически и передавать его не нужно.
clientId R [int][20]

Подотчетное лицо - это сотрудник, отвественное за денежные средства. Заводится системным пользователем как клиент. Используется при проведении ДДС в основном типа "Расход", значение берется из правочника "клиенты". Является обязательным (при наличии флага externalAction). Это поле нужно для предоставления информации об подотчетном лице, которое производит фиксацию расхода либо прихода через кассу или расчетный счет банка. 
linkedCashOfficeId R [int][20]

Вторая Касса, по которой произошло перемещение средств при внешних ДДС (параметр, связан с cashOfficeId, однако является только информационным, не означает автоматическое создание по указанной кассе). Является обязательным (при наличии флага externalAction).

Ответ


                        {
    "status": "ok",
    "timestamp": 1462950227944,
    "data": {
        "orderId": "фыв1",
        "amountMovingDirectionId": 101781,
        "amount": {
            "local": 3000,
            "foreign": 0
        },
        "date": "2016-05-11",
        "contractId": 1013430,
        "paymentTypeId": 101172,
        "settlementAccountId": null,
        "cashOfficeId": 101801,
        "comment": "",
        "externalAction": false,
        "accountId": null,
        "clientId": null,
        "linkedCashOfficeId": null,
        "id": 10181145,
        "osmpTxnId": null,
        "contactTxnId": null,
        "liderSysId": null,
        "liderSysNo": null,
        "controlAmount": {
            "local": 0,
            "foreign": 0
        }
    }
}
Описание параметров
Параметр Обязателен Тип данных Описание
clientId О [int][20]

Подотчетное лицо - это сотрудник, отвественное за денежные средства. Заводится системным пользователем как клиент. Используется при проведении ДДС в основном типа "Расход", значение берется из правочника "клиенты". Является обязательным (при наличии флага externalAction). Это поле нужно для предоставления информации об подотчетном лице, которое производит фиксацию расхода либо прихода через кассу или расчетный счет банка. 
date О [string]

Дата погашение в формате ГГГГ-ММ-ДД. Это поле оставлено для обратной совместимости. Рекомендуеться использовать поле dateTime.

Если при создании ДДС будет указано только поле date, то ДДС сохранится без времени. Если будут указаны оба поля, то приоритет будет у поля dateTime. Так как используются дата и время. Поле date в этом случае будет проигнорировано.

Эти изменения важны. Эти изменения касаются автоакцепта. Если ДДС сохранён со временем, то при автоакцепте для создания операций будет использоваться время ДДС. Если ДДС было сохранено без времени, то при автоакцепте будет подставляться текущее системное время.
dateTime О [string]

Дата и время ДДС в формате unix timestamp в миллисекундах. Смотрите также описание параметра date. 
contractId О [int][20]

Идектификатор контракта.
paymentTypeId О [int][20]

Способ платежа. Возможные значения: 

101171 - безналичные платеж,
101172 - наличные,
101173 - другой
settlementAccountId О [int][20]

Номер счета из справочника банки, по которому происходит движение денежных средств.Если через кассу (наличный расчет), то не обязателен.
cashOfficeId О [int][20]

Касса, по которой произошло движение денежных средств. Поле является условно обязательным, так как передается только при наличных расчетах.
comment О [string][255]

Комментарий. 
externalAction О [bool]

Признак "внешнего" ДДС. Внешнее ДДС - это движение денег, не касающееся кредитной деятельности организации. Поле является условно обязательным.
accountId О [int][20]

Номер счета и справочника счета. Является обязательным для внешних ДДС (при наличии флага externalAction). Для внутренних ДДС значение параметра берётся из справочника автоматически и передавать его не нужно.
linkedCashOfficeId О [int][20]

Вторая Касса, по которой произошло перемещение средств при внешних ДДС (параметр, связан с cashOfficeId, однако является только информационным, не означает автоматическое создание по указанной кассе). Является обязательным (при наличии флага externalAction).
id О [string]

Идентификатор
osmpTxnId О [int]

Id транзакции в ОСМП. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
contactTxnId О [int]

Id транзакции в системе Contact. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
liderSysId О [string]

sys id транзакции Лидер. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
liderSysNo О [int]

sys no транзакции Лидер. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
controlAmount О [object]

Контрольная сумма
controlAmount.local О [float]

Контрольная сумма в локальной валюте
controlAmount.foreign О [float]

Контрольная сумма в иностранной валюте
createdUserId О [int]

Id пользователя, создавшего ДДС
orderId О [string][50]

Номер платежного поручения, номер транзакции в рамках платежной системы. При создании нового ДДС заполняется автоматически, если не передовать значение. 
amountMovingDirectionId О [int][20]

Идентификатор типа движения денежных средств:

101781    -    Приход
101782    -    Расход
amount О [object]

Сумма. Указывается в локальной и иностраной валюте. Если погашение произошло только в одной валюте (в локальной) - amount.foreign указывается = 0
amount.local О [float]

Сумма погашение в локальной валюте
amount.foreign О [float]

Сумма погашение в иностранной валюте