---
swagger: "2.0"
info:
  x-ibm-name: business-account-management
  title: Business Account Management
  version: 1.0.0
  contact:
    name: АО «Банк ЦентрКредит»
    email: api@bcc.kz
  description: ""
schemes:
- https
basePath: /v1/business-account-management
consumes:
- application/json
produces:
- application/json
securityDefinitions:
  Authorization:
    type: oauth2
    description: Токен аутентификации, полученный при вызове сервиса авторизации
    flow: application
    scopes:
      bcc.application.business.account.management: Allow access to Busines Account
        Management API
    tokenUrl: https://api.bcc.kz/bcc/production/v2/oauth/token
security:
- Authorization:
  - bcc.application.business.account.management
x-ibm-configuration:
  testable: true
  enforced: true
  phase: realized
paths:
  /accounts:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/Accounts'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      operationId: GetAccounts
      tags:
      - Accounts
      description: Получение списка счетов
    parameters:
    - $ref: '#/parameters/x-client-token'
  /accounts/{iban}/statement:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/StatementResponse'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      tags:
      - Accounts
      - Statement
      summary: ""
      operationId: getStatement
      description: Выписка по счету
    parameters:
    - $ref: '#/parameters/x-client-token'
    - name: iban
      type: string
      pattern: ^KZ[A-Z0-9]{18}$
      required: true
      in: path
      description: Номер 20 разрядного счета по которому требуется получение информации
    - name: convertKaz
      type: boolean
      required: true
      in: query
    - name: dateFrom
      type: string
      required: true
      in: query
      description: Дата начала периода (YYYY-MM-DD)
      format: date
    - name: dateTo
      type: string
      required: true
      in: query
      description: Дата окончания периода (YYYY-MM-DD)
      format: date
    - name: currency
      type: string
      required: true
      in: query
      description: Валюта выписки
  /transfers/xml:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            type: string
            example: |2-
               <?xml version='1.0'?>
               <root>
                   <bank_id_db>KCJBKZKX</bank_id_db>
               <account_db>KZ948502203106201650</account_db>
               <rnn_db>KZ24070105KSN0000000</rnn_db>
                <idn_db>061140003010</idn_db>
               <kod>15</kod>
               <bank_id_cr>KKMFKZ2A</bank_id_cr>
                   <account_cr>KZ24070105KSN0000000</account_cr>
                   <rnn_cr>null</rnn_cr>
                   <idn_cr>940740000624</idn_cr>
                   <valuedate>23-03-2023</valuedate>
                   <date_doc>23-03-2023</date_doc>
                   <ndoc>19</ndoc>
                   <kbe>19</kbe>
                   <knp>913</knp>
                   <taxcode>123456</taxcode>
                   <amount>123</amount>
                   <id>664794</id>
               </root>
      parameters:
      - name: transferId
        type: integer
        required: true
        in: query
        description: Идентификатор транзакции
        format: int64
      tags:
      - Transfers
      summary: Получение данные перевода в xml
      operationId: getXml
      produces: []
      consumes: []
    parameters:
    - $ref: '#/parameters/x-client-token'
  /transfers:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/PageResult'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      parameters:
      - name: beginDate
        type: string
        required: true
        in: query
        description: Дата начала периода "dd-MM-yyyy"
        format: date
      - name: endDate
        type: string
        required: true
        in: query
        description: Дата окончания периода "dd-MM-yyyy"
        format: date
      - name: iban
        type: string
        required: true
        in: query
        description: Номер 20 разрядного счета по которому требуется получение информации
      - name: page
        type: integer
        required: false
        in: query
        description: Номер страницы (по умолчанию 0)
        format: int32
      - name: size
        type: integer
        required: false
        in: query
        description: Количество элементов на странице (по умолчанию 10)
        format: int32
      tags:
      - Transfers
      summary: Список переводов
      operationId: GetTransferList
    post:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/CreateTransfer'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      tags:
      - Transfers
      summary: Создание перевода
      operationId: CreateTransfer
    parameters:
    - $ref: '#/parameters/x-client-token'
  /transfers/send:
    put:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/SendTransferResponse'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      tags:
      - Transfers
      summary: Отправка перевода
      operationId: SendTransfer
    parameters:
    - $ref: '#/parameters/x-client-token'
  /transfers/status:
    get:
      responses:
        200:
          description: 200 OK
          schema:
            $ref: '#/definitions/StatusResponse'
        400:
          description: BadRequest
        401:
          description: Unauthorized
        403:
          description: Forbidden
        500:
          description: Internal Server Error
      summary: Сервис предназначен для получения информации о переводе
      tags:
      - Transfers
      operationId: getStatus
      parameters:
      - name: id
        type: string
        required: true
        in: query
        description: id документа
      - name: isKZT
        type: boolean
        required: true
        in: query
        description: признак платежа в тенге
    parameters:
    - $ref: '#/parameters/x-client-token'
definitions:
  StatementResponse:
    type: object
    description: Структура выписки по счету.
    properties:
      info:
        $ref: '#/definitions/StatementInfo'
      inBalance:
        $ref: '#/definitions/BalanceInfo'
      outBalance:
        $ref: '#/definitions/BalanceInfo'
      transactions:
        type: array
        items:
          $ref: '#/definitions/Transaction'
  StatementInfo:
    type: object
    properties:
      reference:
        type: string
        example: 09301
        description: Референс
      currency:
        type: string
        example: KZT
        description: Валюта выписки
      accountBankCode:
        type: string
        example: KCJBKZKX
        description: БИК банка
      accountNumber:
        type: string
        example: KZ100100100100100100
        description: Номер счёта
      accountType:
        type: string
        example: CURR
        description: Тип счёта
      accountName:
        type: string
        example: Счет
        description: Наименование счёта
      accOwnerAddress:
        type: string
        example: 050000, КАЗАХСТАН, АЛМАТЫ г
        description: Адрес клиента
      bankBranchAddress:
        type: string
        example: 050000, КАЗАХСТАН, АЛМАТЫ г
        description: Адрес отделения банка
      bankBranchIdn:
        type: string
        example: 100100100100
        description: БИН отделения банка
      bankBranchBIC:
        type: string
        example: KCJBKZKX
        description: БИК отделения банка
      lastStatementDate:
        type: string
        example: 31-03-2020
        format: date
        description: Дата последней выписки
      accOwnerCode:
        type: string
        example: 17
        description: Код резиденства и сектора эконимики клиента
      accOwnerIdn:
        type: string
        example: 100100100100
        description: ИИН/БИН клиента
      accOwnerName:
        type: string
        example: Клиент
        description: Наименование клиента
      bankBranchName:
        type: string
        example: Отделение
        description: Наименование отделения банка
      bankBranchCode:
        type: string
        example: QQ1
        description: Код отделения банка
      dateFrom:
        type: string
        format: date
        example: 03-11-2020
        description: Дата начала периода
      dateTo:
        type: string
        format: date
        example: 03-11-2020
        description: Дата окончания периода
      statementDateTime:
        type: string
        format: date-time
        example: 23-02-2021 15:08:23
        description: Дата формирования выписки
      payCountDebit:
        type: number
        example: 55
        description: Количество транзакций по дебету
      payCountCredit:
        type: number
        example: 22
        description: Количество транзакции по кредиту
      turnoverDebit:
        type: number
        example: 694210.330000
        description: Обороты по дебету
      turnoverCredit:
        type: number
        example: 694210.440000
        description: Обороты по кредиту
      turnover:
        type: number
        example: 6941110.330000
        description: Обороты
      eqTurnover:
        type: number
        example: 69422.330000
        description: Обороты в эквиваленте
  BalanceInfo:
    type: object
    properties:
      date:
        type: string
        example: 03-11-2020
        format: date
        description: Дата баланса
      currency:
        type: string
        example: USD
        description: Валюта
      rate:
        type: number
        example: 1
        description: Курс
      amount:
        type: number
        example: 1543405.450000
        description: Баланс в валюте
      eqAmount:
        type: number
        example: 1543405.450000
        description: Баланс в эквиваленте
  Transaction:
    type: object
    properties:
      paymentId:
        type: string
        example: 10002282217111
        description: Идентификатор транзакции
      docNumber:
        type: string
        example: 175
        description: Номер документа
      valueDate:
        type: string
        example: 04-02-2020
        format: date
        description: Дата валютирования
      entryDate:
        type: string
        example: 04-02-2020
        format: date
        description: Операционный день
      execdate:
        type: string
        example: 23-02-2021 15:08:23
        format: date-time
        description: Дата/Время исполнения
      createDate:
        type: string
        example: 23-02-2021 15:08:23
        format: date-time
        description: Дата/Время ввода в систему
      dbcrfl:
        type: string
        example: 1
        description: Направление транзакции (1-дебет, 0-кредит)
      amount:
        type: number
        example: 154655.730000
        format: float
        description: Сумма транзакции
      clientReference:
        type: string
        example: 175
        description: Клиентский референс
      bankReference:
        type: string
        example: ALM2020471551594
        description: Банковский референс
      knp:
        type: string
        example: 332
        description: Код назначения платежа
      budgetCode:
        type: string
        example: 142
        description: Код бюджетной классификации
      partyCode:
        type: string
        example: 14
        description: Резиденство и сектор экономики корреспондента
      partyIdn:
        type: string
        example: 100100100100
        description: ИИН/Бин корреспондента
      partyName:
        type: string
        example: Банк ЦентрКредит АО
        description: Наименование корреспондента
      partyAccount:
        type: string
        example: KZ100100100100100100
        description: Счет корреспондента
      partyBankCode:
        type: string
        example: KCJBKZKX
        description: БИК банка корреспондента
      partyBankName:
        type: string
        example: АО "Банк ЦентрКредит"
        description: Наименование банка корреспондента
      corrIdn:
        type: string
        example: 180640010876
        description: ИИН/БИН отправителя
      corrName:
        type: string
        example: Наименование
        description: Наименование отправителя
      purpose:
        type: string
        example: Для зачисления на картсчета сотрудникам
        description: Назначение платежа
      eqAmount:
        type: string
        example: 154655.730000
        description: Сумма транзакции в эквиваленте
      eqCurrency:
        type: string
        example: KZT
        description: Валюта эквивалента
      chief:
        type: string
        example: Иванов И. И.
        description: Руководитель (1-я подпись)
      mainbk:
        type: string
        example: Не предусмотрено
        description: Главный бухгалтер (2-я подпись)
      stage:
        type: string
        example: FIN
        description: Состояние
      period:
        type: string
        example: 4
        description: Период оплаты (для платежей в бюджет)
      clerk:
        type: string
        example: Иванов И. И.
        description: Исполнитель
      poTypeDesc:
        type: string
        example: Платежное поручение
        description: Тип платежа
      cardTrnAmount:
        type: string
        description: Сумма транзакции по карте
      cardTrnCurr:
        type: string
        description: Валюта транзакции по карте
      cardRRn:
        type: string
      officialRate:
        type: string
        description: Учетный курс валюты транзакции
      marketRate:
        type: string
        description: Рыночный курс валюты транзакции
      registry:
        $ref: '#/definitions/RegistryRecord'
  RegistryRecord:
    type: object
    description: Реестр платежа
    properties:
      assign:
        type: string
        description: Назначение
      code:
        type: string
        description: Номер документа
      dop:
        type: string
        description: Дата документа
      dt:
        type: string
        description: Дата рождения
      errCode:
        type: string
        description: Код ошибки
      fm:
        type: string
        description: Фамилия
      ft:
        type: string
        description: Отечество
      knp:
        type: string
        description: Код назначения платежа
      la:
        type: string
        description: Лицевой счет
      nm:
        type: string
        description: Имя
      nord:
        type: number
      opv:
        type: string
        description: Идентификатор пенсионной проплаты
      pendFl:
        type: number
      period:
        type: string
        description: Период оплаты
      rnn:
        type: string
        description: ИИН/БИН
      subRef:
        type: string
        description: Субреференс
      sum:
        type: string
        description: Сумма
  Subject:
    type: object
    properties:
      account:
        description: Счёт
        type: string
        example: KZ128560000000517854
      bik:
        description: БИК
        type: string
        example: GCVPKZ2A
      code:
        description: Код
        type: string
        example: "17"
      in:
        description: ИИН
        type: string
        example: "940302300403"
      name:
        description: Имя
        type: string
        example: Имя
    additionalProperties: false
    required:
    - account
    - bik
    - code
    - in
    - name
  StatusResponse:
    properties:
      amount:
        type: number
        format: double
        description: сумма платежа
      clientCode:
        type: string
        description: Код клиента
      commissionAccountNumber:
        type: string
        description: Счет спсиания комиссии
        example: KZ128560000000517854
      currency:
        type: string
        description: Валюта
        example: KZT
      customerId:
        format: int64
        description: Идентификатор владельца
        type: integer
        example: 31234
      division:
        type: string
        description: Подразделение
        example: AF1
      docDate:
        type: string
        format: date
        description: Дата документа
        pattern: dd-MM-yyyy
        example: 01-01-2023
      isUrgent:
        type: boolean
        description: Признак срочного платежа
      knp:
        type: string
        description: КНП (Код назначения платежа)
        example: "185"
      narrative_first:
        description: Произвольное назначение платежа, заполняется клиентом
        type: string
        example: Оплата пенсионных взносов за сотрудников
      narrative:
        description: Назначение платежа
        type: string
        example: Единый платеж
      signatureFirst:
        type: string
        description: Первый руководитель
      signatureScheme:
        type: integer
        format: int32
        description: схема одобрения
      signatureSecond:
        type: string
        description: Главный бухгалтер
      state:
        $ref: '#/definitions/State'
        description: статус платежа
      type:
        type: string
        $ref: '#/definitions/TransferType'
        description: Тип платежа
        example: SINGLE
      valueDate:
        type: string
        format: date
        description: Дата валютирования
        pattern: dd-MM-yyyy
        example: 01-01-2023
      receiver:
        $ref: '#/definitions/Participant'
      sender:
        $ref: '#/definitions/Participant'
    additionalProperties: false
    required:
    - sender
    - receiver
    - valueDate
    - type
    - state
    - signatureSecond
    - signatureScheme
    - signatureFirst
    - narrative_first
    - narrative
    - amount
    - clientCode
    - commissionAccountNumber
    - currency
    - customerId
    - division
    - docDate
    - isUrgent
    - knp
  TransferType:
    enum:
    - BUDGET
    - EXTERNAL
    - INTERNAL
    - MEDICAL
    - MEDICAL_REMAND
    - PENSION
    - SALARY
    - SINGLE
    - SOCIAL
    - STANDARD_CARD
    - STANDARD_CARD_BANK
    - VOLUNTARY_PENSION
    type: string
  State:
    enum:
    - APPROVED
    - APPROVED_BANK
    - APPROVED_HALF
    - BANK_ACCEPTED
    - CONFIRMED
    - CREATED
    - DELETED
    - ERROR
    - EXECUTED
    - PRESENDED
    - SENDED
    type: string
  Accounts:
    type: array
    items:
      $ref: '#/definitions/Account'
  Account:
    properties:
      id:
        type: integer
        format: int64
        description: Идентификатор счета
      iban:
        type: string
        description: Номер счета
        example: KZ128560000000517854
      client_code:
        type: string
        description: Идентификатор клиента
        example: 01253687
      description:
        type: string
        description: Описание
      name:
        type: string
        description: Название счета
        example: Текущий счет
      currency:
        type: string
        description: Валюта
        example: KZT
      status:
        type: string
        description: Статус
        example: OPENED
      division:
        type: string
        description: Код отдела
      type:
        $ref: '#/definitions/AccountType'
        description: Тип счета
      is_main:
        type: boolean
        description: Признак основного счета
    additionalProperties: false
    required:
    - id
    - client_code
    - description
    - iban
    - name
    - currency
    - status
    - division
    - type
    - is_main
  AccountType:
    enum:
    - CURR
    - CARD
    type: string
  Participant:
    type: object
    properties:
      in:
        type: string
        description: ИИН/БИН
      name:
        type: string
        description: Наименование
      account:
        type: string
        description: Номер счета
      code:
        type: string
        description: КОд - код отправителя денег./ КБе - код получателя денег.
      country:
        type: string
        description: ISO код страны плательщика фактического получателя
      intermediary:
        type: object
        description: Получатель бенефициар (посредник)
      isThirdPartyPayment:
        type: boolean
        description: Признак платежа 3-му лицу (Фактический бенефициар).
  Employee:
    type: object
    properties:
      operation:
        description: Операция
        type: string
        example: Операция
      birth_date:
        format: date
        description: Дата рождения
        pattern: dd-MM-yyyy
        type: string
        example: 01-01-2023
      surname:
        description: Фамилия
        type: string
        example: Фамилия
      name:
        description: Имя
        type: string
        example: Имя
      patronymic:
        description: Отчество
        type: string
        example: Отчество
      account:
        description: Счёт
        type: string
        example: KZ80009EP00368609101
      amount:
        description: Сумма фактическая за сотрудника
        type: number
        example: 100
      estimatedAmount:
        description: Ожидаемая сумма оплаты за сотрудника
        type: number
        example: 200
      knpList:
        description: Список КНП за которые производится оплата
        type: array
        items:
          type: string
        example:
        - 185
        - 191
      iin:
        description: ИИН
        type: string
        example: "940302300403"
      period:
        format: date
        description: Период
        pattern: dd-MM-yyyy
        type: string
        example: 01-01-2023
      assign:
        type: string
        description: Назначение
      economicSectorCode:
        type: string
        description: Код сектора экономики
      isResident:
        type: boolean
        description: Признак резиденства
      country:
        type: string
        description: Страна получателя  ISO код страны по стандарту Alpha-2 ISO 3166-1
  Bank:
    properties:
      _id:
        type: string
      _sub:
        type: string
      archival:
        type: string
      bank_name:
        type: string
      code_bank:
        type: string
      iban_code:
        type: string
  CreateTransfer:
    type: object
    properties:
      comission_account:
        description: Счёт списания комиссии
        type: string
        example: KZ128560000000517854
      amount:
        description: Сумма
        type: number
        example: 0
      currency:
        description: Валюта
        type: string
        example: KZT
      knp:
        description: КНП (Код назначения платежа)
        type: string
        example: "185"
      taxcode:
        description: КБК
        type: string
        example: "123"
      sender:
        allOf:
        - $ref: '#/definitions/Subject'
        - description: Отправитель
      receiver:
        allOf:
        - $ref: '#/definitions/Subject'
        - description: Получатель
      signatureA:
        description: Электронная подпись XML
        type: string
        example: XML с подписью NCA
      signatureB:
        description: Электронная подпись XML
        type: string
        example: XML с подписью NCA
      narrative_first:
        description: Произвольное назначение платежа, заполняется клиентом
        type: string
        example: Оплата пенсионных взносов за сотрудников
      narrative:
        description: Назначение платежа
        type: string
        example: Единый платеж
      type:
        $ref: '#/definitions/TransferType'
        description: Тип платежа
        example: SINGLE
      period:
        format: date
        description: Период
        pattern: dd-MM-yyyy
        type: string
        example: 01-01-2023
      customer_id:
        format: int64
        description: Идентификатор владельца
        type: integer
        example: 31234
      state:
        $ref: '#/definitions/State'
        description: Состояние(Статус) платежа
        example: CREATED
      is_urgent:
        description: Признак срочного платежа
        type: boolean
        example: false
      nds:
        format: int32
        description: НДС
        type: integer
        example: 0
      employeeList:
        $ref: '#/definitions/Employee'
        description: Список сотрудников
      detailList:
        description: Детали платежа
        $ref: '#/definitions/TransferDetailDTO'
  TransferDetailDTO:
    type: object
    properties:
      id:
        format: int64
        description: Идентификатор
        type: integer
        example: 21324
      type:
        type: string
        description: Тип деталей
      value:
        description: Значение - результат
        type: string
  SendTransferResponse:
    type: object
    properties:
      processResult:
        description: Результат
        $ref: '#/definitions/ProcessResult'
      count:
        format: int32
        description: Количество переводов
        type: integer
        example: 0
      success:
        format: int32
        description: Признак успешности
        type: integer
        example: 0
  PageResult:
    properties:
      content:
        description: Содержимое
        $ref: '#/definitions/TransferResponse'
      pageNumber:
        type: string
        description: Номер страницы
      pageSize:
        type: string
        description: Количество элементов на странице
      totalElements:
        type: string
        description: Общее количество элементов
      totalPage:
        type: string
        description: Количество страниц
    additionalProperties: false
  ProcessResult:
    type: object
    properties:
      data:
        description: Список транзакций
        type: array
        items:
          type: string
          example:
          - "123"
          - "321"
  TransferResponse:
    properties:
      id:
        type: integer
        format: int64
        description: Идентификатор платежа
      docDate:
        type: string
        description: Дата документа
      nDoc:
        type: string
        description: Номер документа
      amount:
        type: integer
        format: int64
        description: Сумма платежа
      currency:
        type: string
        description: Валюта платежа
      narrative:
        type: string
        description: Назначение платежа
      isKZT:
        type: boolean
        description: Признак платежа в тенге
      timeSent:
        type: string
        description: Дата оправления документа
      documentTypeId:
        type: integer
        format: int64
        description: Тип документа
      timeParsed:
        type: string
        description: Дата платежа
      receiverIdn:
        type: string
        description: ИИН/БИН получаетля
      receiverName:
        type: string
    additionalProperties: false
  Intermediary:
    properties:
      taxIdentificationNumber:
        type: string
        description: Номер налогоплательщика фактического бенефициара
      isLegalEntity:
        type: boolean
        description: Признак юридического лица бенефициара
      name:
        type: string
        description: Наименование фактического бенефициара в платеже
    additionalProperties: false
tags: []
parameters:
  x-client-token:
    name: x-client-token
    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
...