Перейти к основному содержимому
Версия: 2026.09.1

Создание налогового платежа без списка сотрудников

Создаёт налоговый платёж без списка сотрудников. Передайте domesticTransferType=PaymentOrder и paymentProductType=TAX_PAYMENT.

EndpointPOST /domestic-payment-service/api/v1/external-payment
Content-Typeapplication/json
АвторизацияOAuth2 / JWT (Bearer token)

Тело запроса​

ПолеТипОбязательностьОписание
idLongНетИдентификатор платежа. При создании не передаётся, используется при обновлении
domesticTransferTypeenum (DomesticTransferType)ДаТип платежа. Для API = "PaymentOrder" — отдельного значения для налогового платежа не существует
paymentProductTypeenum (PaymentProductType)ДаТип продукта платежа. Для налогового платежа = "TAX_PAYMENT". Это ключевой признак: от него зависят все проверки ниже (taxCommittee, budgetClassificationCode и т.д.)
numberStringУсловноНомер документа (валидируется constraint number)
amountBigDecimalДаСумма платежа (проверка лимитов и max sum)
senderResidencyCountry.twoLetterCodeStringДаКод страны отправителя
senderResidencyCountry.nameStringНетНаименование страны отправителя
actualSender.taxCodeStringНетБИН/ИИН фактического отправителя
actualSender.nameStringНетИмя фактического отправителя
actualSender.typeenum (ActualSenderType)НетТип (DEBTOR)
paymentSourceenum (PaymentSource)—Вычисляется сервером (V2 / FACTORING), клиентом не передаётся
valueDateLocalDate (yyyy-MM-dd)УсловноДата валютирования
purpose.codeStringДаКод назначения платежа (КНП). Для налогового платежа — код, соответствующий уплате конкретного налога/бюджетного платежа
purpose.labelStringДаТекст назначения платежа
taxCommittee.binStringДа, если paymentProductType = TAX_PAYMENTБИН налогового органа-получателя; проверяется как корректный БИН/ИИН (IINUtil.isIinCorrect)
taxCommittee.nameStringДа, если paymentProductType = TAX_PAYMENTНаименование налогового органа-получателя
prioritybooleanНетПризнак срочности
vatAmountBigDecimalНетСумма НДС
infoStringНетДоп. информация по назначению
account.currencyStringДаВалюта счёта
account.numberStringДаIBAN счёта
account.aliasStringНетПсевдоним
account.balanceBigDecimalНетБаланс
account.typeenum AccountTypeДаТип счёта
beneficiary.accountStringДаIBAN счёта получателя (реквизиты банка налогового органа)
beneficiary.nameStringДаНаименование получателя
beneficiary.bankCodeStringДаКод банка получателя
beneficiary.taxCodeStringДаБИН/ИИН получателя
beneficiary.bankNameStringДаБанк получателя
beneficiary.bankBICStringДаBIC банка получателя
beneficiary.residencyAndEconomicCodeStringДаКБе
beneficiary.counterpartyIdLongНетID контрагента
beneficiary.residencyCountryCode.twoLetterCodeStringДаСтрана получателя (код)
beneficiary.residencyCountryCode.nameStringНетСтрана получателя (название)
beneficiary.actualBeneficiary.taxCodeStringНетБИН/ИИН фактического получателя
beneficiary.actualBeneficiary.nameStringНетИмя фактического получателя
kvo.codeStringУсловноКод валютной операции
kvo.labelStringУсловноНаименование КВО
budgetClassificationCodeStringДа, если paymentProductType = TAX_PAYMENTКод бюджетной классификации (КБК)
budgetClassificationLabelStringНетРасшифровка КБК (справочно, не валидируется)
invoiceIdLongНетИдентификатор инвойса; относится к факторингу, для налогового платежа не используется
consignmentsList<ConsignmentRequest>НетПартии поставки; относится к факторингу, для налогового платежа не используется
numberOfAdministrativeAffairsStringУсловноНомер административного дела; обязателен, если budgetClassificationCode входит в список КБК по административным штрафам (константа KBK_FOR_ADM_FINES)
dateOfAdministrativeAffairsLocalDate (yyyy-MM-dd)УсловноДата административного дела; условие обязательности то же, что и у numberOfAdministrativeAffairs
vinCodeStringУсловноVIN автомобиля; обязателен, если budgetClassificationCode входит в список КБК для VIN-платежей (константа KBK_FOR_VIN)
subsidiary.subsidiaryOrganizationIdLongНетID дочерней организации
isNotNeedUncBooleanНетНе требуется УНК
isPermitGiveInformationBooleanНетСогласие на предоставление информации
isLoanPaybooleanНет (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"
}

Тело ответа​

ПолеТипОписание
paymentIdLongИдентификатор созданного платежа

Коды ошибок​

Ошибки:

КодУсловие
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 на неё не влияет.

Следующие действия​

Инициализация подписания → подписание с синхронной отправкой в АБС. Результат доступен через получение платежа.