Создание налогового платежа без списка сотрудников
Создаёт налоговый платёж без списка сотрудников. Передайте domesticTransferType=PaymentOrder и paymentProductType=TAX_PAYMENT.
| Endpoint | POST /domestic-payment-service/api/v1/external-payment |
| Content-Type | application/json |
| Авторизация | OAuth2 / JWT (Bearer token) |
Тело запроса
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
id | Long | Нет | Идентификатор платежа. При создании не передаётся, используется при обновлении |
domesticTransferType | enum (DomesticTransferType) | Да | Тип платежа. Для API = "PaymentOrder" — отдельного значения для налогового платежа не существует |
paymentProductType | enum (PaymentProductType) | Да | Тип продукта платежа. Для налогового платежа = "TAX_PAYMENT". Это ключевой признак: от него зависят все проверки ниже (taxCommittee, budgetClassificationCode и т.д.) |
number | String | Условно | Номер документа (валидируется constraint number) |
amount | BigDecimal | Да | Сумма платежа (проверка лимитов и max sum) |
senderResidencyCountry.twoLetterCode | String | Да | Код страны отправителя |
senderResidencyCountry.name | String | Нет | Наименование страны отправителя |
actualSender.taxCode | String | Нет | БИН/ИИН фактического отправителя |
actualSender.name | String | Нет | Имя фактического отправителя |
actualSender.type | enum (ActualSenderType) | Нет | Тип (DEBTOR) |
paymentSource | enum (PaymentSource) | — | Вычисляется сервером (V2 / FACTORING), клиентом не передаётся |
valueDate | LocalDate (yyyy-MM-dd) | Условно | Дата валютирования |
purpose.code | String | Да | Код назначения платежа (КНП). Для налогового платежа — код, соответствующий уплате конкретного налога/бюджетного платежа |
purpose.label | String | Да | Текст назначения платежа |
taxCommittee.bin | String | Да, если paymentProductType = TAX_PAYMENT | БИН налогового органа-получателя; проверяется как корректный БИН/ИИН (IINUtil.isIinCorrect) |
taxCommittee.name | String | Да, если paymentProductType = TAX_PAYMENT | Наименование налогового органа-получателя |
priority | boolean | Нет | Признак срочности |
vatAmount | BigDecimal | Нет | Сумма НДС |
info | String | Нет | Доп. информация по назначению |
account.currency | String | Да | Валюта счёта |
account.number | String | Да | IBAN счёта |
account.alias | String | Нет | Псевдоним |
account.balance | BigDecimal | Нет | Баланс |
account.type | enum AccountType | Да | Тип счёта |
beneficiary.account | String | Да | IBAN счёта получателя (реквизиты банка налогового органа) |
beneficiary.name | String | Да | Наименование получателя |
beneficiary.bankCode | String | Да | Код банка получателя |
beneficiary.taxCode | String | Да | БИН/ИИН получателя |
beneficiary.bankName | String | Да | Банк получателя |
beneficiary.bankBIC | String | Да | BIC банка получателя |
beneficiary.residencyAndEconomicCode | String | Да | КБе |
beneficiary.counterpartyId | Long | Нет | ID контрагента |
beneficiary.residencyCountryCode.twoLetterCode | String | Да | Страна получателя (код) |
beneficiary.residencyCountryCode.name | String | Нет | Страна получателя (название) |
beneficiary.actualBeneficiary.taxCode | String | Нет | БИН/ИИН фактического получателя |
beneficiary.actualBeneficiary.name | String | Нет | Имя фактического получателя |
kvo.code | String | Условно | Код валютной операции |
kvo.label | String | Условно | Наименование КВО |
budgetClassificationCode | String | Да, если paymentProductType = TAX_PAYMENT | Код бюджетной классификации (КБК) |
budgetClassificationLabel | String | Нет | Расшифровка КБК (справочно, не валидируется) |
invoiceId | Long | Нет | Идентификатор инвойса; относится к факторингу, для налогового платежа не используется |
consignments | List<ConsignmentRequest> | Нет | Партии поставки; относится к факторингу, для налогового платежа не используется |
numberOfAdministrativeAffairs | String | Условно | Номер административного дела; обязателен, если budgetClassificationCode входит в список КБК по административным штрафам (константа KBK_FOR_ADM_FINES) |
dateOfAdministrativeAffairs | LocalDate (yyyy-MM-dd) | Условно | Дата административного дела; условие обязательности то же, что и у numberOfAdministrativeAffairs |
vinCode | String | Условно | VIN автомобиля; обязателен, если budgetClassificationCode входит в список КБК для VIN-платежей (константа KBK_FOR_VIN) |
subsidiary.subsidiaryOrganizationId | Long | Нет | ID дочерней организации |
isNotNeedUnc | Boolean | Нет | Не требуется УНК |
isPermitGiveInformation | Boolean | Нет | Согласие на предоставление информации |
isLoanPay | boolean | Нет (default false) | Погашение кредита |
Примечание: beneficiary в налоговом платеже — это реквизиты банка налогового органа, а не сам налоговый орган; они заполняются клиентом так же, как обычный контрагент, и не связаны напрямую с полем taxCommittee (в примере ниже они намеренно совпадают, т.к. получателем средств выступает тот же налоговый орган).
Пример тела запроса
Реквизиты и суммы в примере условные. Замените их актуальными значениями.
{
"domesticTransferType": "PaymentOrder",
"paymentProductType": "TAX_PAYMENT",
"account": {
"type": "Current",
"currency": "KZT",
"number": "KZ11111111111KZ11111"
},
"amount": 11111,
"beneficiary": {
"account": "KZ11111111KSN1111111",
"bankBIC": "KKKKKKK",
"bankCode": "070",
"bankName": "ГУ «",
"name": "УГД по району",
"residencyAndEconomicCode": "11",
"residencyCountryCode": {
"twoLetterCode": "KZ",
"name": "КАЗАХСТАН"
},
"taxCode": "111141111111"
},
"budgetClassificationCode": "111111",
"budgetClassificationLabel": "КБК Расшифровка",
"info": "info field",
"kvo": null,
"number": "1",
"purpose": {
"code": "911",
"label": "Индивидуальный подоходный налог с доходов, облагаемых у источника выплаты"
},
"senderResidencyCountry": {
"twoLetterCode": "KZ",
"name": "КАЗАХСТАН"
},
"taxCommittee": {
"bin": "111141111111",
"name": "УГД по району"
},
"valueDate": "2026-07-15"
}
Тело ответа
| Поле | Тип | Описание |
|---|---|---|
paymentId | Long | Идентификатор созданного платежа |
Коды ошибок
Ошибки:
| Код | Условие |
|---|---|
| 400 Bad Request | Невалидный JSON / неизвестный domesticTransferType / нарушение constraint полей |
| 401 Unauthorized | Отсутствует/невалиден JWT |
| 403 Forbidden | Нет доступа (нет привилегии) |
| 400 / бизнес-ошибки валидации | Возвращаются как ValidationExceptionResponse (список ошибок по полям, формируемый стратегией валидации) |
Пример ошибки валидации — некорректный БИН налогового органа:
{
"validationExceptions": [
{
"fieldName": "taxCommittee.bin",
"translationKey": "validation.v1.incorrect_tax_code",
"message": "Incorrect tax code",
"translatedMessage": "ИИН/БИН указан неверно"
}
]
}
Пример ошибки валидации — не передан КБК:
{
"validationExceptions": [
{
"fieldName": "budgetClassificationCode",
"translationKey": "validation.v1.field_is_empty",
"message": "Field is empty",
"translatedMessage": "Поле не может быть пустым"
}
]
}
Необходимые привилегии
-
payments_add -
payments_view -
payments_edit -
privilege_counterparty_view
Набор привилегий не отличается от «Перевод контрагенту»: проверка доступа выполняется по domesticTransferType (PaymentOrder), paymentProductType на неё не влияет.
Следующие действия
Инициализация подписания → подписание с синхронной отправкой в АБС. Результат доступен через получение платежа.