Набор сервисов для получения информации о налоговой задолженности и дополнительной информации о налогоплательщике в КГД.
Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервисов в песочнице. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
Пути
/taxInfo
Проверка налоговой задолженности
Проверка налоговой задолженности налогоплательщика
Авторизация посредством вызова запроса с механизмом HTTP Basic аутентификации
Успешное получение информации
/taxPayerInfo
Получение дополнительной информации о налогоплательщике
Получение данных о налогоплательщике по ИИН из справочника налогоплательщиков РК
Авторизация посредством вызова запроса с механизмом HTTP Basic аутентификации
Идентификационный номер налогоплательщика
Определения
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"charCode": {
"type": "string"
},
"nameRu": {
"type": "string"
},
"nameKz": {
"type": "string"
},
"reportAcrualDate": {
"type": "string"
},
"totalArrear": {
"type": "string"
},
"totalTaxArrear": {
"type": "string"
},
"pensionContributionArrear": {
"type": "string"
},
"socialContributionArrear": {
"type": "string"
},
"socialHealthInsuranceArrear": {
"type": "string"
},
"taxPayerInfo": {
"$ref": "#\/definitions\/TaxInfoPayerType"
}
},
"required": [
"charCode",
"reportAcrualDate",
"totalArrear",
"totalTaxArrear",
"pensionContributionArrear",
"socialContributionArrear",
"socialHealthInsuranceArrear"
]
}
{
"type": "object",
"properties": {
"iinBin": {
"type": "string"
},
"nameRu": {
"type": "string"
},
"nameKz": {
"type": "string"
},
"arrearsInfo": {
"type": "array",
"items": {
"$ref": "#\/definitions\/ArrearsInfoType"
}
},
"taxArrear": {
"type": "string"
},
"poenaArrear": {
"type": "string"
},
"percentArrear": {
"type": "string"
},
"fineArrear": {
"type": "string"
},
"totalArrear": {
"type": "string"
}
},
"required": [
"iinBin"
]
}
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"nameRu": {
"type": "string"
},
"nameKz": {
"type": "string"
},
"taxArrear": {
"type": "string"
},
"poenaArrear": {
"type": "string"
},
"percentArrear": {
"type": "string"
},
"fineArrear": {
"type": "string"
},
"totalArrear": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"status": {
"$ref": "#\/definitions\/StatusType"
},
"responseData": {
"$ref": "#\/definitions\/ResponseDataType"
}
},
"required": [
"status"
]
}
{
"type": "object",
"properties": {
"messageType": {
"type": "string"
},
"responseCode": {
"type": "string"
},
"sendTime": {
"type": "string"
},
"iinBin": {
"type": "string"
},
"nameRu": {
"type": "string"
},
"nameKz": {
"type": "string"
},
"taxOrgInfo": {
"$ref": "#\/definitions\/TaxOrgInfoType"
}
},
"required": [
"messageType",
"responseCode",
"sendTime",
"iinBin"
]
}
Информация о налогоплательщике по ИИН из справочника налогоплательщиков РК.
Примечание для поля personType
Для ФЛ. 1 — ничего из нижеследующих, 32 — индивидуальный предприниматель, 64 — адвокат, 128 — частный нотариус, 256 — частный судебный исполнитель. Для ЮЛ данное поле отсутствует.
Примечание для поля taxAuthorityCode
Код налогового органа передается без лидирующего нуля. Т.е. если код 0380, то в поле вернется 380. Кроме того в случае если в системе хранится нечисловое значение кода, то будет возвращено значение 1. В случае если код не определен, то данное поле в ответе будет отсутствовать.
{
"properties": {
"title": {
"type": "string",
"description": "ФИО или наименование налогоплательщика",
"example": "Иванов Иван Иванович"
},
"selfEmployedTitle": {
"type": "string",
"description": "Наименование индивидуального предпринимателя",
"example": "ИП \"Новые технологии\""
},
"taxPayerType": {
"type": "integer",
"description": "Тип налогоплательщика. 1 — Юридическое лицо, 0 — физическое число",
"example": "0",
"format": "int32"
},
"notResident": {
"type": "integer",
"description": "Признак не резидента. 1 — не резидент, 0 — резидент",
"example": "0",
"format": "int32"
},
"personType": {
"type": "integer",
"description": "Тип физического лица",
"example": "32",
"format": "int32"
},
"inactive": {
"type": "integer",
"description": "Признак бездействующего налогоплательщика. 0 — действующий, 1 — бездействующий.",
"format": "int32",
"example": "0"
},
"taxAuthorityCode": {
"type": "integer",
"description": "Код налогового органа по месту жительства или местоположению",
"example": "181401",
"format": "int32"
}
},
"additionalProperties": false,
"required": [
"taxPayerType",
"title",
"notResident",
"inactive",
"taxAuthorityCode"
]
}
Информация о результате выполнения операции, может содержать дополнительные не описанные в документации атрибуты специфичные для разных API.
{
"properties": {
"success": {
"type": "boolean",
"description": "Результат выполнения операции"
},
"code": {
"type": "integer",
"description": "Код ответа",
"format": "int32"
},
"description": {
"type": "string",
"description": "Описание кода ответа"
}
},
"additionalProperties": true,
"required": [
"success",
"code",
"description"
]
}