openapi: 3.2.0
info:
  title: Raiffeisen Ru Limit API
  version: 1.0.0
  description: 'Operations tagged Limit across 2 of this provider''s published API definitions: raiffeisen-ru-agency-factoring-openapi.yml, raiffeisen-ru-agency-factoring-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.raiffeisen.ru/payables-financing
tags:
- description: Лимит
  name: Limit
paths:
  /v1/limits:
    get:
      description: Метод получения лимита
      operationId: getLimits
      parameters:
      - description: Клиентский номер (CNUM)
        in: query
        name: cnums
        required: false
        schema:
          example: AAABBB
          type: string
      - $ref: '#/components/parameters/IdTokenHeader'
      - $ref: '#/components/parameters/AuthorizationHeader'
      responses:
        '200':
          content:
            application/json:
              examples:
                simple:
                  summary: Одобренный
                  value:
                  - principal:
                      ogrn: '1027739326449'
                      shortNameRus: АО Ромашка
                      cqrsVersion: -1628796591
                      inn: '7744000302'
                      kpp: '770401001'
                      id: bf1d1868-a98e-4ae5-976f-0c4e21e0d510
                      state:
                        statusDate: '2021-07-10T06:53:37.433111Z'
                        errors: []
                        status: APPROVED
                      fullNameEng: Joint Stock Chamomile
                      cnum: AA10AA
                      fullNameRus: Акционерное общество Ромашка
                    rest: 90.0
                    amount: 100.01
                    cqrsVersion: -1628796591
                    id: bf1d1868-a98e-4ae5-976f-0c4e21e0d510
                    used: 10.01
                    state:
                      statusDate: '2021-07-10T06:53:37.433111Z'
                      errors: []
                      status: APPROVED
                    currencyCode: RUB
              schema:
                $ref: '#/components/schemas/LimitListResponse'
          description: OK
        '400':
          content:
            application/json:
              examples:
                simple:
                  value:
                  - code: REST_ERR_5001
                    message: General service error
                    traceId: 29bda8ca-4d33-11ec-81d3-0242ac130000
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: BAD_REQUEST
        '401':
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
      summary: Получения лимита
      tags:
      - Limit
    servers:
    - url: https://api.raiffeisen.ru/payables-financing
components:
  schemas:
    RestErrorCodes:
      description: '| code            | description                                |

        |-----------------|--------------------------------------------|

        | REST_ERR_5001   | General service error                       |

        | REST_ERR_5040   | Tax is not available                        |

        | REST_ERR_5041   | Incorrect format of taxpayer status         |

        | REST_ERR_5042   | Incorrect format of KPP payer''s             |

        | REST_ERR_5043   | Incorrect format of UIN                     |

        | REST_ERR_5044   | Incorrect format of CBC                     |

        | REST_ERR_5045   | Incorrect format of OKTMO                   |

        | REST_ERR_5046   | Incorrect format of payment reason          |

        | REST_ERR_5047   | Incorrect format of tax period              |

        | REST_ERR_5048   | Incorrect format of the payment reason document number |

        | REST_ERR_5049   | Incorrect format of the payment reason document date   |

        | REST_ERR_5050   | Incorrect format of receiver name           |

        | REST_ERR_5051   | Incorrect format of purpose                 |

        '
      enum:
      - REST_ERR_5001
      - REST_ERR_5040
      - REST_ERR_5041
      - REST_ERR_5042
      - REST_ERR_5043
      - REST_ERR_5044
      - REST_ERR_5045
      - REST_ERR_5046
      - REST_ERR_5047
      - REST_ERR_5048
      - REST_ERR_5049
      - REST_ERR_5050
      - REST_ERR_5051
      example: REST_ERR_5001
      type: string
    ErrorCodes:
      description: '| code       | description                        |

        |------------|------------------------------------|

        | ERR_0000   | Unexpected error                   |

        | ERR_0001   | Creditor not valid                 |

        | ERR_0002   | Error getting okved from DaData    |

        | ERR_0003   | Affiliation check not valid        |

        | ERR_0004   | Affiliation check nof found        |

        | ERR_1001   | Requisites not valid               |

        | ERR_1002   | Creditor not valid                 |

        | ERR_1003   | The financing period is longer than the maximum |

        | ERR_1004   | Exceeded daily limit               |

        | ERR_1005   | Creditor not found                 |

        | ERR_1006   | Exceed maximum limit               |

        | ERR_1007   | Date is not found in calendar      |

        | ERR_1008   | Agreement not found                |

        | ERR_1009   | Agreement not valid                |

        | ERR_1010   | Agreement is blocked               |

        | ERR_1011   | Order date invalid                 |

        | ERR_1012   | Maturity date invalid              |

        | ERR_1013   | Limit not valid                    |

        | ERR_1014   | Due date is unavailable            |

        | ERR_1015   | Tariff plan not found              |

        | ERR_1016   | Order date is not working day      |

        | ERR_1017   | Tariff plan not approved           |

        | ERR_2000   | General service error              |

        | ERR_4001   | Requisites not valid               |

        | ERR_4002   | Payment rejected by operator       |

        | ERR_4003   | Payment rejected by CBR            |

        | ERR_6000   | Entry rejected by CIG              |

        | ERR_9001   | Value date is over                 |

        | ERR_9002   | First financing date is over       |

        | ERR_11001  | Minimum Margin check failed        |

        | ERR_12001  | Account is blocked                 |

        '
      enum:
      - ERR_0000
      - ERR_0001
      - ERR_0002
      - ERR_0003
      - ERR_0004
      - ERR_1001
      - ERR_1002
      - ERR_1003
      - ERR_1004
      - ERR_1005
      - ERR_1006
      - ERR_1007
      - ERR_1008
      - ERR_1009
      - ERR_1010
      - ERR_1011
      - ERR_1012
      - ERR_1013
      - ERR_1014
      - ERR_1015
      - ERR_1016
      - ERR_1017
      - ERR_2000
      - ERR_4001
      - ERR_4002
      - ERR_4003
      - ERR_6000
      - ERR_9001
      - ERR_9002
      - ERR_11001
      - ERR_12001
      example: ERR_2000
      type: string
    ErrorMessage:
      example:
        code: REST_ERR_5001
        message: General service error
        traceId: 29bda8ca-4d33-11ec-81d3-0242ac130000
      properties:
        code:
          $ref: '#/components/schemas/RestErrorCodes'
        message:
          description: Сообщение
          example: General service error
          type: string
        traceId:
          description: traceId
          example: 29bda8ca-4d33-11ec-81d3-0242ac130000
          type: string
      required:
      - code
      - message
      - traceId
      type: object
    Error:
      example:
        code: ERR_1001
        message: General service error
      properties:
        code:
          $ref: '#/components/schemas/ErrorCodes'
        message:
          description: Сообщение
          example: General service error
          type: string
        traceId:
          description: traceId
          example: 29bda8ca-4d33-11ec-81d3-0242ac130000
          type: string
      required:
      - code
      - message
      type: object
    LimitState:
      allOf:
      - $ref: '#/components/schemas/State'
      - properties:
          status:
            $ref: '#/components/schemas/LimitStatus'
        type: object
      description: Состояние лимита
      example:
        statusDate: '2025-07-10T06:53:37.433211'
        errors: []
        status: APPROVED
      type: object
    Limit:
      example:
        id: 2c44306f-fc96-4780-9b37-6447273b190e
        principal:
          id: 2c44306f-fc96-4780-9b37-6447273b190e
          cnum: AA10AA
          shortNameRus: АО Ромашка
          fullNameRus: Акционерное общество Ромашка
          fullNameEng: Joint Stock Chamomile
          inn: '7744000302'
          ogrn: '1027739326449'
          kpp: '770401001'
          state:
            statusDate: '2025-07-10T06:53:37.433211'
            errors: []
            status: APPROVED
          cqrsVersion: -1628796591
        amount: 100.01
        used: 10.01
        rest: 90.0
        currencyCode: RUB
        state:
          statusDate: '2025-07-10T06:53:37.433211'
          errors: []
          status: APPROVED
        cqrsVersion: -1628796591
      properties:
        id:
          description: Идентификатор лимита
          example: 2c44306f-fc96-4780-9b37-6447273b190e
          format: uuid
          type: string
        principal:
          $ref: '#/components/schemas/Principal'
        amount:
          description: Сумма лимита
          example: 100.01
          type: number
        used:
          description: Сумма использование лимита
          example: 10.01
          type: number
        rest:
          description: Остаток лимита
          example: 90.0
          type: number
        currencyCode:
          $ref: '#/components/schemas/CurrencyCode'
        state:
          allOf:
          - $ref: '#/components/schemas/LimitState'
          description: Состояние лимита
          type: object
        cqrsVersion:
          description: hashCode от state - состояния реестра
          example: -1628796591
          type: integer
      type: object
    CurrencyCode:
      description: Валюта платежа
      enum:
      - RUB
      example: RUB
      type: string
    LimitListResponse:
      description: Список лимитов
      example:
      - principal:
          ogrn: '1027739326449'
          shortNameRus: АО Ромашка
          cqrsVersion: -1628796591
          inn: '7744000302'
          kpp: '770401001'
          id: bf1d1868-a98e-4ae5-976f-0c4e21e0d510
          state:
            statusDate: '2021-07-10T06:53:37.433111Z'
            errors: []
            status: APPROVED
          fullNameEng: Joint Stock Chamomile
          cnum: AA10AA
          fullNameRus: Акционерное общество Ромашка
        rest: 90.0
        amount: 100.01
        cqrsVersion: -1628796591
        id: bf1d1868-a98e-4ae5-976f-0c4e21e0d510
        used: 10.01
        state:
          statusDate: '2021-07-10T06:53:37.433111Z'
          errors: []
          status: APPROVED
        currencyCode: RUB
      items:
        $ref: '#/components/schemas/Limit'
      type: array
    PrincipalState:
      allOf:
      - $ref: '#/components/schemas/State'
      - properties:
          status:
            $ref: '#/components/schemas/PrincipalStatus'
        type: object
      description: Состояние пакета
      example:
        statusDate: '2025-07-10T06:53:37.433211'
        errors: []
        status: APPROVED
      type: object
    Principal:
      description: Принципал
      example:
        id: 2c44306f-fc96-4780-9b37-6447273b190e
        cnum: AA10AA
        shortNameRus: АО Ромашка
        fullNameRus: Акционерное общество Ромашка
        fullNameEng: Joint Stock Chamomile
        inn: '7744000302'
        ogrn: '1027739326449'
        kpp: '770401001'
        state:
          statusDate: '2025-07-10T06:53:37.433211'
          errors: []
          status: APPROVED
        cqrsVersion: -1628796591
      properties:
        id:
          description: Идентификатор принципала
          example: 2c44306f-fc96-4780-9b37-6447273b190e
          format: uuid
          type: string
        cnum:
          description: Клиентский номер (CNUM)
          example: AA10AA
          type: string
        shortNameRus:
          description: Сокращенное наименование организации
          example: АО Ромашка
          type: string
        fullNameRus:
          description: Полное наименование организации
          example: Акционерное общество Ромашка
          type: string
        fullNameEng:
          description: Полное наименование организации на англ. языке
          example: Joint Stock Chamomile
          type: string
        inn:
          description: ИНН
          example: '7744000302'
          type: string
        ogrn:
          description: ОГРН
          example: '1027739326449'
          type: string
        kpp:
          description: КПП
          example: '770401001'
          type: string
        state:
          allOf:
          - $ref: '#/components/schemas/PrincipalState'
          description: Состояние пакета
          type: object
        cqrsVersion:
          description: hashCode от state - состояния реестра
          example: -1628796591
          type: integer
      required:
      - cnum
      - cqrsVersion
      - fullNameEng
      - fullNameRus
      - id
      - inn
      - kpp
      - ogrn
      - shortNameRus
      - state
      type: object
    LimitStatus:
      description: Статус лимита
      enum:
      - APPROVED
      - INVALID
      example: APPROVED
      type: string
    State:
      description: Состояние объекта
      example:
        statusDate: '2025-07-10T06:53:37.433211'
        errors: []
      properties:
        statusDate:
          description: yyyy-MM-dd'T'HH:mm:ss.SSSSSS
          format: date-time
          pattern: ([0-9]{4})-(?:[0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2}).([0-9]{6})
          type: string
        errors:
          description: Ошибки
          items:
            $ref: '#/components/schemas/Error'
          type: array
      required:
      - statusDate
      type: object
    PrincipalStatus:
      description: Статус принципала
      enum:
      - FETCHED
      - APPROVED
      - REJECTED
      example: APPROVED
      type: string
    ErrorResponse:
      description: Список ошибок
      example:
      - code: REST_ERR_5001
        message: General service error
        traceId: 29bda8ca-4d33-11ec-81d3-0242ac130000
      items:
        $ref: '#/components/schemas/ErrorMessage'
      type: array
  responses:
    Unauthorized:
      description: Аутентификация не пройдена
    InternalError:
      description: Внутренняя ошибка
  parameters:
    AuthorizationHeader:
      name: Authorization
      in: header
      description: Токен доступа
      required: true
      schema:
        type: string
        format: byte
        example: Bearer QXV0aG9yaXphdGlvbiBIZWFkZXIgRm9yIFRlc3Rpbmc=
    IdTokenHeader:
      name: Id-Token
      in: header
      description: Идентификационный токен пользователя
      required: true
      schema:
        type: string
        format: byte
        example: SUQgVE9LRU4gRk9SIFRFU1RJTkc=
x-refined-from:
- raiffeisen-ru-agency-factoring-openapi.yml
- raiffeisen-ru-agency-factoring-openapi.yml