API Documentation - Метод создания приходного ДДС по GUID клиента

06-12-2018 12:11

Метод создания приходного ДДС по GUID клиента

POST /bs-core/main/loans/payment

Метод создаёт приходное ДДС по GUID клиента (на паевой контракт с признаком Счет клиента).

Логика метода следующая. Проверяются обязательные поля, ищется клиент по указанному clientGuid, по этому клиенту ищем активный паевой контракт с проставленными признаками Дополнительный и Счет клиента и на этот контракт сохраняется приходный ДДС (без автоакцепта). Описание возможных ошибок смотрите вот по этой ссылке https://connect.brainysoft.ru/documentation/article/272.

Запрос

POST /bs-core/main/loans/payment
{
 "orderId":"123yyy456",
 "amount": {
      "local": 3000,
      "foreign": 0
    },
"dateTime":1532000789986,
"clientGuid":"111115",
"paymentTypeId":101172,
"settlementAccountId":101671,
"cashOfficeId":101801,
"comment":"Приходный ДДС 19-07-2018 13:00:00"
}

Описание параметров

Параметр	Обязателен	Тип данных	Описание
orderId	О	[string][50]	Номер ДДС. Если этот параметр не указан, то при сохранении ДДС этот номер формируется автоматически.
amount	R	[object]	Сумма
amount.local	М	[float]	Сумма в национальной валюте
amount.foreign	М	[float]	Сумма в иностранной валюте. Так как все платежы производятся в национальной валюте, то значение этого поля проставляется 0.
dateTime	О	[string]	Дата и время ДДС в формате unix timestamp в миллисекундах. Если поле не указано, то используются текущие дата и время.
clientGuid	R	[string]	GUID клиента. Нужно передавать значения, которые передаются в параметре borrower.guid в методе "Метод создания клиента, заявки, контракта ... (Revo)".
paymentTypeId	О	[int][20]	Id Вида платежа: 101171 - Банк 101172 - Касса Если paymentTypeId не указан, то используется значение 101171 (Банк).
settlementAccountId	R	[int][20]	Id Расч/счета из справочника "Банки"
cashOfficeId	R	[int][20]	Id Кассы. Этот параметр является условно обязательным. Передается в том случае, если в параметре paymentTypeId передаётя значение 101172 - Касса.
comment	О	[string][255]	Комментарий

Ответ


                        {
    "status": "ok",
    "timestamp": 1462950227944,
    "data": {
        "orderId": "123yyy456",
        "amountMovingDirectionId": 101781,
        "amount": {
            "local": 3000,
            "foreign": 0
        },
        "date": "2018-07-19",
		"dateTime":1532000789986,
        "contractId": 3,
        "paymentTypeId": 101172,
        "settlementAccountId":101671,
        "cashOfficeId": 101801,
        "comment":"Приходный ДДС 19-07-2018 13:00:00",
        "externalAction": false,
        "accountId": null,
        "clientId": null,
        "linkedCashOfficeId": null,
        "id": 10181145,
        "osmpTxnId": null,
        "contactTxnId": null,
        "liderSysId": null,
        "liderSysNo": null,
        "controlAmount": {
            "local": 0,
            "foreign": 0
        },
		"createdUserId":1082
    }
}

Описание параметров

Параметр	Обязателен	Тип данных	Описание
orderId	О	[string][50]	Номер ДДС
amountMovingDirectionId	О	[int][20]	Идентификатор типа движения денежных средств (Id Типа ДДС). Так как приходный ДДС, то значение параметра 101781 - приход.
amount	О	[object]	Сумма
amount.local	О	[float]	Сумма в национальной валюте
amount.foreign	О	[float]	Сумма в иностранной валюте. Так как все платежы производятся в национальной валюте, то значение этого поля всегда будет принимать значение 0.
date	О	[string]	Дата погашение в формате ГГГГ-ММ-ДД. Значение этого поля тоже самое, что и в поле dateTime, но без времени.
dateTime	О	[string]	Дата и время ДДС в формате unix timestamp в миллисекундах.
contractId	О	[int][20]	Id Контракта, созданного методом "Метод создания клиента, заявки, контракта ... (Revo)".
paymentTypeId	О	[int][20]	Id Вида платежа: 101171 - Банк 101172 - Касса
settlementAccountId	О	[int][20]	Id Расч/счета из справочника "Банки"
cashOfficeId	О	[int][20]	Id Кассы
comment	О	[string][255]	Комментарий
externalAction	О	[bool]	Признак "внешнего" ДДС. Внешнее ДДС - это движение денег, не касающееся кредитной деятельности организации. В этом параметре возвращается значение false, так как этот метод не работает с внешними ДДС.
accountId	О	[int][20]	Id Счета (для внешнего движения). В этом методе возвращается значение null.
clientId	О	[int][20]	Id Клиента (для внешнего движения). Возвращается значение null, так как метод не работает с внешними ДДС.
linkedCashOfficeId	О	[int][20]	Id Корр. касса (для внешнего движения). Возвращается значение null, так как метод не работает с внешними ДДС.
id	О	[int][20]	Идентификатор, созданного приходного ДДС.
osmpTxnId	О	[int][20]	Id транзакции в ОСМП. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
contactTxnId	О	[int][20]	Id транзакции в системе Contact. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
liderSysId	О	[string][25]	Sys id транзакции Лидер. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
liderSysNo	О	[int][20]	Sys no транзакции Лидер. Это поле оставлено для обратной совместимости и помечено на удаление. Не использовать.
controlAmount	О	[object]	Контрольная сумма. Это поле оставлено для обратной совместимости.
controlAmount.local	О	[float]	Контрольная сумма в локальной валюте. Это поле оставлено для обратной совместимости.
controlAmount.foreign	О	[float]	Контрольная сумма в иностранной валюте. Это поле оставлено для обратной совместимости.
createdUserId	О	[int][11]	Id пользователя, создавшего ДДС.