Создание конвертации валюты
Тип документа предназначен для перевода сумм в тенге со счета Клиента на счет резидента РК.
Создание конвертации валюты
| |
|---|
| endpoint | /currency-exchange-service/accountTransfer/create |
| Request method | POST |
| Response status | 200 |
| |
|---|
| Content-Type | application/json |
Тело запроса / Body
!ВАЖНО: в примечаниях постоянные значения в рамках текущего запроса выделяются цветом.
| № | Поле | Тип данных | Является обязательным | Примечание |
|---|
| 1 | id | integer | | |
| 2 | account | object | Да | Счет списания. AccountShortView – описание в таблице далее |
| 3 | accountant | object | Да | CustomerUserShortView – описание в таблице далее |
| 4 | allowMoneyProcessing | boolean | Да | true |
| 5 | amount | decimal | Да | Сумма. Формат – "########.##" |
| 6 | creditAccount | object | Да | Счет зачисления. AccountShortView – описание в таблице далее |
| 7 | creditNumber | string | | |
| 8 | creditSum | decimal | | |
| 9 | director | object | Да | CustomerUserShortView – описание в таблице далее |
| 10 | exchangeRate | decimal | Да | Обменный курс |
| 11 | feeAccount | object | Да | Счет комиссии. AccountShortView – описание в таблице далее |
| 12 | fixDebitSum | boolean | Да | true |
| 13 | individualExchangeRate | boolean | Да | false |
| 14 | number | string | Да | Номер платежного документа. Не более 9 знаков. |
| 15 | operationTargetCode | string | | |
| 16 | purpose | string | Да | Назначение. Формируется как расшифровка operationTargetId + contractNumber + contractDate |
| 17 | purposeCode | string | Да | Составное назначение платежа. purpose + КНП |
| 18 | valueDate | date | Да | Дата документа. Формат - "dd.MM.yyyy" |
| 19 | contractId | long | Да | Идентификатор валютного контракта в Системе |
Object: account (AccountShortView)
| № | Поле | Тип данных | Является обязательным | Примечание |
|---|
| 1 | number | string | Да | Номер счета |
| 2 | currency | string | | Валюта |
| 3 | plannedBalance | decimal | | |
Object: creditAccount (AccountShortView)
| № | Поле | Тип данных | Является обязательным | Примечание |
|---|
| 1 | number | string | Да | Номер счета |
| 2 | currency | string | | Валюта |
| 3 | plannedBalance | decimal | | |
Object: feeAccount (AccountShortView)
| № | Поле | Тип данных | Является обязательным | Примечание |
|---|
| 1 | number | string | Да | Номер счета |
| 2 | currency | string | | Валюта |
| 3 | plannedBalance | decimal | | |
Object: director, accountant (CustomerUserShortView)
| № | Поле | Тип данных | Является обязательным | Примечание |
|---|
| 1 | id | long | Да | Идентификатор в Системе |
Ответ / Response object
| № | Поле | Тип данных | Примечание |
|---|
| 1 | value | long | Идентификатор созданного в Системе документа {id} |
Пример запроса
curl --location 'https://api-test.berekebank.kz/currency-exchange-service/accountTransfer/create' \ --header 'Authorization: [object Object]' \ --data '{"id":null,"account":{"currency":"KZT","number":"KZ1111111BC1111111111","plannedBalance":11111111.11},"accountant":{"id":111111},"allowMoneyProcessing":true,"amount":11111.1,"creditAccount":{"currency":"USD","number":"KZ11111111111BC111111","plannedBalance":0},"creditNumber":null,"creditSum":111,"director":{"id":1111111},"exchangeRate":111.1,"feeAccount":{"currency":"KZT","number":"KZ111111111111BC11111","plannedBalance":11111111.11},"fixDebitSum":false,"individualExchangeRate":false,"number":"11","operationTargetCode":"5","purpose":"Получение услуг|405/50 от 17.03.2017","purposeCode":"213","valueDate":"18.02.2025","contractId":"111111"}'
Пример ответа
{"id":71262,"hasPermissionToSign":true,"requestId":null,"authFactorType":null}
Редактирование конвертации валюты
Редактирование платежного поручения доступно только для документов с активным статусом Черновик (Raw) или Новый (Draft).
| |
|---|
| endpoint | /currency-exchange-service/accountTransfer/update/{id} |
| Request method | PUT |
| Response status | 200 |
Примечание: id – идентификатор созданного в Системе документа.
| |
|---|
| Content-Type | application/json |
Тело запроса / Body
Смотреть Создание конвертации валюты > Тело запроса / Body
Ответ / Response object
| № | Поле | Тип данных | Примечание |
|---|
| 1 | value | long | Идентификатор отредактированного в Системе документа id |
Пример запроса
curl --location 'https://api-test.business-t.berekebank.kz/currency-exchange-service/accountTransfer/update/71262' \ --header 'Authorization: [object Object]' \ --data '{"id":null,"account":{"currency":"KZT","number":"KZ11111111111BC00011","plannedBalance":11111111.11},"accountant":{"id":496713},"allowMoneyProcessing":true,"amount":11111.1,"creditAccount":{"currency":"USD","number":"KZ11111111111BC11111","plannedBalance":0},"creditNumber":null,"creditSum":000,"director":{"id":000000},"exchangeRate":000.0,"feeAccount":{"currency":"KZT","number":"KZ00000000000BC00000","plannedBalance":11111111.11},"fixDebitSum":false,"individualExchangeRate":false,"number":"11","operationTargetCode":"5","purpose":"Получение услуг|405/50 от 17.03.2017","purposeCode":"213","valueDate":"18.02.2025","contractId":"149701"}'
Пример ответа
{"id" : 71262,"hasPermissionToSign" : true,"requestId" : null,"authFactorType" : null}