Создание конвертации валюты

Тип документа предназначен для перевода сумм в тенге со счета Клиента на счет резидента РК.

Создание конвертации валюты

endpoint	/currency-exchange-service/accountTransfer/create
Request method	POST
Response status	200

Дополнительные заголовки / Additional headers

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

curl --location 'https://api-test.berekebank.kz/currency-exchange-service/accountTransfer/create' \
  --header 'Authorization: Bearer <token>' \
  --data '{"id":null,"account":{"currency":"KZT","number":"KZ00000KZT0000000000","plannedBalance":11111111.11},"accountant":{"id":111111},"allowMoneyProcessing":true,"amount":11111.1,"creditAccount":{"currency":"USD","number":"KZ00000KZT0000000000","plannedBalance":0},"creditNumber":null,"creditSum":111,"director":{"id":1111111},"exchangeRate":111.1,"feeAccount":{"currency":"KZT","number":"KZ00000KZT0000000000","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 – идентификатор созданного в Системе документа.

Дополнительные заголовки / Additional headers

Content-Type	application/json

Тело запроса / Body

Смотреть Создание конвертации валюты > Тело запроса / Body

Ответ / Response object

№	Поле	Тип данных	Примечание
1	value	long	Идентификатор отредактированного в Системе документа id

Пример запроса

Показать запрос

cURL

curl --location 'https://api-test.business-t.berekebank.kz/currency-exchange-service/accountTransfer/update/71262' \
  --header 'Authorization: Bearer <token>' \
  --data '{"id":null,"account":{"currency":"KZT","number":"KZ00000KZT0000000000","plannedBalance":11111111.11},"accountant":{"id":496713},"allowMoneyProcessing":true,"amount":11111.1,"creditAccount":{"currency":"USD","number":"KZ00000KZT0000000000","plannedBalance":0},"creditNumber":null,"creditSum":0,"director":{"id":0},"exchangeRate":0.0,"feeAccount":{"currency":"KZT","number":"KZ00000KZT0000000000","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
}