---
swagger: "2.0"
info:
  x-ibm-name: gbdul-info-by-bin-v2-api
  title: GbdulInfoByBinV2 API
  version: 1.0.0
  description: Сервис для предоставления регистрационных данных о юридическом лице
  contact:
    name: АО «Банк ЦентрКредит»
    email: api@bcc.kz
schemes:
- https
basePath: /gbdul-info-by-bin-v2
consumes:
- application/json
produces:
- application/json
securityDefinitions:
  Authorization:
    type: oauth2
    description: Токен аутентификации, полученный при вызове сервиса авторизации
    flow: application
    scopes:
      bcc.application.govtech.api: Allow access to Goventment Services API
    tokenUrl: https://api.bcc.kz/bcc/production/v2/oauth/token
security:
- Authorization:
  - bcc.application.govtech.api
x-ibm-configuration:
  testable: true
  enforced: true
  phase: realized
paths:
  /{bin}:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/ResponseDto'
        400:
          description: 400 Bad Request
          schema:
            $ref: '#/definitions/FailureResponse'
        404:
          description: 404 Not Found
          schema:
            $ref: '#/definitions/FailureResponse'
        500:
          description: 500 Internal Server Error
          schema:
            $ref: '#/definitions/FailureResponse'
      parameters:
      - name: bin
        type: string
        required: true
        in: path
        description: БИН организации
definitions:
  FailureResponse:
    type: object
    properties:
      timestamp:
        type: string
        format: date-time
      error:
        type: string
      violations:
        type: array
        items:
          $ref: '#/definitions/Violation'
  Violation:
    type: object
    properties:
      name:
        type: string
      message:
        type: string
  ResponseDto:
    title: Ответ на запрос
    required:
    - status
    type: object
    properties:
      status:
        $ref: '#/definitions/DictionaryTypeDto'
      organization:
        $ref: '#/definitions/OrganizationTypeDto'
      ipsNerezident:
        $ref: '#/definitions/IpsNerezTypeDto'
  DictionaryTypeDto:
    type: object
    required:
    - code
    - nameKz
    - nameRu
    properties:
      code:
        type: string
        description: Код
        example: "0"
      nameRu:
        type: string
        description: Значение на русском языке
        example: Наименование на русском языке
      nameKz:
        type: string
        description: Значение на государственном языке
        example: Наименование на государственном языке
  OrganizationTypeDto:
    type: object
    required:
    - bin
    - fullNameKz
    - fullNameRu
    - orgForm
    - regStatus
    - registrationDate
    - registrationDepartment
    properties:
      bin:
        type: string
        description: БИН
        example: 010140017782
      regStatus:
        $ref: '#/definitions/DictionaryTypeDto'
      registrationDepartment:
        $ref: '#/definitions/DictionaryTypeDto'
      registrationDate:
        type: string
        format: date-time
        description: Дата первичной регистрации
        example: "1999-08-25T00:00:00+06:00"
      registrationLastDate:
        type: string
        format: date-time
        description: Дата последней перерегистрации
        example: "2001-08-25T00:00:00+06:00"
      liquidationDate:
        type: string
        format: date-time
        description: Дата ликвидации, реорганизации
      fullNameRu:
        type: string
        description: Полное наименование на русском языке
        example: Акционерное общество "Информационно-учетный центр"
      fullNameKz:
        type: string
        description: Полное наименование на государственном языке
        example: '"Ақпараттық-есептеу орталығы" акционерлік қоғамы'
      fullNameEn:
        type: string
        description: Полное наименование на английском языке
      shortNameRu:
        type: string
        description: Сокращенное наименование на русском языке
        example: АО "Информационно-учетный центр"
      shortNameKz:
        type: string
        description: Сокращенное наименование на государственном языке
        example: '"Ақпараттық-есептеу орталығы" АҚ'
      shortNameEn:
        type: string
        description: Сокращенное наименование на английском языке
      orgForm:
        $ref: '#/definitions/DictionaryTypeDto'
      formOfLaw:
        $ref: '#/definitions/DictionaryTypeDto'
      privateEnterpriseType:
        $ref: '#/definitions/DictionaryTypeDto'
      taxOrgStatus:
        type: boolean
        description: 1 - бездействующий,0-нет
      addInfo:
        $ref: '#/definitions/AddInfoTypeDto'
      liquidation:
        $ref: '#/definitions/LiquidationTypeDto'
      organizationLeader:
        $ref: '#/definitions/LeaderTypeDto'
      activity:
        type: array
        items:
          $ref: '#/definitions/ActivityTypeDto'
        description: Виды деятельности
      address:
        $ref: '#/definitions/AddressTypeDto'
      authCapital:
        $ref: '#/definitions/AuthCapitalTypeDto'
      foundersUL:
        type: array
        items:
          $ref: '#/definitions/OrganizationShortTypeDto'
        description: Участники, учредители - юрлица
      foundersFL:
        type: array
        items:
          $ref: '#/definitions/PersonTypeDto'
        description: Участники, учредители - физлица
      foundersCount:
        type: integer
        format: int32
        description: Количество участников, учредителей
        example: 3
      foundersCountUL:
        type: integer
        format: int32
        description: Количество участников, учредителей юридических лиц
        example: 1
      foundersCountFL:
        type: integer
        format: int32
        description: Количество участников, учредителей физических лиц
        example: 2
      headerOrganization:
        $ref: '#/definitions/HeadTypeDto'
      statCommInfo:
        $ref: '#/definitions/StatCommInfoTypeDto'
      mainActivityProf:
        $ref: '#/definitions/DictionaryTypeDto'
      reorganizationBins:
        $ref: '#/definitions/ReorganizationTypeDto'
      benefiziars:
        $ref: '#/definitions/BenefiziarsTypeDto'
  IpsNerezTypeDto:
    type: object
    required:
    - bin
    - fullNameRu
    - orgForm
    - regDate
    - regStatus
    properties:
      bin:
        type: string
        description: БИН
      regDate:
        type: string
        format: date-time
        description: Дата записи в Национальный реестр БИН
      liquidationDate:
        type: string
        format: date-time
        description: Дата прекращения деятельности
      fullNameRu:
        type: string
        description: Полное наименование на русском языке
      orgForm:
        $ref: '#/definitions/DictionaryTypeDto'
      countryFac:
        type: boolean
        description: CountryFac
      countryNerezident:
        $ref: '#/definitions/DictionaryTypeDto'
      regStatus:
        $ref: '#/definitions/DictionaryTypeDto'
      leader:
        $ref: '#/definitions/LeaderIpsNerezTypeDto'
      address:
        $ref: '#/definitions/AddressIpsNerezTypeDto'
  AddInfoTypeDto:
    type: object
    required:
    - creationMethod
    - propertyType
    properties:
      creationMethod:
        $ref: '#/definitions/DictionaryTypeDto'
      propertyType:
        $ref: '#/definitions/DictionaryTypeDto'
      typicalCharter:
        type: boolean
        description: 1 - деятельность по типовому уставу
      commerceOrg:
        type: boolean
        description: 1 - коммерческая организация
      enterpriseSubject:
        type: boolean
        description: 1 - субъект предпринимательства
      fundType:
        $ref: '#/definitions/DictionaryTypeDto'
      gosCompanyType:
        $ref: '#/definitions/DictionaryTypeDto'
      statusOO:
        $ref: '#/definitions/DictionaryTypeDto'
      affiliated:
        type: boolean
        description: 1 - дочерняя организация
      international:
        type: boolean
        description: 1 - международная организация
      foreignInvest:
        type: boolean
        description: 1 - с участием иностранных инвесторов
      oneCitizenShip:
        type: boolean
        description: 1 - Участие лиц без гражданства
      branchesExistence:
        type: boolean
        description: 1 - наличие филиалов и представительств
  LiquidationTypeDto:
    type: object
    properties:
      liqBase:
        $ref: '#/definitions/DictionaryTypeDto'
      liqType:
        $ref: '#/definitions/DictionaryTypeDto'
      liqDecisionDate:
        type: string
        format: date-time
        description: Дата решения о ликвидации
      reorgType:
        $ref: '#/definitions/DictionaryTypeDto'
      binReceiver:
        type: string
        description: БИН правоприемника
  LeaderTypeDto:
    type: object
    properties:
      position:
        $ref: '#/definitions/LeaderPositionTypeDto'
      country:
        $ref: '#/definitions/DictionaryTypeDto'
      citizenCountry:
        $ref: '#/definitions/DictionaryTypeDto'
      nationalityRelation:
        $ref: '#/definitions/DictionaryTypeDto'
      iin:
        type: string
        description: ИИН
      surName:
        type: string
        description: Фамилия
      name:
        type: string
        description: Имя
      middleName:
        type: string
        description: Отчество
  ActivityTypeDto:
    type: object
    required:
    - activityNameKz
    - activityNameRu
    properties:
      main:
        type: boolean
        description: Основной вид дейятельности?
      oked:
        type: string
        description: код ОКЭД
        example: "64999"
      activityNameKz:
        type: string
        description: Название вида деятельности на государственном
        example: Басқа топтамаларға енгізілмеген сақтандыру және зейнетақымен қамсыздандырудан
          басқа, қаржылық көрсетілетін қызметтердің басқа да түрлері
      activityNameRu:
        type: string
        description: Название вида деятельности на русском языке
        example: Другие виды финансовых услуг, кроме страхования и пенсионного обеспечения,
          не включенные в другие группировки
  AddressTypeDto:
    type: object
    required:
    - cityKz
    - cityRu
    properties:
      rka:
        type: string
        description: Регистрационный код адреса
        example: 0201300080497704
      zipCode:
        type: string
        description: Почтовый индекс
        example: "010000"
      kato:
        type: string
        description: Код КАТО
        example: "711310000"
      ate:
        type: string
        description: Идентификатор АТЕ с ИС АР
        example: "107989"
      geonimCode:
        type: string
        description: код геонима по ИС АР
        example: "108104"
      districtRu:
        type: string
        description: Область на русском языке
        example: город Нур-Султан
      districtKz:
        type: string
        description: Область на государственном языке
        example: Нұр-Сұлтан қаласы
      regionRu:
        type: string
        description: Район на русском языке
        example: район Сарыарка
      regionKz:
        type: string
        description: Район на государственном языке
        example: Сарыарқа ауданы
      ruralRu:
        type: string
        description: Сельский округ на русском языке
      ruralKz:
        type: string
        description: Сельский округ на государственном языке
      cityRu:
        type: string
        description: Населенный пункт на русском языке
        example: '-'
      cityKz:
        type: string
        description: Населенный пункт на государственном языке
        example: '-'
      streetRu:
        type: string
        description: Название улицы на русском языке
        example: Проспект Республика
      streetKz:
        type: string
        description: Название улицы на государственном языке
        example: Республика Даңғылы
      buildingType:
        $ref: '#/definitions/DictionaryTypeDto'
      buildingNumber:
        type: string
        description: Номер строения
        example: "29"
      block:
        type: string
        description: Номер блока
      corpus:
        type: string
        description: Номер корпуса
      roomType:
        $ref: '#/definitions/DictionaryTypeDto'
      appartmentNumber:
        type: string
        description: Номер помещения
      officeNumber:
        type: string
        description: Номер офиса Не входящий в РКА
  AuthCapitalTypeDto:
    type: object
    properties:
      valueAll:
        type: number
        format: double
        description: Уставной капитал всего в тенге
      valueGov:
        type: number
        format: double
        description: Доля государственного в тенге
      percentGov:
        type: number
        format: double
        description: Доля государственного в %
      valuePrivate:
        type: number
        format: double
        description: Доля частного в тенге
      percentPrivate:
        type: number
        format: double
        description: Доля частного в %
  OrganizationShortTypeDto:
    type: object
    required:
    - organizationNameKz
    - organizationNameRu
    - registrationLastDate
    properties:
      bin:
        type: string
        description: БИН
        example: 010140017782
      country:
        $ref: '#/definitions/DictionaryTypeDto'
      registrationNumber:
        type: string
        description: Регистрационный номер в стране инкорпорации для нерезидента РК
      registrationLastDate:
        type: string
        format: date-time
        description: Дата последней перерегистрации
        example: "1999-08-25T00:00:00+06:00"
      organizationNameRu:
        type: string
        description: Наименование организации на русском языке
        example: Государственное учреждение "Комитет государственного имущества и
          приватизации Министерства финансов Республики Казахстан"
      organizationNameKz:
        type: string
        description: Наименование организации на государственном языке
        example: '"Қазақстан Республикасы Қаржы министрлігінің Мемлекеттік мүлік және
          жекешелендіру комитеті" мемлекеттік мекемесі'
      activity:
        type: string
        description: Вид деятельности для иностранных лиц
      value:
        type: number
        format: double
        description: Сумма вклада в тенге
      percent:
        type: number
        format: double
        description: Доля в %
  PersonTypeDto:
    type: object
    properties:
      country:
        $ref: '#/definitions/DictionaryTypeDto'
      nationalityRelation:
        $ref: '#/definitions/DictionaryTypeDto'
      citizenCountry:
        $ref: '#/definitions/DictionaryTypeDto'
      iin:
        type: string
        description: ИИН
        example: "123456789012"
      taxNumber:
        type: string
        description: Налоговый номер в стране инкорпорации для иностранных лиц
      surName:
        type: string
        description: Фамилия
      name:
        type: string
        description: Имя
      middleName:
        type: string
        description: Отчество
      value:
        type: number
        format: double
        description: Сумма вклада в тенге
      percent:
        type: number
        format: double
        description: Доля в %
  HeadTypeDto:
    type: object
    required:
    - organizationNameKz
    - organizationNameRu
    - registrationLastDate
    properties:
      bin:
        type: string
        description: БИН
      country:
        $ref: '#/definitions/DictionaryTypeDto'
      registrationNumber:
        type: string
        description: Регистрационный номер в стране инкорпорации для нерезидента РК
      registrationLastDate:
        type: string
        format: date-time
        description: Дата последней перерегистрации
      organizationNameRu:
        type: string
        description: Наименование организации на русском языке
      organizationNameKz:
        type: string
        description: Наименование организации на государственном языке
      activity:
        type: string
        description: Вид деятельности для иностранных лиц
  StatCommInfoTypeDto:
    type: object
    properties:
      orgSize:
        $ref: '#/definitions/DictionaryTypeDto'
      activityAttr:
        $ref: '#/definitions/DictionaryTypeDto'
      addressFact:
        $ref: '#/definitions/AddressStatTypeDto'
      activity:
        type: array
        items:
          $ref: '#/definitions/ActivityTypeDto'
        description: Вид деятельности
      actualDate:
        type: string
        format: date-time
        description: Дата получения актуализации
        example: "2021-10-26T00:00:00+06:00"
  ReorganizationTypeDto:
    type: object
    required:
    - binReorganizationUl
    properties:
      binReorganizationUl:
        type: array
        items:
          type: string
          description: БИН реорганизованного юрлица
        description: Список БИН реорганизованных юрлиц
  BenefiziarsTypeDto:
    type: object
    required:
    - benefiziar
    properties:
      benefiziar:
        type: array
        items:
          $ref: '#/definitions/BenefiziarPersonTypeDto'
        description: Бенефициар юридического лица
  LeaderIpsNerezTypeDto:
    type: object
    properties:
      iin:
        type: string
        description: ИИН
      surName:
        type: string
        description: Фамилия
      name:
        type: string
        description: Имя
      middleName:
        type: string
        description: Отчество
  AddressIpsNerezTypeDto:
    type: object
    properties:
      kato:
        type: string
        description: Код КАТО
      districtRu:
        type: string
        description: Область на русском языке
      districtKz:
        type: string
        description: Область на государственном языке
      regionRu:
        type: string
        description: Район на русском языке
      regionKz:
        type: string
        description: Район на государственном языке
      cityRu:
        type: string
        description: Населенный пункт на русском языке
      cityKz:
        type: string
        description: Населенный пункт на государственном языке
      streetRu:
        type: string
        description: Название улицы на русском языке
      streetKz:
        type: string
        description: Название улицы на государственном языке
      buildingNumber:
        type: string
        description: Номер строения
      appartmentNumber:
        type: string
        description: Номер квартиры, офиса
  LeaderPositionTypeDto:
    type: object
    required:
    - positionType
    properties:
      positionType:
        $ref: '#/definitions/DictionaryTypeDto'
      issueDate:
        type: string
        format: date-time
        description: Дата назначения
      lossDate:
        type: string
        format: date-time
        description: Дата отстранения от должности или Дата утраты силы должности
          управляющего
  AddressStatTypeDto:
    type: object
    required:
    - nameKz
    - nameRu
    properties:
      rka:
        type: string
        description: Регистрационный код адреса
        example: 0201300080497704
      kato:
        type: string
        description: Код КАТО
        example: "711310000"
      nameRu:
        type: string
        description: адрес на русском языке
        example: Г.НУР-СУЛТАН РАЙОН САРЫАРКА Проспект РЕСПУБЛИКИ, дом 29
      nameKz:
        type: string
        description: адрес на государственном языке
        example: НҰР-СҰЛТАН Қ. САРЫАРҚА АУДАНЫ РЕСПУБЛИКИ Даңғылы, дом 29
  BenefiziarPersonTypeDto:
    type: object
    required:
    - citizenshipRelationCode
    - countryOfResidence
    properties:
      countryOfResidence:
        type: string
        description: Страна местожительства
      countryOfCitizenship:
        type: string
        description: Страна гражданства
      citizenshipRelationCode:
        type: string
        description: Код отношения к гражданству
      iin:
        type: string
        description: ИИН
      taxNumberIncCountry:
        type: string
        description: Налоговый номер в стране инкорпарации
      personStatusInGBDFL:
        type: string
        description: Статус лица в ГБДФЛ
      surname:
        type: string
        description: Фамилия
      name:
        type: string
        description: Имя
      middlename:
        type: string
        description: Отчество
      birthday:
        type: string
        format: date-time
        description: Дата рождения
      identityDocument:
        $ref: '#/definitions/DocumentTypeDto'
  DocumentTypeDto:
    type: object
    required:
    - documentNumber
    - documentType
    - issueDate
    - issuerId
    properties:
      documentType:
        type: string
        description: код документа из ГБД ФЛ
      documentNumber:
        type: string
        description: номер документа
      issueDate:
        type: string
        format: date-time
        description: дата выдачи
      issuerId:
        type: string
        description: код органа выдачи из ГБД ФЛ
tags: []
parameters:
  xib-trace-id:
    name: xib-trace-id
    type: string
    required: true
    in: header
    description: Уникальный идентификатор запроса
x-ibm-endpoints:
- endpointUrl: https://api.bcc.kz:10443/bcc/production
  description: Альтернативная точка подключения для вызова сервиса в продуктивной
    среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в
    режиме "PRODUCTION"
  type:
  - production
  - development
- endpointUrl: https://api.bcc.kz/bcc/production
  description: Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное
    на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
  type:
  - production
- endpointUrl: https://api-test.bcc.kz/bcc/production
  description: Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное
    на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
  type:
  - development
...