• Аутентификация
• API
  • postДля возможности Marketplace передавать через API с
  • getЗапрос идентификатора СберСмартКабинета участника
  • postСоздание нового смарт-контракта
  • getЗапрос данных по смарт-контракту

Documentation Powered by Redocly

Смарт-контракты на ЭДС (1.0.15)

Скачать OpenAPI-спецификацию:Скачать

Работа со смарт-контрактами через API позволяет избежать повторного ввода условий сделки в СберСмартКабинете.

Доступные функции:

• Создание смарт-контракта
• Получение статуса смарт-контракта

Подробнее о смарт-контрактах

Аутентификация

OAuth2

Security Scheme Type	OAuth2
clientCredentials OAuth Flow	Token URL: https://mc.api.sberbank.ru/prod/tokens/v3/oauth Scopes: auth://sbersmartcabinet/digital-money-contract - единый scope для API

API

Для возможности Marketplace передавать через API с

post/customers

Для возможности Marketplace передавать через API смарт-контракт и быть участником этого смарт-контракта. (Разовая операция для каждого нового Marketplace)

Авторизация

OAuth2 (

• auth://sbersmartcabinet/digital-money-contract

)

Заголовки

RqUID required

string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$ Example: fe4e390d969bcc91f4db3e4ec0d2fa26 Уникальный идентификатор запроса

Схема запроса: application/json

inn required	string <= 12 characters ^(([0-9]{12})|([0-9]{10}))?$ ИНН организации
kpp	string <= 9 characters ^([0-9]{9})?$ КПП организации

Ответы

https://mc.api.sberbank.ru/prod/sbersmartcabinet/digital-money-contract/v1/customers

Пример запроса

• Payload

Content type

application/json

{

• "inn": "7804492059",
• "kpp": "780401001"

}

Пример ответа

• 200
• 400
• 401
• 403
• 404
• 405
• 429
• 500

Content type

application/json

{

• "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1d1i"

}

Запрос идентификатора СберСмартКабинета участника

get/members

Запрос идентификатора СберСмартКабинета участника смарт-контракта

Авторизация

OAuth2 (

• auth://sbersmartcabinet/digital-money-contract

)

QUERY-ПАРАМЕТРЫ

inn required	string (inn) <= 12 characters ^(([0-9]{12})|([0-9]{10}))?$ Example: inn=7804492059 ИНН организации
kpp	string (kpp) <= 9 characters ^([0-9]{9})?$ Example: kpp=780401001 КПП организации

Заголовки

RqUID required

string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$ Example: fe4e390d969bcc91f4db3e4ec0d2fa26 Уникальный идентификатор запроса

Ответы

https://mc.api.sberbank.ru/prod/sbersmartcabinet/digital-money-contract/v1/members

Пример ответа

• 200
• 400
• 401
• 403
• 404
• 405
• 429
• 500

Content type

application/json

{

• "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1d1i"

}

Создание нового смарт-контракта

post/basic-smart-contracts

Создание нового смарт-контракта

Авторизация

OAuth2 (

• auth://sbersmartcabinet/digital-money-contract

)

Заголовки

RqUID required

string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$ Example: fe4e390d969bcc91f4db3e4ec0d2fa26 Уникальный идентификатор запроса

Схема запроса: application/json

required	object Информация по смарт-контракту
required	Array of objects <= 10 items [ items ]

Ответы

https://mc.api.sberbank.ru/prod/sbersmartcabinet/digital-money-contract/v1/basic-smart-contracts

Пример запроса

• Payload

Content type

application/json

{

• "smartContract": {

  • "name": "Пшеница, 3 кл 23450",
  • "subject": "Пшеница",
  • "dueContractApprove": {

    • "date": "2022-08-30T00:00:00.000Z",
    • "onDate": "AUTOMATIC_CANCEL"

    },
  • "dueTransactionApprove": {

    • "date": "2022-08-31T00:00:00.000Z",
    • "onDate": "AUTOMATIC_CANCEL"

    },
  • "canceledSmartContractId": "1aadb5e775db496ab929e6fbe",
  • "transaction": {

    • "purpose": "За пшеницу, 3 кл. 23450",
    • "amount": "120000.25",
    • "payerId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1f1i",
    • "recipientId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h"

    },
  • "partnerCommissions": [

    • {

      • "purpose": "Комиссия за предоставление площадки",
      • "amount": "2000",
      • "recalculateProportionally": true,
      • "payerId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1f1i",
      • "recipientId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1n"

      }

    ]

  },
• "members": [

  • {

    • "id": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h",
    • "role": "SELLER"

    }

  ]

}

Пример ответа

• 200
• 400
• 401
• 403
• 404
• 405
• 429
• 500

Content type

application/json

{

• "timestamp": "2022-01-13T09:59:48.704+03:00",
• "smartContractId": "2sadb5e775db496ab929e6fbv",
• "smartContractStatus": "PENDING"

}

Запрос данных по смарт-контракту

get/basic-smart-contracts/{id}

Запрос данных по смарт-контракту

Авторизация

OAuth2 (

• auth://sbersmartcabinet/digital-money-contract

)

PATH-ПАРАМЕТРЫ

id required

string (smartContractId) 25 characters ^[a-z0-9]{25,25}$ Example: 2sadb5e775db496ab929e6fbv ID смарт-контракта

Заголовки

RqUID required

string (RqUID) <= 32 characters ^(([0-9]|[a-f]|[A-F]){32})$ Example: fe4e390d969bcc91f4db3e4ec0d2fa26 Уникальный идентификатор запроса

Ответы

https://mc.api.sberbank.ru/prod/sbersmartcabinet/digital-money-contract/v1/basic-smart-contracts/{id}

Пример ответа

• 200
• 400
• 401
• 403
• 404
• 405
• 429
• 500

Content type

application/json

{

• "smartContract": {

  • "status": "PENDING",
  • "name": "Пшеница, 3 кл. 23450",
  • "subject": "Пшеница",
  • "dueContractApprove": {

    • "date": "2022-01-25T18:25:59+03:00",
    • "onDate": "AUTOMATIC_CANCEL"

    },
  • "dueTransactionApprove": {

    • "date": "2022-01-25T18:25:59+03:00",
    • "onDate": "AUTOMATIC_CANCEL"

    },
  • "canceledSmartContractId": "1aadb5e775db496ab929e6fbe",
  • "transaction": {

    • "purpose": "За пшеницу, 3 кл. 23450",
    • "amount": "120000.25",
    • "payerId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1f1i",
    • "recipientId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1f1h",
    • "changeRequest": {

      • "initiatorRole": "BUYER",
      • "actualAmount": "100000",
      • "purpose": "За пшеницу, 3 кл. 23450",
      • "approveDocumentNumber": "177 от 14.03.2022"

      }

    },
  • "partnerCommissions": [

    • {

      • "purpose": "Комиссия за услугу по оформлению сделки",
      • "amount": "1000",
      • "recalculateProportionally": "true",
      • "payerId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h",
      • "recipientId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1s",
      • "changeRequest": {

        • "initiatorRole": "BUYER",
        • "actualAmount": "1000",
        • "purpose": "Комиссия за пшеницу, 3 кл. 23450",
        • "approveDocumentNumber": "177 от 14.03.2022"

        }

      }

    ]

  },
• "members": [

  • {

    • "id": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h",
    • "inn": "7804492059",
    • "kpp": "780401001",
    • "orgName": "Общество с ограниченной ответственностью Зерно-Трейд",
    • "role": "SELLER"

    }

  ],
• "contractApproves": [

  • {

    • "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h",
    • "signInfo": {

      • "inn": "7804492059",
      • "kpp": "780401001",
      • "orgName": "Общество с ограниченной ответственностью Зерно-Трейд",
      • "signDate": "2022-01-25T18:25:59+03:00",
      • "fio": "Морозов Иван Ильич",
      • "position": "Главный бухгалтер"

      },
    • "signExists": "true"

    }

  ],
• "transactionApproves": [

  • {

    • "memberId": "252t312q2t362n372q2t36192s2x2v2x382p30193133322t3d2n2v2p382t191d2n1h",
    • "signInfo": {

      • "inn": "7804492059",
      • "kpp": "780401001",
      • "orgName": "Общество с ограниченной ответственностью Зерно-Трейд",
      • "signDate": "2022-01-25T18:25:59+03:00",
      • "fio": "Морозов Иван Ильич",
      • "position": "Главный бухгалтер"

      },
    • "signExists": "true"

    }

  ]

}